Débogueur de script et Journal de la session

Permet aux Débogueur de script utilisateurs ayant le rôle script_debugger de déboguer JavaScript côté serveur. Les utilisateurs disposant du rôle log_debugger peuvent utiliser le Journal de la session pour 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 des points d’arrêt.
• Mettez la session en cours en pause à un point d’arrêt.
• Évaluez les expressions pendant l’exécution.
• Pas à pas à travers le code 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.
• Affichez 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 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 ServiceNow® Espace de travail d'agent celle qui comporte 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 dans 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 glide.debugger.log.transaction.count préférences utilisateur et glide.debugger.log_messages_limit et respectivement. Pour plus d’informations sur les préférences utilisateur, reportez-vous à la section Paramètres des glide.debugger.log.transaction.countglide.debugger.log_messages_limitpré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 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 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 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 vidé 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 includes de script, les actions des scripts ou les actions d’interface utilisateur qui nécessitent une réponse pour être poursuivis. Si la méthode GlideSystem isInteractive() renvoie True lors de l’exécution du script en contexte, alors le 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 exécute un script include sur un formulaire Soumettez qui est une transaction interactive en attente que les données du formulaire soient modifiées avant de continuer.
• Lorsqu’une tâche planifiée exécute le même include de script, 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 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 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 les 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 les lignes de scripts dans l’enregistrement Glide qui ont subi des modifications pendant 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 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 de la console et de l’exécution pas à pas de Débogueur de script
  Une fois qu’un Débogueur de script script a été mis en pause, utilisez les contrôles pas à pas pour vous déplacer entre les lignes de script et entre les scripts 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 des expressions.
• Évaluer les expressions en cours d’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 le Débogueur de script
  Les développeurs peuvent lancer la Débogueur de script à partir du navigateur Studiod’applications 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 supprimer 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 les actions de débogage disponibles et les informations qu’elles peuvent afficher.
• Détails de la transaction
  Il Débogueur de script affiche les détails de la transaction pour la session utilisateur en pause en cours.
• 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
  Il Débogueur de script permet à plusieurs développeurs de déboguer leurs propres transactions sans s’affecter les uns les autres.
• Débogueur de script Prise en charge de l’emprunt d’identité
  Vous pouvez utiliser tout en empruntant l’identité Débogueur de script d’un autre utilisateur, mais uniquement si l’utilisateur dont l’identité est empruntée dispose du rôle script_debugger et 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.