Tracer et Déboguer les Scripts

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

Vous pouvez exécuter des traces de script pour vérifier l'absence de problèmes dans vos scripts. Elles vous permettent de voir les actions qui se déclenchent dans le script, ainsi que les variables présentes 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 à la suite.

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

Capturer une trace de script unique

Vous pouvez suivre les performances de votre script, lancer un script ou effectuer un appel de test avec l'outil Trace Output. Cet outil retrace le contact ou le script en cours d'exécution et affiche chaque Action qui s'est déclenchée, les variables qui sont créées et à quel moment, ainsi que les valeurs que ces variables contenaient à 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.

You can only capture a trace if the script is saved. If you attempt to capture a script trace on a script with unsaved changes, Studio prompts you to save the script. If you have compile errors in the script, Studio won't save the script. You must resolve errors before you can save the script and run the trace.

1. Dans NiCE CXone, cliquez sur le sélecteur d'application et sélectionnez Omnicanal Routing > 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 > Démarrer avec Trace.
4. Sélectionnez une ACD Compétence téléphonique entrante.
5. Pour transmettre des valeurs au script via les variables de paramètre, entrez les valeurs dans le champ Paramètres. Entrez une valeur par ligne. Les valeurs que vous entrez sont associées aux paramètres P1 à Pn, où n correspond au numéro de la dernière valeur de paramètre que vous ajoutez.
6. Pour simuler une interaction pour un script d'Appel entrant téléphonique, 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 se déclenche.
8. Utilisez les Options de la fenêtre de sortie de trace pour examiner la trace.
9. To save the trace output to your computer: 
   1. Cliquez sur les points de suspension dans le coin supérieur droit de la fenêtre, puis 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 mettre fin à la trace sans mettre fin à l'interaction sur le serveur, cliquez sur Detach.
11. Pour mettre fin à la fois à la trace et à l'interaction, cliquez sur Terminer, puis
12. Cliquez sur OK pour confirmer. Cela met fin à l'interaction sur le serveur et déconnecte le contact ou met fin au script en cours.

Capturer les traces sur les Contacts en direct

Vous pouvez capturer une trace sur un script pendant son exécution, lors du traitement des contacts La personne qui interagit avec un agent, un SRVI 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 souhaitez tracer un numéro DE téléphone spécifique, vous pouvez entrer un ANI Aussi connu sous le nom d’id de l’appelant. numéro de téléphone listé d’un appel entrant, ou d’un appel vocal entrant. ou DNIS Le numéro composé lors des appels vocaux entrants ou sortants.. Studio trace uniquement les contacts possédant ce numéro.

1. Dans NiCE CXone, cliquez sur le sélecteur d'application et sélectionnez Omnicanal Routing > 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.

4. Entrez le Nombre de contacts que vous souhaitez tracer.
5. Under Filters, select an option: 
   • Aucun : trace le nombre de contacts que vous avez saisi, à compter de la prochaine exécution de ce script.
   • DNIS : Sélectionnez cette option et entrez un DNIS Le numéro composé lors des appels vocaux entrants ou sortants.. Studio trace le nombre spécifié de contacts ayant un DNIS correspondant.
   • ANI : Sélectionnez cette option et entrez un ANI Aussi connu sous le nom d’id de l’appelant. numéro de téléphone listé d’un appel entrant, ou d’un appel vocal entrant. . Studio retrace le nombre spécifié de contacts ayant un ANI correspondant.
6. Cliquez sur Démarrer la capture. La fenêtre de sortie de la 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. To save the trace output to your computer: 
   1. Cliquez sur l'ellipse 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 mettre fin au traçage sans terminer l'interaction sur le serveur, cliquez sur Détacher.
10. Pour mettre fin à la fois à la trace et à l'interaction, cliquez sur Terminer, puis cliquez sur ok pour confirmer. Cette action met fin à l'interaction sur le serveur et déconnecte le contact ou termine le script en cours.

Capturer les traces sur plusieurs Contacts en direct

Vous pouvez capturer des traces sur un script pendant son exécution lors du traitement des contacts La personne qui interagit avec un agent, un SRVI ou un robot dans votre centre d’appels. en direct. Cela vous permet de diagnostiquer des problèmes dans votre centre de contacts 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 des traces multiples s'ouvre et attend l'exécution du script Aussi connu sous le nom d’id de l’appelant. numéro de téléphone listé d’un appel entrant, ou d’un appel vocal entrant. avec des contacts en direct. Si vous avez spécifié un ANI Aussi connu sous le nom d’id 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 des appels vocaux entrants ou sortants. pour filtrer les contacts, le script attend des contacts avec un numéro correspondant. Au fur et à mesure que 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 réseaux sociaux. commencent, des entrées pour chaque contact apparaissent dans la fenêtre des traces multiples, jusqu'au nombre que vous avez spécifié. L'état dans le coin supérieur gauche de la fenêtre indique le nombre de traces en cours ou terminées, ainsi que le nombre de celles qui attendent encore des contacts pour démarrer.

1. Dans NiCE CXone, cliquez sur le sélecteur d'application et sélectionnez Omnicanal Routing > 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. Entrez le nombre de contacts que vous souhaitez tracer, de 1 à 20.
5. Under Filters, select an option: 
   • Aucun : Trace le nombre de contacts que vous avez saisi, à partir de la prochaine exécution de ce script.
   • DNIS : Sélectionnez cette option et entrez un numéro DNIS. Studio indique le nombre de contacts que vous avez saisis qui ont ce DNIS.
   • ANI : Sélectionnez cette option et entrée un numéro ANI. Studio suit le nombre de contacts que vous avez entrés qui ont un ANI correspondant.

