Débogueur de script et Journal de la session

Permet Débogueur de script aux utilisateurs disposant du rôle script_debugger de déboguer JavaScript côté serveur. Les utilisateurs disposant du rôle log_debugger peuvent utiliser pour Journal de la session afficher et télécharger les journaux requis.

Les utilisateurs disposant du rôle script_debugger peuvent effectuer ces actions à l’aide de Débogueur de script:

• Disposer d’une transaction de débogage dédiée, qui s’applique uniquement à la session en cours.
• Définissez et supprimez les points d’arrêt.
• Mettre en pause la session en cours à un point d’arrêt.
• Évaluer les expressions pendant l’exécution.
• Parcourez le code ligne par ligne.
• Entrez et sortez des appels de fonctions et de méthodes.
• Affichez la valeur des variables locales et globales.
• Affichez la valeur des variables privées à partir des fermetures de fonctions.
• Affichez la pile des appels.
• Affichez la transaction que le système traite.
• Désactivez le débogueur de script pour reprendre l’exécution des scripts en pause.

Utilisez l’onglet Journal de la session pour récupérer le journal de session pour les règles métier, les includes de script et une interface utilisateur personnalisée telle que celle qui ServiceNow® Espace de travail d'agent a un composant GraphQL. Les utilisateurs disposant du rôle log_debugger peuvent :

• Affichez les journaux de session dans un onglet distinct.
• Télécharger un journal.
• Afficher les journaux pour Espace de travail d'agent.
• Spécifiez les options de débogage pour afficher ou télécharger uniquement les journaux requis.

Par défaut, 100 transactions et 10 000 messages apparaissent sur l’onglet Journal de la session . Si le nombre de transactions ou de messages dépasse la valeur par défaut, le journal de session est effacé et les transactions ou messages suivants s’affichent. Vous pouvez configurer cette transaction et ce nombre de messages à l’aide des préférences utilisateur glide.debugger.log.transaction.count respectivement glide.debugger.log_messages_limit . Pour plus d’informations sur les glide.debugger.log.transaction.count préférences utilisateur et glide.debugger.log_messages_limit les préférences utilisateur, voir Paramètres des préférences utilisateur.

Remarque :

Activer Journal de la session en tant qu’onglet séparé à Débogueur de script l’aide de la glide.debugger.log.ui propriété système.

• L’option Page affiche les journaux dans les formulaires et les listes et dans l’onglet Journal de session .
• L’option Session affiche les journaux uniquement dans l’onglet Journal de session .

Pour plus d’informations sur la propriété système, consultez Propriétés glide.debugger.log.uisystème disponibles.

Lorsque vous exécutez une instruction dans la console, l’instruction exécutée est stockée dans le cache du navigateur. Vous pouvez utiliser la flèche vers le haut pour obtenir l’instruction précédente et la flèche vers le bas pour obtenir l’instruction suivante à partir du cache du navigateur. Le paramètre glide.debugger.console.cached_stmt_limit de préférence utilisateur définit le nombre d’instructions mises en cache dans une session de navigateur. La valeur par défaut du cache d’instruction est 20 et la valeur maximale est 100. Vous pouvez configurer la valeur du cache d’instruction dans les préférences utilisateur.

Remarque :

Les instructions mises en cache ne sont pas disponibles lorsque le cache du navigateur est effacé ou lorsque vous vous connectez à partir d’un autre navigateur ou d’un autre ordinateur.

L’outil Débogueur de script peut mettre en pause tout script côté serveur qui s’exécute dans une transaction interactive, comme les règles métier, les includes de script, les actions de script ou les actions d’interface utilisateur qui nécessitent une réponse pour continuer. Si la méthode GlideSystem isInteractive() renvoie la valeur True lors de l’exécution du script en contexte, elle Débogueur de script peut le mettre en pause.

Remarque :

Certains objets de script, tels que les includes de script, peuvent être appelés à partir de plusieurs contextes. Par exemple :

• Lorsqu’une règle métier s’exécute, un include de script sur un envoi de formulaire, c’est-à-dire une transaction interactive qui attend que les données du formulaire changent avant de continuer.
• Lorsqu’une tâche planifiée exécute le même include de script, c’est-à-dire une transaction d’arrière-plan non interactive qui peut également exécuter d’autres scripts simultanément.

