Déboguer les Scripts dans Desktop Studio

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

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

Studio propose deux façons de vérifier les problèmes dans vos scripts :

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

Si votre script contient des actions Snippet, vous pouvez déboguer le code de l'Extrait depuis la fenêtre Snippet editor.

Rechercher les 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 affiche tous les avertissements et 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, mais les erreurs, si. Il est recommandé de résoudre 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 s'effectuent automatiquement lors de l'enregistrement d'un script, mais vous pouvez exécuter une vérification de syntaxe à tout moment. Vous ne pourrez pas exécuter ou enregistrer un script contenant des erreurs. Si vous tentez d'exécuter ou d'enregistrer un script contenant 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 : Extrait Ligne 2. Fonction : NameLabel n'a pas été défini.
  • Utilisation d'une fonction comme paramètre de méthode. Par exemple : paramètres de fonction non terminés.
  • Utilisation d'un type de données incorrect dans une fonction qui requiert un type de données spécifique. Par exemple : paramètres de fonction non terminés.

Il existe certaines erreurs qui peuvent ne pas apparaître dans l'onglet Script Erreurs. Certaines erreurs de validation apparaissent dans une fenêtre de notification qui fournit des détails sur l'erreur. Les Erreurs de validation incluent des éléments tels que JSON non valide dans le REST API action. Si vous tentez d'enregistrer alors que 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-clic 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 Erreurs pour afficher les résultats de la vérification de la syntaxe.
  4. Double-clic 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 les performances de votre script, générer un script ou effectuer un appel de test avec l'outil . 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. 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.

Utilisez la fenêtre Trace Output

Lorsque vous exécutez une trace, la sortie s'affiche 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 actionClosed Performs a process within a Studio script, such as collecting customer data or playing music..

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

  2. Dans le coin supérieur droit de la fenêtre Trace Output, cliquez sur une action dans le volet des détails du script. Si vous visionnez 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.

  3. Cliquez sur les icônes dans la barre d'outils en haut de la fenêtre Trace Output pour développer L'icône Développer tout dans la fenêtre Sortie de trace, un carré avec un signe moins à l'intérieur et une série de lignes horizontal empilées à côté, représentant une liste ouverte. ou réduire tout L'icône Développer tout dans la fenêtre Sortie de trace, un carré avec un + à l'intérieur et une série de lignes horizontal empilées à côté de celui-ci représentant une liste. des détails pour variables dans le volet des détails du script. Ceci affecte toute Variable comportant 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.

  5. Cliquez sur l'icône Tools L'icône Outils de traçage, un marteau et une clé croisés en X. et sélectionnez une option pour modifier les variables affichées dans l'onglet variables .

  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. Ajouter 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

Vous pouvez modifier les ensembles de variables qui apparaissent dans une trace. Cela vous permet de vous concentrer sur des types spécifiques de variables, 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 L'icône Outils de traçage, un marteau et une clé croisés en X. .
  3. Sélectionnez l'option pour l'ensemble de variables que vous souhaitez afficher ou masquer dans la trace. Les options cochées sont actuellement visibles dans la trace.

Capturer 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 lors de l'instance suivante 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 trace unique, les informations qui en résultent s'affichent dans la fenêtre Trace Output .

  1. Dans Studio, ouvrez le script dont vous voulez capturer une trace.
  2. Cliquez sur Déboguer > Capturer script > Instance suivante.
  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 Continu

Une trace continue capture chaque interaction traitée par le script. La sortie de trace est sauvegardée dans des fichiers de votre locataire NiCE 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 Déboguer > Capturer Script > Continu. 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 Déboguer, puis sélectionnez si vous souhaitez charger un fichier de trace situé sur votre système ou à distance dans votre locataire NiCE 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é se charge dans la fenêtre Trace Output .
  4. Si vous souhaitez télécharger des fichiers de trace depuis NiCE CXone sur votre ordinateur local, cliquez sur l'icône Outils L'icône Outils de traçage, un marteau et une clé croisés en X. 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 unANIClosed Also known as caller ID. Listed phone number of an incoming voice call.ouDNISClosed The number dialed on inbound or outbound voice calls. 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 la liste déroulante Trace Script et sélectionnez Trace when ANI is ou Trace when DNIS is.

  3. Enter the ANI or DNIS number you want to trigger the trace in the Insert <number> field.
  4. Click the Capture Next Instance icon A grey sphere. . The number of times you click changes the behavior: 
    • Cliquez une fois pour tracer l'instance suivante du script en cours d'exécution avec le numéro spécifié. L'icône devient rouge.
    • Cliquez deux fois pour tracer en continu les futures instances du script en cours d'exécution 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 sauvegarder la liste afin que, chaque fois que vous exécutez une trace sur ce script en particulier, la liste de surveillance soit sauvegardée et se charge 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 les différentes actions de la liste dans le panneau des détails du script. Les variables associées à chaque action apparaissent dans l'onglet variables .
  4. For each variable you want to add to the watch list:
    1. Sélectionnez la variable sous l'ongletvariables .
    2. Cliquez sur l'icône Add to Watch List L'icône Ajouter à la liste de surveillance, une paire de lunettes..
  5. You can add a variable manually if you know the name:
    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. 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 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 The Trace Tools icon, a hammer and a wrench crossed like an X. 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, exécutez une nouvelle trace sur le script.