Tracer et déboguer des scripts

Autorisations requises : ACD > Studio > Scripts > Débogage

Vous pouvez exécuter des traces de script pour vérifier les problèmes dans vos scripts. Ils vous permettent de voir les actions qui se déclenchent dans le script et les variables qui se trouvent dans le script au moment où chaque action se déclenche.

Chaque trace s'ouvre dans une fenêtre distincte. Cela signifie que vous pouvez conserver les traces précédentes ouvertes pour les comparer aux nouvelles, ou capturer plusieurs contacts en direct d'affilée.

Studio ne conserve pas l'historique des traces que vous avez capturées. Si vous pensez que vous pourriez avoir besoin de vous référer à une trace précédente, gardez la fenêtre de sortie de trace ouverte ou téléchargez le fichier de trace sur votre ordinateur.

Capturer une seule trace de script

Vous pouvez suivre les performances de votre script, générer un script ou effectuer un appel de test avec l'outil Trace Output. Cet outil trace le contact ou le script en cours d'exécution et affiche chaque action déclenchée, les variables créées et quand, ainsi que les valeurs détenues par les variables à chaque point. Il s'agit d'un outil utile pour tester et déboguer vos scripts. Vous pouvez exécuter des traces sur des interactions en direct ou simulées.

Vous ne pouvez capturer une trace que si le script est enregistré. Si vous tentez de capturer une trace de script sur un script comportant des modifications non enregistrées, Studio vous invite à enregistrer le script. Si le script contient des erreurs de compilation, Studio ne l’enregistrera pas Vous devez résoudre les erreurs avant de pouvoir enregistrer le script et exécuter la trace.

1. Dans CXone Mpower, cliquez sur le sélecteur d'application et sélectionnezRoutage omnicanal > Studio .
2. Dans la page Scripts, localisez et double-cliquez pour ouvrir le script avec lequel vous souhaitez travailler avec ou pour en créer un nouveau. Le script s’ouvre dans un nouvel onglet.
3. Cliquez sur Trace > Commencer avec Trace.
4. Sélectionnez un téléphone entrant ACD Compétence.
5. Pour transmettre des valeurs au script via des variables de paramètres, saisissez les valeurs dans le champ Paramètres. Entrez une valeur par ligne. Les valeurs que vous saisissez correspondent aux paramètres P1 à Pn, où n est le numéro de la dernière valeur de paramètre que vous ajoutez.
6. Pour simuler une interaction pour un script téléphonique entrant, cliquez sur Simuler un appel entrant et fournissez les informations nécessaires.
7. Cliquez sur Démarrer la capture. La fenêtre de sortie de trace s'ouvre. La fenêtre reste vide jusqu'à ce que la première action du script soit déclenchée.
8. Utilisez les options de la fenêtre de sortie de trace pour examiner la trace.
9. Pour enregistrer la sortie de trace sur votre ordinateur :
   1. Cliquez sur les points de suspension dans le coin supérieur droit de la fenêtre et sélectionnez Télécharger le fichier de trace.
   2. Choisissez un emplacement et un nom pour le fichier.
   3. Cliquez sur Enregistrer.
10. Pour terminer la trace sans mettre fin à l'interaction sur le serveur, cliquez sur Détacher.
11. Pour mettre fin à la fois à la trace et à l'interaction, cliquez sur Terminer, puis cliquez sur OK pour confirmer. Cela met fin à l'interaction sur le serveur et déconnecte le contact ou termine le script en cours.

Capturer des traces sur des contacts en direct

Vous pouvez capturer une trace sur un script pendant son exécution lors du traitement de contacts The person interacting with an agent, IVR, or bot in your contact center. en direct. Cela vous permet de diagnostiquer des problèmes dans votre centre de contact ou de collecter des données pour le support technique.

Si vous souhaitez tracer un numéro de téléphone spécifique, vous pouvez saisir un ANI Also known as caller ID. Listed phone number of an incoming voice call. ou un DNIS The number dialed on inbound or outbound voice calls.. Studio ne trace que les contacts avec ce numéro.

