Saltearse al contenido
Nappai Documentation

Data to JSON

El componente Data to JSON es una herramienta de preparación y conversión dentro de Nappai. Su función principal es tomar cualquier objeto o lista de datos que le proporciones y transformarlo en un formato limpio, estandarizado y universal (JSON). Esto garantiza que la información sea completamente compatible con otras aplicaciones, APIs externas, bases de datos o los siguientes pasos de tu flujo de trabajo, evitando errores comunes de sincronización o formato.

¿Cómo funciona?

Cuando conectas este componente en tu flujo, el sistema realiza automáticamente tres pasos sencillos en segundo plano:

  1. Reconoce la estructura: Verifica si recibiste un solo registro o una lista completa de datos.
  2. Extrae y organiza: Accede al contenido interno de la información, preparándola para una conversión unificada.
  3. Limpia y estandariza: Aplica un proceso interno de validación que elimina posibles incompatibilidades y convierte cualquier dato complejo en una estructura pura y segura. Este “filtro de calidad” asegura que el resultado final solo contenga información estándar, lista para ser leída por cualquier sistema externo sin riesgo de fallos.

Conexión y Credenciales

Este componente no requiere configuración de credenciales ni autenticación externa. Funciona de manera autónoma dentro de tu flujo de automatización.

Entradas

Modo de Mapeo (Mapping Mode)

Este componente cuenta con un modo especial llamado “Mapping Mode” (Modo de Mapeo). Cuando activas este modo mediante el interruptor, se habilita una entrada adicional llamada “Mapping Data” y cada campo de entrada te ofrece tres formas diferentes de proporcionar datos:

  • Fixed (Fijo): Escribes el valor directamente en el campo.
  • Mapped (Mapeado): Conectas la salida de otro componente para usar su resultado como valor.
  • Javascript: Escribes código Javascript para calcular el valor dinámicamente.

Esta flexibilidad te permite crear flujos de trabajo más dinámicos y conectados.

Campos de Entrada

Los siguientes campos están disponibles para configurar este componente. Cada campo puede estar visible en diferentes operaciones:

  • Data: La información de entrada (ya sea un único objeto o una lista completa) que deseas convertir al formato JSON.
    • Visible en: Siempre disponible (este es el único campo de entrada del nodo)

Salidas

Al ejecutar el componente, generarás una salida estructurada lista para ser consumida por otros nodos:

  • JSON: Entrega la información ya transformada en un formato limpio, estrictamente compatible y listo para ser utilizado en pasos posteriores de tu automatización.

Ejemplo de Respuesta JSONjson

{ “id”: 12345, “estado”: “completado”, “fecha_creacion”: “2024-01-15T10:30:00”, “datos_adjuntos”: [ “valor_alfa”, “valor_beta” ] } Nota: Este ejemplo muestra cómo se estructura el resultado. Podrás usar cada llave (ej. id, estado, datos_adjuntos) para mapear sus valores en los nodos siguientes de tu flujo.

Conectividad

La salida generada por este componente está diseñada para conectarse lógicamente a nodos que requieran información estandarizada, como:

  • APIs o Webhooks: Para enviar datos limpios a servicios externos de manera segura.
  • Bases de Datos o Hojas de Cálculo: Para guardar registros sin errores de formato.
  • Nodos de Transformación o Validación: Para realizar chequeos de esquema o enriquecer la información antes de una acción final. Su salida se integra nativamente en el flujo de datos de Nappai, actuando como un puente confiable entre la extracción de información y su uso posterior.

Ejemplo de Uso

Escenario: Preparar datos de un reporte para enviarlos a una API externa

  1. Supón que extraes un listado de clientes desde un sistema de gestión y lo conectas a Data to JSON.
  2. El componente tomará automáticamente la lista, la validará y la convertirá en un formato JSON estandarizado.
  3. Conectas la salida de este nodo a un nodo de “HTTP Request” o “Enviar a Base de Datos”.
  4. Al ejecutar el flujo, los datos se enviarán sin fallos de serialización, garantizando una integración fluida con el sistema externo.

Consejos y Mejores Prácticas

  • Utiliza este componente siempre que necesites “limpiar” o estandarizar datos antes de enviarlos a una API o base de datos.
  • Si tu entrada está vacía o no contiene datos válidos, el componente entregará automáticamente una lista vacía para evitar interrupciones en el flujo.
  • Aprovecha el Mapping Mode para enlazar dinámicamente salidas de otros nodos sin tener que modificar manualmente los valores.
  • Mantén una estructura de entrada coherente (siempre un objeto o siempre una lista) para obtener resultados predecibles y optimizar el rendimiento del flujo.

Consideraciones de Seguridad

Este componente incluye mecanismos internos de validación que actúan como un filtro de seguridad. Si encuentra datos complejos o referencias circulares que puedan causar conflictos, el sistema manejará el error de forma controlada y detendrá la ejecución con una notificación clara, protegiendo así la integridad de tu flujo y evitando fallos inesperados en otros nodos. Siempre revisa que los datos de entrada provengan de fuentes confiables para garantizar una conversión segura y sin interrupciones.