Etiquetas de conexión

Las etiquetas de conexión son representaciones visuales de los datos disponibles desde bloques conectados, proporcionando una manera fácil de referenciar datos entre bloques y salidas de bloques anteriores en tu flujo de trabajo.

¿Qué son las etiquetas de conexión?

Las etiquetas de conexión son elementos interactivos que aparecen cuando los bloques están conectados. Representan los datos que pueden fluir de un bloque a otro y te permiten:

Visualizar datos disponibles de bloques de origen
Referenciar campos de datos específicos en bloques de destino
Crear flujos de datos dinámicos entre bloques

Las etiquetas de conexión facilitan ver qué datos están disponibles de bloques anteriores y usarlos en tu bloque actual sin tener que recordar estructuras de datos complejas.

Uso de etiquetas de conexión

Hay dos formas principales de usar etiquetas de conexión en tus flujos de trabajo:

Arrastrar y soltar

Haz clic en una etiqueta de conexión y arrástrala a los campos de entrada de los bloques de destino. Aparecerá un menú desplegable mostrando los valores disponibles.

Pasa el cursor sobre una etiqueta de conexión para ver los datos disponibles
Haz clic y arrastra la etiqueta a un campo de entrada
Selecciona el campo de datos específico del menú desplegable
La referencia se inserta automáticamente

Sintaxis de corchetes angulares

Escribe <> en los campos de entrada para ver un menú desplegable de valores de conexión disponibles de bloques anteriores.

Haz clic en cualquier campo de entrada donde quieras usar datos conectados
Escribe <> para activar el menú desplegable de conexión
Navega y selecciona los datos que quieres referenciar
Continúa escribiendo o selecciona del menú desplegable para completar la referencia

Sintaxis de etiquetas

Las etiquetas de conexión utilizan una sintaxis simple para hacer referencia a los datos:

<blockName.path.to.data>

Donde:

blockName es el nombre del bloque de origen
path.to.data es la ruta al campo de datos específico

Por ejemplo:

<agent1.content> - Hace referencia al campo de contenido de un bloque con ID "agent1"
<api2.data.users[0].name> - Hace referencia al nombre del primer usuario en el array de usuarios desde el campo de datos de un bloque con ID "api2"

Referencias dinámicas de etiquetas

Las etiquetas de conexión se evalúan en tiempo de ejecución, lo que significa:

Siempre hacen referencia a los datos más actuales
Pueden utilizarse en expresiones y combinarse con texto estático
Pueden anidarse dentro de otras estructuras de datos

Ejemplos

// Reference in text
"The user's name is <userBlock.name>"

// Reference in JSON
{
  "userName": "<userBlock.name>",
  "orderTotal": <apiBlock.data.total>
}

// Reference in code
const greeting = "Hello, <userBlock.name>!";
const total = <apiBlock.data.total> * 1.1; // Add 10% tax

Cuando utilices etiquetas de conexión en contextos numéricos, asegúrate de que los datos referenciados sean realmente un número para evitar problemas de conversión de tipos.