Show TOC

Function documentationError and Conflict Handler Integration

 

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.

Integration

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 Start of the navigation path Interface Development Next navigation step Additional Interface Properties Next navigation step Assign ECH Component End of the navigation path.

Prerequisites

To use the ECH integration, you must have SAP NetWeaver 7.31 and you must have installed the component AIFX.

Features

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).

SAP Application Interface Framework Monitoring and Error Handling supports ECH

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 Start of the navigation path Additional Interface Properties Next navigation step Specify Interface Engines End of the navigation path:

  • 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 Note

Not all the functions, for example, data transformation and statistics, are supported.

End of the note.
ECH Supports the SAP Application Interface Framework

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 Start of the navigation path Additional Interface Properties Next navigation step Specify Interface Engines End of the navigation path, select the following engines:

  • Application Engine: Proxy

  • Persistence Engine: Proxy

  • Selection Engine: AIF Index Tables

  • Logging Engine: AIF Application Log

More Information

For more information about ECH, see the SAP Library for Start of the navigation path SAP Business Suite Next navigation step SAP ERP Next navigation step Central Component Next navigation step Error and Conflict Handler (CA-FS-ECH) End of the navigation path .