XML Activities

Versión: 1.0.0  ·  ID: zoan-packages-xml  ·  Autor: Zoan Software

El paquete XML lee, consulta y modifica documentos XML, un formato de intercambio de datos muy usado en integraciones (facturación electrónica, servicios web SOAP, configuraciones, archivos del sector salud). Te permite extraer datos de un XML y modificarlo sin tener que parsear el texto a mano.

¿Qué es XML y XPath?

XML representa datos con etiquetas anidadas: <Factura><Numero>FAC-001</Numero></Factura>. XPath es el “lenguaje de consulta” para navegar ese árbol y apuntar a un elemento — por ejemplo, //Factura/Numero selecciona el número de la factura. No necesitas dominar XPath: con expresiones simples como //Etiqueta cubres la mayoría de los casos.

Cómo funciona este paquete

Las actividades trabajan sobre el texto XML (una cadena), no sobre un archivo abierto. El patrón típico es:

1. Read XML lee el archivo y devuelve su contenido como string.
2. Consultas valores con XML Query Text / XML Query All, o lo modificas con XML Set Value / XML Add Element (que devuelven el XML modificado).
3. Write XML guarda el resultado a un archivo.

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

XPath en una cucharada

XPath	Selecciona
//Numero	Todos los elementos <Numero> en cualquier nivel
//Factura/Numero	Los <Numero> hijos directos de <Factura>
//Factura[@id='5']	La <Factura> con atributo id="5"
//Item[2]	El segundo <Item>

Actividades

Actividad	Tipo	Salida	Qué hace
Read XML	xml-read	string	Lee un archivo XML como texto
Write XML	xml-write	string	Guarda un texto XML a un archivo
XML Query Text	xml-query-text	string	Primer valor que coincide con un XPath
XML Query All	xml-query-all	List	Todos los valores que coinciden
XML Set Value	xml-set-value	string	Cambia el valor de un elemento
XML Add Element	xml-add-element	string	Agrega un elemento hijo

Siguientes pasos

• Read XML — leer un archivo XML.
• XML Query Text — extraer un dato con XPath.
• JSON — para datos en formato JSON.