Appeler l'action de la table de décision

Fonctionnalité à venir : Décisions fondées sur des règles

Utilisez l'action Appeler la table de décision dans une tâche pour sélectionner et exécuter une table de décision basée sur des règles configurée précédemment par un administrateur dans Genesys Cloud. Lorsque vous appelez une table de décision, vous intégrez les schémas JSON d'entrée et de sortie associés dans le flux. Architect traite ces schémas JSON comme des types de données JSON personnalisés qui ne sont disponibles qu'avec l'action Appeler la table de décision. Cependant, après avoir ajouté une action Call Decision Table à votre flux, vous pouvez également utiliser le type de données JSON personnalisé avec une action Update Data

Decision tables allow administrators to define input and output criteria, and if the input values meet the set criteria, the decision table produces an output. Flow authors can call a decision table, define the input values, and then use the output JSON object that the decision table produces for further processing in the flow. For more information about decision tables, see About rule-based decisions.  

Note: Usage charges apply for rule-based decisions, metered for the number of times you invoke the execution API. For more information, see Rule-based decision pricing.

  1. Depuis Architect la page d’accueil, cliquez ou planerz au-dessus de la Flux menu et sélectionnez le type désiré. flux
  2. Créez un flux nouveau ou sélectionnez un nouveau. La page de configuration du flux s’ouvre.
  3. Sélectionnez la tâche et cliquez dessus pour l'ouvrir. L’éditeur tâche s’ouvre.
  4. Dans la boîte à outils de l'éditeur de tâches, développez la catégorie Data et faites glisser une action Call Decision Table à l'emplacement souhaité dans l'éditeur de tâches.
  5. Dans la case Name , saisissez un nom significatif pour l'action. Ce nom devient le nom de l'action Call Decision Table dans le flux de travail de la tâche.
  6. Dans la liste Decision Table, sélectionnez la table de décision souhaitée.
  7. En fonction du schéma de règles de la table de décision sélectionnée, définissez Input, Output, et Failure Outputs que l'action exécute au moment de l'exécution.
    Note: Les propriétés d'entrée qui apparaissent proviennent du schéma d'entrée créé pour la table de décision.
  8. Continuez à construire la tâche conformément à votre conception du flux, y compris les chemins Success et Failure de la table de décision d'appel.

Nom Description
Champ Nom Saisissez un nom distinctif pour l'action Table de décision d'appel. L’étiquette que vous entrez ici devient le nom de l’action affiché dans la séquence tâche.
Tableau de décision

Cliquez sur la flèche à la fin de cette liste et sélectionnez la table de décision appropriée. Pour affiner la sélection, tapez les premières lettres du tableau de décision approprié.

Vous pouvez sélectionner n'importe quelle table de décision publiée, quelle que soit la division à laquelle elle appartient. Toutefois, si votre table de décision possède un type de données de file d'attente, vous ne pouvez utiliser la file d'attente que dans les divisions concernées.

Entrée

Définir les valeurs d'entrée que l'action exécute au moment de l'exécution. Selon la manière dont un administrateur configure la table de décision dans Genesys Cloud, ces options varient et peuvent être facultatives.

Sélectionnez Standard ou JSON pour basculer entre les modes d'édition standard et JSON.

  • Standard: Permet de définir les valeurs d'entrée dans les champs de saisie fournis. Les champs qui apparaissent proviennent du schéma d'entrée créé pour la table de décision. 
  • JSON: Permet de définir les valeurs d'entrée directement à l'aide de propriétés JSON. Dans ce mode, vous pouvez accéder à l'éditeur JSON personnalisé d'Architect et à ses outils pour définir les valeurs d'entrée. L'éditeur affiche le type de schéma, s'il s'agit d'une entrée ou d'une sortie, et la table de décision. Pour plus d'informations sur l'utilisation de l'éditeur JSON personnalisé, voir Editeur JSON personnalisé pour l'architecture.

Les modes d'édition standard et JSON autorisent l'utilisation de littéraux et d'expressions comme valeurs d'entrée. Si vous n'avez pas défini une propriété et sa valeur en mode JSON, le champ correspondant en mode standard indique qu'aucune valeur n'est spécifiée. 

Remarques:

  • Architect conserve les valeurs existantes lorsque vous passez d'un mode d'édition à l'autre. S'il y a des erreurs de validation au moment du changement de mode, Architect vous avertit et vous propose de revenir aux valeurs valides précédentes ou d'annuler le changement de mode. 
  • Si les données JSON personnalisées ont une structure de valeur complexe telle que des collections, vous ne pouvez pas revenir au mode d'édition standard.
  • Le passage du mode littéral au mode expression pour l'ensemble de l'objet d'entrée réinitialise les données d'entrée. L'option permettant d'accéder à l'éditeur JSON personnalisé disparaît également en mode expression.
Sortie

Sélectionnez une variable existante ou saisissez-en une nouvelle pour affecter l'objet JSON renvoyé par la table de décision. 

