Skip to content

XPath Expression Evaluator#

The XPath Expression Evaluator task evaluates XPath expressions against XML or HTML data structures. It enables navigation, querying, and extraction of elements, attributes, or values from structured XML/HTML documents. This makes it useful for data extraction, transformation, and validation tasks involving hierarchical data.

mainImage

Note

This task results from a split of the Expression Evaluator task. It can be used along with Generic Expression Evaluator and Regular Expression Evaluator.

Workflows#

Data Flow Control Flow

Inputs#

Name Data Type Description
<custom list> <custom> Defines the input values used in the evaluation
Activate any Triggers task execution

Outputs#

Name Data Type Description
<custom list> <custom> Defines the output values generated by the evaluation
Success Boolean Returns true if the task completes successfully
Error Error Contains information about any error that occurs

Settings#

The General tab includes standard task settings and the following parameters:

Name Data Type Values Default Value Description
Evaluator Behavior enum EvaluateAll
EvaluateUntilTrue		 EvaluateAll Defines whether all expressions are evaluated or evaluation stops after the first true result
Clear Inputs Boolean false When enabled, clears input values after task execution

settings

The Inputs Tab includes the following settings:

Name Data Type Description
Name String Input Name
Friendly Name String The displayed input name
Type Long
Decimal
DateTime
Boolean
String
Integer		 Defines the data type of the input
Default Value any Default value assigned to the input parameter
Required any Indicates if input is required

inputs

The Outputs Tab includes the following settings:

Name Data Type Description
Name String Output Name
Friendly Name String The displayed output name
Type Long
Decimal
DateTime
Boolean
String
Integer		 Defines the data type of the output
Expression any XPath expression applied to the input data

outputs

Evaluator Behavior#

The XPath Expression Evaluator locates elements or values in an XML or HTML document using the defined XPath expression. It returns a single value or an array of values that match the specified path.

  • EvaluateUntilTrue: Stops processing when an expression returns a true value and outputs the corresponding result.
  • EvaluateAll: Evaluates all configured expressions and outputs all results.
  • Clear Inputs: When enabled, resets the inputs after task execution.