Extraits de débogage

Vous pouvez déboguer les snippets à partir de la fenêtre de l'Éditeur de snippets de 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 :

• Vérifier la syntaxe dans le snippet. Vous pouvez le faire à tout moment pendant le codage d'un snippet. Cela n'utilise pas le débogueur.
• Déboguer l'ensemble du snippet pour voir les variables et leurs valeurs après l'exécution de l'ensemble du snippet.
• Définir un point d'arrêt pour arrêter le débogage à une ligne précise du code.
• Faire dfiler chaque ligne du snippet afin de voir comment les variables et leurs valeurs changent ligne par ligne.
• Utiliser des instructions TRACE pour produire des données dans le volet Trace de la fenêtre de l'éditeur de Snippet .

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

Vérification de la syntaxe d’un snippet

Vous pouvez demander à Studio de vérifier la syntaxe d'un snippet.

1. Dans Studio, ouvrez un script contenant une action Extrait.
2. Double-cliquez sur l'action Snippet.
3. Ajoutez le code Snippet dans l'onglet Text View , s'il n'en contient pas déjà.

4. Cliquez sur l'icône Check Syntax en bas de la fenêtre de l'éditeur Snippet .

   Si aucune erreur de syntaxe n'est trouvée, le champ de statut situé à côté de l'icône Vérifier la syntaxe affiche le message Okay.

   Si des erreurs de syntaxe sont détectées, un message d'erreur descriptif s'affiche. La description comprend le numéro de ligne où se trouve l'erreur. En outre, le champ de statut situé à côté de l'icône Vérifier la syntaxe affiche le message Error at line [#].

5. Corrigez les éventuels problèmes de syntaxe détectés.
6. Vous pouvez sélectionner une ou plusieurs lignes dans le code snippet et cliquer sur l'icône Comment out selected lines . Cette fonction est utile si vous souhaitez sauter une erreur et en rechercher d’autres erreurs.
7. Vous pouvez sélectionner une ou plusieurs lignes commentées dans le code du snippet et cliquer sur l'icône Uncomment the selected lines .

Utilisation de l'outil de débogueur

1. Dans Studio, ouvrez un script contenant une action Extrait.
2. Double-cliquez sur l'action Snippet.
3. Ajoutez le code Snippet dans l'onglet Text View , s'il n'en contient pas déjà some.
4. Sur le côté droit de la fenêtre Snippet editor, cliquez sur l'onglet Débogueur.
5. Cliquez sur le bouton flèche vers le bas situé sur le côté droit de l'icône Déboguer puis sélectionnez Démarrer.

6. S'il y a des erreurs de syntaxe dans le code, la fenêtre Snippet editor s'agrandit. Toutes les erreurs dans le code apparaissent dans un volet au bas de la fenêtre. Si aucune erreur n’a été rencontrée, passez à l’étape suivante.

   Voir l'image

   
   1. Corrigez les erreurs.
   2. Une fois les erreurs corrigées, cliquez sur les icônes Fermer ou effacer la Sortie de trace pour fermer le volet des erreurs.
   3. Démarrez à nouveau le débogueur.
7. Affichez le contenu de l'onglet variables as Text . L'onglet affiche les variables et leurs valeurs lorsque tout le code a été exécuté si vous n'avez pas défini de point d'arrêt.
8. Vous pouvez sélectionner une ou plusieurs lignes dans le code de l'extrait et cliquer sur l'icône Mettre en commentaire les lignes sélectionnées . Cela peut être utile si vous voulez supprimer du code afin de voir comment le résultat du débogage change.
9. Vous pouvez sélectionner une ou plusieurs lignes de code mises en commentaire et cliquer sur l'icône Décommenter les lignes sélectionnées pour réintégrer ces lignes dans l'extrait.

Débogage 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. Cela vous permet de voir les variables et les valeurs à mi-chemin du snippet sans avoir à le faire défiler ligne par ligne.

1. Dans Studio, ouvrez un script contenant une action Extrait.
2. Double-cliquez sur l'action Snippet.
3. Ajoutez le code Snippet dans l'onglet Text View , s'il n'en contient pas déjà some.

4. Cliquez dans la colonne à gauche des numéros de ligne dans la fenêtre éditeur d'Extrait. Un cercle rouge apparaît à ce numéro de ligne.

   Voir l'image

   
5. Sur le côté droit de la fenêtre Snippet editor, cliquez sur l'onglet Débogueur.
6. Cliquez sur le bouton flèche vers le bas situé sur le côté droit de l'icône Déboguer puis sélectionnez Démarrer.

7. S'il y a des erreurs de syntaxe dans le code, la fenêtre Snippet editor s'agrandit. Toutes les erreurs dans le code apparaissent dans un volet au bas de la fenêtre. Si aucune erreur n’a été rencontrée, passez à l’étape suivante.

   Voir l'image

   
   1. Corrigez les erreurs.
   2. Une fois les erreurs corrigées, cliquez sur les icônes Fermer ou effacer la Sortie de trace pour fermer le volet des erreurs.
   3. Démarrez à nouveau le débogueur.
8. Affichez le contenu de l'onglet variables as Text . L'onglet affiche les variables et leurs valeurs au point d'arrêt, si vous en avez défini un. La ligne où le débogage s'est arrêté pour le point d'arrêt est mise en surbrillance dans la fenêtre Snippet Editor.
9. Si vous avez terminé avec le point d'arrêt, cliquez à nouveau sur le cercle rouge pour l'effacer.
10. Si nécessaire, placez un autre point d'arrêt.
11. Pour continuer le débogage à partir du point d'arrêt, cliquez sur l'icône Reprendre .
12. Pour arrêter le débogage, cliquez sur l'icône Arrêter le débogage .

Défilement dans le code de snippet

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 Extrait.
2. Double-cliquez sur l'action Snippet.
3. Ajoutez le code Snippet dans l'onglet Text View , s'il n'en contient pas déjà some.
4. Sur le côté droit de la fenêtre Snippet editor, cliquez sur l'onglet Débogueur.
5. Cliquez sur le bouton flèche vers le bas situé sur le côté droit de l'icône Déboguer puis sélectionnez Démarrer.

6. S'il y a des erreurs de syntaxe dans le code, la fenêtre Snippet editor s'agrandit. Toutes les erreurs dans le code apparaissent dans un volet au bas de la fenêtre. Si aucune erreur n’a été rencontrée, passez à l’étape suivante.

   Voir l'image

   
   1. Corrigez les erreurs.
   2. Une fois les erreurs corrigées, cliquez sur les icônes Fermer ou effacer la Sortie de trace pour fermer le volet des erreurs.
   3. Démarrez à nouveau le débogueur.
7. Affichez le contenu de l'onglet variables as Text . Il affiche les variables du code et leurs valeurs au démarrage du code de l'Extrait.
8. Cliquez sur l'icône Étape pour passer à la ligne suivante dans l'extrait.
9. Répétez les deux étapes précédentes pour chaque ligne du snippet.
10. Si vous voulez sauter les lignes de code restantes, cliquez sur l'icône Reprendre . L'onglet variables as Text affiche les variables et leurs valeurs une fois que tout le code de l'extrait a été exécuté.
11. Pour arrêter le débogage, cliquez sur l'icône Arrêter le débogage , puis répétez cette procédure à partir de l'étape 3.

Consultation du contenu des objets dynamiques et des tableaux

Vous pouvez afficher le contenu des objets dynamiques dans la Snippet fenêtre de l'éditeur lorsque vous exécutez le débogueur.Cela vous permet de vérifier que l'objet contient bien les données qu'il est censé contenir à chaque étape de votre code.

1. Dans Studio, double-cliquez sur une action Extrait.
2. Ajoutez le code de l'extrait, si nécessaire.
3. Dans l'onglet Debugger , cliquez sur l'onglet variables sous forme d'arborescence.
4. Dans l'onglet Debugger , cliquez sur la flèche vers le bas située à côté de l'icône Commencer le débogage , puis sélectionnez Step Into . Si vous ne souhaitez pas exécuter le code ligne par ligne, cliquez sur l'icône Commencer le débogage.
5. Cliquez sur l'icône Étape et observez le contenu de l'onglet variables as Tree. Chaque fois que vous cliquez sur Étape, ce champ est mis à jour avec les variables et les objets du script après la ligne de code précédente. Sautez cette étape si vous avez cliqué sur Commencer le débogage.
6. Lorsque vous avez parcouru toutes les lignes de code ou si vous avez cliqué sur Commencer le débogage, l'onglet variables as Tree affiche toutes les variables, objets et leur contenu à la fin de l'extrait.

7. Vous pouvez cliquer sur l'icône + à côté des tableaux de chaînes ou des objets dynamiques dans le code pour les développer. Si le contenu est un autre tableau ou objet, vous pouvez continuer à développer l'arborescence pour voir ce que contient chaque entité.

   Voir l'image

   

Débogage à l'aide de TRACE

Le mot-clé TRACE vous permet de déboguer en utilisant la journalisation. Ce mot-clé ne fonctionne que lors de l'utilisation de 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 lancez le débogueur, le texte est affiché dans le volet Trace qui apparaît en bas de la fenêtre de l'éditeur Snippet .

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

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

Le texte entre guillemets doubles est affiché dans la fenêtre de l'éditeur de Snippet . Il apparaît dans le volet Trace au bas de la fenêtre.

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

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

Le résultat de cet exemple est le suivant :

I = 1

I = 2

I = 3

I = 4

I = 5

Utiliser la variable système de test

The variable is a system variable reserved for use in debugging snippets. It allows you to set the value of variables that are used in the snippet and would already be populated by the script before it hits the  action.

When you use in a snippet, it must be used as part of an  statement and set to 1. The code between the curly brackets only executes when you run the snippet debugger because the variable only equals 1 when the debugger runs. When the script runs for a contact La personne qui interagit avec un agent, un SRVI ou un robot dans votre centre d’appels., has the value of 0, so the code between the curly brackets in the  statement is ignored.

For example: 

In this example, the statement within the  statement sets the initial condition of the variable. In a live script, this value would be set elsewhere in the script and the value set in the  statement would be ignored. The reason you need it in debugging the snippet is that the full script isn't running to set that value.

1. Dans NiCE CXone, cliquez sur le sélecteur d'application et sélectionnez Omnicanal Routing > Studio .
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. Open a action or add a new one to the canvas.

4. Click the Text View tab.

5. At the top of the window, add the following code:

6. In place of , insert whatever code or  statements you need to set the initial conditions required for the snippet to run, such as setting initial variable values that your snippet code requires. For example: 

7. Add the snippet code that you want to test. For example:

8. To test the code, click the bug to open the debugger.

9. Click Apply to save the snippet, then save your script.