XML Activities

Version: 1.0.0  ·  ID: zoan-packages-xml  ·  Author: Zoan Software

The XML package reads, queries and modifies XML documents, a data exchange format widely used in integrations (electronic billing, SOAP web services, configurations, healthcare files). It allows you to extract data from an XML and modify it without having to parse the text by hand.

What is XML and XPath?

XML represents data with nested tags: <Factura><Numero>FAC-001</Numero></Factura>. XPath is the “query language” to navigate that tree and point to an item — for example, //Factura/Numero selects the invoice number. You don’t need to master XPath: simple expressions like //Etiqueta cover most cases.

How this package works

Activities work on XML text (a string), not on an open file. The typical pattern is:

1. Read XML reads the file and returns its contents as string.
2. You query values with XML Query Text / XML Query All, or modify them with XML Set Value / XML Add Element (which return the modified XML).
3. Write XML saves the result to a file.

Read XML   path = = ruta   → output: xml
XML Query Text   xml = = xml   xpath = "//Factura/Total"   → output: total

XPath in a scoop

XPath	Select
//Numero	All <Numero> items at any level
//Factura/Numero	The <Numero> direct children of <Factura>
//Factura[@id='5']	The <Factura> with attribute id="5"
//Item[2]	The second <Item>

Activities

Activity	Type	Output	What it does
Read XML	xml-read	string	Read an XML file as text
Write XML	xml-write	string	Save XML text to a file
XML Query Text	xml-query-text	string	First value that matches an XPath
XML Query All	xml-query-all	List	All values that match
XML Set Value	xml-set-value	string	Change the value of an element
XML Add Element	xml-add-element	string	Add a child element

Next steps

• Read XML — read an XML file.
• XML Query Text — extract data with XPath.
• JSON — for data in JSON format.