Débogage de scripts

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

Studio propose deux façons de vérifier si vos scripts présentent des problèmes :

• Vérifiez les erreurs de syntaxe.
• Exécutez une trace de script, qui vous montre ce qui se passe lorsque le script traite chaque action.

Si vous avez des actions Snippet dans votre script, vous pouvez déboguer le code de l’extrait à partir de la fenêtre Snippet Editor.

Vérifier les erreurs de syntaxe

Lorsque vous vérifiez les erreurs de syntaxe, tous les problèmes détectés dans votre script apparaissent sous l’onglet Script Errors . L’onglet vous montre tous les avertissements et toutes les erreurs liés à votre script, y compris dans les extraits de code. Les avertissements n’empêchent pas l’exécution ou l’enregistrement de votre script, contrairement aux 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 syntaxiques sont effectuées automatiquement lorsque vous enregistrez un script, mais vous pouvez effectuer une vérification syntaxique à 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 inclure des éléments tels que :

• 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 méthode ou une fonction qui requiert un type de données spécifique. Par exemple : Unterminated function parameters.

Certaines erreurs peuvent ne pas apparaître sous l’onglet Script Errors. Certaines erreurs de validation apparaissent dans une fenêtre de notification d’erreur avec des détails sur l’erreur. Les erreurs de validation comprennent des éléments tels que du 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 l’action sur le canevas 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 syntaxique.
4. Double-cliquez sur un avertissement ou une erreur dans l’onglet Script Errors pour voir l’action sur le canevas où le problème se produit.

Traces de script

Vous pouvez suivre la progression et les performances de votre script à l’aide de l’outil Trace Output . Cet outil retrace le contact à travers le script et affiche les résultats de chaque action déclenchée, les variables qui sont définies et le moment où elles le sont, ainsi que les valeurs des 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 des interactions simulées.

Vous ne pouvez exécuter une trace que si le script est enregistré. Si vous tentez d’exécuter une trace sur un script dont les modifications n’ont pas été 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 d’enregistrer le script et d’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.

Utiliser la fenêtre Trace Output

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 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 client, l’écoute d’un message ou de musique, ou le routage d’un contact vers un agent..

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

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

   
   En savoir plus sur les champs de cette étape

   Champ	Détails
   IBVoice	Le nom du script. IBVoice est le nom du script dans cet exemple d’image.
   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 présentation 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 souhaitez 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 vous indique également le nom et le chemin d’accès du script qui est tracé. 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 Properties affiche toutes les propriétés de l’action et leurs paramètres de configuration. L’emplacement par défaut du volet Properties se 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é empruntée. Lorsque vous cliquez sur une action, toutes les variables du script à ce moment-là apparaissent dans l’onglet Variables . L’emplacement par défaut du volet Détails du script se trouve en haut à droite de la fenêtre Trace Output, sous la barre d’outils. Consultez le tableau déroulant 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 au bas de la fenêtre Trace Output .
   Onglet Watch List	Vous pouvez créer une liste de variables de script que vous souhaitez 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 au bas de la fenêtre Trace Output .

2. En haut à droite de la fenêtre Trace Output, cliquez sur une action dans le volet des 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 progresse et déclenche chaque action.

   En savoir plus sur les champs de cette étape

   Champ	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 du déclenchement de l’action. 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 empruntée 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 SRVI 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 des 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

   Champ	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. Cela peut changer au fur et à mesure que le scénario progresse 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 souhaitez suivre des variables spécifiques dans la trace.

Modifier la visibilité d’une variable dans une trace

Vous pouvez modifier les ensembles de variables qui apparaissent dans une trace. Cela vous permet de vous concentrer sur des types de variables spécifiques, en fonction de ce que vous recherchez dans la 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 souhaitez 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.

Capturer une trace de script

Vous pouvez capturer une trace d’un script en cours d’exécution. Vous pouvez le faire avec des scripts de production qui traitent des contacts en direct. Cela vous permet de diagnostiquer les problèmes rencontrés par votre centre d’appels ou de capturer des données en vue d’un dépannage avec le soutien 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.

Capturer 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 dans votre CXone unité commerciale Regroupement organisationnel de haut niveau utilisé pour gérer le support technique, la facturation et les paramètres globaux pour votre environnement CXone. Vous pouvez spécifier l’emplacement 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.

Afficher les fichiers de trace

Vous pouvez afficher les fichiers de trace enregistrés à partir d’une trace continue.

1. Dans Studio, cliquez sur le menu Debug, puis choisissez de charger un fichier de trace situé sur votre système ou à distance dans votre CXone unité commerciale Regroupement organisationnel de haut niveau utilisé pour gérer le support technique, la facturation et les paramètres globaux pour votre environnement CXone.
2. Sélectionnez le fichier que vous souhaitez 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 souhaitez 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.

Capturer une trace avec un ANI ou un DNIS spécifique

Vous pouvez définir un EAN (ANI) Aussi 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 DNIS 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é lors des appels vocaux sortants. spécifique pour déclencher un traçage lorsqu’un appel provenant du numéro spécifié entre 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 la liste déroulante Trace Script et sélectionnez Trace when ANI is ou Trace when DNIS is.

   Afficher l’image de la liste déroulante Tracer un script avec l’option EAN sélectionnée

   
3. Saisissez le numéro EAN 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 fois que vous cliquez modifie le comportement :
   • Cliquez une fois pour tracer la prochaine instance du script exécuté avec le numéro spécifié. L’icône devient rouge.
   • Cliquez deux fois pour tracer en continu les futures instances du script exécuté 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 d’origine.
5. Lors de la prochaine exécution du script avec l’EAN ou le DNIS spécifié, une trace est capturée et enregistrée dans un fichier.

Surveiller les 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 de sorte qu’à chaque fois que vous exécutez une trace sur ce script particulier, la liste de surveillance est enregistrée et chargée dans la fenêtre Trace Output .

1. Dans Studio, ouvrez le script que vous voulez tracer.
2. Exécutez un traçage initial 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 souhaitez 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 du signe plus. L’onglet Watch List apparaît avec un champ pour une nouvelle variable.
   2. Saisissez le nom de la variable que vous souhaitez observer et appuyez sur Entrer.
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 du 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 enregistré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.