Extraits de débogage dans Scripts

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

Vous pouvez déboguer des extraits à partir de la fenêtre de l'éditeur Snippet. Le débogueur vous permet de voir les variables dans le code snippet. Cela peut vous aider à résoudre des problèmes dans votre code. Cinq options sont disponibles pour déboguer les snippets :

En outre, si votre code contient des objets dynamiques ou des tableaux, vous pouvez voir leur contenu et la façon dont il change.

Utilisation de l'outil de débogueur

  1. Dans Studio, ouvrez un script contenant une action Snippet.
  2. Cliquez sur Ouvrir l’éditeur A rectangle with a horizontal line near the top. sur l’action Snippet.
  3. Ajoutez du code Extrait, s'il n'en contient pas déjà some.
  4. Sur le côté gauche de la fenêtre de l'éditeur d'Extrait, cliquez sur l'icône de bogue Icon of a bug.. Le panneau Exécuter & Déboguer apparaît en glissant depuis le côté gauche de la fenêtre.
  5. Cliquez sur le triangle Icône représentant un triangle pointant vers la droite. pour commencer le débogage.
  6. Affichez le contenu de la section variables du panneau Exécuter & Déboguer. Cette section affiche les variables et leurs valeurs lorsque le débogueur a exécuté l'ensemble du code de l'extrait. Dans cette section :

    • Les objets de données dynamiques affichent la valeur {Dynamic}. Cliquez pour les développer et afficher les valeurs de leurs membres.
    • Placez le curseur sur une valeur pour afficher cette valeur dans une infobulle. Cela vous permet de voir les valeurs importantes.
    • Cliquez sur une valeur, puis appuyez sur CTRL+C pour copier la valeur dans le presse-papiers.
  7. Vérifiez les erreurs dans la variable _err à tout moment du processus de débogage. Certaines erreurs apparaissent sous forme de messages toastClosed Small, temporary pop-up messages on the bottom of the screen indicating things like errors and successes. dans la fenêtre Extrait de l'éditeur.

  8. To make changes to your snippet: 
    1. Arrêter le débogueur, s'il est en cours d'exécution. Pendant que le débogueur est en cours d'exécution, l'extrait est en mode en lecture seule.
    2. Apportez vos modifications.
    3. Cliquez sur Apply dans la fenêtre de l'éditeur Snippet. La fenêtre de l'éditeur se ferme automatiquement. Cela envoie les modifications au serveur, où le service de débogage s'exécute.
    4. Rouvrez la fenêtre de l'Snippet éditeur et exécutez de nouveau le débogueur.

Déboguer avec un point d'arrêt

Vous pouvez définir un point d'arrêt si vous souhaitez que le débogage s'arrête à une ligne spécifique du code de du snippet. Vous pouvez définir plus qu'un point d'arrêt et laisser le débogueur passer d'un point d'arrêt à l'autre. Cela vous permet de voir les variables et les valeurs à des points précis de l'extrait sans le parcourir ligne par ligne.

Vous pouvez définir des points d'arrêt avant de démarrer le débogueur ou pendant qu'il est en cours d'exécution. Le débogage est mis en pause lorsque la ligne contenant le point d'arrêt est sur le point d'être exécutée. Pendant la pause, vous pouvez voir la valeur actuelle de toutes les variables de l'extrait dans la Section variables de la fenêtre Run & Debug.

  1. Dans Studio, ouvrez un script contenant une action Snippet.
  2. Cliquez sur Ouvrir l’éditeur A rectangle with a horizontal line near the top. sur l’action Snippet.
  3. Ajoutez du code Extrait, s'il n'en contient pas déjà some.
  4. Sur le côté gauche de la fenêtre de l'éditeur d'Extrait, cliquez sur l'icône de bogue Icon of a bug.. Le panneau Exécuter & Déboguer apparaît en glissant depuis le côté gauche de la fenêtre.
  5. Ajoutez un point d'arrêt en cliquant dans la colonne à gauche de n'importe quelle ligne dans la fenêtre éditeur d'Extrait. Un point rouge apparaît à côté du numéro de ligne. Vous pouvez ajouter plus qu'un point d'arrêt à l'extrait. Vous pouvez également ajouter des points d'arrêt pendant que le débogueur est en cours d'exécution.

  6. Cliquez sur le triangle Icône représentant un triangle pointant vers la droite. pour commencer le débogage.
  7. Affichez le contenu de la section variables du panneau Exécuter & Déboguer. Cette section affiche les variables et leurs valeurs au point d'arrêt, si vous en avez défini un. La ligne où le débogage a été interrompu pour le point d'arrêt est mise en surbrillance dans la fenêtre de l'éditeur d'Extrait et une flèche ouverte Icon of a yellow arrow apparaît dans la colonne des points d'arrêt. Dans cette section :

    • Les objets de données dynamiques affichent la valeur {Dynamic}. Cliquez pour les développer et afficher les valeurs de leurs membres.
    • Placez le curseur sur une valeur pour afficher cette valeur dans une infobulle. Cela vous permet de voir les valeurs importantes.
    • Cliquez sur une valeur, puis appuyez sur CTRL+C pour copier la valeur dans le presse-papiers.
  8. Lorsque vous avez terminé avec un point d'arrêt, cliquez de nouveau sur le cercle rouge pour le supprimer.
  9. Pour continuer le débogage à partir du point d'arrêt, cliquez sur reprendre Icon of a vertical line with a triangle next to it.. Si vous avez défini plus qu'un point d'arrêt, le débogueur s'arrête juste avant le suivant.
  10. Pour parcourir le code ligne par ligne à partir du point d'arrêt actuel, cliquez sur la flèche vers le bas Icon of an arrow pointing down.. Vous pouvez reprendre Icon of a vertical line with a triangle next to it. à tout moment pour terminer le débogage ou pour passer au point d'arrêt suivant.
  11. Vérifiez les erreurs dans la variable _err à tout moment du processus de débogage. Certaines erreurs apparaissent sous forme de messages toastClosed Small, temporary pop-up messages on the bottom of the screen indicating things like errors and successes. dans la fenêtre Extrait de l'éditeur.

  12. Pour arrêter le débogage, cliquez sur le carré Icon of an empty square..
  13. To make changes to your snippet: 
    1. Arrêter le débogueur, s'il est en cours d'exécution. Pendant que le débogueur est en cours d'exécution, l'extrait est en mode en lecture seule.
    2. Apportez vos modifications.
    3. Cliquez sur Apply dans la fenêtre de l'éditeur Snippet. La fenêtre de l'éditeur se ferme automatiquement. Cela envoie les modifications au serveur, où le service de débogage s'exécute.
    4. Rouvrez la fenêtre de l'Snippet éditeur et exécutez de nouveau le débogueur.

