Creation and Updating of a Network

Use

SAP Event Management 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 (Classic) .

Prerequisites

You have carried out the Customizing for the connection to the document flow. For more information about Customizing, see Connection to the Document Flow under Prerequisites .
You have set up an asynchronous communication with the application system. For more information, see Customizing for SAP Event Management under General Settings in SAP Event Management Define Application System .

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 Event Management under Start of the navigation path Interface to Document Flow Next navigation step Integration with Document Flow. End of the navigation path

Locking Concept

It may happen 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 locking concept is in use in SAP Event Management. Here the document flow locks the object in the network that is currently being updated by an event message or event handler from SAP Event Management. When SAP Event Management updates a document flow, it uses the lock object /SAPTRX/E_DF and thereby locks the associated documents and predecessor documents. When SAP Event Management removes the lock on the associated event handlers or event messages, it simultaneously removes the lock for the document flow. If SAP Event Management does not update the document flow network after multiple attempts, it writes an entry to the application log.

Note Note

For more information about the SAP locking concept, see the SAP NetWeaver documentation in the SAP help portal under Start of the navigation path SAP NetWeaver by Key Capability Next navigation step Application Platform by Key Capability ABAP Technology Client/Server Technology The SAP Locking Concept (BC-CST-EQ) End of the navigation path .

End of the note.

Activities

SAP Event Managementhas created a new event handler or updated an existing one. The document flow has created a new network or updated an existing one. SAP Event Management does the following:

If you have carried out the Customizing for updating the document flow by creating or changing an event handler, SAP Event Management proceeds as follows:
1. On the basis of the event handler type, SAP Event Management invokes the activity for updating an event handler.
  
  SAP Event Management 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 Event Management evaluates this condition and updates the network only in accordance with the condition.
2. SAP Event Management reads the Customizing for the document flow and searches in for the source information in SAP Event Management that the system sends to the document flow to create or update the associated network.
3. SAP Event Management reads the attributes that the document flow saves together with the source information in the network.
4. SAP Event Management searches for the predecessor document and reads the target data for creating or updating the network.
5. SAP Event Management sends all the necessary data to the document flow.
  
  If an error occurs in the document flow, SAP Event Management writes an entry to the application log.
If you have set up the Customizing for updating the document flow via an event message, SAP Event Management proceeds as follows:
1. SAP Event Management processes this event message.
  
  For this, SAP Event Management applies the rule set and calls your rule activity for the document flow.
  
  SAP Event Management finds an activity with the parameter for the group for simultaneously updating the network. You can use a rule set condition for this.
2. SAP Event Management reads the Customizing for the document flow and searches in for the source information in SAP Event Management that the system sends to the document flow to create or update the associated network.
3. SAP Event Management reads the attributes that the document flow saves together with the source information in the network.
4. SAP Event Management searches for the predecessor document and reads the target data for creating or updating the network.
5. SAP Event Management sends all the necessary data to the document flow.
  
  If an error occurs in the document flow, SAP Event Management writes an entry to the application log.