1. Dans CXone Mpower, cliquez sur le sélecteur d'application et sélectionnezRoutage omnicanal > Studio .
2. Dans la page Scripts, localisez et double-cliquez pour ouvrir le script avec lequel vous souhaitez travailler avec ou pour en créer un nouveau. Le script s’ouvre dans un nouvel onglet.

3. Cliquez sur Trace > Capturer les contacts en direct.

   Voir l’image

   

4. Saisissez le nombre de contacts que vous souhaitez suivre.
5. Sous Filtres, sélectionnez une option :
   • Aucun : suit le nombre de contacts que vous avez saisis, à compter de la prochaine exécution de ce script.
   • DNIS : sélectionnez cette option et saisissez un numéro DNIS. Studio trace le nombre de contacts que vous avez saisis et qui ont ce DNIS.
   • ANI : sélectionnez cette option et entrez un numéro ANI. Studio trace le nombre de contacts que vous avez saisis et qui ont un ANI correspondant.
6. Cliquez sur Démarrer la capture. La fenêtre de sortie de trace s'ouvre. La fenêtre reste vide jusqu'à ce qu'une instance du script correspondant à l'option Filtre sélectionnée commence à s'exécuter.
7. Utilisez les options de la fenêtre de sortie de trace pour examiner la trace.
8. Pour enregistrer la sortie de trace sur votre ordinateur :
   1. Cliquez sur les points de suspension dans le coin supérieur droit de la fenêtre et sélectionnez Télécharger le fichier de trace.
   2. Choisissez un emplacement et un nom pour le fichier.
   3. Cliquez sur Enregistrer.
9. Pour terminer la trace sans mettre fin à l'interaction sur le serveur, cliquez sur Détacher.
10. Pour mettre fin à la fois à la trace et à l'interaction, cliquez sur Terminer, puis sur OK pour confirmer. Cela met fin à l'interaction sur le serveur et déconnecte le contact ou termine le script en cours.

Capturer des traces sur plusieurs contacts en direct

Vous pouvez capturer des traces sur un script pendant son exécution lors du traitement de contacts The person interacting with an agent, IVR, or bot in your contact center. en direct. Cela vous permet de diagnostiquer des problèmes dans votre centre de contact ou de collecter des données pour le support technique.

Vous pouvez démarrer des traces pour un maximum de 20 contacts à la fois. La fenêtre de traces multiples s'ouvre et attend que le script s'exécute avec des contacts en direct. Si vous avez spécifié un ANI Also known as caller ID. Listed phone number of an incoming voice call. ou un DNIS The number dialed on inbound or outbound voice calls. pour filtrer les contacts, le script attend les contacts avec un numéro correspondant. Lorsque les interactions The full conversation with an agent through a channel. For example, an interaction can be a voice call, email, chat, or social media conversation. commencent, les entrées pour chaque contact apparaissent dans la fenêtre de traces multiples, jusqu'au nombre que vous avez spécifié. L'état dans le coin supérieur gauche de la fenêtre indique combien de traces sont en cours ou terminées, et combien attendent encore que les contacts démarrent.

1. Dans CXone Mpower, cliquez sur le sélecteur d'application et sélectionnezRoutage omnicanal > Studio .
2. Dans la page Scripts, localisez et double-cliquez pour ouvrir le script avec lequel vous souhaitez travailler avec ou pour en créer un nouveau. Le script s’ouvre dans un nouvel onglet.

3. Cliquez sur Trace > Capturer les contacts en direct.

   Voir l’image

   

4. Saisissez le nombre de contacts que vous souhaitez suivre, de 1 à 20.
5. Sous Filtres, sélectionnez une option :
   • Aucun : suit le nombre de contacts que vous avez saisis, à compter de la prochaine exécution de ce script.
   • DNIS : sélectionnez cette option et saisissez un numéro DNIS. Studio trace le nombre de contacts que vous avez saisis et qui ont ce DNIS.
   • ANI : sélectionnez cette option et entrez un numéro ANI. Studio trace le nombre de contacts que vous avez saisis et qui ont un ANI correspondant.

