Débogage de scripts dans Desktop Studio

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

Studio provides two ways you can check for issues in your scripts:

• Check for syntax errors.
• Run a script trace, which shows you what's happening as the script processes each action.

If you have Snippet actions in your script, you can debug the snippet code from within the Snippet editor window.

Vérification des erreurs de syntaxe

Lorsque vous vérifiez les erreurs de syntaxe, tous les problèmes détectés dans votre script apparaissent dans l'onglet Script Errors . Cet onglet vous montre tous les avertissements et les erreurs liés à votre script, y compris dans les snippets. Les avertissements n'empêchent pas le script de s'exécuter ou de s'enregistrer, mais bien les erreurs. La meilleure pratique consiste à traiter tous les avertissements avant de mettre le script en production, même s'ils n'empêchent pas le script de fonctionner.

Les vérifications de syntaxe sont effectuées automatiquement lorsque vous enregistrez un script, mais vous pouvez en effectuer une à tout moment. Vous ne pourrez pas exécuter ou enregistrer un script qui contient des erreurs. Si vous tentez d'exécuter ou d'enregistrer un script comportant des erreurs, Studio affiche une fenêtre de notification. Vous pouvez consulter l'onglet Script Errors pour plus d'informations. Les erreurs peuvent notamment avoir les raisons suivantes :

• Variables mal orthographiées. Par exemple : Snippet Line 2. Function: NameLabel has not been defined.
• Utilisation d'une fonction comme paramètre de méthode. Par exemple : Unterminated function parameters.
• Utilisation d'un type de données incorrect dans une fonction qui requiert un type de données spécifique. Par exemple : Unterminated function parameters.

Il se peut que certaines erreurs ne s’affichent pas dans l'onglet Script Errors. Certaines erreurs de validation apparaissent dans une fenêtre de notification qui fournit des détails sur l'erreur. Les erreurs de validation comprennent des éléments tels qu'un JSON non valide dans l'action REST API. Si vous tentez d'enregistrer lorsque le script contient une erreur de validation, le script peut revenir à la version la plus récente du script sans l'erreur de validation. Si cela se produit, toutes les modifications non enregistrées sont perdues.

Double-cliquez sur un avertissement ou une erreur dans l’onglet Script Errors pour voir sur le canevas l'action où le problème se produit.

1. Dans Studio, ouvrez un script.
2. Cliquez sur Validation> Syntax Check.
3. Cliquez sur l'onglet Script Errors pour afficher les résultats de la vérification de syntaxe.
4. Double-cliquez sur avertissement ou une erreur dans l’onglet Script Errors pour voir sur le canevas l'action où le problème se produit.

Traces de script

You can track the progress and performance of your script with the tool. This tool traces the contact through the script and displays the results of each action that fired, what variables are being set and when, and the values the variables held at each point. This is a helpful tool to test and debug your scripts. You can run traces on live interactions or simulated ones.

Vous ne pouvez exécuter une trace que si le script est enregistré. Si vous tentez d’exécuter 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, Studio ne l’enregistrera pas Vous devez résoudre les erreurs avant de pouvoir enregistrer le script et exécuter la trace. Any validation errors in the script cause Studio to revert to the last version of the script without the validation error. If you've started a trace, it runs, but will run on the last saved version of the script.

Utilisation de la fenêtre Trace Output

When you run a trace, the output appears in the window. You can use this window to view the variables in the script and see how they change as the script progresses through each action Exécute un processus dans un script Studio, tel que la collecte de données client, la lecture d'un message ou d'une musique, ou l'acheminement d'un contact vers un agent..

