Script Debugger und Sitzungsprotokoll

Mit Script Debugger können Benutzer mit der Rolle „script_debugger“ serverseitiges JavaScript debuggen, während Sie mit Sitzungsprotokoll erforderliche Protokolle anzeigen und herunterladen können.

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

• Über eine dedizierte Debug-Transaktion verfügen, die nur für die aktuelle Sitzung gilt.
• Haltepunkte zu setzen und zu entfernen.
• Die aktuelle Sitzung an einem Haltepunkt anzuhalten.
• Wertet Ausdrücke zur 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 Rules, Skripteinbindungen und eine benutzerdefinierte UI wie ServiceNow® Mitarbeiterbereich abzurufen, die über eine GraphQL-Komponente verfügt. Benutzer mit der Rolle „script_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 in den Benutzereinstellungen glide.debugger.log.transaction.count bzw. glide.debugger.log_messages_limit konfigurieren. Weitere Informationen zu den Benutzereinstellungen glide.debugger.log.transaction.count und glide.debugger.log_messages_limit finden Sie unter Benutzereinstellungen.

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 und auf der Registerkarte Sitzungsprotokoll an.
• Die Option Sitzung zeigt Protokolle nur auf der Registerkarte Sitzungsprotokoll an.

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 Browsercache 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 und der Höchstwert ist 100. Sie können den Anweisungscachewert in den Benutzereinstellungen konfigurieren.

Hinweis:

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

Der Script Debugger kann jedes serverseitige Skript anhalten, das in einer interaktiven Transaktion ausgeführt wird, z. B. Business Rules, Skripteinbindungen, Skriptaktionen oder UI-Aktionen, die eine Antwort erfordern, um fortzufahren. Wenn die GlideSystem-Methode isInteractive()True zurückgibt, wenn das Skript im Kontext ausgeführt wird, kann Script Debugger es anhalten.

Hinweis:

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

• Wenn eine Business Rule eine Skripteinbindung für eine Formularübermittlung ausführt, bei der es sich um eine interaktive Transaktion handelt, die auf die Änderung der Formulardaten wartet, bevor sie fortgesetzt wird.
• wenn eine regelmäßige Aufgabe dieselbe Skripteinbindung ausführt, bei der es sich um eine nicht interaktive Hintergrundtransaktion handelt, die auch andere Skripts gleichzeitig 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 der Code im interpretierten Modus ausgeführt. Wenn Teile des Skripts so festgelegt sind, dass sie im strikten Modus ausgeführt werden, kann der Debugger die richtigen Objekte nicht finden, und der Debugger schlägt fehl. Script Debugger muss für Skripts außerhalb des strikten Modus ausgeführt werden.

• Script Tracer und Debugging-Skripts
  Mit dem Skript-Tracer können Sie Ihre Debugging-Suche filtern, um Skriptprobleme schnell einzugrenzen. Sie können Zeilen von Skripts im Glide-Datensatz identifizieren, die während der Ausführung geändert wurden. Wenn Sie diese bestimmten Skriptzeilen suchen, anstatt eine weite Suche durchzuführen, sparen Sie Zeit und verbessern die Produktivität.
• Teile der Benutzeroberfläche
  Die Schnittstelle Script Debugger zeigt Informationen zu festgelegten Haltepunkten, die Aufrufliste und die Zeilennummer der aktuell ausgeführten Skriptzeile, Details zu Variablen und Transaktionenund den Status der Konsolean.
• Skript-Debugger – Schritt-für-Schritt-Anweisungen 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 Konsolensteuerungen, um die Konsole zu erweitern, die Konsole zu reduzieren, die Konsole zu löschen und Ausdrücke erneut auszuführen.
• Bewerten Sie Ausdrücke zur Laufzeit mithilfe der Konsole
  Definieren, deklarieren und überprüfen Sie neue Variablen und Funktionen, während Sie ein Skript zur Laufzeit mit der -Konsole debuggen. Die Skriptausführung muss angehalten werden, um die Konsole verwenden zu können.
• 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 an bestimmten Zeilen anzuhalten, und entfernen Sie Haltepunkte, wenn Sie mit dem Debuggen fertig sind.
• Protokollpunkte festlegen oder entfernen
  Legen Sie Haltepunkte oder bedingte Protokollpunkte fest, um Nachrichten in der Konsole an bestimmten Zeilen 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.