Field Watcher

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 5 Minuten Lesedauer

    • Das Tool Field Watcher verfolgt alle Aktionen, die das System für ein ausgewähltes Formularfeld ausführt, und zeigt diese an.

    Hinweis:
    Der Feldbeobachter wird mit Next Experience in Utahnicht unterstützt. Weitere Informationen zu unterstützten Funktionen in Next Experiencefinden Sie unter Überlegungen zur Aktivierung von Next Experience.

    Administratoren können mit Field Watcher herausfinden, was mit dem Feld geschieht und wie sich der Wert des Felds ändert, wenn ein Event wie das Auslösen einer Business Rule oder die Durchsetzung einer Datenrichtlinie stattfindet. Administratoren können sich auch als Nicht-Admin-Benutzer ausgeben, um zu debuggen, was passiert, wenn diese Benutzer Änderungen an einer Instanz vornehmen. Es kann jeweils nur ein Feld beobachtet werden. Benutzer ohne Administratorberechtigung mit der Rolle „Identitätswechsel“ haben Zugriff auf das Field Watcher-Feature.

    Funktionsweise des Field Watcher

    Das Tool Field Watcher protokolliert Aktivitäten, wenn eines der folgenden Events in einem Feld auftritt:
    • Der Standardwert wird für das Feld festgelegt.
    • Benutzerzugriffsrechte für das Feld ändern sich aufgrund einer ACL- oder Dictionary-Einstellung.
    • Eine Datenrichtlinie verhindert, dass der Wert festgelegt wird.
    • Eine Referenzqualifizierer-Abfrage des Feldwerts wird ausgeführt.
    • Eine Benutzeroberflächenrichtlinie ändert ein Feld zu oder von schreibgeschützt, sichtbar, obligatorisch oder bearbeitbar.
    • Ein abhängiger Wert in einem anderen Feld schränkt die Auswahlmöglichkeiten ein.
    • Der Wert des Feldes wird festgelegt oder geändert, basierend auf:
      • Zuweisungsregeln
      • Aktionen von einer Engine, z. B. der Workflow-Engine
      • Business Rules
      • Benutzereinträgen
      • Client-Skripts
      • UI Actions
    Hinweis:
    Field Watcher funktioniert nur für Formularfelder. Kann nicht für Listenfelder verwendet werden. Field Watcher ist für passwortgeschützte Felder oder verschlüsselte Felder nicht verfügbar. Field Watcher ist nur innerhalb des UI-Frames verfügbar. Die Option zum Anzeigen eines Felds wird nicht im Kontextmenü angezeigt, wenn Sie einen Datensatz außerhalb des UI-Frames öffnen, z. B. auf einer neuen Registerkarte.

    Field Watcher verwenden

    Greifen Sie auf Debugging-Informationen auf Feldebene über Field Watcher zu.

    Vorbereitungen

    Erforderliche Rolle: keine

    Prozedur

    1. Navigieren Sie zu dem Formular, für das Sie Debugging-Informationen auf Feldebene anzeigen möchten.
    2. Aktivieren Sie Field Watcher, indem Sie mit der rechten Maustaste auf eine Feldbezeichnung in einem Formular klicken und ‚<Feldname>‘ beobachen auswählen.

      Das Debugger-Symbol (Das Debugger-Symbol) erscheint neben der Feldbezeichnung. Ab diesem Zeitpunkt zeichnet Field Watcher jede Aktion auf, die in dem ausgewählten Feld ausgeführt wird. Wenn Sie zum Beispiel ein Priorität-Feld beobachten, und die Priorität von mittel auf niedrig geändert wird, und der Datensatz aktualisiert wird, zeigt Field Watcher Informationen zu dieser Änderung an.

    3. Zeigen Sie das Protokoll des Field Watcher an, indem Sie auf das Debugger-Symbol klicken.
      Am unteren Bildschirmrand wird ein neues Fenster mit einer Registerkarte für Field Watcher angezeigt. Es können auch Registerkarten für JavaScript-Protokollierung und JavaScript-Debugger angezeigt werden.
    4. Klicken Sie auf die Registerkarte Field Watcher, falls erforderlich.
    5. Stoppen Sie die Beobachtung eines Feldes, indem Sie mit der rechten Maustaste auf das Feld klicken und <Feldname> nicht mehr beobachten auswählen.
      Klicken Sie, um eine anderes Feld zu beobachten, mit der rechten Maustaste auf dieses Feld und wählen Sie <Feldname> beobachten aus.
    6. Löschen Sie das Protokoll des Field Watcher, indem Sie auf die Schaltfläche zum Leeren des Protokolls klicken (Die Schaltfläche zum Leeren des Protokolls).
    7. Ändern Sie die Größe des Field Watcher-Bereichs, indem Sie die Trennleiste nach oben oder unten ziehen.
      Durch Ziehen der Trennleiste zum unteren Bildschirmrand wird der Field Watcher-Bereich geschlossen. Öffnen Sie den Bereich erneut, indem Sie erneut auf das Debugger-Symbol klicken.

    Details zur Registerkarte Field Watcher

    Field Watcher zeigt Feldinformationen und Konfigurationsoptionen an.

    Auf der linken Seite der Registerkarte Field Watcher werden die folgenden Informationen für das überwachte Feld angezeigt.
    • Tabelle: Tabelle, zu der das Feld gehört.
    • Element: Feldbezeichnung.
    • Typ: Typ der im Feld gespeicherten Daten.
    • Abhängig: Feld, von dem das aktuelle Feld abhängt.
    • Referenz: Tabelle, aus der der Feldwert stammt, falls zutreffend.
    • Referenz-Qual: Referenzqualifizierer, die möglicherweise Daten in dem Feld einschränken.
    • Attribute: Attribute für das Feld, wie im Dictionary-Eintrag für dieses Feld angegeben.

    Wählen Sie auf der rechten Seite der Registerkarte Field Watcher die Art der Aktivitätsinformationen aus, die Sie für das ausgewählte Feld anzeigen möchten. Deaktivieren Sie die Checkbox für Informationen, die nicht benötigt werden.

    Versteckte Felder beobachten

    Administratoren müssen möglicherweise ein verstecktes Feld beobachten.

    Prozedur

    1. Verwenden Sie das Dictionary, um den Spaltennamen des Felds zu ermitteln.
    2. Erhöhen Sie die Berechtigungen auf die Rolle security_admin.
    3. Navigieren zu Systemdefinition > Skripts im Hintergrund.
    4. Geben Sie in Skript ausführen (JavaScript wird auf dem Server ausgeführt) den folgenden Befehl ein: 
      gs.getSession ( ). setWatchField ( "hidden_field" ) ;

      Ersetzen Sie hidden_field durch den Spaltennamen des ausgeblendeten Felds.

    5. Navigieren Sie zu dem Formular, das das fehlende Feld enthält.

      Die Ausgabe der Registerkarte „Feldbeobachtung“ enthält Informationen zum ausgeblendeten Feld.

    Informationen für das überwachte Feld anzeigen

    Wenn Informationen zu einem überwachten Feld geändert werden und der Datensatz aktualisiert wird, werden am Ende der Registerkarte Field Watcher relevante Informationen angezeigt.

    Abbildung : 1. Field Watcher – Anzeigedaten
    Field Watcher – Anzeigedaten
    Field Watcher-Informationen umfassen:
    • Zeitstempel: Uhrzeit, zu der das Feld geändert wurde, im Format HH:MM:SS (ms).
      • Orangener Text: serverseitige Änderungen wie ACLs.
      • Blauer Text: clientseitige Änderungen wie Client-Skripts.
    • Objekttyp, der das Feld und den zugehörigen Namen geändert hat: Die Art des Elements, das sich im Feld geändert hat; zum Beispiel, CLIENT-SKRIPT, Business Rule oder ACL. Bei Skripts, Business Rules oder anderen Feldern des Konfigurationstyps zeigt Field Watcher den Namen des Skripts oder der Business Rule an, die das Feld geändert hat, sofern vorhanden. Klicken Sie auf den Namen, um direkt zum Datensatz für dieses Element zu gelangen.
    • Alte und neue Werte: Die alten und neuen Werte für das Feld, wenn sich der Wert geändert hat. Field Watcher zeichnet den Wert nicht auf, wenn er zum Zeitpunkt der Erstellung des Datensatzes standardmäßig in das Formular eingefügt wurde.
    • Zusätzliche Informationen: Rufen Sie Informationen zur Nachverfolgung auf, z. B. den Namen der Skript-Engine oder des Workflows, die das Feld geändert haben. Klicken Sie auf das Plus-Symbol, um die Auswahl zu erweitern.
      • Orangener Text: Zeigt serverseitige Aktivität an.
      • Blauer Text: Zeigt eine clientseitige Aktivität an.

    Beispiel: Incident-Priorität überwachen

    Das folgende Beispiel zeigt, was mit dem Feld Priorität auf dem Incident-Formular geschieht, wenn sowohl das Feld Auswirkung als auch das Feld Dringlichkeit geändert wird.

    Das Incident-Formular enthält zwei clientseitige Datensuchen, um die Priorität zu ändern. Außerdem werden serverseitige ACLs und die Engine der Datensuche ausgelöst, wenn der Datensatz gespeichert wird. Schließlich legt eine clientseitige Benutzeroberflächenrichtlinie das Feld Priorität wieder als schreibgeschützt fest. Dies ist die Standardeinstellung.
    Tabelle : 1. Die Priorität des Incidents beobachten
    Originalwerte
    • Priorität: 1 – Kritisch
    • Auswirkungen: 1 – Hoch
    • Dringlichkeit: 1 – Hoch
    Erste Änderung
    1. Der Benutzer ändert dwn Wert Auswirkung zu 3 – Niedrig.
    2. Die Priorität wird automatisch zu 3 – Mittel geändert, basierend auf der Definition der Datensuche Suchen mit Priorität, die standardmäßig in ServiceNowIncidents verwendet wird.
    Hinweis:
    Zu diesem Zeitpunkt wurde der Datensatz nicht gespeichert.
    Zweite Änderung
    1. Der Benutzer ändert den Wert Dringlichkeit zu 2 – Mittel.
    2. Die Priorität wird automatisch zu 4 – Niedrig geändert, basierend auf derselben Definition der Datensuche Suchen mit Priorität.
    3. Der Benutzer speichert den Datensatz, indem er mit der rechten Maustaste auf die Formularkopfzeile klickt und Speichern auswählt.
    Abbildung : 2. Beispiel für Field Watcher
    Hinweis:
    Die Werte, die von 1 auf 3 und dann von 3 auf 4 geändert werden, beziehen sich auf die numerischen Werte in der Auswahlliste.