Débogueur de script et Journal de la session

La Débogueur de script permet aux utilisateurs ayant le rôle script_debugger de déboguer JavaScript côté serveur, tandis que la possibilité d’afficher Journal de la session et de télécharger les journaux requis.

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

• 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.
• Mettez en pause la session en cours à un point d’arrêt.
• Évaluer les expressions pendant l’exécution.
• Code pas à pas ligne par ligne.
• Entrez et sortez des appels de fonction et de méthode.
• Affichez la valeur des variables locales et globales.
• Affichez la valeur des variables privées à partir des fermetures de fonctions.
• Afficher la pile des appels.
• Affichez la transaction que le système est en train de traiter.
• Désactivez le débogueur de script pour reprendre l’exécution des scripts mis en pause.

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

• Affichez les journaux de session dans un onglet distinct.
• Télécharger un journal.
• Affichez 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 ce nombre de transactions et de messages à l’aide des préférences utilisateur et glide.debugger.log_messages_limit et glide.debugger.log.transaction.count respectivement. Pour plus d’informations sur les préférences utilisateur, reportez-vous à la glide.debugger.log.transaction.count section Paramètres glide.debugger.log_messages_limitdes préférences utilisateur.

Remarque :

Activez 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 sous 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 des préférences utilisateur définit le nombre d’instructions mises en cache dans une session de navigateur. La valeur par défaut du cache de déclaration est 20 et la valeur maximale est 100. Vous pouvez configurer la valeur du cache d’instruction à partir des 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.

Le 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 script includes, 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 True lors de l’exécution du script dans son contexte, le Débogueur de script peut le mettre en pause.

Remarque :

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

• Lorsqu’une règle métier exécute un script include sur un formulaire Soumettez cette transaction interactive en attente que les données du formulaire changent avant de continuer.
• Lorsqu’une tâche planifiée exécute le même script include, il s’agit d’une transaction en 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 de débogueur.

Pour afficher les journaux de débogage, reportez-vous à la section Afficher les journaux de débogage.

Remarque :

Lorsque la commande est activée, le Débogueur de script code est exécuté en mode interprété. Si certaines parties du script sont configurées 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. Ils Débogueur de script doivent s’exécuter sur des scripts en dehors du mode strict.

• Script tracer 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 les lignes de scripts 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 large 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 des 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 pas à pas et de console 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 de la console pour développer la console, réduire la console, effacer la console et réexécuter les expressions.
• Évaluer les expressions en exécution à l’aide de la console
  Définissez, déclarez et vérifiez les 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 Débogueur de script
  Les développeurs peuvent lancer la Débogueur de script commande à partir du navigateur Studiod’application ou de l’éditeur de syntaxe.
• Définir ou supprimer des points d’arrêt
  Définissez des points d’arrêt ou des points d’arrêt conditionnels pour mettre en pause les scripts sur 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 consigner les messages à la console sur 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 quelles actions de débogage sont disponibles et quelles informations elles peuvent afficher.
• Détails de la transaction
  Le Débogueur de script affiche les détails de transaction pour la session utilisateur actuellement mise en pause.
• Détails de la transaction disponibles
  La Débogueur de script fournit un ensemble standard de détails de transaction permettant aux développeurs de déboguer et de résoudre 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 Débogueur de script tout en empruntant l’identité d’un autre utilisateur, mais uniquement si l’utilisateur dont l’identité a été empruntée dispose du rôle script_debugger et d’un accès en lecture au script cible.
• Débogueur de script Scripts - Prise en charge de l’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.