Variables

Une variable est un élément d'intégration qui contient et transmet des données entre les tâches, les déclencheurs, et les arêtes d'une intégration.

  • Les variables peuvent être définies de manière statique en conception ou transmises de manière dynamique à l'intégration au moment de l'exécution.
  • Les variables peuvent référencer d'autres variables dans une intégration.
  • Les variables peuvent être accessibles globalement pour toutes les tâches ou accessibles localement à une tâche spécifique.

Variables

Dans Application Integration, les variables sont définies ou initialisées à différents endroits :

  • Variables de configuration : définies au moment de la conception pour stocker les données de configuration de l'intégration. Vous pouvez par exemple les utiliser pour définir une adresse e-mail cible pour les notifications, plutôt que de coder en dur cette adresse e-mail dans l'intégration.
  • Variables système : générées automatiquement par le système pour stocker les données de configuration de l'intégration. Par exemple, la variable ExecutionId stocke l'ID d'exécution de l'intégration.
  • Variables d'intégration : définies explicitement dans votre intégration pour effectuer le suivi des données tout au long de l'exécution d'une intégration. Vous pouvez par exemple définir une variable pour stocker le résultat d'une tâche et l'utiliser dans une tâche ultérieure.
  • Variables de tâche : définies implicitement en exécutant des tâches spécifiques pour stocker la sortie de la tâche. Par exemple, la tâche Call REST Endpoint (Appeler un point de terminaison REST) définit la variable responseBody pour stocker le corps de la réponse du point de terminaison REST. Les variables de tâche sont également appelées variables générées automatiquement. Les variables générées automatiquement suivent une convention de nommage spéciale qui consiste à utiliser des accents graves autour du nom de la variable.

Variables d'intégration

Les variables d'intégration, qui incluent les variables d'entrée et de sortie, sont semblables aux variables utilisées dans un langage de programmation. Les données des variables peuvent être lues et écrites tout au long de l'exécution de l'intégration.

Les variables d'intégration peuvent être utilisées de différentes manières :

  • Comme entrées dans l'intégration, également appelées variables d'entrée.
  • Renvoyées sous forme de sorties de l'intégration, également appelées variables de sortie.
  • Utilisées pour conserver l'état temporaire lors de l'exécution d'une intégration.

Lorsque vous marquez une variable comme variable d'entrée, vous indiquez que la valeur de la variable doit être fournie lorsque l'intégration est déclenchée. La valeur d'une variable d'entrée peut être modifiée lors de l'exécution de l'intégration.

Lorsque vous marquez une variable comme variable de sortie, vous indiquez que la valeur finale de la variable doit être renvoyée dans le cadre de la réponse de l'intégration.

Il n'est pas nécessaire de définir la valeur d'une variable de façon statique dans l'intégration. Les valeurs des variables peuvent être transmises dans une intégration via l'utilisation d'un déclencheur. Toutefois, si une variable est définie de manière statique dans l'intégration et si la même variable est fournie de manière dynamique avec le déclencheur, l'attribution de valeur dynamique remplace l'attribution statique.

Types de données acceptés

Les types de données suivants sont acceptés pour les variables d'intégration :

  • Chaîne et tableau de chaînes
  • Entier et tableau d'entiers
  • Double et tableau de doubles
  • Booléen et tableau de booléens
  • JSON

Variables de tâche

Les variables de tâche sont des variables prédéfinies et générées automatiquement d'une tâche. Si une tâche a une sortie, toutes ces sorties sont disponibles dans une variable de tâche. Vous ne pouvez pas supprimer ni modifier une variable de tâche. Les variables de tâche sont également appelées variables générées automatiquement.

Le nom unique d'une variable de tâche suit une convention de nommage spéciale : il utilise des accents graves autour du nom de la variable et inclut l'ID de la tâche. Il a le format suivant : `<Task ID>_<Variable Name>`.

Par exemple, la tâche Call REST Endpoint (Appeler un point de terminaison REST) a une sortie pour le corps de la réponse. Si l'ID de cette tâche est Task_5, le nom unique de la variable de tâche pour le corps de la réponse est `Task_5_responseBody`.

Dans le volet Variables , les variables de tâche peuvent être listées par un nom de sortie commun, par exemple responseBody, sans l'ID de la tâche ni les accents graves. Pour afficher le nom de variable complet et unique requis pour la référence, cliquez sur la variable dans le volet et affichez ses détails dans le panneau de droite.

Variables de configuration

Les