Create line-based Module Attributes for IDOC messages

The Tricentis Tosca API Engine enables you to create line-based Module Attributes. You can use this function to work with Intermediate Document (IDOC) text messages to enable data transfer with SAP.

IDOC messages contain lines of a fixed length and line breaks. The first line of the message is the control record that provides general information about the IDOC, i.e. how it should be processed. The rest of the message contains segments in which the first column is the control record and the rest are data records.

To steer the values of these IDOC message elements, you can create line-based Module Attributes. To do so, follow the steps below:

  1. Select a Module and access the API Testing menu.

  2. Highlight the element you want to steer with your mouse.

    You can mark multiple lines in your message. The system identifies all relevant elements and creates Module Attributes for them.

  3. Click Add in the API Testing menu.

The created Module Attributes are organized in a hierarchical structure based on the line numbers that indicate the IDOC's control record and data records.

Line-based Module Attributes

The created Module Attributes have the same names as the elements you marked. The elements of an IDOC message have predefined specific names that identify them, e.g. the element TABNAM contains information on the name of the table.

Line-based Module Attribute TABNAM

The parameter Path in the Properties pane contains the character information of the Module Attribute, separated by semicolon.

  • The first number indicates the line that contains the element.

  • The second number indicates the first character of the Module Attribute.

  • The third number indicates the total number of characters of the Module Attribute, including empty spaces.