6. Cliquez sur Démarrer la capture. La fenêtre de traces multiples s'ouvre. La fenêtre est vide jusqu'à ce que le script commence à s'exécuter pour un contact. Les informations sur chaque contact apparaissent dans le tableau de la fenêtre. Ne fermez pas cette fenêtre tant que vous n'avez pas fini de travailler avec les traces. Les données de trace ne sont pas enregistrées automatiquement.

7. Pour filtrer les contacts afin de localiser celui que vous souhaitez afficher :
   • Cliquez sur le bouton à côté de Fermer tout et sélectionnez une option. Vous pouvez choisir entre Tout, Terminé, En cours d'exécution, Erreur ou Détaché.
   • Utilisez la barre de recherche. Il recherche toutes les colonnes sauf Statut.

8. Dans la fenêtre de traces multiples, cliquez sur les trois points à côté de l'un des contacts et choisissez une option pour la trace de ce contact.

   En savoir plus sur les champs de cette étape

   Champ	Détails
   Se détacher du contact	Termine la trace sans mettre fin au contact ou à l'interaction.
   Mettre fin au contact	Met fin à la fois à la trace et à l'interaction. Cette instance du script est terminée sur le serveur. Cela met fin à l'interaction, ce qui déconnectera le contact en direct de votre centre de contact.
   Télécharger le fichier de trace	Téléchargez une copie du fichier de trace sur votre ordinateur au format JSON.

9. Double-cliquez sur un contact pour afficher sa sortie de trace.
10. Utilisez les options de la fenêtre de sortie de trace pour examiner la trace.
11. Cliquez sur Retour aux contacts pour revenir à la fenêtre de traces multiples.

Afficher la sortie de trace

Lorsque vous exécutez une trace, la sortie apparaît dans la fenêtre sortie de trace. Vous pouvez utiliser cette fenêtre pour visualiser les variables du script et voir comment elles changent au fur et à mesure que le script progresse dans chaque action Performs a process within a Studio script, such as collecting customer data or playing music..

Au fur et à mesure que le script s'exécute, les actions s'affichent dans le tableau sur le côté gauche de la fenêtre de sortie de trace dans l'ordre dans lequel elles se déclenchent. Vous pouvez voir le nom de l'action, ses propriétés et leurs configurations, l'heure à laquelle l'action a été déclenchée et le résultat.

1. Dans CXone Mpower, cliquez sur le sélecteur d'application et sélectionnezRoutage omnicanal > Studio .
2. Dans la page Scripts, localisez et double-cliquez pour ouvrir le script avec lequel vous souhaitez travailler avec ou pour en créer un nouveau. Le script s’ouvre dans un nouvel onglet.

3. Démarrer une trace unique ou une trace sur plusieurs contacts The person interacting with an agent, IVR, or bot in your contact center..

4. Si vous avez démarré une trace sur plusieurs contacts, double-cliquez sur un contact dans la fenêtre de traces multiples pour ouvrir la fenêtre de sortie de trace.

5. Utilisez la barre de recherche au-dessus du tableau des actions pour rechercher des actions par nom, nom ou valeur de propriété, heure ou résultat.

6. Cliquez sur n’importe quel en-tête de colonne pour trier la liste en fonction de ces données.

   En savoir plus sur les champs de cette étape

   Champ	Détails
   Nom	Le nom de l'action dans le script qui a été déclenchée.
   Propriétés	Les propriétés de l'action et leurs valeurs lorsqu'elle est déclenchée.
   Heure	L'horodatage du moment où l'action a été déclenchée.
   Résultat	Le résultat de l'action qui s'est déclenchée. Le résultat peut être des messages tels que : La branche qui a été prise, comme Default ou Error. StartAt ONRELEASE indique à que le script est actuellement en attente et qu'il redémarrera lorsqu'un agent répondra à l'interaction. Continue (#), où le nombre entre parenthèses indique la branche qui a été prise.

