IDoc Listener

The IDoc Listener activity can process different IDoc messages using the same program ID.

The IDocs are persisted to the TIBCO transport, for example, EMS, and confirmed in the SAP system.

Only IDocs of SAP port type 4x are supported using the tRFC and qRFC protocols.

Note: In a project, the IDoc Listener activities cannot use the same SAP connection or the SAP connections with the same combination of the gateway host, the gateway service, and the program ID.

If you want to control the number of messages being processed concurrently in the activity, choose one of the following configurations:

Configure the Max Connections field of the referenced server connection according to the number of all the IDoc Listener and RFC BAPI Listener activities and whether the TID management mode is Active.
Configure the RFC Destination accordingly by using the SAP transaction code SMQS.

Note: The IDoc Listener activity does not support the job tuning property, FlowLimit.

See Job Tuning for details.

General

In the General tab, you can establish connections to the SAP system and the messaging source separately, and choose an SAP TIDManager shared resource to manage the check of the duplicate IDoc messages.

The following table lists the fields in the General tab:

Field	Module Property?	Description
Name	No	The name to be displayed as the label for the activity in the process.
SAP Connection	Yes	Click to select an SAP Connection shared resource. The SAP Connection shared resource establishes connections between the plug-in and the SAP system at run time. Ensure that you have created an SAP Connection shared resource accordingly first. See Creating and Configuring an SAP Connection for details. Note: You cannot create a new connection by clicking Create Shared Resource because the server connection that you created cannot be enabled this way. When the server connection of an SAP Connection shared resource is not enabled, you still can select this shared resource by selecting the corresponding process property. Therefore, if you want to select the SAP Connection shared resource by selecting corresponding process property, ensure that the server connection of the shared resource has been enabled.
SAP TID Manager	Yes	Click to select an SAP TIDManager shared resource. The SAP TIDManager shared resource can manage the check of duplicate IDoc messages for the activity. If no matching SAP TIDManager shared resources are found, click Create Shared Resource to create one. For more details, see Creating and Configuring an SAP TIDManager Shared Resource.
Messaging Source	No	The messaging source where the received IDocs are persisted. Only the JMS type is supported.
JMS Connection	Yes	Click to select a JMS Connection shared resource. The JMS Connection shared resource establishes a connection between the plug-in and the EMS server where the activity persists the IDocs received from the SAP system. If no matching JMS Connection shared resources are found, click Create Shared Resource to create one. For more details, see the TIBCO ActiveMatrix BusinessWorks documentation.

Description

In the Description tab, you can enter a short description for the IDoc Listener activity.

Advanced

In the Advanced tab, you can specify the destination used to persist the IDoc received from the SAP system.

The following table lists the fields in the Advanced tab:

Field	Module Property?	Description
Sequence Key	No	This field contains an XPath expression that specifies the order in which the process runs. Process instances with sequencing keys that have the same value are executed sequentially in the order in which the process instances were created.
Custom Job Id	No	This field contains an XPath expression that specifies a custom job ID for the process instance. This ID is displayed in the TIBCO Administrator View Service dialog, and it is also available in the $_processContext process variable. The custom job ID for the process instance.
IDoc Destination	Yes	The destination used to persist the IDocs received from the SAP system.

Output

In the Output tab, you can find the information of the received IDocs.

The following table lists the output elements in the Output tab:

Output Element	Data Type	Description
IDocNumber	String	The number of the received IDoc.
TID	String	The TID of the transaction used to publish the IDoc from the SAP system.
MessageID	String	The message ID of the received IDoc.