1. Dans Studio, ouvrez un script et exécutez une trace ou ouvrez un fichier de trace enregistré.

   Voir l’image de la fenêtre Sortie de trace

   
   En savoir plus sur les champs de cette étape

   champs	Détails
   IBVoice	Le nom du script. IBVoice est le nom du script dans cette image d’exemple.
   Barre d'outils	La barre d'outils de la fenêtre Trace Output se trouve sous le nom du script. Cette barre d'outils contient des options qui vous permettent de :  : Modifier la disposition de la fenêtre Trace Output , y compris les volets et les onglets visibles.  : Modifier les variables visibles dans l'onglet Variables, enregistrer la liste de surveillance actuelle et enregistrer la trace actuelle dans un fichier sur votre ordinateur.  : Créer et gérer une liste de variables que vous voulez surveiller dans cette trace.  : Développer ou réduire toutes les actions ou variables contenant des informations.  : Cette partie de la barre d'outils affiche l'ID du contact actuel. Elle montre également le nom et le chemin d'accès du script en cours de traçage. Vous ne pouvez pas modifier l'emplacement de la barre d'outils.
   Propriétés	Lorsque vous sélectionnez une action dans le volet Script Details , le volet Propertiesaffiche toutes les propriétés de l'action et leurs paramètres de configuration. Par défaut, le volet Propertiesse trouve en haut à gauche de la fenêtre Trace Output, sous la barre d'outils.
   Script Details	Le volet Script Details affiche toutes les actions qui se déclenchent lors de l'exécution du script, dans l'ordre où elles se sont déclenchées. Il n'inclut pas les actions qui font partie du script mais qui n'ont pas été déclenchées, comme les actions qui font partie d'une branche qui n'a pas été suivie. Lorsque vous cliquez sur une action, toutes les variables du script à ce moment-là s’affichent dans l'onglet Variables . Par défaut, le volet Détails du script se trouve en haut à droite de la fenêtre Trace Output, sous la barre d'outils. Reportez-vous à la liste déroulante de l'étape 2 pour plus d'informations sur les intitulés des colonnes de ce volet.
   Onglet Variables	Lorsque vous sélectionnez une variable dans le volet Script Details , toutes les variables présentes dans le script apparaissent dans cet onglet. L'onglet Variables se trouve par défaut dans le bas de la fenêtre Trace Output .
   Onglet Watch List	Vous pouvez créer une liste de variables de script que vous voulez suivre lors de l'exécution du script. Les variables que vous ajoutez apparaissent dans cet onglet. L'onglet Watch List se trouve par défaut dans le bas de la fenêtre Trace Output .

2. En haut à droite de la fenêtre Trace Output, cliquez sur une action dans le volet Détails du script. Si vous observez une trace en direct, ce volet se met à jour en temps réel au fur et à mesure que le script avance et déclenche chaque action.

   En savoir plus sur les champs de cette étape

   champs	Détails
   Script	Le nom du script contenant l'action. Si un script principal engendre un sous-script, il se peut que plusieurs noms apparaissent dans la liste.
   Time	L'heure à laquelle l'action s'est déclenchée.
   Action	Le nom de l'action, y compris les arguments pour chaque action. Les arguments sont tous les paramètres de configuration des propriétés de l'action.
   Result	Le résultat de l'action qui s'est déclenchée. Cela indique ce qui s'est passé à la suite de l'action de traitement du script. Il peut s'agir de la branche que le script a suivie ou de l'action qui s'est produite à la suite du déclenchement de l'action. Par exemple, dans l'image de l'étape 1 de cette section, Default et Error sont des branches. DirectJump to 4 et StartAt ONRELEASE sont le résultat du déclenchement de ces actions. DirectJump to 4 indique que le contact a sélectionné une option dans le menu IVR Menu téléphonique automatisé qui permet aux appelants d'interagir via des commandes vocales, des entrées de touches, ou les deux, pour obtenir des informations, acheminer un appel vocal entrant, ou les deux. qui a amené le script à passer à l'action avec l'ID d'action 4. StartAt ONRELEASE indique à que le script est actuellement en attente et qu'il redémarrera lorsqu'un agent répondra à l'interaction.

3. Cliquez sur les icônes de la barre d'outils en haut de la fenêtre Trace Output pour développer ou réduire les détails des variables dans le volet Détails du script. Cela concerne toutes les variables qui contiennent des détails supplémentaires. Ces variables sont indiquées par une icône + à côté de leur nom.

