Script Debugger und Sitzungsprotokoll

Mit dem Script Debugger können Benutzer mit der Rolle script_debugger serverseitiges JavaScript debuggen. Benutzer mit der Rolle „log_debugger“ können mit Sitzungsprotokoll die erforderlichen Protokolle anzeigen und herunterladen.

Benutzer mit der Rolle script_debugger können die folgenden Aktionen mit Script Debuggerausführen:

• Verfügen über eine dedizierte Debug-Transaktion, die nur für die aktuelle Sitzung gilt.
• Haltepunkte zu setzen und zu entfernen.
• Die aktuelle Sitzung an einem Haltepunkt anzuhalten.
• Wertet Ausdrücke während der Laufzeit aus.
• Den Code Zeile für Zeile durchgehen.
• In Funktions- und Methodenaufrufe ein- und aus diesen auszutreten.
• Den Wert von lokalen und globalen Variablen anzuzeigen.
• Den Wert privater Variablen in Funktionsabschlüssen anzuzeigen.
• Die Aufrufliste anzuzeigen.
• Zeigen Sie die Transaktion an, die das System verarbeitet.
• Deaktivieren des Skript-Debuggers, um die Ausführung angehaltener Skripts fortzusetzen.

Verwenden Sie die Registerkarte Sitzungsprotokoll, um das Sitzungsprotokoll für Business-Regeln, Skripteinbindungen und eine anwenderdefinierte Anwenderoberfläche wie ServiceNow® Mitarbeiterbereich mit einer GraphQL-Komponente abzurufen. Benutzer mit der Rolle „log_debugger“ können:

• Zeigen Sie Sitzungsprotokolle auf einer separaten Registerkarte an.
• Laden Sie ein Protokoll herunter.
• Zeigen Sie Protokolle für Mitarbeiterbereichan.
• Geben Sie Debug-Optionen an, um nur die erforderlichen Protokolle anzuzeigen oder herunterzuladen.

Standardmäßig werden auf der Registerkarte Sitzungsprotokoll 100 Transaktionen und 10.000 Nachrichten angezeigt. Wenn die Anzahl der Transaktionen oder Nachrichten den Standardwert überschreitet, wird das Sitzungsprotokoll gelöscht, und die nächsten Transaktionen oder Nachrichten werden angezeigt. Sie können diese Transaktions- und Nachrichtenanzahl mithilfe der Anwendereinstellungen glide.debugger.log.transaction.count bzw. glide.debugger.log_messages_limit konfigurieren. Weitere Informationen zu den Anwendereinstellungen glide.debugger.log.transaction.count und glide.debugger.log_messages_limit finden Sie unter Anwendereinstellungen.

Hinweis:

Aktivieren Sie Sitzungsprotokoll als separate Registerkarte mit Script Debugger mithilfe der Systemeigenschaft glide.debugger.log.ui.

• Die Option Seite zeigt Protokolle unter Formularen und Listen sowie auf der Registerkarte Sitzungsprotokoll an.
• Bei Verwendung der Option Sitzung werden Protokolle nur auf der Registerkarte Sitzungsprotokoll angezeigt.

Weitere Informationen zur Systemeigenschaft glide.debugger.log.ui finden Sie unter Verfügbare Systemeigenschaften.

Wenn Sie eine Anweisung in der -Konsole ausführen, wird die ausgeführte Anweisung im Browser-Cache gespeichert. Sie können die Nach-oben-Taste verwenden, um die vorherige Anweisung abzurufen, und die Nach-unten-Taste, um die nächste Anweisung aus dem Browsercache abzurufen. Die Benutzereinstellung glide.debugger.console.cached_stmt_limitdefiniert die Anzahl der Anweisungen, die in einer Browsersitzung zwischengespeichert werden. Der Standardwert für den Anweisungscache ist 20, der Höchstwert 100. Sie können den Wert des Anweisungscache in den Anwendereinstellungen konfigurieren.

Hinweis:

Die zwischengespeicherten Anweisungen sind nicht verfügbar, wenn der Browsercache geleert wird oder wenn Sie sich über einen anderen Browser oder einen anderen Computer anmelden.

Script Debugger kann jedes serverseitige Skript anhalten, das in einer interaktiven Transaktion ausgeführt wird, z. B. Business-Regeln, Skripteinbindungen, Skriptaktionen oder UI-Aktionen, für die eine Antwort erforderlich ist, um fortzufahren. Wenn die GlideSystem-Methode isInteractive() bei der Ausführung des Skripts im Kontext „True“ zurückgibt, kann Script Debugger das Skript anhalten.

Hinweis:

Einige Skriptobjekte, wie z. B. Skripteinbindungen, können in mehreren Kontexten aufgerufen werden. Zum Beispiel:

• wenn eine Business Rule eine Skripteinbindung für die Formularübermittlung ausführt, bei der es sich um eine interaktive Transaktion handelt, die auf die Änderung der Formulardaten wartet, bevor der Vorgang fortgesetzt wird.
• Wenn eine regelmäßige Aufgabe dieselbe Skripteinbindung ausführt, handelt es sich um eine nicht interaktive Hintergrundtransaktion, die gleichzeitig andere Skripts ausführen kann.

