Déboguer l’extrait de code

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 de l’extrait. Cela peut vous aider à résoudre des problèmes dans votre code. Il existe cinq options pour déboguer les extraits de code :

• Vérifier la syntaxe dans l’extrait de code. Vous pouvez le faire à tout moment pendant le codage d’un extrait de code. Cette option n’utilise pas l’outil de débogage.
• Déboguer l’ensemble de l’extrait de code pour voir les variables et leurs valeurs après l’exécution de l’ensemble de l’extrait de code.
• Définir un point d’arrêt pour arrêter le débogage à une certaine ligne du code.
• Parcourir chaque ligne de l’extrait de code et observer comment les variables et leurs valeurs changent ligne par ligne.
• Utiliser les instructions TRACE pour produire des données dans le volet Trace de la fenêtre de l’éditeur Snippet .

En outre, si votre code contient des objets dynamiques ou des tableaux, vous pouvez afficher leur contenu et voir comment il change.

Vérifier la syntaxe de l’extrait de code

Vous pouvez demander à Studio de vérifier la syntaxe d’un extrait de code.

1. Dans Studio, ouvrez un script contenant une action Extrait.
2. Double-clic sur l'action Extrait.
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 d’état 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 s’affiche, décrivant l’erreur. La description comprend le numéro de ligne où se trouve l’erreur. En outre, le champ d’état situé à côté de l’icône de vérification de la syntaxe affiche le message suivant : Error at line [#].

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

Utiliser l’outil de débogage

1. Dans Studio, ouvrez un script contenant une action Extrait.
2. Double-clic sur l'action Extrait.
3. Ajoutez le code Snippet dans l'onglet Text View , s'il ne contient pas déjà some.
4. Du côté droit de la fenêtre Snippet editor, cliquez sur l'onglet Débogueur.
5. Cliquez sur le bouton de la flèche vers le bas à droite de l'icône Déboguer et 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 panneau au bas de la fenêtre. S'il n'y a aucune erreur, passez à l'étape suivante.

   Visualiser 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 panneau d'erreurs.
   3. Redémarrez le débogueur.
7. Affichez le contenu de l'onglet Variables as Text . L'onglet affiche les variables et leurs valeurs une fois que 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 les lignes sélectionnées en commentaire . Cela est utile si vous voulez supprimer du code pour 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 Annuler la mise en commentaire des lignes sélectionnées pour rajouter ces lignes dans l'extrait.

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 l’extrait. Cela vous permet de voir les variables et les valeurs à mi-chemin de l’extrait sans avoir à le parcourir ligne par ligne.

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

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

   Visualiser l’image

   
5. Du côté droit de la fenêtre Snippet editor, cliquez sur l'onglet Débogueur.
6. Cliquez sur le bouton de la flèche vers le bas à droite de l'icône Déboguer et 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 panneau au bas de la fenêtre. S'il n'y a aucune erreur, passez à l'étape suivante.

   Visualiser 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 panneau d'erreurs.
   3. Redémarrez 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. Placez un autre point d’arrêt, si vous en avez besoin.
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 .

Entrer par le code de l’extrait

Vous pouvez utiliser l’outil de débogage pour parcourir le code de l’extrait ligne 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-clic sur l'action Extrait.
3. Ajoutez le code Snippet dans l'onglet Text View , s'il ne contient pas déjà some.
4. Du côté droit de la fenêtre Snippet editor, cliquez sur l'onglet Débogueur.
5. Cliquez sur le bouton de la flèche vers le bas à droite de l'icône Déboguer et 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 panneau au bas de la fenêtre. S'il n'y a aucune erreur, passez à l'étape suivante.

   Visualiser 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 panneau d'erreurs.
   3. Redémarrez le débogueur.
7. Affichez le contenu de l'onglet Variables as Text . Il affiche les variables dans le 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 de l’extrait.
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 ce processus à partir de l'étape 3.

Afficher le contenu des objets dynamiques et des tableaux

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

1. Dans Studio, double-cliquez sur une action Extrait.
2. Ajouter un extrait de code, si nécessaire.
3. Dans l'onglet Débogueur , cliquez sur l'onglet Variables sous forme d'arborescence.
4. Dans l'onglet Débogueur , cliquez sur la flèche vers le bas à côté de l'icône Commencer le débogage et sélectionnez Étape par étape . Si vous ne souhaitez pas parcourir 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 sous forme d'arborescence. Chaque fois que vous cliquez sur Étape, ce champ est mis à jour avec les variables et 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 sous forme d'arborescence affiche toutes les variables, tous les objets et leur contenu à la fin de l'extrait.

7. Vous pouvez cliquer sur l'icône + à côté de tout tableau de chaînes ou objet dynamique dans le code pour le 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é.

   Visualiser l’image

   

Déboguer à 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 au bas de la fenêtre de l’éditeur Snippet .

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

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

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

Vous pouvez utiliser la substitution de variables entre les guillemets 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

La variable est une variable système réservée à l'utilisation dans le débogage des extraits. Il vous permet de définir la valeur des variables qui sont utilisées dans l'extrait et qui seraient déjà remplies par le script avant qu'il n'atteigne l'action .

Lorsque vous utilisez dans un extrait, il doit être utilisé dans le cadre d'une instruction et défini sur 1. Le code entre les accolades ne s'exécute que lorsque vous exécutez le débogueur d'extraits, car la variable n'est égale à 1 que lorsque le débogueur s'exécute. Lorsque le script s'exécute pour un contact La personne qui interagit avec un agent, un SRVI ou un robot dans votre centre d’appels., a la valeur 0, donc le code entre les accolades dans l'instruction est ignoré.

1. Dans NiCE CXone, cliquez sur le sélecteur d'applications et sélectionnez Omnicanal Routing > Studio .
2. Sur la page Scripts, repérez et double-cliquez pour ouvrir le script que vous voulez utiliser. Le script s'ouvre dans un nouvel onglet.

3. Ouvrez une action ou ajoutez-en une nouvelle au canevas.

4. Click the Text View tab.

5. En haut de la fenêtre , ajoutez le code suivant :

6. Au lieu de , insérez le code ou les instructions dont vous avez besoin pour définir les conditions initiales requises pour l'exécution de l'extrait.

7. Ajoutez tout autre code requis par l’extrait.

8. Pour tester le code, cliquez sur le bogue pour ouvrir le débogueur.

9. Cliquez sur Appliquer pour sauvegarder l'extrait, puis enregistrez votre script.