#Variable

This feature is provided by the commercial plugin «Flux de travail : Variable personnalisée», please purchase to use

#Introduction

Vous pouvez déclarer des variables dans un flux de travail ou attribuer des valeurs à des variables déjà déclarées. Cela sert généralement à stocker des données temporaires au sein du flux.

#Créer un nœud

Dans l'interface de configuration du flux de travail, cliquez sur le bouton plus (« + ») dans le flux pour ajouter un nœud « Variable » :

#Configurer le nœud

#Mode

Le nœud Variable est similaire aux variables en programmation : il doit être déclaré avant de pouvoir être utilisé et de se voir attribuer une valeur. Par conséquent, lors de la création d'un nœud Variable, vous devez choisir son mode. Deux modes sont disponibles :

• Déclarer une nouvelle variable : Crée une nouvelle variable.
• Attribuer à une variable existante : Attribue une valeur à une variable qui a été déclarée précédemment dans le flux de travail, ce qui équivaut à modifier la valeur de la variable.

Lorsque le nœud créé est le premier nœud Variable du flux de travail, vous ne pouvez sélectionner que le mode de déclaration, car aucune variable n'est encore disponible pour l'attribution.

Lorsque vous choisissez d'attribuer une valeur à une variable déclarée, vous devez également sélectionner la variable cible, c'est-à-dire le nœud où la variable a été déclarée :

#Valeur

La valeur d'une variable peut être de n'importe quel type. Il peut s'agir d'une constante, comme une chaîne de caractères, un nombre, une valeur booléenne ou une date, ou d'une autre variable du flux de travail.

En mode déclaration, définir la valeur de la variable équivaut à lui attribuer une valeur initiale.

En mode attribution, définir la valeur de la variable équivaut à modifier la valeur de la variable cible déclarée pour une nouvelle valeur. Les utilisations ultérieures récupéreront cette nouvelle valeur.

#Utiliser la valeur de la variable

Dans les nœuds qui suivent le nœud Variable, vous pouvez utiliser la valeur de la variable en sélectionnant la variable déclarée dans le groupe « Variables de nœud ». Par exemple, dans un nœud de requête, utilisez la valeur de la variable comme condition de requête :

#Exemple

Un scénario plus utile pour le nœud Variable se trouve dans les branches, où de nouvelles valeurs sont calculées ou fusionnées avec des valeurs précédentes (similaire à reduce/concat en programmation), puis utilisées après la fin de la branche. Voici un exemple d'utilisation d'une branche de boucle et d'un nœud Variable pour concaténer une chaîne de destinataires.

Tout d'abord, créez un flux de travail déclenché par une collection qui se déclenche lorsque les données « Article » sont mises à jour, et préchargez les données de relation « Auteur » associées (pour obtenir les destinataires) :

Ensuite, créez un nœud Variable pour stocker la chaîne de destinataires :

Ensuite, créez un nœud de branche de boucle pour itérer sur les auteurs de l'article et concaténer leurs informations de destinataire dans la variable de destinataire :

À l'intérieur de la branche de boucle, créez d'abord un nœud de calcul pour concaténer l'auteur actuel avec la chaîne d'auteurs déjà stockée :

Après le nœud de calcul, créez un autre nœud Variable. Sélectionnez le mode attribution, choisissez le nœud Variable de destinataire comme cible d'attribution, et sélectionnez le résultat du nœud de calcul comme valeur :

Ainsi, une fois la branche de boucle terminée, la variable de destinataire stockera la chaîne de destinataires de tous les auteurs de l'article. Ensuite, après la boucle, vous pourrez utiliser un nœud de requête HTTP pour appeler une API d'envoi de courrier, en passant la valeur de la variable de destinataire comme paramètre de destinataire à l'API :

À ce stade, une fonctionnalité simple d'envoi d'e-mails en masse a été implémentée à l'aide d'une boucle et d'un nœud Variable.