Avancer pas à pas dans le code de l'Extrait

Vous pouvez utiliser l'outil de débogage pour faire défiler le code de snippet par ligne. Cela vous permet de voir comment les variables et leurs valeurs changent au fur et à mesure de l'exécution de chaque ligne.

  1. Dans Studio, ouvrez un script contenant une action Snippet.
  2. Cliquez sur Ouvrir l’éditeur A rectangle with a horizontal line near the top. sur l’action Snippet.
  3. Ajoutez du code Extrait, s'il n'en contient pas déjà some.
  4. Sur le côté gauche de la fenêtre de l'éditeur d'Extrait, cliquez sur l'icône de bogue Icon of a bug.. Le panneau Exécuter & Déboguer apparaît en glissant depuis le côté gauche de la fenêtre.
  5. Cliquez dans la colonne à gauche de n'importe quelle ligne dans la fenêtre éditeur d'Extrait. Un point rouge apparaît à côté de la ligne. Il s'agit d'un point d'arrêt, qui marque l'emplacement à partir duquel vous pouvez commencer à exécuter le code pas à pas.

  6. Cliquez sur le triangle Icône représentant un triangle pointant vers la droite. pour commencer le débogage. Si le point d'arrêt se trouve sur la première ligne, aucun code n'est encore exécuté.
  7. Affichez le contenu de la section variables du panneau Exécuter & Déboguer. Cette section affiche les variables du code et leurs valeurs avant le démarrage du code de l'extrait. Dans cette section :

    • Les objets de données dynamiques affichent la valeur {Dynamic}. Cliquez pour les développer et afficher les valeurs de leurs membres.
    • Placez le curseur sur une valeur pour afficher cette valeur dans une infobulle. Cela vous permet de voir les valeurs importantes.
    • Cliquez sur une valeur, puis appuyez sur CTRL+C pour copier la valeur dans le presse-papiers.
  8. Cliquez sur la flèche vers le bas Icon of an arrow pointing down. dans le panneau Exécuter & Déboguer pour passer à la ligne suivante de l'extrait. La Section variables se met à jour pour afficher les variables et leurs valeurs après l'exécution de la première ligne de code de l'extrait.
  9. Répétez les deux étapes précédentes pour chaque ligne de l'extrait. La section variables continue de se mettre à jour après chaque ligne.
  10. Si vous souhaitez sauter les lignes de code restantes, cliquez sur reprendre Icon of a vertical line with a triangle next to it.. La Section variables affiche les variables et leurs valeurs une fois que tout le code de l'extrait a été exécuté.
  11. Vérifiez les erreurs dans la variable _err à tout moment du processus de débogage. Certaines erreurs apparaissent sous forme de messages toastClosed Small, temporary pop-up messages on the bottom of the screen indicating things like errors and successes. dans la fenêtre Extrait de l'éditeur.

  12. Pour arrêter le débogage, cliquez sur le carré Icon of an empty square., puis répétez le processus de débogage si nécessaire.
  13. To make changes to your snippet: 
    1. Arrêter le débogueur, s'il est en cours d'exécution. Pendant que le débogueur est en cours d'exécution, l'extrait est en mode en lecture seule.
    2. Apportez vos modifications.
    3. Cliquez sur Apply dans la fenêtre de l'éditeur Snippet. La fenêtre de l'éditeur se ferme automatiquement. Cela envoie les modifications au serveur, où le service de débogage s'exécute.
    4. Rouvrez la fenêtre de l'Snippet éditeur et exécutez de nouveau le débogueur.