4. Cliquez sur l'onglet Variables en bas de la fenêtre pour faire défiler toutes les variables présentes dans le script lorsque l'action sélectionnée s'est déclenchée.

   En savoir plus sur les champs de cette étape

   champs	Détails
   Name	Le nom de la variable. Les variables dont le nom commence par deux caractères de soulignement sont des variables système.
   Value	La valeur de la variable. Elle peut changer au fur et à mesure que le scénario passe d'une action à l'autre.
   Type	Le type de variable. Les options sont Variable pour les variables standard à valeur unique ou UCN.Data.Dynamic pour les objets de données dynamiques.

5. Cliquez sur l'icône Tools et sélectionnez une option pour modifier les variables affichées dans l'onglet Variables .

   Learn more about fields in this step

   Field	Details
   Show Global Variables in Subs	Select this option if you want global variables to appear in the Variables tab. This includes global variables that are set in this script or are set in another script and can be used in this script. For example, a subscript.
   Show System Variables	Select this option if you want pre-defined system variables to appear in the Variables tab. These are variables added to the script automatically by the system, including the actions in the script.
   Show Private Members	Select this option if you want private members to appear in the Variables tab.

6. Dans le volet Properties , vous pouvez voir les propriétés de l'action sélectionnée et la façon dont elles sont configurées.
7. Ajoutez des variables à une liste de surveillance si vous voulez suivre des variables spécifiques dans la trace.

Modification de la visibilité d'une variable dans une trace

You can change which sets of variables show in a trace. This allows you to focus on specific kinds of variables, depending on what you're looking for in the trace.

1. Dans Studio, ouvrez un script et exécutez une trace.
2. Dans la barre d'outils de la fenêtre Trace Output , cliquez sur l'icône Tools .

3. Sélectionnez l'option correspondant à l'ensemble de variables que vous voulez afficher ou masquer dans la trace. Les options cochées sont actuellement visibles dans la trace.

   Learn more about fields in this step

   Field	Details
   Show Global Variables in Subs	Select this option if you want global variables to appear in the Variables tab. This includes global variables that are set in this script or are set in another script and can be used in this script. For example, a subscript.
   Show System Variables	Select this option if you want pre-defined system variables to appear in the Variables tab. These are variables added to the script automatically by the system, including the actions in the script.
   Show Private Members	Select this option if you want private members to appear in the Variables tab.

Capture d’une trace de script

Vous pouvez capturer une trace d'un script en cours d'exécution. Vous pouvez faire ceci avec des scripts de production qui traitent des contacts en direct. Cela vous permet de diagnostiquer les problèmes rencontrés par votre centre de contact ou de capturer des données en vue d'un dépannage avec l'assistance technique. Vous pouvez choisir de capturer une trace à la prochaine instance lorsque le script s'exécute, ou vous pouvez capturer une trace continue. Une trace continue capture chaque interaction traitée par le script. Lorsque vous capturez une seule trace, les informations qui en résultent apparaissent dans la fenêtre Trace Output .

1. Dans Studio, ouvrez le script dont vous voulez capturer une trace.
2. Cliquez sur Debug > Capture Script > Next Instance.
3. Lorsqu'une interaction démarre et que le script commence à s'exécuter, la fenêtre Trace Output s'ouvre. La fenêtre affiche la trace au fur et à mesure de l'exécution du script.

Capture d’une trace de script continue

Une trace continue capture chaque interaction traitée par le script. La sortie de trace est enregistrée dans des fichiers sur votre CXone . Vous pouvez spécifier l'endroit où ces fichiers sont enregistrés.

1. Dans Studio, ouvrez le script dont vous voulez capturer une trace.
2. Cliquez sur Debug > Capture Script > Continuous. Studio commence à capturer toutes les instances du script en cours d'exécution.

Consultation des fichiers de trace

Vous pouvez visualiser les fichiers de trace enregistrés à partir d'une trace continue.