Pour déboguer les scripts côté client, vous pouvez utiliser des outils de développement basés sur un navigateur.

Une transaction de débogueur reste ouverte tant que la session utilisateur est valide. Si un utilisateur se déconnecte ou si sa session expire, le système ferme la transaction du débogueur.

Pour afficher les journaux de débogage, consultez Afficher les journaux de débogage.

Remarque :

Lorsque la est activée, le Débogueur de script code est exécuté en mode interprété. Si certaines parties du script sont définies pour s’exécuter en mode strict, le débogueur n’est pas en mesure de trouver les objets corrects et le débogueur échoue. Le Débogueur de script doit s’exécuter sur des scripts en dehors du mode strict

• Suivi de script et scripts de débogage
  Le suivi de script peut vous aider à filtrer votre recherche de débogage pour affiner rapidement les problèmes de script. Vous pouvez identifier des lignes de script dans l’enregistrement Glide qui ont subi des modifications au cours de l’exécution. Trouver ces lignes de scripts spécifiques plutôt que d’effectuer une recherche étendue permet de gagner du temps et d’améliorer la productivité.
• Parties de l’interface utilisateur
  L’interface Débogueur de script affiche des informations sur les points d’arrêt définis, la pile d’appels et le numéro de ligne de la ligne de script en cours d’exécution, des détails sur les variables et les transactions, ainsi que l’état de la console.
• Contrôles de la console et de l’étape du débogueur de script
  Après avoir Débogueur de script mis en pause un script, utilisez les contrôles pas à pas pour passer d’une ligne de script à l’autre et d’un script à l’autre dans la pile des appels. Utilisez les commandes Console pour développer la console, réduire la console, effacer la console et réexécuter des expressions.
• Évaluer des expressions en cours d’exécution à l’aide de la console
  Définissez, déclarez et vérifiez de nouvelles variables et fonctions lorsque vous déboguez un script en cours d’exécution à l’aide de la console. L’exécution du script doit être mise en pause pour utiliser la console.
• Lancez le Débogueur de script
  Les développeurs peuvent lancer le Débogueur de script à partir du navigateur d’application, Studioou de l’éditeur de syntaxe.
• Définir ou supprimer les points d’arrêt
  Définissez des points d’arrêt ou des points d’arrêt conditionnels pour mettre en pause les scripts à des lignes spécifiques et supprimez les points d’arrêt lorsque vous avez terminé de les déboguer.
• Définir ou supprimer des points de connexion
  Définissez des points d’arrêt ou des points de connexion conditionnels pour journaliser les messages sur la console à des lignes spécifiques et supprimez les points de connexion lorsque vous avez terminé de les déboguer.
• Débogueur de script statut
  L’état Débogueur de script détermine les actions de débogage disponibles et les informations qu’il peut afficher.
• Détails de la transaction
  Affiche les Débogueur de script détails de transaction pour la session utilisateur en pause actuelle.
• Détails de la transaction disponibles
  Le Débogueur de script fournit un ensemble standard de détails de transaction permettant aux développeurs de déboguer et de dépanner les scripts.
• Débogueur de script Prise en charge de plusieurs développeurs
  Cela Débogueur de script permet à plusieurs développeurs de déboguer leurs propres transactions sans s’affecter mutuellement.
• Débogueur de script Prise en charge de l’emprunt d’identité
  Vous pouvez utiliser la tout en empruntant l’identité Débogueur de script d’un autre utilisateur, mais uniquement si l’utilisateur dont l’identité a été empruntée dispose du rôle script_debugger et dispose d’un accès en lecture au script cible.
• Débogueur de script Scripts : assistance en arrière-plan
  Le module Scripts - Arrière-plan ne prend pas en charge la définition de points d’arrêt directement dans le champ de script. Vous pouvez toutefois définir des points d’arrêt dans les objets de script appelés ou déclenchés par le module Scripts - Arrière-plan.
• Séparation de domaine et Débogueur de script
  L'application Séparation de domaine est prise en charge dans Débogueur de script. Séparation de domaine vous permet de séparer les données, les processus et les tâches administratives en groupes logiques appelés domaines. Vous pouvez contrôler plusieurs aspects de cette séparation, notamment les utilisateurs qui peuvent voir les données et y accéder.