Introduction to Extending Fault Messages

Configuring Oracle AIA Processes for Error Handling and Trace Logging 24-29

24.7.3.3 FaultingService Element

24.8 Extending Fault Messages

This section includes the following topics: ■ Section 24.8.1, Introduction to Extending Fault Messages ■ Section 24.8.2, Extending a Fault Message

24.8.1 Introduction to Extending Fault Messages

When an error occurs within an integration flow, within a Mediator service or BPEL process, the Error Handling framework captures the error within a fault message. The fault message is made available in the error details within the Oracle BPM Worklist. For information about using the Oracle BPM Worklist with Oracle AIA error handling, see Using the Oracle BPM Worklist in Oracle Fusion Middleware Infrastructure Components and Utilities Users Guide for Oracle Application Integration Architecture Foundation Pack. Fault message content is defined by the FaultType message schema definition in Meta.xsd, which is located in \EnterpriseObjectLibrary\Infrastructure\V1\Meta.xsd. If your fault message requirements are not met by the default elements of the schema, you can use the ApplicationFaultMessage element included in the schema to extend the scope of the fault details captured in the message. For more information about the fault message schema, see Section 24.7, Describing the Oracle AIA Fault Message Schema. SenderResourceID Provides identification of the resource or system associated with the SenderResourceTypeCode. Identification of the resource or system associated with the SenderResourceTypeCode. SenderMessageID Provides message identification in the context of the resource or system associated with the SenderResourceTypeCode. Message identification in the context of the resource or system associated with the SenderResourceTypeCode. Table 24–7 FaultingService Element Name Purpose Details ID Provides the date and time at which the service faulted. This is the name of the faulting service. ImplementationCode Provides the possible corrective action for the fault. This is a string describing the type of service that faulted. Possible values are BPEL, JAVA, and OTHER. InstanceID Provides the details of the actual fault message. This is the instance ID of the faulted service. If the service is a BPEL process, this is the BPEL instance ID. ExecutionContextID Provides the value for the ECID. This is an ID generated for a group of service invocationsexecutions. Table 24–6 Cont. IntermediateMessageHop Elements Name Purpose Details 24-30 Developers Guide for Oracle Application Integration Architecture Foundation Pack Extending fault details can add functionally rich information to the fault message to help the integration flow consumer better understand the context of the fault, leading to more effective error resolution. These additional fault details can be used to enable extended error handling functionality as well. For more information about extending error handling, see Section 24.9, Extending Error Handling. For example, you can enrich the fault message with Order Number and Fulfillment System values, which are required to perform extended error handling tasks that update Order tables and create new service requests in an Order Fallout Management application.

24.8.2 Extending a Fault Message