7. Pour voir plus d'informations sur les propriétés d'une action et leurs valeurs, passez la souris sur une entrée dans la colonne Propriétés.

8. Cliquez sur une action dans la sortie de trace pour voir toutes les variables et leurs valeurs dans le script au moment où l'action a été déclenchée.  

   Les variables apparaissent dans la liste sur le côté droit de la fenêtre de sortie de trace. Les variables nouvelles ou modifiées sont affichées en rouge. Dans la liste des variables, vous pouvez :

   • Survolez les entrées pour afficher le contenu complet de cette variable ou de cette valeur dans une fenêtre contextuelle.

   • Sélectionnez ou décochez Global, Système ou Privé pour filtrer les variables dans la liste.

     En savoir plus sur les champs dans cette étape

     Champ	Détails
     Global	Les variables globales peuvent être transmises des indices au script appelant.
     Système	Les variables système sont prédéfinies et ajoutées automatiquement aux scripts lors de leur exécution.
     Privé	Les variables privées ne peuvent être utilisées par le script que dans l'action d'où elles proviennent.

   • Utilisez la barre de recherche pour rechercher des variables par nom ou par valeur.
   • Cliquez sur le symbole supérieur à > à côté du nom d'un objet de données dynamique pour le développer et voir ses membres et leurs valeurs.
   • Double-cliquez sur une variable pour afficher sa valeur dans une fenêtre contextuelle.
   • Copiez une valeur de variable en cliquant sur sa ligne et en appuyant sur CTRL + C. L'arrière-plan de la cellule devient brièvement bleu foncé pour indiquer que la copie a réussi.
   • Utilisez les touches fléchées pour vous déplacer dans la ligne en surbrillance dans la liste des variables.

Télécharger les fichiers de trace

Vous pouvez enregistrer la sortie de trace sous forme de fichier que vous pouvez télécharger sur votre ordinateur. Ceci est utile si vous devez vous référer à une trace ultérieurement. Il vous permet également d'envoyer un fichier de trace à d'autres Studio utilisateurs ou à votre Account Representative. Les fichiers peuvent être visualisés en les chargeant dans Studio. Les fichiers sont enregistrés au format JSON avec une extension TRC.JSON.

1. Dans CXone Mpower, cliquez sur le sélecteur d'application et sélectionnezRoutage omnicanal > Studio .
2. Dans la page Scripts, localisez et double-cliquez pour ouvrir le script avec lequel vous souhaitez travailler avec ou pour en créer un nouveau. Le script s’ouvre dans un nouvel onglet.
3. Cliquez sur Trace et sélectionnez Commencer par Traceou Capturer les contacts en direct.
4. Une fois la trace capturée, cliquez sur les points de suspension dans le coin supérieur droit de la fenêtre de sortie de la trace.
5. Sélectionnez Télécharger le fichier de trace.
6. Spécifiez un nom de fichier et l’endroit où vous souhaitez enregistrer le fichier.
7. Cliquez sur Enregistrer.

Charger les fichiers de trace

Vous pouvez charger un fichier de trace enregistré dans Studio pour le visualiser. Vous ne pouvez charger que les fichiers de trace téléchargés depuis Studio. Les fichiers de trace téléchargés depuis Desktop Studio doivent être chargés dans ce application.

1. Dans CXone Mpower, cliquez sur le sélecteur d'application et sélectionnezRoutage omnicanal > Studio .
2. Sur la page Scripts, cliquez sur Charger et sélectionnez Charger le fichier de trace.
3. Faites glisser un fichier de trace sur la fenêtre Charger la trace ou cliquez sur Parcourir les fichiers pour en sélectionner un.
4. Cliquez sur Ouvrir dans la fenêtre Trace de chargement. La trace s'ouvre dans une fenêtre de sortie de trace.