Skip to main content Skip to complementary content

Grouping the output data

The tXMLMap component uses a group element to group the output data according to a given grouping condition. This allows you to wrap elements matching the same condition with this group element.

To set a group element, two restrictions must be respected:

  1. the root node cannot be set as group element;

  2. the group element must be the parent of the loop element.

Information noteNote:

The option of setting group element is not visible until you have set the loop element; this option is also invisible if an element is not allowed to be set as group element.

Once the group element is set, all of its sub-elements except the loop one are used as conditions to group the output data.

You have to carefully design the XML tree view for the optimized usage of a given group element. For further information about how to use a group element, see tXMLMap.

Information noteNote: tXMLMap provides group element and aggregate element to classify data in the XML tree structure. When handling a row of XML data flow, the behavioral difference between them is:
  • The group element processes the data always within one single flow.

  • The aggregate element splits this flow into separate and complete XML flows.

Setting a group element

About this task

To set a group element, proceed as follows:

Procedure

  1. In the XML tree view on the output side of the Map editor, right-click the element you need to set as group element.
  2. From the opened contextual menu, select As group element.
    Then this element of selection becomes the group element. The following figure presents an example of an XML tree with the group element.
    Example of an XML tree with the group element.

Revoking a defined group element

About this task

To revoke a defined group element, proceed as follows:

Procedure

  1. In the XML tree view on the output side of the Map editor, right-click the element you have defined as group element.
  2. From the opened contextual menu, select Remove group element.
    Then the defined group element is revoked.

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – please let us know!