Creation and Updating of a Network 

Use

SAP Event Management (SAP EM) creates a network in the document flow and updates this network so that you can display the hierarchical structure for an event handler in the Web interface.    

Prerequisites

You have executed Customizing for the connection to the document flow.

For more information about Customizing, see Connection to the Document Flow under Prerequisites.

Features

You can define whether you update an event handler or an event message and the relevant network at the same time.

For more information, see the Implementation Guide (IMG) for SAP Supply Chain Management under Event Management ® Interface to Document Flow  ® Integration with Document Flow.

Lock Concept

It can be the case that multiple event handler types exist in a network and that multiple event messages want to update the same event handler. For this reason, a lock concept is in use in SAP EM. Here the document flow locks the object in the network that is currently being updated by an event message or event handler from SAP EM. When SAP EM updates a document flow, it uses the lock object /SAPTRX/E_DF and thereby locks the relevant documents and predecessor documents. When SAP EM removes the lock on the relevant event handlers or event messages, it also removes the lock for the document flow at the same time. If SAP EM does not update the document flow network after multiple attempts, SAP EM writes an entry to the application log.

For more information about the SAP lock concept, see the SAP Library under SAP NetWeaver ® SAP NetWeaver by Key Capability ® Application Platform by Key Capability ® ABAP Technology ® Client/Server Technology ® The SAP Lock Concept (BC-CST-EQ).

Activities

...

SAP EM has created a new event handler or updated an existing one. The document flow has created a new network or updated an existing one. For this, SAP EM executes the following:

●     If you have executed Customizing for updating the document flow by means of creating or changing an event handler, SAP EM proceeds as follows:

                            a.      On the basis of the event handler type, SAP EM calls the activity for updating an event handler.

SAP EM finds the parameter for the group in the activity for updating an event handler, and updates the network accordingly. If you have defined a condition for updating the network, SAP EM evaluates this condition and updates the network in accordance with the condition.

                            b.      SAP EM reads Customizing for the document flow and searches in SAP EM for the source information that the system sends to the document flow to create or update the relevant network.

                            c.      SAP EM reads the attributes that the document flow saves together with the source information in the network.

                            d.      SAP EM searches for the predecessor document and reads the target data for creating or updating the network.

                            e.      SAP EM sends all the necessary data to the document flow.

If an error occurs in the document flow, SAP EM writes an entry to the application log.

●     If you have configured Customizing for updating the document flow via an event message, SAP EM proceeds as follows:

...

                            a.      SAP EM processes this event message.

For this, SAP EM applies the rule set and calls your rule activity for the document flow.

SAP EM finds an activity with the parameter for the group for simultaneously updating the network. (This can occur on the basis of a rule set condition, for example.)

                            b.      SAP EM reads Customizing for the document flow and searches in SAP EM for the source information that the system sends to the document flow to create or update the relevant network.

                            c.      SAP EM reads the attributes that the document flow saves together with the source information in the network.

                            d.      SAP EM searches for the predecessor document and reads the target data for creating or updating the network.

                            e.      SAP EM sends all the necessary data to the document flow.

If an error occurs in the document flow, SAP EM writes an entry to the application log.