IBM BPM, V8.0.1, All platforms > Authoring services in Integration Designer > Services and service-related functions > Access external services with adapters > Configure and using adapters > IBM WebSphere Adapters > IBM i > Overview of WebSphere Adapter for IBM i > Technical overview

Business faults

The adapter supports business faults, which are exceptions that are anticipated and declared in the outbound service description, or import. Business faults occur at predictable points in a business process, and are caused by a business rule violation or a constraint violation.

Although IBM BPM and WebSphere Enterprise Service Bus support other types of faults, the WebSphere adapter generates only business faults. These business faults are referred to as faults in this document. Not all exceptions are faults. Faults are generated for errors that have a recovery action and do not terminate the application.

For example, during outbound processing, the adapter generates a fault when it receives a business object that does not contain the required data or when the adapter encounters certain errors.


Fault business objects

The external service wizard creates a business object for each fault that the adapter can generate. In addition, the wizard creates a WBIFault superset business object, which has information common to all faults, such as the message, errorCode, and primarySetKey attributes, as shown in figure 1.

Figure 1. The structure of the WBIFault business object

The WBIFault business object contains all the information needed to handle the fault.

Technical overview of WebSphere Adapter for IBM i