Balises de connexion

Les balises de connexion sont des représentations visuelles des données disponibles à partir des blocs connectés, offrant un moyen simple de référencer les données entre les blocs et les sorties des blocs précédents dans votre flux de travail.

Que sont les balises de connexion ?

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

Visualiser les données disponibles des 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 balises de connexion facilitent la visualisation des données disponibles des blocs précédents et leur utilisation dans votre bloc actuel sans avoir à mémoriser des structures de données complexes.

Utilisation des balises de connexion

Il existe deux façons principales d'utiliser les balises de connexion dans vos flux de travail :

Glisser-déposer

Cliquez sur une balise de connexion et faites-la glisser dans les champs de saisie des blocs de destination. Une liste déroulante apparaîtra montrant les valeurs disponibles.

Survolez une balise de connexion pour voir les données disponibles
Cliquez et faites glisser la balise vers un champ de saisie
Sélectionnez le champ de données spécifique dans la liste déroulante
La référence est insérée automatiquement

Syntaxe des chevrons

Tapez <> dans les champs de saisie pour voir une liste déroulante des valeurs de connexion disponibles des 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 la liste déroulante de connexion
Parcourez et sélectionnez les données que vous souhaitez référencer
Continuez à taper ou sélectionnez dans la liste déroulante pour compléter la référence

Syntaxe des balises

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

<blockName.path.to.data>

Où :

blockName est le nom 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 de contenu d'un bloc avec l'ID "agent1"
<api2.data.users[0].name> - Référence le nom du premier utilisateur dans le tableau des utilisateurs du champ de données d'un bloc avec l'ID "api2"

Références dynamiques des balises

Les balises de connexion sont évaluées à 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

Lorsque vous utilisez des balises de connexion dans des contextes numériques, assurez-vous que les données référencées sont bien des nombres pour éviter les problèmes de conversion de type.