Utiliser le mode "replay" pour dépanner un flux d'architecture

Conditions préalables
  • Architecte > Instance de flux > Voir autorisation
  • Architecte > Instance de flux > Recherche autorisation

En mode "replay", vous pouvez voir ce qui s'est passé lors de l'exécution d'un flux, puis le dépanner et le déboguer.

Notes:

Cliquez sur l’image pour l’agrandir. Mode de relecture

Mode replay de l'architecte

  1. Depuis Architect la page d’accueil, cliquez ou planerz au-dessus de la Flux menu et sélectionnez le type préféré. flux
  2. Ouvrez le flux que vous avez précédemment exécuté et que vous souhaitez déboguer et dépanner. La page de configuration du flux s’ouvre.
  3. Si le flux s'ouvre en mode lecture seule, cliquez sur Historique d'exécution.
  4. Si le flux s'ouvre en mode édition, ccliquez sur la flèche vers le bas à côté de Sauvegardez et effectuez l'une des étapes suivantes :
    • Pour afficher l'historique d'exécution des versions précédentes du flux, sélectionnez Execution History dans la liste.
    • Pour passer en mode lecture seule, choisissez l'une des options suivantes :
      • Pour enregistrer votre travail en cours en tant que nouvelle version du flux, cliquez sur Check In puis sur Execution History.
      • Pour revenir à la version précédente du flux, cliquez sur Revert puis sur Execution History.
  5. Dans la liste Résultats de l'historique d'exécution du flux, cliquez sur l'instance de flux à rejouer. L'instance de flux s'ouvre en mode relecture.
    Cliquez sur l’image pour l’agrandir. Historique de l'exécution du flux en mode lecture

Pour une visite visuelle, voir la vidéo suivante :

Pour en savoir plus sur les fonctionnalités du mode de relecture, consultez les sections suivantes.

Pour déboguer une instance de flux, utilisez les commandes de relecture pour naviguer entre les éléments d'exécution du flux (actions, tâches ou menus) dans la chronologie de relecture au bas de la page. Les commandes vous permettent de revenir en arrière et d'avancer à n'importe quel point de l'historique de l'exécution du flux. Les actions de relecture sont disponibles dans la barre d'outils et via des raccourcis clavier personnalisables. Pour modifier les raccourcis clavier par défaut, cliquez sur Preferences.

Contrôles de relecture

Commande de relecture Description Raccourci clavier
Lecture ou pause

Rejouer l'instance de flux du début à la fin, ou mettre en pause la relecture. Pour sélectionner la vitesse de lecture, cliquez sur et sélectionnez la vitesse appropriée. Vous pouvez choisir entre Fast, Default, et Slow.

Remarque :  Si vous avez déjà parcouru plusieurs éléments, la commande play joue en avant à partir de l'élément d'exécution du flux sur lequel vous vous trouvez actuellement jusqu'à la fin ou jusqu'au point d'arrêt suivant si un point d'arrêt existe.

Contrôle + F7
Entrer  Avancez jusqu'à l'élément d'exécution de flux suivant etntervenez dans celui-ci pour suivre son exécution pas à pas. F11
Passer à l'étape suivante Passez à l'élément d'exécution de flux suivant et suivez son exécution sans montrer les étapes des composants. F10
Sortir À l'intérieur d'un élément d'exécution de flux, compléter toutes les étapes restantes en une seule étape pour passer à l'élément d'exécution de flux suivant. F9
Revenir en arrière  Revenez à l'élément d'exécution de flux précédent et entrez-y pour suivre son exécution étape par étape. Contrôle + F11
Reculez Revenir à l'élément d'exécution de flux précédent et suivre son exécution sans montrer les étapes des composants. La relecture de l'exécution s'arrête lorsqu'elle rencontre un point d'arrêt. Contrôle + F10
Reculez Revenir à l'élément d'exécution de flux précédent à partir de l'intérieur d'un élément d'exécution de flux. Contrôle + F9
Jouer jusqu'à la fin  Reprendre l'exécution du flux jusqu'au prochain point d'arrêt ou jusqu'à la fin. Contrôle + F6

Lecture à l'envers jusqu'au début

