Tracer et Déboguer les Scripts

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

Vous pouvez exécuter des traces de script pour vérifier la présence 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 garder 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, conservez la fenêtre de sortie de la trace ouverte ou téléchargez le fichier de trace sur votre ordinateur.

Capturer une trace de Script unique

Vous pouvez suivre la performance de votre script, générer un script, ou effectuer un appel 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, quelles variables sont créées et à quel moment, ainsi que les valeurs que les variables contenaient à chaque point. Cet outil est utile pour tester et déboguer vos scripts. Vous pouvez exécuter des traces sur des interactions en direct ou des interactions simulées.

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

1. Dans NiCE CXone, cliquez sur le sélecteur d'applications et sélectionnez Omnicanal Routing > Studio .
2. Sur la page Scripts, repérez et double-cliquez pour ouvrir le script que vous voulez utiliser ou créez-en un nouveau. Le script s'ouvre dans un nouvel onglet.
3. Cliquez sur Trace > Démarrer avec Trace.
4. Sélectionnez un ACD Compétence de téléphone entrant.
5. Pour transmettre des valeurs au script par l'intermédiaire de variables de paramètre, entrez les valeurs dans le champ Paramètres. Entrez une valeur par ligne. Les valeurs que vous entrez correspondent aux Paramètres P1 à Pn, où n est le nombre de la dernière valeur de paramètre que vous ajoutez.
6. Pour simuler une interaction pour un script de téléphone 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 la 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 la trace pour examiner la trace.
9. To save the trace output to your computer: 
   1. Cliquez sur l'ellipse 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 Détacher.
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 les problèmes dans votre centre de contacts ou de recueillir des données pour le soutien technique.

Si vous voulez tracer un numéro de téléphone en particulier, 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 un DNIS Le numéro composé lors des appels vocaux entrants ou sortants.. Studio trace uniquement les contacts ayant ce numéro.

1. Dans NiCE CXone, cliquez sur le sélecteur d'applications et sélectionnez Omnicanal Routing > Studio .
2. Sur la page Scripts, repérez et double-cliquez pour ouvrir le script que vous voulez utiliser ou créez-en 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 voulez tracer.
5. Under Filters, select an option: 
   • None (Aucun) : Trace le nombre de contacts que vous avez entré, en commençant la prochaine fois que ce script s'exécute.
   • DNIS : Sélectionnez cette option et entrez un DNIS Le numéro composé lors des appels vocaux entrants ou sortants.. Studio trace le nombre de contacts spécifié qui ont 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 trace le nombre de contacts spécifié qui ont 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 la 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, puis 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 à 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 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 des traces sur plusieurs Contacts en direct

Vous pouvez capturer des traces sur un script pendant qu'il s'exécute lors du traitement de 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 que le script s'exécute 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 les contacts ayant 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 combien de traces sont en cours ou terminées, et combien attendent encore que des contacts démarrent.

1. Dans NiCE CXone, cliquez sur le sélecteur d'applications et sélectionnez Omnicanal Routing > Studio .
2. Sur la page Scripts, repérez et double-cliquez pour ouvrir le script que vous voulez utiliser ou créez-en un nouveau. Le script s'ouvre dans un nouvel onglet.

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

   Visualiser l’image

   

4. Entrez le Nombre de contacts que vous souhaitez tracer, de 1 à 20.
5. Under Filters, select an option: 
   • None (Aucun) : Trace le nombre de contacts que vous avez entré, en commençant la prochaine fois que ce script s'exécute.
   • DNIS : Sélectionnez cette option et entrez un numéro DNIS. Studio trace le nombre de contacts que vous avez entré 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é 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. 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 terminé de travailler avec les traces. Les données de trace ne sont pas sauvegardées automatiquement.

