XML File - Split

Splits an XML file.

Remarks

The Split command divides an XML file into multiple child documents based on an XPath selector.

How to Use

1. Set the Item Selector to an XPath expression that matches the nodes you want to split into separate files.
2. (Optional) Set the Sibling Selector to include additional sibling nodes with each split item.
3. (Optional) Provide Namespace Mappings if your XML uses namespaces and your XPath needs to reference them.

For each node matched by the Item Selector, a new child document will be created containing that node (and optionally its siblings and ancestors).

Tips

• Use the Item Selector to target the main repeating element (e.g. //Invoice to split on each invoice).
• Use the Sibling Selector to include related nodes (e.g. comments or headers) with each split.
• Define namespace mappings if your XML uses prefixes (e.g. ns=http://example.com/schema).

Example

• Item Selector: //ns:record
• Sibling Selector: preceding-sibling::ns:comment
• Namespace Mappings: ns=http://www.example.com/schema

This configuration will create a new XML file for each <record> element, including any preceding <comment> siblings, using the specified namespace.

Properties

Name	Type		Description
Item Selector	String	►	An XPath selector which matches the sequence of items to be split.. EditorText Property Editor Requiredtrue
Sibling Selector	String	►	An optional XPath selector which selects siblings to be included. EditorText Property Editor
Namespace Mappings	String	►	The prefix to be used to represent the default namespace. EditorKVP Editor ConverterPg Text Lines Converter Prefix this value to all node names in the Container Selector and Item Selector. For example: //ns:chapter

See Also

XML File