Étiquettes de connexion

Utiliser les étiquettes de connexion pour référencer des données entre les blocs

Les étiquettes de connexion sont des représentations visuelles des données disponibles depuis les blocs connectés. Elles offrent un moyen simple de référencer les sorties des blocs précédents dans votre workflow.

Qu'est-ce qu'une étiquette de connexion ?

Les étiquettes de connexion sont des éléments interactifs qui apparaissent lorsque des blocs sont connectés. Elles représentent les données pouvant circuler d'un bloc à un autre et vous permettent de :

Visualiser les données disponibles depuis les blocs sources
Référencer des champs de données spécifiques dans les blocs de destination
Créer des flux de données dynamiques entre les blocs

Les étiquettes de connexion facilitent la visualisation des données disponibles depuis les blocs précédents et leur utilisation dans votre bloc actuel sans avoir à mémoriser des structures de données complexes.

Utiliser les étiquettes de connexion

Il existe deux façons principales d'utiliser les étiquettes de connexion dans vos workflows :

Glisser-déposer

Cliquez sur une étiquette de connexion et faites-la glisser dans les champs de saisie des blocs de destination. Un menu déroulant apparaîtra affichant les valeurs disponibles.

Survolez une étiquette de connexion pour voir les données disponibles
Cliquez et faites glisser l'étiquette vers un champ de saisie
Sélectionnez le champ de données spécifique depuis le menu déroulant
La référence est insérée automatiquement

Syntaxe avec chevrons

Tapez <> dans les champs de saisie pour voir un menu déroulant des valeurs de connexion disponibles depuis les blocs précédents.

Cliquez dans n'importe quel champ de saisie où vous souhaitez utiliser des données connectées
Tapez <> pour déclencher le menu déroulant de connexion
Parcourez et sélectionnez les données que vous souhaitez référencer
Continuez à taper ou sélectionnez dans le menu déroulant pour compléter la référence

Syntaxe des étiquettes

Les étiquettes de connexion utilisent une syntaxe simple pour référencer les données :

<blockId.path.to.data>

Où :

blockId est l'identifiant du bloc source
path.to.data est le chemin vers le champ de données spécifique

Par exemple :

<agent1.content> - Référence le champ content d'un bloc avec l'ID « agent1 »
<api2.data.users[0].name> - Référence le nom du premier utilisateur dans le tableau users depuis le champ data d'un bloc avec l'ID « api2 »

Références d'étiquettes dynamiques

Les étiquettes de connexion sont évaluées au moment de l'exécution, ce qui signifie :

Elles référencent toujours les données les plus récentes
Elles peuvent être utilisées dans des expressions et combinées avec du texte statique
Elles peuvent être imbriquées dans d'autres structures de données

Exemples

// 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

Lors de l'utilisation d'étiquettes de connexion dans des contextes numériques, assurez-vous que les données référencées sont bien un nombre pour éviter les problèmes de conversion de type.