search

XPath Action

The XPath Action node extracts a value from an XML file using an XPath expression.

It reads the specified XML file, evaluates the provided XPath expression, and returns the extracted value as the node result. This makes it possible to pass XML-based metadata into a stream and use it in later steps (for example, writing it into job metadata or sending it to external systems).

This node is commonly used for stable metadata exchange with third-party systems such as TIXstream.

hashtag
Input Parameters

XML Path Full path to the XML file (including filename and extension) that should be read.

XPath Expression XPath expression used to locate and extract the desired value (e.g., /MetadataExchange/EpisodeTitle/text()).

XPath Action

hashtag
Output and Wildcards

The extracted value is returned as the node result and can be accessed via:

This allows the value to be reused throughout the stream, for example as input for metadata nodes or conditional logic.

hashtag
Behavior

  • Reads an XML file from disk

  • Evaluates the XPath expression

  • Returns the extracted value as a string

  • Supports asynchronous execution

The node fails if the file cannot be read or the XPath expression is invalid.

hashtag
Typical Use Cases

  • extracting metadata from XML sidecar files

  • mapping XML values into job metadata fields

  • driving workflow logic based on XML values

  • integration with external systems (e.g., TIXstream)

  • automated naming and routing decisions based on XML content

hashtag
Practical Tip

Use XPath expressions that explicitly return a text node (e.g., .../text()) to avoid receiving an XML element instead of a simple value.

Last updated