1. Dans Studio, cliquez sur le menu Debug, puis choisissez si vous voulez charger un fichier de trace situé sur votre système ou à distance dans CXone .
2. Sélectionnez le fichier que vous voulez ouvrir dans la fenêtre de fichier qui s'affiche.
3. Cliquez sur le bouton pour ouvrir le fichier de trace sélectionné. Le nom varie selon que vous ouvrez un fichier local ou distant. Le fichier sélectionné est chargé dans la fenêtre Trace Output .
4. Si vous voulez télécharger les fichiers de trace de CXone sur votre ordinateur local, cliquez sur l'icône Tools dans la fenêtre Trace Output , puis sélectionnez Save Trace As.

Capture d’une trace avec un ANI ou un DNIS spécifique

Vous pouvez définir unANI Également connu comme l'identificateur de l'appelant. Numéro de téléphone répertorié d'un appel vocal entrant.ouDNIS Identifie le numéro que le contact a composé pour vous joindre pour les appels vocaux entrants et le numéro que l'agent ou le système a composé pour les appels vocaux sortants. pour déclencher une trace lorsqu'un appel du numéro spécifié arrive dans le système.

1. Dans Studio, ouvrez le script dont vous voulez capturer une trace.

2. Dans la barre d'outils Studio, cliquez sur le menu déroulant Trace Script et sélectionnez Trace when ANI is ou Trace when DNIS is.

   Voir l'image de la liste déroulante Tracer le script avec l'option ANI sélectionnée

   
3. Entrez le numéro ANI ou DNIS qui doit déclencher la trace dans le champ Insert <number>.
4. Cliquez sur l’icône Capture Next Instance . Le nombre de clics modifie le comportement :
   • Cliquez une fois pour tracer la prochaine instance du script s'exécutant avec le numéro spécifié. L'icône devient rouge.
   • Cliquez deux fois pour tracer en continu les futures instances du script s'exécutant avec le numéro spécifié. L'icône se transforme en deux cercles rouges.
   • Cliquez trois fois pour effacer la capture. L'icône reprend sa couleur grise initiale.
5. Lors de la prochaine exécution du script avec l'ANI ou le DNIS spécifié, une trace est capturée et enregistrée dans un fichier.

Surveillance de variables dans une trace

Vous pouvez créer une liste de variables qui vous intéressent particulièrement. La liste de surveillance vous permet de suivre uniquement ces variables sans devoir les rechercher dans la trace. Vous pouvez enregistrer la liste afin que, à chaque fois que vous exécutez une trace sur ce script précis, la liste de surveillance soit enregistrée et chargée dans la fenêtre Trace Output .

1. Dans Studio, ouvrez le script que vous souhaitez tracer
2. Exécutez une trace initiale du script.
3. Dans la fenêtre Trace Output , cliquez sur la liste des actions dans le volet des détails du script. Les variables associées à chaque action apparaissent dans l'onglet Variables .
4. Pour chaque variable que vous voulez ajouter à la liste de surveillance :
   1. Sélectionnez la variable dans l'onglet Variables .
   2. Cliquez sur l’icône Add to Watch List .
5. Vous pouvez ajouter une variable manuellement si vous en connaissez le nom :
   1. Dans la barre d'outils de la fenêtre Trace Output , cliquez sur l'icône représentant un signe plus. L'onglet Watch List s’affiche et présente un champ pour une nouvelle variable.
   2. Entrez le nom de la variable que vous voulez observer et appuyez sur . Entrée.
6. Si vous souhaitez supprimer une variable de la liste de surveillance, sélectionnez-la dans l’onglet Watch List et cliquez sur l'icône représentant un signe moins dans la barre d'outils de la fenêtre Trace Output .
7. Pour enregistrer cette liste de surveillance, cliquez sur l'icône Tools dans la barre d'outils de la fenêtre Trace Output et sélectionnez Save Watch List. La liste est sauvegardée dans Studio. Chaque fois que vous exécutez une trace sur ce script, la liste de surveillance se charge dans la fenêtre Trace Output .
8. Lorsque vous êtes prêt à surveiller les variables de votre liste de surveillance, lancez une nouvelle trace sur le script.