Data
Este componente actúa como un “desempacador” inteligente de información. En lugar de pasar un bloque de datos completo al siguiente paso de tu automatización, este componente analiza el objeto de entrada y extrae cada pieza de información (atributo) por separado.
Esto es muy útil cuando necesitas tomar una acción específica sobre un dato concreto, como enviar un correo electrónico usando solo la dirección, o aplicar una fórmula matemática solo a un número específico dentro de un conjunto de datos.
¿Cómo funciona?
Cuando conectas este componente a un objeto de datos (como una base de datos, un archivo o una respuesta de una IA), el sistema observa internamente qué información contiene ese objeto.
- Análisis: El componente lee las etiquetas o atributos dentro del objeto que le enviaste.
- Extracción: Genera automáticamente una salida independiente por cada atributo encontrado. Por ejemplo, si el objeto tiene un atributo llamado “Email”, el componente creará una salida llamada “Email”.
- Listo para usar: Ahora puedes conectar esas salidas individuales a otros componentes. Si el objeto no tiene datos, el componente no generará salidas.
Conexión y Credenciales
Este componente no requiere configuraciones de credenciales (como claves de API o contraseñas) ni ajustes previos en el panel. Simplemente conéctalo a una fuente de datos que funcione en tu flujo.
Operaciones
Este componente no ofrece operaciones múltiples configurables. Su comportamiento es estándar: extrae y separa los atributos del objeto de entrada automáticamente.
Entradas
Este componente cuenta con un modo especial llamado Mapping Mode (Modo de Mapeo). Cuando activas este modo, cada campo de entrada te ofrece tres formas diferentes de proporcionar datos, lo que te da flexibilidad total en cómo alimentas el componente:
- Fixed (Fijo): Escribes o seleccionas el valor directamente en el campo.
- Mapped (Mapeado): Conectas la salida de otro componente para usar su resultado dinámicamente.
- Javascript: Escribes código pequeño en Javascript para calcular el valor al instante.
Campos de Entrada
El único campo principal necesario para que este componente funcione es:
- Data: Es el objeto principal que contiene la información que quieres analizar. Puede ser un registro de base de datos, una respuesta de texto estructurada o cualquier entidad de datos. Debes conectar aquí el objeto del que deseas extraer los atributos.
Salidas
El resultado de este componente depende completamente de lo que le envíes. No hay una lista fija de salidas predefinidas; en su lugar, genera salidas dinámicas.
- Salidas Dinámicas: Si el objeto de datos que conectaste tiene atributos como
nombre,edadyciudad, el componente creará tres salidas independientes con esos nombres. - Uso: Puedes conectar cada una de estas saladas a diferentes nodos. Por ejemplo, la salida
nombrepuede ir a un nodo de “Enviar Email” y la salidaedada un nodo de “Verificación de Edad”.
Ejemplo de Respuesta JSON
Imagina que conectas un objeto de datos con la siguiente estructura: json { “nombre”: “Ana”, “edad”: 30, “ciudad”: “Madrid” }
El componente DataToAttributeComponent generará internamente salidas individuales equivalentes a:
- Salida ‘nombre’: “Ana”
- Salida ‘edad’: 30
- Salida ‘ciudad’: “Madrid”
Esto te permite usar “Ana”, “30” y “Madrid” como datos separados en pasos siguientes de tu automatización.
Conectividad
Este componente funciona como un puente entre los datos brutos y las acciones específicas.
- Entrante (Input): Debes conectar aquí cualquier componente que genere un objeto de datos o una entidad compleja (por ejemplo, un nodo de “Base de Datos”, un nodo de “Lectura de Archivo” o un nodo de “IA”).
- Saliente (Output): Las saladas generadas suelen conectarse a nodos que requieren datos específicos, como:
- Nodos de Envío de Correos (para el campo ‘Email’).
- Nodos de Base de Datos (para crear nuevos registros).
- Nodos de IA/Texto (para incluir datos específicos en un mensaje).
Ejemplo de Uso
Escenario: Tienes un registro de cliente que incluye Nombre, Email y Teléfono, y solo necesitas enviar un SMS de bienvenida al teléfono.
- Conectas el nodo “Obtener Cliente” a la entrada Data de este componente.
- El componente analiza el registro y crea una salida llamada phone (teléfono).
- Conectas la salida phone al nodo “Enviar SMS”.
- Ignoras las salidas de Nombre y Email porque no las necesitas para esta tarea específica.
Consejos y Mejores Prácticas
- Verifica la estructura de entrada: Asegúrate de que el objeto que conectas a la entrada Data tenga atributos públicos (no privados) para que el componente pueda extraerlos.
- Gestión de cambios: Si la estructura de tus datos cambia (por ejemplo, añades un nuevo campo al registro), las salidas de este componente se actualizarán automáticamente para incluir ese nuevo campo.
- Uso en flujos dinámicos: Ideal para cuando no sabes exactamente qué datos vendrán hasta que se ejecute el flujo, ya que se adapta a lo que encuentra.
Consideraciones de Seguridad
Este componente es seguro por defecto, ya que solo lee y extrae información disponible en los objetos de datos. Sin embargo, recuerda que si un objeto de datos contiene información sensible (como contraseñas), esta estará disponible como una salida si la conexión de datos así lo permite. Asegúrate de no conectar salidas de información sensible a nodos públicos o registrados sin la debida protección.