Extraits de débogage dans 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 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 :

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

Utiliser l’outil de débogage

1. Dans Studio, ouvrez un script contenant une action Snippet.
2. Cliquez sur Ouvrir l'éditeur sur l'action Snippet.
3. Ajoutez du code Snippet, s'il n'en contient pas déjà un peu.
4. Sur le côté gauche de la fenêtre de l’éditeur d’extraits, cliquez sur le bogue . Le panneau Exécuter et déboguer glisse depuis le côté gauche de la fenêtre.
5. Cliquez sur le triangle pour démarrer le débogage.
6. Affichez le contenu de la section Variables du panneau Exécuter et déboguer. Cette section affiche les variables et leurs valeurs lorsque le débogueur a exécuté tout le code de l'extrait. Les objets de données dynamiques affichent la valeur {Dynamique}. Cliquez pour les développer et voir les valeurs de leurs membres.

7. Vérifiez les erreurs dans la variable _err à tout moment du processus de débogage. Certaines erreurs apparaissent sous forme de messages toast Les messages Toast sont de petits messages contextuels temporaires au bas de l’écran indiquant des choses comme les erreurs et les succès. Ils sont intégrés à la fonctionnalité CXone Mpower et peuvent apparaître sur n’importe quel écran. dans la fenêtre de l'éditeur Snippet .

   Afficher l’image

   

8. Pour apporter des modifications à votre extrait :
   1. Arrêtez le débogueur, s'il n'est pas déjà arrêté. Pendant que le débogueur est en cours d’exécution, l’extrait est en mode lecture seule.
   2. Apportez vos modifications.
   3. Cliquez sur Appliquer dans la fenêtre de l'éditeur Snippet. La fenêtre de l'éditeur se ferme automatiquement. Cela envoie les modifications au serveur, sur lequel le service de débogage s'exécute.
   4. Rouvrez la fenêtre de l’éditeur Snippet et exécutez à 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 l’extrait. Vous pouvez définir plusieurs points d’arrêt et demander au débogueur de passer d’un point d’arrêt à l’autre. Cela vous permet de voir les variables et les valeurs à des points spécifiques 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 son exécution. Le débogage s'arrête lorsque la ligne avec 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 Exécuter et déboguer.

1. Dans Studio, ouvrez un script contenant une action Snippet.
2. Cliquez sur Ouvrir l'éditeur sur l'action Snippet.
3. Ajoutez du code Snippet, s'il n'en contient pas déjà un peu.
4. Sur le côté gauche de la fenêtre de l’éditeur d’extraits, cliquez sur le bogue . Le panneau Exécuter et déboguer glisse 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 de l’éditeur d’extraits. Un cercle rouge apparaît à côté du numéro de ligne. Vous pouvez ajouter plusieurs points 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.

   Afficher l’image

   

6. Cliquez sur le triangle pour démarrer le débogage.
7. Affichez le contenu de la section Variables du panneau Exécuter et déboguer. Cette section affiche les variables et leurs valeurs au point d'arrêt, si vous en définissez un. La ligne où le débogage s’est interrompu pour le point d’arrêt est mise en évidence dans la fenêtre de l’éditeur d’extraits de code. Les objets de données dynamiques affichent la valeur {Dynamique}. Cliquez pour les développer et voir les valeurs de leurs membres.
8. Si vous avez terminé avec un point d'arrêt, cliquez à nouveau sur le cercle rouge pour l'effacer.
9. Pour continuer le débogage à partir du point d’arrêt, cliquez sur Reprendre . Si vous avez défini plusieurs points 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 . Vous pouvez reprendre à 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 toast Les messages Toast sont de petits messages contextuels temporaires au bas de l’écran indiquant des choses comme les erreurs et les succès. Ils sont intégrés à la fonctionnalité CXone Mpower et peuvent apparaître sur n’importe quel écran. dans la fenêtre de l'éditeur Snippet .

    Afficher l’image

    

12. Pour arrêter le débogage, cliquez sur le carré .
13. Pour apporter des modifications à votre extrait :
    1. Arrêtez le débogueur, s'il n'est pas déjà arrêté. Pendant que le débogueur est en cours d’exécution, l’extrait est en mode lecture seule.
    2. Apportez vos modifications.
    3. Cliquez sur Appliquer dans la fenêtre de l'éditeur Snippet. La fenêtre de l'éditeur se ferme automatiquement. Cela envoie les modifications au serveur, sur lequel le service de débogage s'exécute.
    4. Rouvrez la fenêtre de l’éditeur Snippet et exécutez à nouveau le débogueur.

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 Snippet.
2. Cliquez sur Ouvrir l'éditeur sur l'action Snippet.
3. Ajoutez du code Snippet, s'il n'en contient pas déjà un peu.
4. Sur le côté gauche de la fenêtre de l’éditeur d’extraits, cliquez sur le bogue . Le panneau Exécuter et déboguer glisse depuis le côté gauche de la fenêtre.

5. Cliquez dans la colonne à gauche de n’importe quelle ligne dans la fenêtre de l’éditeur d’extraits. Un cercle rouge apparaît à côté de la ligne. Il s'agit d'un point d'arrêt qui marque l'endroit à partir duquel vous pouvez commencer à parcourir le code.

   Afficher l’image

   

6. Cliquez sur le triangle pour démarrer le débogage. Si le point d'arrêt est sur la première ligne, aucun code n'est encore exécuté.
7. Affichez le contenu de la section Variables du panneau Exécuter et déboguer. Cette section affiche les variables dans le code et leurs valeurs avant le début de l'extrait de code. Les objets de données dynamiques affichent la valeur {Dynamique}. Cliquez pour les développer et voir les valeurs de leurs membres.
8. Cliquez sur la flèche vers le bas pour passer à la ligne suivante de l’extrait. La section Variables est mise à jour pour afficher les variables et leurs valeurs après l'exécution de la première ligne de code d'extrait.
9. Répétez les deux étapes précédentes pour chaque ligne de l’extrait. La section Variables continue d'être mise à jour après chaque ligne.
10. Si vous souhaitez ignorer les lignes de code restantes, cliquez sur Reprendre . La section Variables affiche les variables et leurs valeurs lorsque 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 toast Les messages Toast sont de petits messages contextuels temporaires au bas de l’écran indiquant des choses comme les erreurs et les succès. Ils sont intégrés à la fonctionnalité CXone Mpower et peuvent apparaître sur n’importe quel écran. dans la fenêtre de l'éditeur Snippet .

    Afficher l’image

    

12. Pour arrêter le débogage, cliquez sur le carré , puis répétez le processus de débogage si nécessaire.
13. Pour apporter des modifications à votre extrait :
    1. Arrêtez le débogueur, s'il n'est pas déjà arrêté. Pendant que le débogueur est en cours d’exécution, l’extrait est en mode lecture seule.
    2. Apportez vos modifications.
    3. Cliquez sur Appliquer dans la fenêtre de l'éditeur Snippet. La fenêtre de l'éditeur se ferme automatiquement. Cela envoie les modifications au serveur, sur lequel le service de débogage s'exécute.
    4. Rouvrez la fenêtre de l’éditeur Snippet et exécutez à nouveau le débogueur.

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

Le mot-clé TRACE vous permet de déboguer à l'aide de 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 extrait de code et exécutez le débogueur, le texte est affiché dans la section Trace de la fenêtre Exécuter et déboguer 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 ne fonctionne qu’avec l’outil de débogage.

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

Le texte entre guillemets est envoyé vers la section Trace de la fenêtre Exécuter et déboguer dans la fenêtre de l'éditeur Snippet.

Vous pouvez utiliser la substitution de variable 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