Déboguer à l'aide du Mot-clé TRACE

Le mot-clé TRACE keyword vous permet de déboguer à l'aide de la journalisation. Ce mot-clé fonctionne uniquement lorsque vous utilisez l'outil de débogage dans la fenêtre de l'éditeur Snippet . Lorsque vous l'incluez dans votre code d'Extrait et que vous exécutez le débogueur, le texte est généré dans la Section Trace de la fenêtre Run & Debug dans la fenêtre de l'éditeur Snippet .

Le mot-clé TRACE est ignoré en dehors de la fenêtre de l'éditeur Snippet. Il fonctionne uniquement avec l'outil de débogage.

La syntaxe est la suivante : TRACE "<expression>"

Le texte compris entre les guillemets doubles est affiché dans la section Trace de la fenêtre Exécuter & Déboguer dans la fenêtre de l'éditeur Snippet.

Vous pouvez utiliser une substitution de variables entre les guillemets doubles pour imprimer la valeur des variables. Par exemple :

FOR i=1 TO 5
{
   TRACE "I = {i}"
}

La sortie de cet exemple dans la Section Trace de la fenêtre Exécuter et Déboguer est :

I = 1
I = 2
I = 3
I = 4
I = 5

Utilisez la Variable Test Système

Le test variable est une variable système réservée à l'utilisation dans le débogage des extraits de code. Elle vous permet de définir la valeur des variables utilisées dans l'extrait de code, qui auraient déjà été renseignées par le script avant qu'il n'atteigne l'action SNIPPET.

Lorsque vous utilisez test dans un extrait, il doit être utilisé dans le cadre d'une instruction IF et défini sur 1. Le code entre les accolades ne s'exécute que lorsque vous exécutez le débogueur de l'extrait, car la variable test n'est égale à 1 que lorsque le débogueur s'exécute. Lorsque le script s'exécute pour un contactClosed The person interacting with an agent, IVR, or bot in your contact center., test a la valeur 0, de sorte que le code entre les accolades dans l'instruction IF est ignoré.

Par exemple :

IF test = {
 ASSIGN myDate = "07/03/2026" //This date falls on a Friday}
ASSIGN myDow = myDate.asdatedow
SWITCH myDow
{
 CASE 0   { ASSIGN newToday = "Sunday"  }
 CASE 1   { ASSIGN newToday = "Monday"  }
 CASE 2   { ASSIGN newToday = "Tuesday" }
 CASE 3   { ASSIGN newToday = "Wednesday" }
 CASE 4   { ASSIGN newToday = "Thursday" }
 CASE 5   { ASSIGN newToday = "Friday"  }
 CASE 6   { ASSIGN newToday = "Saturday"   }
}

Dans cet exemple, l'instruction ASSIGN au sein de l'instruction IF définit la condition initiale de la Variable myDate. Dans un script en production, cette valeur serait définie ailleurs dans le script et la valeur définie dans l'instruction IF serait ignorée. La raison pour laquelle vous en avez besoin lors du débogage de l'extrait est que le script complet n'est pas en cours d'exécution pour définir cette valeur.

  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 . Le script s’ouvre dans un nouvel onglet.
  3. Ouvrez une action SNIPPET ou ajoutez-en une nouvelle au canevas.

  4. En haut de la fenêtre Snippet editor , ajoutez le code suivant :

    IF test = 1
    {
    	[code or variable assignments]
    }
  5. À la place de [code ou affectations de variables], insérez le code ou les instructions ASSIGN dont vous avez besoin pour définir les conditions initiales requises pour l'exécution de l'extrait, telles que la définition des valeurs initiales de variable requises par le code de votre extrait. Par exemple :

    IF test = 1 {
     ASSIGN MyDate = "07/03/2026" //This date falls on a Friday
    }
  6. Ajoutez le code de l'extrait que vous souhaitez tester. Par exemple :

    ASSIGN myDow = myDate.asdatedow
    SWITCH myDow
    {
     CASE 0   { ASSIGN newToday = "Sunday"  }
     CASE 1   { ASSIGN newToday = "Monday"  }
     CASE 2   { ASSIGN newToday = "Tuesday" }
     CASE 3   { ASSIGN newToday = "Wednesday" }
     CASE 4   { ASSIGN newToday = "Thursday" }
     CASE 5   { ASSIGN newToday = "Friday"  }
     CASE 6   { ASSIGN newToday = "Saturday"   }
    }
  7. Pour tester le code, cliquez sur l'icône représentant un insecte Icon of an insect. pour ouvrir le débogueur.

  8. Cliquez sur Appliquer pour enregistrer l'extrait, puis enregistrez votre script.