Saltearse al contenido
Nappai Documentation

Data to JSON(String)

¿Cómo funciona?

Este componente actúa como un traductor universal para tus datos. Su función principal es tomar información estructurada (como objetos de datos, listas, diccionarios, cadenas o mensajes) y convertirla en una cadena de texto en formato JSON.

JSON (JavaScript Object Notation) es un formato ligero y muy utilizado para el intercambio de datos en sistemas modernos. Este componente te permite tomar datos crudos o complejos y transformarlos en un formato legible y compatible con la mayoría de las APIs, bases de datos y servicios externos.

Internamente, el componente realiza los siguientes pasos:

  1. Recepción de datos: Acepta diferentes tipos de entrada, incluyendo listas completas o elementos individuales.
  2. Adaptación automática: Si la entrada es una lista o un objeto complejo, el sistema adapta la estructura para que sea serializable.
  3. Conversión segura: Utiliza un proceso de serialización que maneja automáticamente tipos de datos difíciles (como fechas o identificadores únicos) convirtiéndolos en texto para evitar errores.
  4. Resultado: Devuelve una cadena de texto JSON válida que puede ser utilizada por otros nodos en tu flujo de trabajo.

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, especialmente cuando necesitas procesar listas completas o realizar transformaciones lógicas avanzadas.

Campos de Entrada

Los siguientes campos están disponibles para configurar este componente:

  • Data: Es el objeto de datos, lista de objetos, diccionario o mensaje que deseas convertir a formato JSON. Este campo es flexible y puede recibir información de diversos tipos, adaptándose automáticamente para generar la salida correcta.

Salidas

Este componente produce un único resultado principal:

  • JSON: Una cadena de texto (String) que contiene la estructura JSON codificada a partir de los datos de entrada. Este resultado puede conectarse directamente a otros nodos que requieran información en formato JSON, como APIs, bases de datos o analizadores de texto.

Ejemplo de Respuesta JSON

Al ejecutar este componente con datos válidos, obtendrás una estructura similar a la siguiente: json { “usuario_id”: “123456”, “nombre”: “Maria Rodriguez”, “activo”: true, “roles”: [ “admin”, “editor” ], “fecha_creacion”: “2023-10-27T14:30:00” }

Conectividad

Entradas: Este componente suele recibir datos desde nodos de origen como:

  • Nodos Data (bases de datos, CSVs, etc.).
  • Nodos Message (procesamiento de chat o interacciones).
  • Nodos generadores de variables o templates que entreguen datos estructurados. También puede recibir listas de componentes de procesamiento que necesiten ser estandarizadas.

Salidas: La salida JSON se conecta típicamente a:

  • Nodos API (HTTP Request, API Call) para enviar payloads en solicitudes POST/PUT.
  • Nodos de Base de Datos que requieran almacenamiento en formato JSON.
  • Nodos de Manipulación de Datos para filtrar, buscar o transformar el contenido JSON.
  • Nodos de IA o LLM que necesiten el texto estructurado como contexto o entrada.

Ejemplo de Uso

Escenario: Automatización de envío de informes por correo.

  1. Supongamos que tienes un flujo que recupera datos de clientes de una base de datos.
  2. Conectas la salida de ese nodo Data a la entrada Data de “Data to JSON(String)”.
  3. El componente convierte la lista de clientes en una cadena JSON.
  4. Conectas la salida JSON a un nodo API que envía datos a un servicio de email marketing, el cual requiere un formato JSON específico para procesar la suscripción.
  5. Gracias a este componente, los datos se transforman automáticamente sin necesidad de escribir código manual, asegurando que la API reciba la información en el formato correcto.

Consejos y Mejores Prácticas

  • Uso con Listas: Si tu entrada es una lista grande, activa el “Mapping Mode” para optimizar el procesamiento y asegurar que cada elemento sea manejado correctamente.
  • Validación de Estructura: Asegúrate de que los datos de entrada tengan una estructura lógica antes de convertirlos; esto evita cadenas JSON vacías o incorrectas.
  • Integración con APIs: Este es el paso ideal antes de realizar llamadas a APIs externas, ya que la mayoría requiere payloads en formato JSON.
  • Manejo de Nulos: Si la entrada es None o está vacía, el componente devuelve una lista vacía []. Puedes conectar esto a un nodo de condicional para manejar flujos de error o vacíos.
  • Lectura de Salida: La salida es una cadena de texto. Si necesitas manipular campos específicos del JSON resultante, utiliza nodos de “JSON Parse” o “Object Manipulation” posteriormente en el flujo.

Consideraciones de Seguridad

  • Protección de Información Sensible: Al convertir datos a JSON, verifica que no se estén incluyendo credenciales, contraseñas o datos personales sensibles en el flujo, ya que el resultado es una cadena de texto visible y transferible.
  • Validación de Entradas: Asegúrate de que las fuentes de datos sean confiables para evitar la serialización de estructuras maliciosas o datos corruptos.
  • Almacenamiento Seguro: Si almacenas el resultado JSON en bases de datos o logs, aplica las mismas políticas de seguridad y encriptación que aplicas a otros datos sensibles.