Read XML Node Action

 

Declaration

<AMXMLREADNODE XPATH="text" ATTRNAME="text" RESULTVARIABLE="text" />

See Also

Edit XML Node Action, Create XML Node Action, Delete XML Node Action

Description

Retrieves the node value (or attribute value, if specified) located at the location expressed by the XPath and places it into an AutoMate variable.

Practical Usage

See description.

Parameters

General Tab

Xpath expression

Text, Required
MARKUP: XPATH="/BookStore/Books/Price"

Specifies the Xpath expression to the XML node in order to read it.

Attribute (optional)

Text, Optional
MARKUP: ATTRNAME="AttributeName"

Specifies the XML node's attribute name.

Populate variable with value

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

Specifies the variable to receive the node or attribute value.

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.

<AMXMLREADNODE XPATH="/BookStore/Books/Cost" RESULTVARIABLE="NodeValue" />