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 dont les modifications n’ont pas été enregistrées, Studio vous invite à enregistrer le script. Si vous avez des erreurs de compilation dans le script, Studio ne n’enregistrera pas. Vous devez résoudre les erreurs avant d’enregistrer le script et d’exécuter la trace.

1. Dans CXone Mpower, cliquez sur le sélecteur d’application et sélectionnezRoutage omnicanal > Studio .
2. Sur la page Scripts, localisez le script avec lequel vous voulez travailler et double-cliquez dessus pour l’ouvrir ou créez-en 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 passer des valeurs au script via des variables de paramètres, entrez 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 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 La personne qui interagit avec un agent, un IVR ou un robot dans votre centre d’appels. en direct. Cela vous permet de diagnostiquer des problèmes dans votre centre de contact ou de recueillir des données pour le soutien technique.

Si vous voulez tracer un numéro de téléphone spécifique, vous pouvez entrer un ANI Également connu sous le nom d’identification de l’appelant. Numéro de téléphone listé d’un appel entrant, ou d’un appel vocal entrant. ou un DNIS Le numéro composé lors d’appels vocaux entrants ou sortants.. 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. Sur la page Scripts, localisez le script avec lequel vous voulez travailler et double-cliquez dessus pour l’ouvrir ou créez-en un nouveau. Le script s’ouvre dans un nouvel onglet.

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

   Afficher l’image)

   

4. Entrez le nombre de contacts que vous voulez 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 entrez un numéro DNIS. Studio trace le nombre de contacts que vous avez entrés 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 entrés 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 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 plusieurs contacts en direct

Vous pouvez capturer des traces sur un script pendant son exécution lors du traitement de contacts La personne qui interagit avec un agent, un IVR ou un robot dans votre centre d’appels. en direct. Cela vous permet de diagnostiquer des problèmes dans votre centre de contact ou de recueillir des données pour le soutien 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 Également connu sous le nom d’identification de l’appelant. Numéro de téléphone listé d’un appel entrant, ou d’un appel vocal entrant. ou un DNIS Le numéro composé lors d’appels vocaux entrants ou sortants. pour filtrer les contacts, le script attend les contacts avec un numéro correspondant. Lorsque les interactions La conversation complète avec un agent sur un canal. Par exemple, une interaction peut être un appel vocal, un courriel, un clavardage ou une conversation sur les médias sociaux. 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. Sur la page Scripts, localisez le script avec lequel vous voulez travailler et double-cliquez dessus pour l’ouvrir ou créez-en un nouveau. Le script s’ouvre dans un nouvel onglet.

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

   Afficher l’image

   

4. Entrez 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 entrez un numéro DNIS. Studio trace le nombre de contacts que vous avez entrés 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 entrés 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 en JSON.

9. Double-cliquez sur un contact pour voir 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 retourner à 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 Exécute un processus au sein d’un script Studio, tel que la collecte de données sur les clients ou la diffusion de musique..

Au fur et à mesure que le script s'exécute, les actions s'affichent dans le tableau du 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. Sur la page Scripts, localisez le script avec lequel vous voulez travailler et double-cliquez dessus pour l’ouvrir ou créez-en un nouveau. Le script s’ouvre dans un nouvel onglet.

3. Commencer une seule trace ou trace sur plusieurs contacts La personne qui interagit avec un agent, un IVR ou un robot dans votre centre d’appels..

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.
   Nom du script	Le nom du script dans lequel se trouve l'action. Ceci est utile lors de l'exécution d'une trace sur des contacts en direct.
   Propriétés	Les propriétés de l'action et leurs valeurs quand l'action est déclenchée.
   Heure	L'horodatage du moment où l'action a été déclenchée.
   Résultat	Le résultat du déclenchement de l’action. 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, survolez une entrée dans la colonne Propriétés.

8. Double-cliquez sur une action sur le côté gauche de la fenêtre de sortie de trace pour voir où cette action apparaît dans le script. Le focus se déplace vers l'onglet du navigateur dans lequel le script approprié est ouvert. Si le script n'est pas ouvert, Studio l'ouvre. Studio centre le script sur l'action sur laquelle vous avez cliqué.

   Ça marche sur les traces en cours d'exécution ou déjà terminées. Ça fonctionne aussi sur les fichiers de trace de script qui ont été chargés dans Studio. Cependant, si l'action a été supprimée du script ou si le script n'existe pas dans les fichiers de votre système, Studio affiche une erreur.

   Pour utiliser cette option, vous devrez peut-être activer les fenêtres contextuelles dans votre navigateur pour l'URL CXone Mpower.

9. Cliquez sur la ligne d'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 du 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 trouver 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.

   • Cliquez sur un en-tête de colonne pour trier les variables en fonction de ces données.

     En savoir plus sur les champs dans cette étape

     Champ	Détails
     Nom	Le nom de la variable.
     Valeur	La valeur que contient la variable.
     Type	Le type de variable. Les types possibles sont Variable, UCN.Data.Dynamic, DynamicData, UCN.Data.RESTProxy, ainsi que tout type de données .NET. Les types de données .NET incluent String, Int32et Boolean.

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 aussi d'envoyer un fichier de trace à d'autres utilisateurs Studio ou à votre Représentant de compte. 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. Sur la page Scripts, localisez le script avec lequel vous voulez travailler et double-cliquez dessus pour l’ouvrir ou créez-en 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 à partir de 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.