Jouer en arrière jusqu'au début du flux ou jusqu'à un point d'arrêt précédent si un point d'arrêt existe. Contrôle + F4
Définir ou effacer un point d'arrêt Insérez un point d'arrêt à l'endroit où vous souhaitez que la relecture de l'exécution du flux s'arrête. Supprimer un point d'arrêt précédemment défini.  
Sélectionner l'élément d'exécution Utilisez les flèches vers le haut et vers le bas pour naviguer entre les éléments d'exécution.  

Dans l'onglet de la chronologie du mode de relecture, au bas de la page, vous pouvez inspecter et déboguer tous les éléments d'exécution du flux, et naviguer entre eux. Les actions de relecture suivantes sont disponibles :

    • Cliquez sur l'élément d'exécution du flux (début du flux, action, tâche, menu ou fin du flux) que vous souhaitez inspecter. Architect affiche l'élément d'exécution du flux en mode relecture et le met en surbrillance en violet dans l'éditeur ou la zone de conception. Vous pouvez également utiliser les commandes de relecture pour naviguer entre les éléments. Pour plus d'informations, voir Utiliser les commandes de relecture.

      Cliquez sur l’image pour l’agrandir.

      Mettre en évidence l'élément d'exécution

    • Survolez l'élément d'exécution du flux que vous souhaitez inspecter. Architect affiche diverses informations en fonction de l'élément d'exécution que vous souhaitez inspecter :
      • Le flux a commencé : Architect affiche l'ID d'exécution du flux, la langue de départ du flux et l'heure de début du flux. L'ID d'exécution du flux est l'identifiant unique utilisé par Architect pour identifier une instance d'un flux qui s'est exécutée. Architect indique également si le flux s'est déroulé dans une session sécurisée ou s'il a été tronqué parce qu'il contenait plus de 4 500 actions.L'instance de flux est sécurisée
      • Flux terminé : Architect affiche l'heure de fin du flux et le motif de sortie.
      • Pour tout autre élément d'exécution, Architect affiche le nom et le type de l'action exécutée par le flux, l'heure d'exécution et l'ID d'exécution, l'ID d'exécution de la pile, le chemin de sortie suivi par le flux et l'ID d'action. L'identifiant d'exécution de la pile est un identifiant unique qui indique où se trouve l'élément d'exécution dans la pile d'exécution du flux. Vous pouvez copier la plupart de ces informations dans le presse-papiers. Cliquez sur pour copier.

        Cliquez sur l’image pour l’agrandir.Chronologie du mode de relecture

    • Pour ouvrir la boîte de dialogue Historique de l'exécution du flux, cliquez sur Historique de l'exécution. La boîte de dialogue vous donne accès à Query Builder et, par défaut, à la liste des instances de flux dont l'identifiant de flux correspond à l'identifiant de flux de l'instance de flux que vous êtes en train de visualiser. Vous pouvez exécuter une requête basée sur d'autres critères de flux, tels que le code d'erreur du flux, le code d'avertissement du flux, l'identifiant d'exécution de l'objet de flux invoqué ou l'erreur invoquée par le flux. Vous pouvez également interroger les données historiques par numéro de conversation, ce qui est utile lorsqu'il existe de nombreuses instances d'un même flux basé sur la conversation. Pour plus d'informations sur la création d'une requête d'exécution de flux, voir Créer une requête d'historique d'exécution de flux
    • Pour ouvrir le flux qui a invoqué le flux que vous visualisez en mode relecture, cliquez sur Open Invoking Flow. Cette option n'est disponible que si des données d'exécution historiques sont disponibles pour le flux qui l'invoque. La quantité de données affichées par Architect pour le flux d'invocation dépend du niveau des données d'exécution auquel Genesys Cloud a enregistré le flux d'invocation. Les types de données pris en charge varient en fonction du type de flux. Par exemple, vous ne pouvez pas voir de données de communication lorsque vous rejouez un flux de messages entrants, même si le niveau de données d'exécution auquel Genesys Cloud a enregistré le flux inclut généralement de telles données. Données non prises en charge pour le type de flux
    • Pour afficher ou masquer le graphique de la pile , cliquez sur .
    • Pour ajuster le niveau de zoom de la ligne de temps, de l'absence de zoom à petit, moyen et zoom complet , cliquez sur le menu déroulant Zoom.
    • Pour modifier les raccourcis clavier ou personnaliser l'affichage du mode relecture, cliquez sur Preferences.

    Vous pouvez rechercher différents types d'informations sur dans le champ Flux de recherche :
    • Architecte GUIDs
    • Actions, menus, états ou tâches spécifiques
    • Variables 

    Recherche de l'identifiant de l'action

    Vous pouvez utiliser divers opérateurs pour affiner votre recherche. Pour sélectionner un opérateur de recherche, cliquez sur et sélectionnez l'un des opérateurs suivants :

    • Contient = Architecte renvoie tous les résultats de recherche qui contiennent tous les caractères spécifiés.
    • Exact = Architect renvoie tous les résultats de la recherche qui match les caractères que vous spécifiez exactement.
    • Commence par = Architect renvoie tous les résultats de recherche qui commencent par les caractères que vous avez spécifiés.

    Le panneau Data indique les variables de flux de données returned as the flow ran, ainsi que leurs types de données.Exemple de panneau de données

    Remarques:
    • Architect displays arrow buttons next to variables whose value changes during flow execution. See the string type variable named Slot.FamilySize in the attached example.
    • You can set a breakpoint on such variables. To set a breakpoint, click the button that indicates the data type of the variable and select Set a breakpoint. For Slot.FamilySize, the letter A that precedes the variable name.
    • If the value of a variable of the JSON, string or collection data type exceeds the size limit that Genesys Cloud can store in execution data, Architect displays ValueTooLarge. Because encrypted values can be very long, Architect often shows values of variables used in Set Secured Data actions as ValueTooLarge.  
    • For variable values in secure flows (because Genesys only reports execution data for such flows at the Base level) and values of variables used in Architect actions for secured or encrypted data, Architect displays ValueRedacted.
    • Architects displays ValueInvalid for variables whose value was, for example, set by an expression or function that failed. For example, if a string value to be converted to a DateTime type was invalid, as in ToDateTime("2009-01-10T06:30:")

    Le panneau de communication permet de visualiser facilement l'ensemble du fil de communication qui s'est déroulé lors de l'exécution du flux. Vous pouvez configurer le panneau pour qu'il affiche soit toutes les communications, soit uniquement les communications relatives à l'élément d'exécution du flux actuellement sélectionné.

    Le panneau Communications permet de visualiser les interactions entre un flux et des participants externes. Par exemple, les échanges de messages entre un client et un robot de conversation.

    Cliquez sur l’image pour l’agrandir.

    Exemple de panneau de communication

    Le volet Stack l affiche les éléments d'exécution actuels dans la pile d'exécution du flux et leurs horodatages. Pour voir à quelle profondeur est imbriqué dans la pile d'exécution l'élément d'exécution du flux actuel, activez le graphique de la pile .
    Le panneau Frame Details vous montre les détails de l'action ou du menu sélectionné ou de l'élément d'exécution sur lequel vous vous trouvez actuellement dans la session de relecture : le nom et le type de l'action , ou quand elle s'est exécutée. Par exemple, vous pouvez voir les détails d'une action Décision dans l'exemple suivant :Exemple de détails de cadre 

    Utilisez la poignée de déplacement pour saisir un panneau et le déplacer vers le haut, le bas ou les côtés dans la liste des panneaux, selon que vous avez choisi d'afficher le panneau sur le côté ou en bas.Déplacer les panneaux en mode replay

    Pour passer de la langue par défaut du flux aux langues prises en charge, cliquez sur la flèche vers le bas à côté du filtre de langue et sélectionnez la langue préférée à afficher.

    Passer d'une langue à l'autre en mode lecture

    Pour travailler avec les ID d'éléments, suivez l'une des étapes suivantes :

    • Pour afficher ou masquer les numéros d'identification des éléments, cliquez sur Afficher ou masquer les numéros d'identification des actions, des menus, des tâches et des états.
    • Pour accéder à un élément spécifique, cliquez sur le menu déroulant , sélectionnez Aller à et choisissez l'identifiant approprié.

    Pour trouver les flux qui font référence au flux actuel et l'utilisent, cliquez sur Find consuming flows.

    Lorsque l'instance de flux que vous rejouez contient des données sécurisées, Architect affiche l'icône Icône clé. Pour rechercher des éléments d'exécution qui font référence à des données sécurisées, cliquez sur l'icône.

    Le flux contient des données sécurisées

    Lorsque vous rejouez une instance d'exécution de un flux bot qui a été invoqué par un flux d'appel sécurisé, Architect affiche une icône de verrouillage pour indiquer que l'instance de flux rejouée est sécurisée.Instance de flux sécurisée

    Architect affiche le niveau de données d'exécution que Genesys Cloud a utilisé pour stocker les données historiques de l'instance de flux.

    Dans l'exemple suivant, vous pouvez voir que Genesys Cloud a capturé des données d'exécution au moment de l'exécution du flux au niveau Base. Par conséquent, l'utilisateur ne peut pas accéder aux données des valeurs variables ou aux données de communication :

    Indicateur de niveau des données d'exécution

    Données de base

    Pour plus d'informations sur les données d'exécution historiques et les paramètres des données, voir Aperçu des données d'exécution historiques, Gérer les données d'exécution au niveau du flux, et Gérer les données d'exécution historiques.

    Pour exporter des données d'exécution ou de configuration de flux, cliquez sur Export et cliquez sur l'une des options suivantes :

    • Exporter les données d'exécution
    • Exporter en .i3xxx
    • Exporter en .yaml

    Pour plus d'informations sur l'accès au mode de relecture pour un flux spécifique via la console opérationnelle lorsqu'un événement est généré, voir Troubleshoot using the Genesys Cloud Operational Console.

    Pour personnaliser les raccourcis clavier, procédez comme suit :
    1. Cliquez sur Préférences.La boîte de dialogue Préférences apparaît.
    2. Sélectionner Raccourcis clavier.
    3. Utilisez le champ de recherche pour rechercher des raccourcis existants.
    4. Utilisez le champ Filter By pour réduire la liste des raccourcis clavier affichés :
      • Pour afficher les raccourcis clavier que vous pouvez utiliser pour effectuer des actions dans le flux, sélectionnez Flow.
      • Pour afficher les raccourcis clavier que vous pouvez utiliser pour ouvrir la vue Raccourcis clavier ou basculer la vue Aide à l'expression, sélectionnez Global.
      • Pour afficher les raccourcis clavier que vous pouvez utiliser pour les commandes de lecture, sélectionnez Replay.
    5. Pour importer des raccourcis, cliquez sur .
    6. Pour exporter des raccourcis, cliquez sur .
    7. Pour rétablir les raccourcis clavier par défaut, cliquez sur Reset to Defaults.
    8. (Facultatif) Vous pouvez définir des touches primaires et secondaires pour chaque raccourci.
    9. Cliquez sur Save pour enregistrer vos modifications ou sur Cancel pour les annuler.

    Pour personnaliser l'affichage du mode de relecture, procédez comme suit :

    1. Cliquez sur Préférences.La boîte de dialogue Préférences apparaît.
    2. Sélectionnez Replay Mode.
    3. Cliquez sur Show Values in Local pour utiliser le format d'affichage des valeurs que la langue locale dans laquelle le flux a été exécuté utilise de manière standard. Par exemple, afficher les valeurs décimales avec la virgule comme séparateur décimal si la langue locale est l'allemand , ou utiliser un format local d'affichage de la date et de l'heure au lieu de la norme ISO-8601 pour communiquer des données relatives à la date et à l'heure.
    4. Cliquez sur Show Stack Graph pour afficher un graphique indiquant les niveaux de la pile traversée par le flux.
    5. Sélectionnez le niveau de zoom de la ligne de temps dans la liste déroulante. Les valeurs possibles sont Zoom Off, Zoom Small, Zoom Medium, Zoom Full.
    6. Dans le menu déroulant Data , choisissez d'afficher ou non le panneau et, le cas échéant, de l'afficher en bas ou sur le côté.
    7. Dans le premier menu déroulant Communications, choisissez d'afficher ou non le panneau et, le cas échéant, de l'afficher en bas ou sur le côté.
    8. Dans le deuxième menu déroulant Communications, choisissez d'afficher les communications pour toutes les trames ou uniquement pour la trame en cours.
    9. Dans le menu déroulant Stack , choisissez d'afficher ou non le panneau et, le cas échéant, de l'afficher en bas ou sur le côté.
    10. Dans le menu déroulant Frame Details , choisissez d'afficher ou non le panneau et, le cas échéant, de l'afficher en bas ou sur le côté.

      Préférences du mode de relecture

      Pour plus d'informations, voir Utiliser les commandes de relecture