Zum Debuggen von clientseitigen Skripts können Sie browserbasierte Entwicklertools verwenden.

Eine Debugger-Transaktion bleibt solange geöffnet, wie die Benutzersitzung gültig ist. Wenn sich ein Benutzer abmeldet oder seine Sitzung abläuft, schließt das System die Debugger-Transaktion.

Informationen zum Anzeigen von Debug-Protokollen finden Sie unter Debugging-Protokolle anzeigen.

Hinweis:

Wenn Script Debugger aktiviert ist, wird Code im interpretierten Modus ausgeführt. Wenn Teile des Skripts im strikten Modus ausgeführt werden sollen, kann der Debugger die richtigen Objekte nicht finden und schlägt fehl. Script Debugger muss für Skripts außerhalb des strikten Modus ausgeführt werden.

• Script Tracer und Debugging-Skripts
  Mit dem Script Tracer können Sie Ihre Debugging-Suche filtern, um Skriptprobleme schnell einzugrenzen. Sie können im Glide-Datensatz Zeilen von Skripts identifizieren, die während der Ausführung geändert wurden. Das Auffinden dieser bestimmten Skriptzeilen anstelle einer umfassenden Suche hilft, Zeit zu sparen und die Produktivität zu verbessern.
• Teile der Anwenderoberfläche
  Die Schnittstelle Script Debugger zeigt Informationen über festgelegte Haltepunkte, die Aufrufliste und die Zeilennummer der aktuell ausgeführten Skriptzeile, Details zu Variablen und Transaktionenund den Status der Konsolean.
• Script Debugger – schrittweise Anleitungen und Konsolensteuerelemente
  Nachdem der Script Debugger ein Skript anhält, verwenden Sie die Schritt-für-Schritt-Steuerungen, um zwischen Skriptzeilen und zwischen Skripten in der Aufrufliste zu wechseln. Verwenden Sie die Konsolensteuerelemente, um die Konsole zu erweitern, sie zu reduzieren, sie zu löschen und Ausdrücke erneut auszuführen.
• Wertet Ausdrücke zur Laufzeit mit der -Konsole aus
  Definieren, deklarieren und überprüfen Sie neue Variablen und Funktionen, während Sie ein Skript zur Laufzeit mithilfe der -Konsole debuggen. Die Skriptausführung muss angehalten werden, um die Konsole zu verwenden.
• Starten des Script Debugger
  Entwickler können den Script Debugger aus dem Anwendungsnavigator, Studio oder aus dem Syntax-Editor starten.
• Haltepunkte setzen oder entfernen
  Legen Sie Haltepunkte oder bedingte Haltepunkte fest, um Skripts bei bestimmten Zeilen anzuhalten, und entfernen Sie Haltepunkte, wenn Sie mit dem Debuggen fertig sind.
• Legen Sie Protokollpunkte fest, oder entfernen Sie sie
  Legen Sie Haltepunkte oder bedingte Protokollpunkte fest, um Nachrichten in bestimmten Zeilen in der Konsole zu protokollieren, und entfernen Sie Protokollpunkte, wenn Sie mit dem Debuggen fertig sind.
• Script Debugger Status
  Der Script Debugger Status bestimmt, welche Debugging-Aktionen verfügbar sind und welche Informationen angezeigt werden können.
• Transaktionsdetails
  Der Script Debugger zeigt Transaktionsdetails für die aktuell angehaltene Benutzersitzung an.
• Verfügbare Transaktionsdetails
  Der Script Debugger bietet ein Standardset von Transaktionsdetails für Entwickler zum Debuggen und zur Problembehandlung von Skripts.
• Script Debugger-Unterstützung für mehrere Entwickler
  Der Script Debugger ermöglicht es mehreren Entwicklern, ihre eigenen Transaktionen zu debuggen, ohne sich gegenseitig zu beeinflussen.
• Script Debugger Support zur Verwendung einer anderen Identität
  Sie können den Script Debugger verwenden, während Sie die Identität eines anderen Benutzers annehmen, jedoch nur, wenn der Benutzer, dessen Identität Sie annehmen über die Rolle „script_debugger“ und über Lesezugriff auf das Zielskript verfügt.
• Script Debugger Skripts – Hintergrund Support
  Das Modul „Skripts – Hintergrund“ unterstützt das Festlegen von Haltepunkten direkt im Skriptfeld nicht. Sie können jedoch Haltepunkte in den Skriptobjekten festlegen, die vom Modul „Skripts – Hintergrund“ aufgerufen oder ausgelöst werden.
• Domain Separation und Script Debugger
  Die Domänentrennung wird in Script Debugger unterstützt. Mit der Domain Separation können Sie Daten, Prozesse und Verwaltungsaufgaben in logische Gruppierungen, sogenannte Domänen, aufteilen. Sie können verschiedene Aspekte dieser Trennung steuern, einschließlich der Benutzer, die Daten sehen und darauf zugreifen können.