Event Handler Updating 

Purpose

By updating event handler data, the system can check how event messages are processed for an event handler. To do this, the system needs the expected events that belong to an event handler and the rule set in accordance with the Customizing settings made in SAP Event Management.

You use current event handler data to track and evaluate objects or processes that you have determined to be relevant to supply chain event management.

Prerequisites

●      You have specified the following in the application system:

○       The application object types

○       The condition for determining the application object type

○       The function for determining expected events

○       The control, system, and info parameters (see Parameters)

To do so, in Customizing, choose Integration with SAP Components ® Interface to Event Management.

●      You have defined the following in SAP Event Management:

○       The event handler types

To do so, in Customizing for SAP Event Management, choose Event Handlers and Event Handler Data ® Event Handlers ® Define Event Handler Types.

○       The condition for determining the event handler type

To do so, in Customizing for SAP Event Management, choose Event Handlers and Event Handler Data ® Event Handlers ® Define Conditions for Event Handler Types and Event Handler Sets.

○       The expected event profile

To do so, in Customizing for SAP Event Management, choose Event Handlers and Event Handler Data ® Expected Events ® Define Profiles for Expected Events.

○       The parameter profile

To do so, in Customizing for SAP Event Management, choose Event Handlers and Event Handler Data ® Parameters ® Define Parameter Mapping.

○       The status attribute profile

To do so, in Customizing for SAP Event Management, choose Event Handlers and Event Handler Data ® Status ® Define Status Attribute Profiles.

○       The rule set

To do so, in Customizing for SAP Event Management, choose Reactions to Event Messages ® Define Rule Sets.

●      You have set up Customizing for the application interface and have installed the corresponding visibility process in the application system or have defined your own process. The visibility process allows you to connect to your business objects in the application system.

For more information, see SAP Service Marketplace at http://service.sap.com/scm ® Supply Chain Event Management ® Visibility Processes ® Generic Configuration Guide.

●      You have configured the RFC connections between the application system and SAP Event Management.

To do this, execute the following:

○       In Customizing for the application system, choose Integration with SAP Components ® Interface to Event Management ® Define System Configuration ® Define RFC Connection to SAP EM.

○       In Customizing for SAP Event Management, choose General Settings in SAP Event Management ® Define RFC Connection to Application System.

●      If you want to log changes to data relevant to event handlers, you have defined the relevant indicator with the corresponding level of detail. For more information, see Customizing for SAP Event Management under Event Handlers and Event Handler Data ® Event Handlers ® Define Event Handler Types.

Process

The steps for updating an event handler are shared between the application system and SAP Event Management, as for creating event handlers.

...

       1.      You save your document in the application system.

       2.      The application system executes the following:

...

                            a.      It extracts the data container for the business object so that SAP Event Management can use the application object ID to check if an event handler with the corresponding event handler type can be found.

                            b.      It determines which SAP Event Management system is responsible for the application object type. (An application system can work with several SAP Event Management systems simultaneously.)

                            c.      It specifies the business process type (BPT) of the business object.

                            d.      It retrieves the application object types for the BPT from the application system and determines whether they are relevant to supply chain event management.

                            e.      It creates control parameters for all application objects that are SCEM-relevant.

       3.      The application system checks if the event handler has the correct status for the application object, that is, it has not been set to inactive (for example, for testing purposes).

       4.      SAP Event Management executes the following:

...

                            a.      It standardizes the control parameters that have been sent from the application system into a view that it can process.

                            b.      It checks if suitable event handlers already exist.

If it does not find any suitable event handlers, it continues to execute the checks for generating an event handler.

If it finds a suitable event handler, it uses this and updates the event handler.

                            c.      It sends the result of the check to the application system.

       5.      The application system continues to process the confirmed application objects.

       6.      The application system then executes the following:

...

                            a.      It collects all the data from the parameter containers. This includes:

■       Expected events

■       Control parameters

■       Info parameters

■       Tracking IDs

■       Query IDs

■       Business object keys

■       Event data

■       Application object IDs

■       Queue names

You can define in the application system that SAP Event Management is to delete the control parameters, info parameters, query IDs, or tracking IDs that belong to a relevant application object.

                            b.      It sends the marker for sending the collected data to SAP Event Management.

When the application system continues with the saving process, it sends the data; see also step 6e.

                            c.      It marks open communication processes for a status update in the status table.

When the application system continues with the saving process, it performs the status update; see also step 6e.

                            d.      It flags the application log for an update.

When the application system continues with the saving process, it updates the application log; see also step 6e.

                            e.      It returns to saving the business object. All actions that have been marked for execution are completed in the application system.

       7.      At the same time, SAP Event Management determines the event handler type and updates the event handler with the relevant expected events and status attributes. SAP Event Management also standardizes the data from the parameter containers in the application system into a view that it can process. Then it calls the activities for updating the process and sends the confirmation of the completed transactions to the application system.

If necessary, SAP Event Management deletes any control parameters, info parameters, query IDs, or tracking IDs that belong to a relevant application object.

If you have activated logging with change documents and use activities in the rule set that change data relevant to change documents, SAP Event Management updates the corresponding change documents.