Note: Architect attribue à la variable l'intégralité de l'objet JSON renvoyé par la table de décision, ce qui permet d'accéder aux valeurs JSON à l'aide de la notation par points. Par exemple, si vous avez nommé la variable Task.output, vous pouvez accéder aux valeurs contenues dans l'objet JSON de sortie en utilisant une action de mise à jour des données avec une expression de variable, Task.output.<JSON property name>.

Traitement des valeurs nulles

Le tableau suivant montre comment les valeurs nulles envoyées par Architect en tant qu'entrées sont validées pour les règles des tables de décision :

Valeur d'entrée en Architect Mode d'édition Valeur mappée dans les tables de décision
Aucune valeur Standard

Nul

Valeur littérale vierge

Note: Ceci ne s'applique qu'à un type de données de type chaîne de caractères.

  • Standard
  • JSON
Chaîne vide

Not_Set

  • Standard
  • JSON
Nul

Nul

  • Standard
  • JSON
Nul

L'action Call Decision Table prend en charge les types de données suivants pour les variables d'entrée et de sortie :
  • Types de données standard
    • Booléen: Une expression booléenne ne peut avoir que deux valeurs : true (vrai) ou false (faux). 
    • Date: Une valeur Date est une chaîne de caractères au format prescrit par la norme XML pour les données de date, similaire à la norme ISO 8601.
    • Date et heure: Une valeur DateTime est une chaîne de caractères au format prescrit par la norme XML pour les données de date, similaire à la norme ISO 8601. 
    • Enum: Une énumération est une liste prédéfinie d'options sélectionnables.
      Note: Architect gère nativement les valeurs Enum comme des chaînes de caractères. Lorsque vous définissez une valeur d'entrée Enum pour l'action Appeler la table de décision, vous devez utiliser la clé d'élément configurée sous Options Enum dans le schéma de règles utilisé par la table de décision. Ne pas utiliser l'étiquette de l'article. De même, si une règle correspond aux valeurs d'entrée, Architect renvoie la clé de l'élément dans la variable de sortie, si le résultat est de type Enum.
    • Entier: Un nombre entier est un nombre entier tel que 987 ou 5.
    • Numéro: Un nombre comprend toutes les valeurs numériques, y compris les décimales.
    • Chaîne: Il s'agit d'une chaîne de texte standard ou d'une série personnalisée de caractères alphabétiques, numériques et symboliques.
  • Types de données de la plate-forme
    • File d'attente: Les files d’attente sont les « En attente analyse de cause première» d’interactions. Dans Architect, une expression de file d'attente achemine un élément de travail vers une file d'attente éligible. Les files d'attente sont établies et configurées par l'administrateur de Genesys Cloud.

Nom Description
Sorties échouées

Ces sorties permettent à l'auteur du flux de mapper les résultats des variables errorType et errorMessage lorsque l'action de la table de décision d'appel emprunte la voie de l'échec. Les résultats des défaillances vous aident à anticiper les problèmes potentiels et à les gérer efficacement, améliorant ainsi la résilience de votre flux.

  • erreurType: Une chaîne non vide qui contient le type ou la catégorie de l'erreur.
  • Message d’erreur: Message d'erreur non localisé. La chaîne peut être vide ou NOT_SET.

Remarque : Survolez l'icône d'information à côté de errorType pour afficher la liste des valeurs de type d'erreur autorisées.

Sélectionnez les variables que vous souhaitez affecter aux valeurs des données d'échec renvoyées par l'action Table de décision des appels.

Vous pouvez utiliser les valeurs errorType suivantes :

  • ActionInvocationLimitExceeded: Si un flux a exécuté avec succès cinq fois l'action Call Decision Table, toutes les invocations ultérieures de l'action suivent le chemin de l'échec.
  • ExecutionOutOfCapacityError: When a flow executes a newly published or rarely used decision table, Genesys Cloud first prepares the decision table and optimizes it for use. Though this preparation process is typically very fast, an occasional error may occur for execution requests made during this phase. The error generally does not occur during normal production workloads.

    If this error occurs, the flow must simply retry the execution. It is recommended that you configure enough retries to handle it. After the decision table has been prepared, Architect will execute it without any issue.
  • GeneralExecutionError: Une erreur générale s'est produite pendant l'exécution. 
  • InvalidRequest: La demande n'a pas été formée correctement pour l'exécution. Par exemple, une erreur HTTP 400 s'est produite.

Remarque :Cliquez sur la flèche à côté de Échec des sorties et développer ou réduire la liste des variables.

Trajectoire Description
Opération réussie

Un chemin d’accès terminé indique que le système ne rencontre aucune erreur au cours du processus. Il ne s’agit pas de déterminer si le fonctionnalité système reçoit des données qui sont le résultat prévu ou.

Échec

Ce chemin indique qu'une erreur s'est produite lors de la tentative d'exécution de l'action ou qu'un problème s'est produit lors du traitement des résultats de l'action Appeler la table de décision. Faites glisser l'action appropriée sous le chemin de l'échec.