SAP Application Interface Framework provides you with monitoring and error handling functionality. The Error and Conflict Handler (ECH) is a forward error handling mechanism provided by SAP NetWeaver. The SAP Application Interface Framework supports ECH as an optional and alternative error handing functionality.
ECH messages can be monitored in the SAP Application Interface Framework and error messages generated by the SAP Application Interface Framework can be sent to ECH for processing.
You can define an interface assigned to an ECH component and business process in Customizing for SAP Application Interface Framework
(transaction code /AIF/CUST) under .
To use the ECH integration, you must have SAP NetWeaver 7.31 and you must have installed the component AIFX.
ECH supports forward resolution of asynchronous messages. It is integrated by default into standard Enterprise Services and enables clients to register errors and creates post processing orders accordingly via the post processing office (PPO).
In the SAP Application Interface Framework, interface developers can use the SIW configuration and template delivered with the SAP Application Interface Framework to create an interface supporting ECH (see SIW Integration).
If the SAP NetWeaver PI message is processed by ECH, SAP Application Interface Framework's Monitoring and Error Handling
can monitor and handle (for example, edit, save, restart, and cancel) PPO persistence in addition to the standard ECH monitoring transaction. The locking, version handing, and status controlling reuse ECH standard functions, so that they are consistent and synchronized between Monitoring and Error Handling
in the SAP Application Interface Framework and ECH monitoring. This integration scenario is independent of the SAP Application Interface Framework runtime as Monitoring and Error Handling
works on the PPO persistence layer utilized by ECH.
The interface determination function of the SAP Application Interface Framework is used (see Interface Determination).
An ECH-specific engine supports SAP Application Interface Framework Monitoring and Error Handling
functions, for example, the following:
You can select a PPO in Monitoring and Error Handling
and easily navigate to the ECH monitoring tool
You can navigate between the application log and data content (dual directions)
You can mass edit and save
You can mass restart and cancel
In order to be able to handle ECH messages in Monitoring and Error Handling
, you have to maintain the following engines in Customizing for SAP Application Interface Framework
under :
Application engine: ECH
Handles asynchronous data messages received via a proxy from SAP NetWeaver PI but processed by the Error and Conflict Handler application. Each message has a corresponding postprocessing order.
Persistence engine: ECH
Handles the data content of messages processed by the Error and Conflict Handler application. Includes load data and save data as new version.
Selection engine: ECH
Handles message processed by the Error and Conflict Handler application instead of the SAP Application Interface Framework. Data is selected from postprocessing order related tables.
Logging engine: ECH
Handles messages for a postprocessing order raised during Error and Conflict Handler application processing.
Note
Not all the functions, for example, data transformation and statistics, are supported.
A proxy developer can choose to use the ECH monitoring tool to monitor messages and handle errors and can choose to use the SAP Application Interface Framework to process the message as follows:
ECH collects errors generated by the SAP Application Interface Framework in runtime
ECH restarts or cancels any messages processed by the SAP Application Interface Framework runtime
SAP Application Interface Framework Monitoring and Error Handling
can load an original SAP NetWeaver PI message and the relevant application logs
An SAP Application Interface Framework-specific ECH action class is delivered to enable ECH runs with the SAP Application Interface Framework runtime. A proxy developer can use the SIW to switch on ECH support and can generate a proxy class implementation that calls the SAP Application Interface Framework-specific action class. This action class provides the following functions:
Message processing is delegated to the SAP Application Interface Framework
Restart/Retry is delegated to the SAP Application Interface Framework
Cancel is handled by the SAP Application Interface Framework action class
In this integration scenario, SAP Application Interface Framework Monitoring and Error Handling
works on top of SAP NetWeaver PI message persistence. However, the SAP NetWeaver PI message is processed by ECH and the status recorded in the SAP NetWeaver PI message persistence no longer allows you to change the SAP NetWeaver PI message data. You cannot handle (for example, edit, save, restart, cancel) errors in Monitoring and Error Handling
and you have to use the ECH monitoring tool (transaction code ECH_MONI_SEL).
In order to monitor such an SAP Application Interface Framework interface, in Customizing for SAP Application Interface Framework
under , select the following engines:
Application Engine: Proxy
Persistence Engine: Proxy
Selection Engine: AIF Index Tables
Logging Engine: AIF Application Log
For more information about ECH, see the SAP Library for
.