Tracer et Déboguer les Scripts

Cette page d'aide concerne Studio. Ces informations sont également disponibles pour Desktop Studio.

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 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 la 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, 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 qui s'est déclenchée, les variables qui sont créées et à quel moment, ainsi que les valeurs que les 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 celles-ci.

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'applications Icon of three-by-three grid of white squares on a blue background et sélectionnez Omnicanal Routing > Studio Trois flèches jointes à la base. L'une pointe vers le haut, une autre vers le haut à droite et une autre vers le haut à gauche. .
  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 de téléphone entrant.
  5. Pour transmettre des valeurs au script via variables de paramètre, entrez les valeurs dans le champ Paramètres. Entrez une valeur par ligne. Les valeurs que vous entrez sont mappé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 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 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 l'ellipse Trois points à la suite. 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 Icon of a broken link. Détacher.
  11. Pour mettre fin à la fois à la trace et à l'interaction, cliquez sur Icon of square inside a circle.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 un contact en direct

Vous pouvez capturer une trace sur un script pendant son exécution, lors du traitement des contactsClosed 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 recueillir des données pour le soutien technique.

Si vous souhaitez tracer un numéro DE téléphone spécifique, vous pouvez saisir une ANIClosed Also known as caller ID. Listed phone number of an incoming voice call. ou une DNISClosed The number dialed on inbound or outbound voice calls.. Lors du filtrage par numéro DE téléphone, Studio ne trace que les contacts possédant ce numéro.

Suivez ces étapes pour démarrer une trace unique. Pour démarrer plus que une trace en même temps, consultez la tâche suivante.

  1. Dans NiCE CXone, cliquez sur le sélecteur d'applications Icon of three-by-three grid of white squares on a blue background et sélectionnez Omnicanal Routing > Studio Trois flèches jointes à la base. L'une pointe vers le haut, une autre vers le haut à droite et une autre vers le haut à gauche. .
  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 Contacts en direct.

  4. Under Filters, select an option: 
  5. 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.
  6. Utilisez les Options de la fenêtre de sortie de trace pour examiner la trace.
  7. To save the trace output to your computer: 
    1. Cliquez sur l'ellipse Trois points à la suite. 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.
  8. Pour mettre fin à la trace sans mettre fin à l'interaction sur le serveur, cliquez sur Icon of a broken link. Détacher.
  9. Pour mettre fin à la fois à la trace et à l'interaction, cliquez sur Icon of square inside a circle. Terminer, puis cliquez sur ok pour confirmer. Cette action met fin à l'interaction sur le serveur et déconnecte le contact ou met fin au 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 contactsClosed 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 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 Multiple traces s'ouvre et attend que le script s'exécute avec des contacts en direct. Si vous avez spécifié un ANIClosed Also known as caller ID. Listed phone number of an incoming voice call. ou un DNISClosed The number dialed on inbound or outbound voice calls. pour filtrer les contacts, le script attend les contacts dont le numéro correspond.

Au fur et à mesure que les interactionsClosed 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, des entrées apparaissent dans la fenêtre des traces multiples pour chaque contact, jusqu'au nombre que vous avez spécifié. L'état dans le coin plus haut à gauche de la fenêtre indique combien de traces sont en cours ou terminées, et combien de contacts sont encore en attente de démarrage.

  1. Dans NiCE CXone, cliquez sur le sélecteur d'applications Icon of three-by-three grid of white squares on a blue background et sélectionnez Omnicanal Routing > Studio Trois flèches jointes à la base. L'une pointe vers le haut, une autre vers le haut à droite et une autre vers le haut à gauche. .
  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, de 1 à 20.
  5. Under Filters, select an option: 
  6. Cliquez sur Démarrer la capture. La fenêtre Multiple traces s'ouvre. Elle s'affiche par défaut sur la Page de sortie de trace. L'espace fenêtre est vide jusqu'à ce que le script commence à s'exécuter pour un contact.

  7. Pour afficher la liste de toutes les traces que vous avez démarrées, cliquez sur Retour à toutes les traces.

  8. To filter contacts on the All Traces page: 
    • 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 recherche dans toutes les colonnes, sauf État.
  9. Dans la fenêtre Multiple des traces, cliquez sur les trois points Icône représentant trois points sur une ligne. à côté de l'un des contacts et choisissez une option pour la trace de ce contact.

  10. Double-cliquez sur un contact pour afficher sa sortie de trace.
  11. Utilisez les options de la fenêtre de sortie de trace pour examiner la trace.
  12. Cliquez sur Back to All Traces dans le coin supérieur gauche pour revenir à la fenêtre des traces multiples.

Afficher la Sortie de Trace

Lorsque vous exécutez une trace, la sortie s'affiche 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 actionClosed 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 apparaissent dans le tableau situé 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 s’est déclenchée, ainsi que le résultat.

  1. Dans NiCE CXone, cliquez sur le sélecteur d'applications Icon of three-by-three grid of white squares on a blue background et sélectionnez Omnicanal Routing > Studio Trois flèches jointes à la base. L'une pointe vers le haut, une autre vers le haut à droite et une autre vers le haut à gauche. .
  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 contactsClosed 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 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.

  7. Pour afficher davantage d'informations sur les propriétés d'une action et leurs valeurs, pointez sur 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 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é.

    Ceci 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, il peut être nécessaire d'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 du côté droit 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 de cette valeur dans une fenêtre contextuelle.
    • Sélectionnez ou désélectionnez Global, Système ou Privé pour filtrer les variables dans la liste.

    • 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 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.
    • Cliquez sur le signe plus Icon of a plus sign. à droite d'une variable pour l'ajouter à la liste de surveillance des variables. Le signe plus est visible uniquement lorsque le curseur le survole.
    • Cliquez sur la coche Icon of a check mark. à 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 variables.
    • Cliquez sur un en-tête de colonne pour trier les variables selon cette donnée.

Télécharger les Fichiers Trace

Vous pouvez sauvegarder la sortie de la trace en tant que fichier que vous pouvez télécharger sur votre ordinateur. Ceci 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'applications Icon of three-by-three grid of white squares on a blue background et sélectionnez Omnicanal Routing > Studio Trois flèches jointes à la base. L'une pointe vers le haut, une autre vers le haut à droite et une autre vers le haut à gauche. .
  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 Démarrer avec Trace ou Capturer les Contacts en direct.
  4. Une fois la trace capturée, cliquez sur l'ellipse Trois points à la suite. 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'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 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 cette application.

  1. Dans NiCE CXone, cliquez sur le sélecteur d'applications Icon of three-by-three grid of white squares on a blue background et sélectionnez Omnicanal Routing > Studio Trois flèches jointes à la base. L'une pointe vers le haut, une autre vers le haut à droite et une autre vers le haut à gauche. .
  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 Ouvrir dans la fenêtre Load Trace. La trace s'ouvre dans une fenêtre de sortie de trace.