Write XML

Write XML

Tipo: xml-write  ·  Paquete: XML Activities v1.1.1  ·  Salida: string

Guarda un texto XML en un archivo. Es el último paso tras modificar un XML con XML Set Value o XML Add Element. Devuelve la ruta escrita.

Cómo funciona

Escribe content en el archivo de path. Por defecto formatea el XML con sangría (indent = true) para que sea legible; con indent = false lo guarda en una sola línea, sin espacios entre etiquetas.

• Antes de escribir comprueba que content sea un XML bien formado y seguro (sin DTD, dentro de los límites del paquete). Ver Seguridad y límites. Si no lo es, no toca el archivo.
• Escribe la declaración <?xml version="1.0" encoding="…"?> con la codificación de encoding, aunque content no la traiga. Con "utf-8" el archivo se guarda con BOM.
• Crea las carpetas que falten en la ruta y sobrescribe el archivo si ya existe.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
path	string	—	Ruta del archivo a escribir.
content	string	—	El texto XML a guardar (p. ej. la salida de XML Set Value).

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
encoding	string	"utf-8"	Codificación del archivo (p. ej. "utf-8", "utf-16", "iso-8859-1").
indent	bool	true	Formatea con sangría. El interruptor del Designer o una expresión que dé true/false. Desde la versión 1.1.1. Otro valor es un error ('indent' debe ser true o false.).

Salida

Devuelve un string con la ruta del archivo escrito (la misma de path).

Errores comunes

Mensaje	Causa y solución
'path' es obligatorio. / 'content' es obligatorio.	El parámetro quedó vacío o su expresión dio null.
Mensaje del analizador XML con línea y posición	content no es un XML bien formado (por ejemplo, pasaste un texto que no es XML).
El XML declara una DTD (<!DOCTYPE>). … / El XML es demasiado grande …	Límites de seguridad del paquete. Ver Errores comunes del paquete.
Mensaje de .NET de codificación no admitida	encoding no es un nombre de codificación válido.
Error de acceso del sistema de archivos	No hay permisos sobre la carpeta o el archivo está abierto en otro programa.

Ejemplo

Read XML   path = ruta   → output: xml
XML Set Value   xml = xml   xpath = "//Estado"   value = "Procesado"   → output: xmlNuevo
Write XML   path = "C:/salida/factura.xml"   content = xmlNuevo   → output: rutaGuardada
Log   message = "Guardado en " + rutaGuardada

Actividades relacionadas

• Read XML — leer un archivo XML.
• XML Set Value / XML Add Element — modificar antes de guardar.