Merge XML Files Action

Declaration

<AMXMLMERGEFILES FILEB="text" XPATH1="text" XPATH2="text"/>

See Also

Output XML File Action

Description

Merges two XML files together into one XML file. XPaths can be provided to customize both insertion points into the host XML file as well as node offsets in the file being merged from.

If user provides the Xpath expression for File 2 then that XML fragment from File 2 is appended to File 1.

Practical Usage

See description.

Parameters

General Tab

File 2

Text, Required
MARKUP: FILEB="C:\Automate\Append.XML"

Specifies the file which will merge into the current XML document.

Xpath Expression for XML Document (Optional)

Text, Optional
MARKUP: XPATH1="/Root1"

Specifies the Xpath expression identifying the insertion point of host XML file.

Xpath Expression for File2 (Optional)

Text, Optional
MARKUP: XPATH2="/Root2"

Specifies the Xpath expression identifying the offset node for second file.

Session Name

Text, Optional - Default "XMLSession1"
MARKUP: SESSIONNAME="FirstXMLSession"

Specifies the session name to identify the in-memory XML document to use in subsequent XML steps. This allows several in-memory XML documents to be active simultaneously.

Notes

Custom Description

This action includes the Description tab for entering a custom step description.

More on setting custom step description

Standard Error Handling Options

This action also includes the standard Error Causes and On Error failure handling options/tabs.

More on Error Handling Options

Variables and Expressions

All text fields allow the use of expressions, which can be entered by surrounding the expression in percentage signs (example: %MYVARIABLE%, %Left('Text',2)%). To help construct these expressions, you can open Expression Builder from these fields by pressing F2.

More on variables
More on expressions

More on the expression builder

Example

NOTE: The code below can be copied and pasted directly into the Steps pane of the Task Builder.

<AMXMLMERGEFILES FILEB="C:\Automate\Append.xml" />