Concatenates defined sources.

Concat steps are used to concatenate string elements into one new resulting XML element inserted in the output.
The Concat step uses an array of input strings (set using the Sources property) to be concatenated. An optional Separator parameter can also be added. If used, the separator is inserted in the resulting string between each concatenated element.
The resulting string is added to the sequence XML output and can be used as a new source for other steps.
Note: In Convertigo Studio, when a Concat step is created in a sequence, it can be easily replaced by an Element step, using the right-click menu on the step and choosing the option Change to > Element.

• The Node name property remains the same.
• The first source filled in the Concat step is moved to the Source property of the Element step.
• Default value properties defined in Concat step lines are concatenated and moved to the Default value property of the Element step.

Property Type Category Description
Comment String standard Describes the object comment to include in the documentation report.
This property generally contains an explanation about the object.
Is active boolean standard Defines whether the step is active.
Node name String standard Defines the tag name of the generated XML element.
This property can contain any name, no words are reserved, and must follow the rules on XML naming:

• it can contain letters, numbers, and other characters,
• it cannot start with a number,
• it cannot contain spaces nor punctuation character.
Assigned XSD Simple type QName XmlQName expert Defines the schema base type to assign as a type to this simple XML element.
This property allows to assign a simple XSD type to the simple XML element generated by this step. It can only be used when the step actually generates a simple XML element.
Output boolean expert Defines whether the XML generated by this step should be appended to the resulting XML.
Set this property to true to add the step’s resulting XML to the sequence’s output XML (default value for steps generating XML). Set this property to false to prevent the steps’s XML result to appear in the sequence’s output XML.
Setting this property to false does not prevent the step’s generated XML from being used as a source by other steps.
Separator String expert Defines the text to be used as a separator string.
If set, this text is added between each text to concatenate. Default value is a white space, think about removing it if you do not want to use it.
Sources XMLVector expert Defines a list of source items to use as values.
This property allows defining a list of source items that are used to create the result value. Each source item contains three columns to be set:

• Description: Defines a comment or description about this source item.
• Source: Defines the source. A source is a reference on a step previously existing in the parent sequence, associated with an XPath applied on the step’s result DOM. At runtime, the XPath is applied on the step’s current execution result XML and extracts a list of XML nodes resulting from this execution.
• Default value: Defines the default value for this source. If the source’s XPath doesn’t match in the referenced step or if the source is left blank, the default value is used. Otherwise, the source item creates no data.

Each source item may define a source and a default value.
Note: A new source item can be added to the list using the blue keyboard icon. The source items defined in the list can be ordered using the arrow up and arrow down buttons, or deleted using the red cross icon.