Variables d’entrée et de sortie de script

Les variables chaîne, numériques et booléennes ont Contribution et Sortie Propriétés. Quand une variable est Contribution la propriété est Oui, sa valeur peut être définie par une source de données externe. Quand une variable est Sortie la propriété est Oui, sa valeur est enregistrée sur l’objet de conversation et peut être récupérée par programmation une fois l’appel terminé. Ces propriétés ne sont pas mutuellement exclusives. L’un ou les deux peuvent être activés pour une variable.

Les variables pour lesquelles ces propriétés sont activées sont appelées variables d’entrée, variables de sortie ou les deux. Voici comment comprendre ces termes :

Une variable est un multicanal si sa propriété Input est Yes. Sa valeur peut être entrée de une source externe, telle que Architect flux d ’ appels.
Une variable dont la propriété de sortie est Oui est un variable de sortie. Lorsque script est exécuté, toute valeur affectée à la variable est enregistrée pour une utilisation en dehors de script. Sa valeur est sortie vers stockage externe lors de l’exécution de script.
Comme les deux propriétés peuvent être définies sur Oui, une variable peut être à la fois une variable d'entrée et une variable de sortie.
Une variable Liste, lorsqu'elle est utilisée comme entrée, aura la valeur de la conversation séparée par une virgule.
Une variable Liste, lorsqu'elle est utilisée comme sortie, aura sa liste jointe par une virgule dans la conversation.

Vous ne pouvez pas utiliser de variables dynamiques en tant que variables d’entrée ou de sortie.

Pour les nouvelles variables, par défaut à la fois en entrée et en sortie. Si des scripts existants utilisent des variables, PureCloud définit l’entrée et la sortie sur Oui pour ces variables afin que les scripts soient compatibles avec les versions antérieures.

Propriété de sortie

le Sortie Cette propriété permet de stocker la valeur d’une variable script pour l’utiliser après la fin d’un appel, sans avoir à configurer une action de données, ou d’ajouter des colonnes supplémentaires à une liste de contacts. Lorsque Output est défini sur Yes, la valeur de cette variable script est écrite dans l’objet de conversation. Sa valeur sauvegardée peut être récupérée par programme par le processus externe du client. Pour utiliser une variable comme variable de sortie, activez Sortie. Lorsque la valeur de cette variable change pendant l’exécution d’un script, l’objet de conversation est mis à jour en 3 secondes.

Couples clé / valeur dans l’objet de conversation

Les variables sont écrites dans l’objet de conversation sous forme de paires clé / valeur. Vous pouvez les récupérer en utilisant les API de la plate-forme Terminaux de conversation. Interrogez l’objet d’attributs des participants de la conversation en utilisant le nom de la variable comme clé :

"participants": [
  {
    "attributes": {
      "scripterOutputVariable1": "value",
      "scripterOutputVariable2": "value"
    },
],

Si la variable est sortie uniquement, Genesys Cloud applique la valeur de cette variable au participant agent à moins qu'il ne voie ces données variables sur un autre participant ; dans ce cas, pour garder les données synchronisées, Genesys Cloud met à jour l'autre participant.
Si les valeurs d’entrée et de sortie sont vraies, script attache les données au participant sur lequel il a trouvé les données, qui est dans la plupart des cas le client. Sinon, l’emplacement par défaut est le participant de l’agent.

Par exemple, sila les données viennent de Architect à travers un multicanal, puisArchitect place le données variables surla client participant, et futures mises à jour àcette remplacement variable la valeur surla client participant.

Remarque : PureCloud ajoute des variables de sortie à v2 / conversations et non v2 / analytique / conversations.

FAQ sur les actions de données Variable de sortie

La méthode action de données externe pour l’enregistrement de données à partir de scripts convient aux clients qui doivent extraire des informations complexes, puis les acheminer vers une base de données via des procédures stockées. La propriété Output fournit un moyen plus simple de collecter les données sauvegarder dans un fichier script.

Lorsque Output est défini sur Oui, des variables chaîne, numériques ou booléennes sont écrites dans les conversations point de terminaison de l’API publique sous forme de paires clé / valeur pouvant être recherchées, extraites et corrélées facilement.
Les variables dynamiques et d’objet ne peuvent pas être stockées à l’aide de ce processus. Pour sauvegarder des données d’objet complexe ou des variables dynamiques, utilisez plutôt action de données.

Propriété d’entrée

le Contribution propriété indique si la valeur de cette variable peut être définie par une source externe, telle qu’un Architect flux d ’ appels. Définissez Entrée sur Oui pour toutes les variables pour lesquelles vous souhaitez recevoir des données entrantes. Lorsque Entrée est défini sur Non, la variable n’acceptera pas les valeurs externes, même si la source externe envoie une valeur. Pour utiliser une variable comme variable d’entrée, activez Entrée.

Données sécurisées du client

Paramètres de conversation de sortie pour Get Secure Data et Set Secure Data

Quand le Production option pour la variable est activée, la valeur de cette variable de script est écrite dans l'objet conversation. Le client peut récupérer par programme la valeur de la variable pour permettre la sortie de données sensibles lors des interactions avec le client. Assurez-vous de désactiver le Production option pour la variable afin que les données saisies dans cette variable ne soient pas utilisées de manière non sécurisée lors des interactions avec le client. Pour plus d'informations, voir Actions de script disponibles. Le Obtenez des données sécurisées et Définir les données sécurisées du Données sécurisées du client est le moyen correct d'interroger et de mettre à jour les données client sensibles. Pour plus d'informations, voir Action Obtenir des données sécurisées et Action Définir les données sécurisées.