Active IDoc Monitoring

You monitor IDocs for specific errors by creating a set of registry entries; if an IDoc reports a specified error, the corresponding event will be raised. The raiser comment of the event contains specific IDoc information such as the DocId and MessageId.

You specify the registry entries for IDoc Monitoring as follows:

Copy
/configuration/sap/<sap_system>/idoc/monitoring/MessageType/<message_type>/Event/<event>

Where

  • <sap_system> is the name of your SAP system, such as PR1 for example
  • <message_type> is the message type, or message ID, of the IDoc, such as MATMAS for example
  • <event> is the name of your Redwood Server event to raise

You specify the IDoc statuses in the Value field of the <event> registry entry; multiple values are specified comma-separated. The Event registry entry can have more than one <event> child key.

The raiser comment contains the following information:

Copy
IDoc: <DocId>/<MessageType>/<status>/<direction>/<receiver_type>/<receiver_port>/<sender_type>/<sender_port>

SAP Tables

  • TEDS1 - IDoc status table
  • EDMSG - Message type table

Example

You specified the following registry entry:

Copy
/configuration/sap/PR1/idoc/monitoring/MessageType/MATAMS/Event/IdocEvent = 45, 46, 56, 58

The IDoc 207019 reached status 56, which matches the value of the registry entry. The event IdocEvent is raised with the following raiser comment:

Copy
IDoc: 207019/MATMAS/56/I/LS/TSTCLNT200/LS/JCOCLNT200

Prerequisites

  • ProcessServerService.SAP.iDoc license key set to true
  • IDoc transport files

Procedure

Downloading the IDoc Transport Files

  1. Navigate to Configure > Admin > Configuration > Software Groups.
  2. Locate the IDoc Transport files, choose Download from the context menu.