7. To filter contacts to locate the one you want to view: 
   • Cliquez sur le bouton à côté de Fermer tout et sélectionnez une option. Vous pouvez choisir parmi All (Tout), Terminé, Running (en cours d'exécution), Erreur, ou Detached (Détaché).
   • Utilisez la barre de recherche. Elle effectue une recherche dans toutes les colonnes sauf État.

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

   Apprenez-en davantage sur les champs dans cette étape

   Champ	Détails
   Détacher du contact	Met fin à 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-clic sur un contact pour afficher sa sortie de trace.
10. Utilisez les options dans la fenêtre de sortie de trace pour examiner la trace.
11. Cliquez sur Retour à toutes les traces dans le coin supérieur gauche pour retourner à la fenêtre des traces multiples.

afficher la Sortie de trace

Lorsque vous exécutez une trace, la sortie apparaît dans la fenêtre trace output. Vous pouvez utiliser cette fenêtre pour visualiser les variables dans le script et voir comment elles changent à 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..

Pendant l'exécution du script, les actions s'affichent dans le tableau situé du 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 de déclenchement de l'action, ainsi que le résultat.

1. Dans NiCE CXone, cliquez sur le sélecteur d'applications et sélectionnez Omnicanal Routing > Studio .
2. Sur la page Scripts, repérez et double-cliquez pour ouvrir le script que vous voulez utiliser ou créez-en un nouveau. Le script s'ouvre dans un nouvel onglet.

3. Démarrer 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 au-dessus du tableau des actions pour trouver 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 selon cette donnée.

   Apprenez-en davantage sur les champs dans cette étape

   Field	Détails
   Name (Nom)	Le nom de l'action dans le script qui s'est déclenchée.
   Nom du Script	Le nom du script dans lequel se trouve l'action. Cela est utile lors de l'exécution d'une trace sur des contacts en direct.
   Properties (propriétés)	Les propriétés de l'action et leurs valeurs lorsque l'action s'est déclenchée.
   Heure	L'estampille temporelle du moment où l'action s'est 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 Par défaut ou Erreur. StartAt ONRELEASE indique que le script est actuellement en attente et 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 Properties (propriétés).

8. Double-cliquez 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 à droite de la fenêtre de sortie de trace. Les variables nouvelles ou modifiées sont affichées 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.

     Apprenez-en davantage sur les champs dans cette étape

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

   • La liste des variables comporte une barre de recherche qui vous permet de rechercher des variables spécifiques par nom ou par valeur.
   • Cliquez sur le symbole supérieur à > à côté du nom d'un objet de données dynamiques pour le développer et voir ses membres et leurs valeurs.
   • Double-clic 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 n'est visible que lorsque le curseur passe dessus.
   • 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 vous déplacer dans la ligne mise en surbrillance de la liste des variables.

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

     Apprenez-en davantage sur les champs dans cette étape

     Champ	Détails
     Name (Nom)	Le nom de la variable.
     Valeur	La valeur que contient la variable.
     Catégorie	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 comprennent String, Int32 et Boolean.

Télécharger les Fichiers Trace

Vous pouvez sauvegarder la sortie de la trace comme un 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 de Studio ou à votre représentant de compte. Les fichiers peuvent être visualisés 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'applications et sélectionnez Omnicanal Routing > Studio .
2. Sur la page Scripts, repérez et double-cliquez pour ouvrir le script que vous voulez utiliser ou créez-en un nouveau. Le script s'ouvre dans un nouvel onglet.
3. Cliquez sur Trace et sélectionnez Démarrer avec Trace ou 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. Préciser un Nom du fichier et l'endroit où vous voulez sauvegarder le fichier.
7. Cliquez sur Enregistrer.

Charger les Fichiers Trace

Vous pouvez charger un fichier de trace sauvegardé dans Studio pour le visualiser. Vous pouvez charger uniquement les fichiers de trace téléchargés à partir de Studio. Les fichiers de trace téléchargés à partir de Desktop Studio doivent être chargés dans cette Application.

1. Dans NiCE CXone, cliquez sur le sélecteur d'applications et sélectionnez Omnicanal Routing > Studio .
2. Sur la Page Scripts, cliquez sur Charger et sélectionnez Charger le fichier de trace.
3. Faire glisser un fichier de trace dans 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 Charger la trace. La trace s'ouvre dans une fenêtre de sortie de la trace.