IDoc Parser

Use the IDoc Parser activity to retrieve IDocs processed by the IDoc Listener activity, and then parse the IDocs as the activity output.

Different IDoc type requires different IDoc Parser activity to perform the parse process.

General

In the General tab, you can establish connections to the SAP system and the messaging source separately, and download the schema of the IDoc to be parsed by the IDoc Parser activity.

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 an inbound connection between the plug-in and the SAP system. The inbound connection is only used to download the IDoc schema at design time.

If no matching SAP Connection shared resources are found, right-click the Resources folder, and then click New > SAP Connection to create a new connection. See Creating and Configuring an SAP Connection for details.

IDoc Name No Click Fetch IDoc to download the schema of the IDoc to be parsed.
In the Search IDoc dialog, complete the following tasks:
  1. Specify the IDoc filter to filter out the required IDoc types with the basic IDoc type name. The IDoc filter supports wildcard search.

  2. Select an IDoc type.
    • Basic Type: select Basic Type if you want to download the IDoc schema of the basic type. Only the basic IDoc types matching the IDoc filter can be filtered out.
    • Extended Type: select Extended Type if you want to download the IDoc schema of the extended type. The extended IDoc type name includes the name of the basic IDoc type that it is extended from. Therefore, the extended IDoc types can be filtered out by using the corresponding basic IDoc type name.
  3. Click Fetch IDocs.
  4. Select the IDoc type that you want to download and click OK.

    Ensure that the selected IDoc type and the associated segments have been released in the SAP system.

When the IDoc schema is downloaded, an XSD file is created. The XSD file cannot be visible in the project but it can be picked from the activity if required.

Note: When an IDoc schema is downloaded to the plug-in, if new segment definitions are added to the IDoc schema because of the upgrade of the SAP system, you have to refresh the IDoc schema in the plug-in.
Messaging Source No The messaging source where the activity retrieves the IDocs to be parsed.

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 retrieves the IDocs to be parsed.

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.

Max Session Yes The number of IDoc messages to be processed concurrently.

The default value is 1.

If you set the value of this field to negative or zero, the value of 1 is used automatically at run time.

See Job Tuning for details.

Description

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

Advanced

In the Advanced tab, you can specify the destination used to retrieve the IDocs to be parsed, and the message selector.

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.
Receive IDoc Destination Yes The destination used to retrieve the IDoc to be parsed.
Note: This destination must be the one that the IDoc Listener activity uses to persist IDocs.
Message Selector No The message selector used to select a specific IDoc message from the receive IDoc destination.

The default value is SAPIDOC_IDOCTYP = 'IDoc_Type' AND SAPIDOC_CIMTYP = 'Cim_Type' .

You can also use other JMS properties, for example, SAPIDOC_OUTMOD, SAPIDOC_STATUS, and SAPIDOC_CREDAT.

If a syntax error occurs, you can click Reset Syntax next to the Message Selector field to reset this field.

Output

The Output tab shows the parsed IDoc in the XML format.

Contents
Search Results