Output XML Action

 

Declaration

<AMXMLOUTPUT OUTPUTTYPE="text [options]" XMLFILETYPE="text [options]" XMLDESTINATION="text" OVERWRITEFILE="text [options]" />

See Also

Merge XML Files Action, Sign XML File Action

Description

Outputs the in-memory representation of the XML session, for example, to a file or variable before ending the XML session. Using this action does not change the XML or end the session, thus allowing subsequent XML steps to continue using the session.

Practical Usage

See description.        

Parameters

General Tab

Output to

Text [Options], optional default "File"
MARKUP: OUTPUTTYPE="Variable"

Specifies where to store the XML document after you have modified it using different XML actions. The available options are:

File--Use this option if you want to store it in new file or an original file.

Variable--Use this option if you want to store XML data into an Automate variable.

Save XML Document To

Text [Options], optional default "New"
MARKUP: XMLFILETYPE="Original"

Specifies the file you want to save the XML document into--either new or original.

NOTE: This option only appears if you select the File option under the Output To dropdown.

New File - Stores the current XML document into new file

Original File - During Start XML Session if new file is created or existing file is used than this option will use that file to store the modified XML document.

Decode XML

Text, Optional
MARKUP: DECODE="text"

Decodes the XML value in HTML format.

Output File:

Text, Required
MARKUP: FILE="c:\foldername\file.XML"

Specifies the path and file name of the new XML file.

Note: This option only appears if you select the File option under the Output To dropdown.

Overwrite if File Exists

Yes/No, Optional - Default "NO"
MARKUP: OVERWRITEFILE="YES"

If set to Yes, specifies that if the file already exists, it will be overwritten with the new document. If set to No, the step fails if the file already exists.

Note: This option only appears if you select the File option under the Output To dropdown.

Populate Variable with value

Text [variable name], Required
MARKUP: RESULTVARIABLE="varname"

Specifies the variable to store the in memory XML document.

Note: This option only appears if you select the Variable option under the Output To dropdown.

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.

<AMXMLOUTPUT OUTPUTTYPE="File" XMLFILETYPE="Original" />
Note : Outputing the changes into samefile

<AMXMLOUTPUT OUTPUTTYPE="Variable" RESULTVARIABLE="OutputXML" />
NOte : Putting the XML document data into Automate Variable.