Evaluate Xpath Expression Action

Declaration

<AMXMLEVALUATEXPATHEXPR XPATH="text" RESULTVARIABLE="varname"/>

See Also

Edit XML Node Action,

 

Description

Evaluates an XPath expression using XPath functions.

Note: The Evaluate action takes an XPath expression, evaluates it, and returns a typed result of Boolean (Boolean), Number (Double), String (String), or Node Set (XPathNodeIterator).

Practical Usage

See Description.

Parameters

General Tab

XPath Expression

Text, Required
MARKUP: XPATH="sum(//price/text())"

Specifies the Xpath Expression from the current XML document to use to evaluate a value.

Populate Variable with value

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

Specifies the variable to receive the evaluated Xpath expression's 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.

<AMXMLEVALUATEXPATHEXPR XPATH="sum(//price/text())" RESULTVARIABLE="TotalPrice" />