Référencer les données d’un flux de travail

Référencer des données de runtime

Le runtime désigne l’endroit où les données de déclenchement d’une intégration sont stockées. La référence pour les données de runtime est {{runtime}}.

Vous pouvez référencer des éléments de données stockés dans le runtime. Lorsque vous référencez ces éléments, vous devez spécifier le nom de l’élément individuel.

Par exemple, si une feuille dans le Smartsheet déclenche un flux de travail et que vous devez faire référence à l’ID de la ligne concernée, la référence peut ressembler à ce qui suit : {{runtime.event.rowId}}.

La structure exacte et la convention de dénomination diffèrent selon le déclencheur et le type d’événement. 

Pour vous assurer que vous utilisez la référence appropriée :

1. Dans l’élément Run Log, survolez un objet déclencheur. 
2. Sélectionnez  Brandfolder Image .
3. Dans la liste qui apparaît, sélectionnez Copy Data Reference.

Brandfolder Image

Référencer des données d’état

Vous pouvez faire référence à un état lorsque des données sont transmises à partir d’un flux de travail parent. Le format de la référence est le suivant : {{states.state name.value}}.

Les données d’état référencées par rapport à un module dépendent toujours de cet état. Dans ce cas, la structure de la référence est la suivante : {{states.state name.integration or utility name.module name}}.

Si un module peut générer plusieurs valeurs de données, ajoutez le chemin d’accès à ces données spécifiques dans votre référence de données (de la même manière que vous faites référence à des éléments individuels de données de runtime).

Par exemple, le module Smartsheet: Get Row renvoie par défaut les données de l’image ci-dessous. 

Brandfolder Image

Dans le cas de la valeur saisie dans la cellule Address de la ligne, la référence ressemble à ce qui suit :
{{states.GetRow.smartsheet.get_row.row.cells.Address.value}}.

Référencer les données d’un flux de travail enfant

Vous pouvez référencer les données d’un flux de travail enfant dans le flux de travail parent. Pour ce faire, procédez comme suit :

1. Copiez la référence de données que vous souhaitez utiliser à partir du flux de travail parent.
2. Ajoutez un module Run Child Workflow (Exécuter un flux de travail enfant) dans le flux de travail parent et nommez-le.

Dans le flux de travail parent, dans le module enfant :

3. Sélectionnez Valeurs d’entité enfant.  
4. Ajoutez une clé, un nom que vous utiliserez pour faire référence aux données dans le flux de travail enfant.
5. Ajoutez la valeur correspondante, la référence de données que vous avez copiée à l’étape 1. Il peut ressembler à quelque chose comme {{states.startstate.stringtools.compose_text}}

d’un flux de travail enfant.

3. Sélectionnez le module auquel vous souhaitez faire référence aux données du flux de travail parent.
4. Dans le champ où vous souhaitez faire référence aux données du flux de travail parent, saisissez {{runtime.entities.text}} , où « texte » est la clé ajoutée à l’étape 4. 

Si vous souhaitez faire référence à {{runtime.entities.text} } comme {{states.text.value}} dans le flux de travail enfant, vous devez créer un état nommé « text » dans le flux de travail enfant

Référencer les données d’un flux de travail enfant

Vous pouvez référencer les données d’un flux de travail enfant dans le flux de travail parent. Pour ce faire, votre référence de données peut ressembler à ce qui suit :

• states.{{state that runs the child}}.child.{{state in child}}.value. ; ou
• states.{{state that runs the child}}.child.{{state in child}}.integration ou utility.module.

Options pour les références de données vides

Lorsque l’étape suivante de votre flux de travail dépend d’une valeur spécifique, qui peut exister ou non, vous pouvez utiliser des barres verticales (||) pour gérer deux scénarios.

Par exemple, imaginons que vous souhaitiez utiliser la valeur d’une cellule Smartsheet pour déterminer le chemin d’une jonction emprunté par le flux de travail. Mais vous ne pouvez pas garantir que la cellule contiendra toujours une valeur. 

Si la cellule est vide, le flux de travail s’arrêtera lorsqu’il arrivera à la jonction. Vous pouvez ajouter des barres verticales (||) à la fin de votre référence de données pour éviter cette situation. Si cette valeur contient des données, le flux de travail utilisera la référence à gauche des barres. Si aucune donnée n’existe dans cette cellule, le flux de travail utilisera ce qui se trouve à droite des barres.

Jetez un œil aux deux scénarios possibles dans la référence suivante :
{{states.GetRow.smartsheet.get_row.row.cells.Address.value||116 George Street, Edinburgh, UK}}

1. Le flux de travail tentera d’abord d’utiliser l’adresse de la ligne obtenue précédemment : GetRow.smartsheet.get_row.row.cell.Address.value.
2. Mais si cette cellule est vide, elle passera à l’adresse spécifiée après les barres verticales : 116 George Street, Edinburgh, UK.

Astuces concernant l’utilisation des barres verticales

Vous pouvez utiliser : 

• une autre référence de données après les barres verticales plutôt qu’une valeur saisie, ou
• plusieurs barres verticales pour gérer divers scénarios possibles.

Mélanger du texte et des références de données

Dans la plupart des modules, vous pouvez combiner du texte écrit et des références de données. Vous pouvez rédiger les parties de l’e-mail qui doivent toujours être identiques et utiliser des références de données pour celles qui ne le sont pas toujours, telles que le nom d’un destinataire ou une date.

Si vous avez créé le flux de travail météo décrit dans l’article Start a blank workflow for US Weather Service (Commencer un flux de travail vide pour le service météorologique américain), peut-être avez-vous remarqué que l’URL utilisée dans l’appel API au service météorologique américain contenait deux références de données.