Saltearse al contenido
Nappai Documentation

Data to XML

Bienvenido a la guía del componente Data to XML en Nappai. Este componente es una herramienta esencial para convertir la información que tienes en tu sistema (como listas o tablas) en un formato estándar llamado XML.

El formato XML es muy útil porque permite guardar, compartir y leer datos de manera estructurada, similar a cómo lo harías con un archivo de texto, pero con etiquetas que organizan la información. Puedes usar este componente para preparar tus datos para que otros sistemas los lean, para guardarlos en archivos o para enviarlos a través de internet.

¿Cómo funciona?

Imagina que tienes un registro de cliente en tu computadora, como una ficha con su nombre, edad y ciudad. El componente Data to XML toma esa ficha (o lista de fichas) y la transforma automáticamente en un texto con formato especial.

El proceso interno es sencillo:

  1. Lee tus datos: El componente mira el objeto de datos que le has proporcionado.
  2. Crea etiquetas: Toma las categorías de tus datos (por ejemplo, “Nombre” o “Email”) y las convierte en etiquetas de apertura y cierre (como <Name> y </Name>).
  3. Inserta valores: Coloca la información real dentro de esas etiquetas.
  4. Genera el resultado: Devuelve un texto completo en formato XML listo para ser usado.

Básicamente, actúa como un traductor que convierte tus datos nativos de Nappai al lenguaje universal de XML.

Conexión y Credenciales

Este componente no requiere configurar credenciales ni conectarse a servicios externos. Todo el procesamiento se realiza localmente dentro de tu flujo de trabajo en Nappai. Puedes conectarlo directamente a componentes anteriores que generan datos y conectar su salida a componentes que necesiten leer ese texto XML.

Entradas

Campos de Entrada

Para que el componente funcione, debes proporcionarle la siguiente información:

  • Data: Es el objeto principal que deseas convertir. Puede ser un diccionario (una ficha con varios campos) o una lista de diccionarios (varias fichas juntas). Este campo es obligatorio; sin datos, no hay nada que convertir.
    • Visible en: Todas las operaciones

INSTRUCCIÓN PARA EL MODELO: Los nombres de los campos (display_name) DEBEN copiarse EXACTAMENTE como aparecen en “Información Adicional del Componente” (en inglés). Solo las explicaciones deben estar en español. NO traduzcas los nombres de los campos. NO incluyas esta advertencia en la documentación final.

Salidas

Una vez que el componente procesa la información, genera lo siguiente:

  • xml: Es una cadena de texto que contiene toda la información en formato XML. Este texto resultante es la salida principal de este nodo y puede ser conectado a otros componentes para ser guardado en un archivo, enviado por correo o almacenado en tu base de datos.

Ejemplo de Respuesta JSON

A continuación, puedes ver cómo se vería la estructura del objeto de entrada y cómo se transforma en la salida. El ejemplo muestra una estructura de entrada típica (JSON) que el componente procesa internamente para generar el texto XML. json { “status”: “success”, “component”: “Data to XML”, “example_input_structure”: { “name”: “Juan Pérez”, “age”: 30, “city”: “Madrid”, “hobbies”: [“leer”, “correr”] }, “example_xml_output_description”: “El componente generará un texto como: Juan Pérez30…” }

Nota: En tu flujo de trabajo, el campo de salida xml contendrá el texto exacto con las etiquetas XML, listo para ser mapeado.

Conectividad

Este componente es versátil y puede conectarse a varios tipos de nodos posteriores en tu flujo:

  1. Componentes de Archivos: Es ideal conectar la salida xml a nodos como “Write to File” para guardar la información en un archivo .xml en tu sistema.
  2. Integraciones API: Muchos servicios web aceptan datos en formato XML. Puedes conectar este componente a nodos de “HTTP Request” o “Send Email” que requieran el cuerpo del mensaje en este formato.
  3. Otras Transformaciones: Si necesitas modificar el XML antes de guardarlo, puedes conectarlo a otros componentes de transformación de datos que manipulen texto.

Ejemplo de Uso

Escenario: Guardar un reporte de empleados en un archivo

Imagina que tienes un flujo que recopila datos de empleados de una hoja de cálculo.

  1. Entrada: El componente anterior te da una lista de empleados con sus nombres y salarios.
  2. Componente Data to XML: Conectas esta lista al campo Data del componente Data to XML.
  3. Resultado: El componente genera un texto XML donde cada empleado es una “fila” con sus etiquetas <Name> y <Salary>.
  4. Siguiente Paso: Conectas la salida xml a un componente “Save File” que guarda el resultado en una carpeta de tu servidor con el nombre empleados.xml.

Consejos y Mejores Prácticas

  • Verifica la Estructura: Asegúrate de que los datos que envías al campo Data sean simples (diccionarios o listas). Estructuras demasiado complejas o con tipos de datos extraños pueden causar errores de serialización.
  • Uso en Lotes: Si tu flujo maneja grandes cantidades de datos, el componente está optimizado para trabajar en modo mapeo, procesando elementos de forma eficiente.
  • Legibilidad: El XML generado es legible por humanos y máquinas. Úsalo cuando necesites que otros sistemas o software externo puedan leer tus datos sin configuraciones complicadas.

Consideraciones de Seguridad

Dado que este componente realiza una transformación local de datos a texto:

  • Validación de Datos: Asegúrate de que los datos de entrada no contengan información sensible no deseada antes de la conversión, ya que el XML resultante puede ser leíble o exportable.
  • Control de Acceso: El archivo o dato XML resultante debe ser manejado con los mismos cuidados de seguridad que cualquier otro dato confidencial en tu sistema Nappai.