Toon to Data

Bienvenido al componente Toon to Data de Nappai. Este componente es como un traductor especializado: toma texto escrito en el formato TOON (una forma estructurada de organizar información) y lo convierte en un objeto de datos comprensible para el sistema.

Imagina que tienes una lista de instrucciones o una tabla escrita en un lenguaje simple; este componente la lee, analiza esa estructura y la transforma en un formato que otros componentes de Nappai pueden usar fácilmente para tomar decisiones, guardar información o mostrar gráficos.

¿Cómo funciona?

Internamente, este componente sigue un proceso claro y eficiente:

Recepción del Texto: Recibe texto escrito en formato TOON. Puede ser texto que escribes manualmente o información que proviene de otro lugar.
Análisis (Decodificación): El componente “lee” el texto identificando las reglas del formato TOON (como la estructura, los espacios y los valores).
Creación del Objeto: Una vez entendido el texto, crea un Objeto de Datos. Este no es solo texto plano, sino una estructura organizada (como una tabla o una lista de categorías) que tu automatización puede manipular.

El resultado es un objeto listo para ser conectado a otros pasos de tu flujo de trabajo.

Conexión y Credenciales

Este es un componente de procesamiento de datos interno. No requiere credenciales ni configuraciones externas para funcionar. No necesitas conectar cuentas de Google, API keys ni servicios de pago.

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.

TOON Data: Un objeto de datos completo que ya contiene el texto en formato TOON. Úsalo si la información viene de otro nodo de tu flujo.
TOON Text: Permite escribir el texto en formato TOON manualmente. Útil para probar el componente o si tienes información pequeña que puedes copiar y pegar directamente. Controla los saltos de línea y la indentación para que la estructura se entienda bien.
Mode: Un selector que te ayuda a decidir de dónde viene la información. Elige Data Entry si vas a usar el campo “TOON Data” (para conectar con otros nodos) o Manual Entry si prefieres escribir el texto tú mismo en el campo “TOON Text”.

Salidas

Al ejecutar este componente, obtendrás una salida principal lista para ser usada en los siguientes pasos de tu automatización.

Data: Este es el resultado final. Es un objeto de datos estructurado derivado del texto que le diste. Ahora puedes conectar este nodo a otros que necesiten leer esa información organizada (por ejemplo, un nodo que envíe un correo basado en esa información o que guarde los datos en una base de datos).

Ejemplo de Respuesta JSON

A continuación, puedes ver cómo se vería la estructura de datos resultante después de transformar un texto TOON. Este es el formato que podrás usar en los siguientes nodos: json { “key1”: “valor_ejemplo_1”, “key2”: { “subkey”: “dato_anidado”, “id”: 123 }, “status”: “success” }

Conectividad

Este componente es versátil y puede conectarse con facilidad a otros elementos del sistema:

Conectando con Otros Componentes: La salida Data se conecta lógicamente a componentes que necesitan “leer” información. Por ejemplo, podrías conectarlo a un nodo de “Enviar Email” para incluir datos específicos del objeto en el mensaje, o a un nodo de “Crear Registro” en una base de datos para guardar esa información.
Lógica del Flujo: Es ideal ubicarlo en medio de un flujo de automatización: primero obtienes los datos (en formato texto), luego los transformas con este componente, y finalmente los usas para tomar acciones.

Ejemplo de Uso

Escenario: Quieres automatizar la lectura de una pequeña tabla de precios que tienes en texto plano dentro de otro sistema.

Paso 1: Obtienes el texto con los precios en formato TOON.
Paso 2 (Toon to Data): Usas este componente en el campo TOON Text y pegas el texto manualmente (o conectas la salida de donde obtuviste el texto). El componente lo convierte en un objeto Data.
Paso 3: Conectas la salida Data a un nodo de “Notas” o “Reporte”, y el sistema ahora puede mostrar los precios de forma ordenada y limpia en tu dashboard.

Plantillas

Esta sección no está disponible para este componente en el momento.

Componentes Relacionados

Esta sección no está disponible para este componente en el momento.

Notas Importantes

Esta sección no contiene notas específicas críticas para este componente.

Consejos y Mejores Prácticas

Usa el Modo Manual para pruebas: Si estás aprendiendo a usar el formato TOON, usa el campo TOON Text para escribir manualmente y ver rápidamente cómo el sistema lo interpreta.
Conecta para flujos complejos: Cuando ya tengas el flujo funcionando, es mejor conectar el campo TOON Data a la salida de otro componente para que la automatización sea automática y no tengas que escribir el texto cada vez.
Revisa la estructura: Asegúrate de que tu texto TOON tenga la indentación correcta (los espacios al inicio de cada línea), ya que esto ayuda al componente a entender qué dato pertenece a qué categoría.

Consideraciones de Seguridad

Este es un componente de procesamiento interno de datos. No interactúa con servicios externos ni expone información sensible de forma directa. Solo procesa la información que tú (u otros componentes) le envías dentro de tu propio flujo de trabajo.