Présentation des variables

Date de la dernière mise à jour : Aug 06, 2024 |

Une variable est une représentation symbolique des données auxquelles vous pouvez accéder sans les saisir. L'introduction de variables est utile lorsque vous utilisez les mêmes valeurs à plusieurs endroits. Par exemple, si vous utilisez la même URL à plusieurs endroits, vous pouvez l'ajouter en tant que variable globale. Si l'URL change, il vous suffit de modifier une valeur dans la variable. Les variables sont disponibles dans Orchestration et Automatisation. Orchestration modifie cette valeur dans tous les flux de travail où cette variable globale est utilisée.

Les variables dans Orchestration sont des paires clé-valeur. Chaque nom de variable représente sa clé. Ainsi, lorsque vous faites référence au nom de la variable, vous pouvez accéder à sa valeur.

Orchestration utilise les types de variables suivants :

  • Globale

  • Locale

En tant qu'utilisateur responsable de la planification des travaux, vous pouvez accéder aux variables en saisissant une valeur de variable statique dans le champ correspondant. Cette valeur reste constante pendant l'exécution.

En tant qu'utilisateur Administrateur, vous pouvez saisir des valeurs de variables statiques dans le champ correspondant. Vous pouvez également sélectionner une variable qui obtient des valeurs en temps réel et qui est associée à l'engagement. Pour ajouter une variable, cliquez sur l'icône Ajouter une variable et sélectionnez une variable parmi les options disponibles.

Variables globales

Les variables globales sont des entités dont le nom et la valeur sont attribués et qui peuvent être utilisées dans tous les flux de travail. Vous pouvez créer, afficher, modifier et supprimer des variables dans Gestionnaire d'Orchestration. Si vous modifiez une variable globale, la modification s’applique à tous les flux de travail dans lesquels la variable est utilisée. Pour éviter toute erreur, ne pas modifier ou supprimer la variable globale pendant l’exécution du flux de travail.

Pour accéder à une variable, cliquez sur l'icône Ajouter une variable et sélectionnez Variables globales dans la liste des options disponibles. Par exemple, vous pouvez créer les variables suivantes :

Nom de la variable

Valeur

hôte

avaya.com/fr

protocole

https

port

443

Vous pouvez les utiliser comme suit dans le champ URI REST de la tâche API REST : GlobalVariables.protocol://GlobalVariables.host:GlobalVariables.port/updaterecords

Variables locales

Les variables locales ne sont disponibles que pour le flux de travail spécifique et sont représentées dans Orchestration avec les variables de cache et de tâche.

Lorsqu’une interaction se déroule dans le cadre d’un flux de travail, elle accumule des données. Par exemple, la Tâche de démarrage est associée à l’événement ENGAGEMENT_PREROUTED. La Tâche de démarrage contient un ensemble riche de données relatives à l’interaction et aux données collectées pendant le préroutage. Pour mettre ces informations à la disposition des tâches en aval, ajoutez-les au cache du flux de travail.

Le cache du flux de travail est le terme utilisé pour décrire la collecte de données disponibles dans le flux de travail. Le cache est disponible pour l'utilisateur de type Administrateur afin de faciliter la personnalisation et la configuration avancées. Pour accéder au cache, vous pouvez sélectionner Variables de cache dans les zones de texte où vous saisissez des données. Vous pouvez sélectionner les données requises dans la liste des éléments actuellement disponibles dans le cache. Pour ajouter ou remplacer une variable de cache, utilisez l’onglet Mappage des résultats de la tâche API REST ou Fonctions Azure. Une liste d'attributs qu'Orchestration utilise pour le routage est un exemple de variable de cache.

Vous pouvez également utiliser les données au niveau de la tâche. Orchestration crée les résultats de la tâche lors de la réception du nom et des données de résultat. Vous pouvez utiliser les résultats de tâche dans la tâche où vous avez reçu le résultat et dans toutes les tâches suivantes du flux de travail qui sont directement ou indirectement connectées à cette tâche. Orchestration fait la distinction entre :

  • Variables de résultat : résultats des tâches précédentes.

  • Variables de la tâche en cours : résultats de la tâche en cours.

Pour configurer une tâche, configurez les propriétés de la tâche, dont la plage diffère en fonction de la tâche. Avec les tâches API REST et Fonctions Azure, vous pouvez ajouter tous les types de variables comme valeurs aux propriétés de la tâche. Pour ajouter ou remplacer une valeur dans la propriété de la tâche, utilisez le champ Destination de l'onglet Mappage des résultats de la tâche API REST. Vous pouvez voir les propriétés de tâche dans les instances de flux de travail.

Remarque :

Si vous supprimez ou modifiez une variable d'un flux en libre-service, vous devez également supprimer ou modifier la variable dans le flux de travail d'Orchestration. Modifiez les tâches en aval telles que Démarrer l’automatisation qui utilise la variable supprimée ou modifiée, sinon le flux de travail se termine par une erreur pendant l'appel.



Types de variables