6. Cliquez sur Démarrer la capture. La fenêtre des traces multiples s'ouvre. La fenêtre est vide jusqu'à ce que le script commence à s'exécuter pour un contact.Des Informations sur chaque contact apparaissent dans le tableau de la fenêtre. Ne fermez pas cette fenêtre avant d'avoir terminé de travailler avec les traces. La trace des données n'est pas sauvegardée automatiquement.

7. To filter contacts to locate the one you want to view: 
   • Cliquez sur le bouton situé à côté de Close All et sélectionnez une option. Vous pouvez choisir parmi All, Terminé, Running, Erreur ou Detached.
   • Utilisez la barre de recherche. Elle effectue une recherche dans toutes les colonnes à l'exception de la colonne état.

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

   En savoir plus sur les champs de cette étape

   Champ	Détails
   Détacher du contact	Termine la trace sans mettre fin au contact ou à l'interaction.
   Mettre fin au contact	Mettez fin à la fois à la trace et à l'interaction. Cette instance du script est arrêtée sur le serveur. Ceci 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 Back to All Traces dans le coin supérieur gauche pour revenir à la fenêtre des traces multiples.

Voir la Sortie 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 dans un script Studio, comme la collecte de données clients ou la lecture de musique..

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

1. Dans NiCE CXone, cliquez sur le sélecteur d'application et sélectionnez Omnicanal Routing > 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émarrez une trace unique ou une trace sur plusieurs contacts La personne qui interagit avec un agent, un SRVI 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 des traces multiples pour ouvrir la fenêtre de sortie de trace.

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

6. Cliquez sur n'importe quel en-tête de colonne pour trier la liste selon cette donnée.

   En savoir plus sur les champs de cette étape

   Champ	Détails
   Nom	Le nom de l'Action dans le script qui s'est déclenchée.
   Nom du script	Nom du script dans lequel se trouve l'Action. Cette information est utile lors de l'exécution d'une analyse sur des contacts en direct.
   Propriétés	Les propriétés de l'action et leurs valeurs au moment où l'action s'est déclenchée.
   Heure	L'estampille temporelle indiquant lorsque l'action s'est 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 taken, telle que 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. Continuer (#), où le chiffre entre parenthèses indique la branche qui a été suivie.

7. Pour afficher davantage d'informations sur les propriétés d'une action et leurs valeurs, placez le curseur sur une entrée dans la colonne Propriétés.

8. Double-clic sur une action à 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 où 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é.

   Cela fonctionne sur les traces en cours d'exécution ou déjà terminées. Cela fonctionne également sur les fichiers de trace de script qui ont été chargés dans Studio. Toutefois, 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 NiCE CXone.

9. Click an action's row in the trace output to see all variables and their values in the script at the time that the action fired.  

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

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

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

     En savoir plus sur les champs de cette étape

     Champ	Détails
     Global	Les variables globales peuvent être transmises des sous-scripts vers le script appelant.
     Système	Les variables système sont prédéfinies et ajoutées automatiquement aux Scripts lors de l'exécution d'un script.
     Privé	Les variables privées sont uniquement disponibles pour être utilisées par le script au sein de l'Action dans laquelle elles sont créées.

   • Utilisez la barre de recherche pour trouver des variables par nom ou par valeur.
   • Cliquez sur le symbole supérieur à > situé à côté du nom d'un objet de données dynamiques pour le développer et afficher ses membres ainsi que leurs valeurs.
   • Double-cliquez sur une variable pour afficher sa valeur dans une fenêtre contextuelle.
   • Copiez la valeur d'une 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.
   • Cliquez sur le signe plus à droite d'une variable pour l'ajouter à la liste de surveillance des variables. Le signe plus est uniquement visible lorsque le curseur le survole.
   • Cliquez sur la coche à côté d'une variable pour la supprimer de la liste de surveillance des variables.
   • Utilisez les touches fléchées pour parcourir la ligne surlignée dans la liste des variables.

   • Cliquez sur un en-tête de colonne pour trier les variables selon cette donnée.

     En savoir plus sur les champs de cette étape

     Champ	Détails
     Nom	Le nom de la variable.
     Valeur	La valeur contenue par 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, Int32 et Boolean.

Télécharger les Fichiers Trace

Vous pouvez sauvegarder la sortie de trace en tant que fichier que vous pouvez télécharger sur votre ordinateur. Cela est utile si vous devez consulter une trace ultérieurement. Cela vous permet également d'envoyer un fichier de trace à d'autres utilisateurs Studio ou à votre représentant de compte. Les fichiers peuvent être vus en les chargeant dans Studio. Les Fichiers sont sauvegardés au format JSON avec une extension TRC.JSON.

1. Dans NiCE CXone, cliquez sur le sélecteur d'application et sélectionnez Omnicanal Routing > 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 Start with Trace ou Capturer les Contacts en direct.
4. Une fois la trace capturée, cliquez sur l'ellipse 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. Précisez un Nom du fichier et l'emplacement où vous souhaitez enregistrer le fichier.
7. Cliquez sur enregistrer.

Charger les Fichiers Trace

Vous pouvez charger un fichier de trace sauvegardé dans Studio pour l'afficher. Vous pouvez uniquement charger des 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 cette application.

1. Dans NiCE CXone, cliquez sur le sélecteur d'application et sélectionnez Omnicanal Routing > Studio .
2. Sur la Page Scripts, cliquez sur Load et sélectionnez Load trace file.
3. Faire glisser un fichier Trace sur la fenêtre Load Trace ou cliquez sur browse for files pour en sélectionner un.
4. Cliquez sur Open dans la fenêtre Load Trace. La trace s'ouvre dans une fenêtre de sortie de trace.