HistoryWalker – Scoped, Global

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 16 Minuten Lesedauer

    • Die HistoryWalker-API verwendet die Audit-/Protokolltabellen, um eine Verlaufsversion eines vorhandenen Datensatzes zu generieren. Diese historische Version enthält alle Updates für alle Felder für den angegebenen Glide-Datensatz.

    Diese API bietet die Möglichkeit, einen GlideRecord auf eine vorherige Update-Anzahl (Walking GlideRecord) zurückzusetzen, wobei die entsprechenden Glide-Elemente ausgefüllt sind. Nachdem der Walking GlideRecord abgerufen wurde, bietet die API die Möglichkeit, zwischen den Update-Nummern vorwärts und rückwärts zu wechseln und durch die historischen Updates zu navigieren.

    Diese API ermöglicht Ihnen Folgendes:

    • Weisen Sie an HistoryWalker API zur Verwendung einer bestimmten History Walker-Implementierung zum Abrufen von Audit-Daten.
    • Navigieren Sie durch die historische Version eines Glide-Datensatzes.
    • Wenden Sie die entsprechenden Verlaufs-/Audit-Daten an, um einen vorhandenen GlideRecord auf den Status in einer bestimmten Update-Anzahl zu erhalten.
    • Deaktivieren Sie die Zugriffssteuerung auf Zeilenebene.
    • Deaktivieren Sie die Zugriffssteuerung auf Feldebene.
    • Deaktivieren Sie den Abruf und die Verarbeitung von „Changes“-Daten.
    • Sie können Journalfelder aktivieren.
    • Variablen aktivieren

    Die HistoryWalker Die API bietet vier Möglichkeiten zum Abrufen von Audit-Daten:

    1. VERLAUF: VERLAUF-Walker

      Wenn nicht verfügbar oder nicht aktuell, wird ein Verlaufssatz-Datensatz [sys_history_Set] für den Glide-Datensatz erstellt, den Sie beim Instanziieren von übergeben haben HistoryWalker API, die die Daten in der Tabelle „SYS-Audit“ [sys_Audit] verwendet. Die Tabelle „sys_history_Set“ enthält den Namen der zugehörigen Verlaufstabelle [sys_history_line]. Die Tabelle „sys_history_line“ enthält einen Datensatz für jeden Feldwert, der in der zu bearbeitenden Tabelle aktualisiert wurde. Mit dieser Abrufmethode HistoryWalker Methoden rufen Verlaufsdaten aus der generierten Tabelle „sys_history_line“ ab, anstatt die Tabelle „sys_Audit“ direkt abzufragen.

      Die Datensätze in der Tabelle „sys_history_line“ werden nach aufsteigenden Feldwerten „Aktualisieren“ [Update] sortiert und nicht nach chronologischer Reihenfolge gruppiert. Das Update-Feld ist lose mit dem Feld Updates [sys_mod_count] in der Aufgabentabelle verknüpft.
      Hinweis:
      Aktualisierungen von sys_mod_count durch Clients werden nicht synchronisiert und können daher überschrieben werden, wodurch diese Anzahl unzuverlässig ist.
    2. AUDIT: Audit-Walker

      Fragt die Tabelle „sys_Audit“ für den Glide-Datensatz ab, den Sie beim Instanziieren von übergeben haben HistoryWalker API. Jeder Datensatz in der Tabelle „sys_Audit“ enthält die Änderungen an Feldwerten, die während der Lebensdauer des Datensatzes aufgetreten sind.

      Datensätze werden aufsteigend nach dem Feld „Aktualisierungsanzahl“ [Record_checkpoint] und nicht nach chronologischer Reihenfolge sortiert. Das Feld Record_Checkpoint ist lose mit dem Feld Updates [sys_mod_count] in der Aufgabentabelle verknüpft. 1:1-Korrelation ist nicht garantiert.

      Bei der Entscheidung, ob die AUDIT-Abrufmethode verwendet werden soll, sollten Sie Folgendes beachten:
      • Größe der Tabelle „sys_Audit“. Die Tabelle „sys_Audit“ kann ziemlich groß werden, da die Änderungen für alle Felder in allen Datensätzen in dieser Tabelle beibehalten werden.
      • Möglicherweise fehlt es je nach Einstellung der Systemeigenschaft an Update-Null-Datensatz glide.sys.audit_inserts. Diese Eigenschaft definiert, ob ein Audit-Datensatz mit den anfänglichen Feldwerten erstellt wird, wenn ein Datensatz zum ersten Mal in eine Tabelle eingefügt wird. In einem -Basissystem ist diese Eigenschaft auf „falsch“ festgelegt, was den verursacht HistoryWalker API zur zusätzlichen Verarbeitung zur Berücksichtigung dieser fehlenden Informationen.
      Daher wird ausgeführt HistoryWalker API mit AUDIT ist nicht so leistungsfähig wie VERLAUF oder PRÜFPUNKT.
    3. PRÜFPUNKT: Prüfpunkt-Walker

      Verwendet einen Hybridansatz, um Verlaufsdaten aus der Tabelle „sys_history_Set“ oder „sys_Audit“ abhängig von der Einstellung der Systemeigenschaft abzurufen com.glide.history_walker.max_history_count. Wenn für den zu bearbeitenden Datensatz ein sys_mod_count vorhanden ist, der den in dieser Eigenschaft festgelegten Wert überschreitet, Standardwert = 1.000, verwendet der Prüfpunkt-Walker die Tabelle sys_Audit, um Verlaufsdaten abzurufen. Andernfalls wird die Tabelle sys_history_Set verwendet.

      Der Grund für diese Prüfung besteht darin, dass die Tabelle „sys_history_Set“ einen leistungsfähigeren Ansatz für Walking-Verlaufsdaten bietet, jedoch nur bis zu einem bestimmten Zeitpunkt. Wenn die Gesamtzahl der Feldaktualisierungen eine bestimmte Ebene erreicht, etwa 10.000, kann die Generierung der Tabelle „sys_history_Set“ die Anwendertransaktionszeitüberschreitung überschreiten. Wenn die Zeitüberschreitung überschritten wird, sind die Gesamtergebnisse leistungsschlechter als die Ausführung für die Tabelle „sys_Audit“, die alle Tabellenaktualisierungen enthält. Der Prüfpunkt-Walker verwendet com.glide.history_walker.max_history_countUm den optimalen Datensatzsatz zu bestimmen, der verwendet werden soll, um die beste Leistung zu erzielen.

      Datensätze werden aufsteigend nach dem Feld „Interner Prüfpunkt für Datensatz“ [internal_checkpoint] gruppiert und sortiert. Da das Feld internal_checkpoint ein Zeitstempel ist, werden die Datensätze in chronologischer Reihenfolge angezeigt. Außerdem hat das Feld internal_checkpoint keine Zuordnung zum Feld Task.sys_mod_count.

      Der wichtigste Unterschied zwischen dem Prüfpunkt-Walker und anderen Walkern besteht darin, dass die anderen Walker an Task.sys_mod_count-Einträge gekoppelt und von diesen gesteuert werden und sich auf sys_Audit.Record_checkpoint und sys_history_line.Update beziehen. Der Prüfpunkt-Walker verwendet die Felder sys_audit.internal_checkpoint und sys_history_line.internal_checkpoint.

      Der interne Prüfpunkt des Datensatzes behebt diese beiden Probleme, wodurch der Prüfpunkt-Walker die zuverlässigste Möglichkeit zum Abrufen von Audit-Verlaufsdaten ist.

    4. OFFLINE: Offline-Verlaufswalker

      Stellt die Offline-Verlaufsfunktion bereit, die von Anwendungen wie der mobilen Offline-App für Außendienst verwendet wird. Wenn für eine Aufgabentabellenerweiterung Felder festgelegt sind, für die das Wörterbuchattribut offline_timestamp_field festgelegt ist, wird der Offline-Verlaufswalker unabhängig von einer Eigenschaft oder expliziten Anweisung zur Verwendung eines anderen Walkers ausgeführt. Der Offline-Verlaufswalker verwendet die Tabellen sys_history_line und sys_history_Set, die Verlaufsdaten enthalten, die absichtlich nach Datum und Uhrzeit sortiert sind, um Offline-Updates zu unterstützen. Nur der Offline-Verlaufswalker kann genaue Ergebnisse für solche Tabellen liefern.

      Hinweis:
      Für Offline-Updates, die HistoryWalker Die API wird automatisch initiiert, und die einzigen zwei Methoden, die Sie verwenden können, sind: Walk-To(0) Und WalkForward() . Sie können keine anderen anrufen HistoryWalker Methoden für Offline-Updates.

    Die Systemeigenschaft com.snc.walker.defaultDefiniert den Standardtyp des Datensatzgangs, der beim Instanziieren von ausgeführt werden soll HistoryWalker API. Für Upgrades von Kunden ist diese Eigenschaft auf „VERLAUF“ festgelegt. Für neue Kunden ist diese Eigenschaft auf „PRÜFPUNKT“ festgelegt.

    Wenn Sie instanziieren HistoryWalker API wie folgt com.snc.walker.defaultDie Eigenschaft bestimmt, welche Datensatz-Walker-Implementierung die API verwendet. 
    var hw = new sn_hw.HistoryWalker(<table name>, <sys_id>);
    Sie können auch den Typ des Datensatzwalkers übergeben, der beim Instanziieren der API verwendet werden soll. Es ist ratsam, bei der Instanziierung dieser API immer die gewünschte Walker-Implementierung einzubeziehen.
    var hw = new sn_hw.HistoryWalker(<table name>, <sys_id>, <walker>);
    Z. B.:
    var hw = new sn_hw.HistoryWalker('incident', '1c741bd70b2322007518478d83673af3', 'CHECKPOINT');

    Um diese Klasse in bereichsbezogenen und globalen Anwendungen zu verwenden, verwenden Sie sn_hw Namespace-Bezeichner. Das History-Walker-Plugin (com.glide.history_walker), das standardmäßig aktiviert ist, ist für den Zugriff auf die HistoryWalker-API erforderlich.

    HistoryWalker: HistoryWalker(String tableName, String sysId, String Walker)

    Instanziiert das HistoryWalker-Objekt und ruft die Verlaufsdaten für den angegebenen Glide-Datensatz ab.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    tableName Zeichenfolge Name der Tabelle, die den abzurufenden Datensatz enthält.
    sysId Zeichenfolge SYS_ID des Datensatzes, dessen Verlaufsdaten Sie abrufen möchten.
    walker Zeichenfolge Optional. Name des Verlaufswalkers, der zum Abrufen der Verlaufsdaten für den angegebenen Datensatz verwendet werden soll.
    Gültige Werte:
    • AUDIT
    • PRÜFPUNKT
    • VERLAUF
    • OFFLINE

    Standard: Walker, der in der Systemeigenschaft com.snc.walker.default angegeben ist.

    Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird, um die am GlideRecord vorgenommenen Änderungen mit dem Prüfpunkt-Walker zu durchlaufen.

    
var gr_Hw = new GlideRecord('sc_req_item');
gr_Hw.get('b0d3335d49534210f877468e89703a7c');
 
var hw = new sn_hw.HistoryWalker(gr_Hw.getTableName(), gr_Hw.getUniqueValue(), 'CHECKPOINT');
hw.walkTo('19096afcc800000001');
printChangedFields(hw);
 
function printChangedFields(hw) {
   var walkedGr = hw.getWalkedRecord();
   var fields = GlideScriptRecordUtil.get(walkedGr).getChangedFieldNames();
   gs.info('Fields changed at update ' + hw.getUpdateNumber() + ' were:');
   for (var j = 0; j < fields.size(); j++) {
      var fieldName = fields.get(j) + '';
      if (fieldName !== 'variables')
         gs.info(walkedGr.getValue('sys_updated_on') + ' ' + fieldName + '=' + walkedGr.getValue(fieldName));
   }
 
   var variables = walkedGr.variables;
   for (var variableName in variables) {
      if (variables[variableName].changes())
         gs.info(walkedGr.getValue('sys_updated_on') + ' ' + variableName + '=' + variables[variableName].getValue());
   }
   gs.info('');
}

    Ausgabe:

    Fields changed at update 3 were:
2024-07-09 08:50:21 price=1499
2024-07-09 08:50:21 state=2
2024-07-09 08:50:21 priority=2
2024-07-09 08:50:21 recurring_price=100

    HistoryWalker – HistoryWalker(String tableName, String sysId, Boolean useAudit)

    Ruft den Datenbankdatensatz basierend auf den Parametern ab und verwendet die Verlaufssatz- oder Audit-Daten, um die Verlaufsdaten abhängig vom dritten Parameter abzurufen.

    Tabelle : 2. Parameter
    Name Typ Beschreibung
    tableName Zeichenfolge Name der Tabelle, die den abzurufenden Datensatz enthält.
    sysId Zeichenfolge SYS_ID des abzurufenden Datensatzes.
    useAudit Boolean Kennzeichnung, die angibt, ob Auditdaten zum Abrufen des Verlaufsdatums verwendet werden sollen.
    Gültige Werte:
    • Wahr: Verwenden Sie Audit-Daten, um das historische Datum abzurufen.
    • Falsch: Verwenden Sie den Verlaufssatz, um das Verlaufsdatum abzurufen.

    Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    var incGr = new GlideRecord('incident');
incGr.get('number', 'INC0000015');

var hw = new sn_hw.HistoryWalker(incGr.getTableName(), incGr.getUniqueValue(), true);
if (hw.walkTo(3)) {
    var oldPriority = hw.getWalkedRecord().priority;
    gs.info('Incident priority in update number ' + hw.getUpdateNumber() + ' was ' + oldPriority);
} else
    gs.info('Incident does not have update number 3');

    Ausgabe:

    Incident priority in update number 3 was 4

    HistoryWalker – getUpdateNumber()

    Ruft die Aktualisierungsnummer des aktuellen durchlaufenen Glide-Datensatzes ab.

    Tabelle : 3. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 4. Ergebnisse
    Typ Beschreibung
    int Aktuelle Update-Nummer oder -1, wenn der Datensatz nicht gefunden wird.

    Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    var incGr = new GlideRecord('incident');
incGr.get('number', 'INC0000015');

var hw = new sn_hw.HistoryWalker(incGr.getTableName(), incGr.getUniqueValue());
for(int i = 0; i < 2; i++) {
  hw.walkForward();
}
gs.info('Update number: ' + hw.getUpdateNumber());

    Ausgabe:

    Update number: 3

    HistoryWalker – getWalkedRecord()

    Ruft den Datensatz mit den Verlaufs-/Audit-Daten auf, nachdem eine Aktualisierungsnummer aufgerufen wurde.

    Tabelle : 5. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 6. Ergebnisse
    Typ Beschreibung
    GlideRecord Der durchlaufene GlideRecord.

    Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    var incGr = new GlideRecord('incident');
incGr.get('number', 'INC0000015');
 
var hw = new sn_hw.HistoryWalker(incGr.getTableName(), incGr.getUniqueValue());
hw.walkForward();
var walkedRecord = hw.getWalkedRecord();
gs.info('Priority in update number 0: ' + walkedRecord.priority);
hw.walkForward();
walkedRecord = hw.getWalkedRecord();
gs.info('Short description in update number 1: ' + walkedRecord.short_description);

    Ausgabe:

     Priority in update number 0: 4
Short description in update number 1: My monitor has stopped working

    HistoryWalker – getWalkedRecordCopy()

    Gibt eine Kopie des Datensatzes zurück, der mit den Verlaufs-/Audit-Daten gefüllt ist, nachdem er zu einer Update-Nummer gegangen ist.

    Hinweis:
    Die GetWalkedRecord() Die Methode kann den erhaltenen WalkedRecord ändern, nachdem sie zu einer anderen Update-Nummer gegangen ist. Die GetWalkedRecordCopy() Die Methode ruft einen Klon in den Walking-Datensatz ab, um dies zu verhindern.
    Tabelle : 7. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 8. Ergebnisse
    Typ Beschreibung
    GlideRecord Kopie des gelaufenen GlideRecord.

    Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    var incGr = new GlideRecord('incident');
incGr.get('number', 'INC0000015');
 
var walkedRecord = [];
var hw = new sn_hw.HistoryWalker(incGr.getTableName(), incGr.getUniqueValue());
hw.walkForward();
walkedRecord[0] = hw.getWalkedRecordCopy();
hw.walkForward();
walkedRecord[1] = hw.getWalkedRecordCopy();
 
gs.info('Priority in update number 0: ' + walkedRecord[0].priority);
gs.info('Short description in update number 1: ' + walkedRecord[1].short_description);

    Ausgabe:

    Priority in update number 0: 4
Short description in update number 1: My monitor has stopped working

    HistoryWalker – isFieldLevelSecurity()

    Gibt an, ob der Lesezugriff auf Datensatzebene auf den Datensatz angewendet wird, wenn er aus der Datenbank abgerufen wird.

    Tabelle : 9. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 10. Ergebnisse
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob die Sicherheit auf Feldebene aktiviert ist.
    Gültige Werte:
    • Wahr: Sicherheit auf Feldebene ist aktiviert.
    • Falsch: Sicherheit auf Feldebene ist nicht aktiviert.

    Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    var incGr = new GlideRecord('incident');
incGr.get('number', 'INC0000015');

var hw = new sn_hw.HistoryWalker(incGr.getTableName(), incGr.getUniqueValue());
gs.info('Field level security is active: ' + hw.isFieldLevelSecurity());

    Ausgabe:

    Field level security is active: true

    HistoryWalker – isRecordLevelSecurity()

    Gibt an, ob der Lesezugriff auf Datensatzebene auf den Datensatz angewendet wird, wenn er aus der Datenbank abgerufen wird.

    Tabelle : 11. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 12. Ergebnisse
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob die Sicherheit auf Datensatzebene aktiviert ist.
    Gültige Werte:
    • Wahr: Sicherheit auf Datensatzebene ist aktiviert.
    • Falsch: Sicherheit auf Datensatzebene ist nicht aktiviert.

    Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    var incGr = new GlideRecord('incident');
incGr.get('number', 'INC0000015');

var hw = new sn_hw.HistoryWalker(incGr.getTableName(), incGr.getUniqueValue());
gs.info('Record level security is active: ' + hw.isRecordLevelSecurity());

    Ausgabe:

    Record level security is active: true

    HistoryWalker – isWithChanges()

    Gibt an, ob eine der Methoden, mit denen der Datensatz von einem Update zum anderen übertragen wird, die „Changes“-Daten für jedes Element unterstützt.

    Tabelle : 13. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 14. Ergebnisse
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob die Change-Unterstützung aktiviert ist.
    Gültige Werte:
    • Wahr: Change-Unterstützung ist aktiviert.
    • Falsch: Change-Unterstützung ist nicht aktiviert.

    Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    var incGr = new GlideRecord('incident');
incGr.get('number', 'INC0000015');

var hw = new sn_hw.HistoryWalker(incGr.getTableName(), incGr.getUniqueValue());
gs.info('Changes is active: ' + hw.isWithChanges());

    Ausgabe:

    Changes is active: true

    HistoryWalker – isWithJournalFields()

    Gibt an, ob Felder des Journaltyps über die Verlaufswerte aufgefüllt werden.

    Tabelle : 15. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 16. Ergebnisse
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob Journalfelder ausgefüllt sind.
    Gültige Werte:
    • Wahr: Journalfelder werden ausgefüllt.
    • Falsch: Journalfelder sind nicht ausgefüllt.

    Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    var incGr = new GlideRecord('incident');
incGr.get('number', 'INC0000015');

var hw = new sn_hw.HistoryWalker(incGr.getTableName(), incGr.getUniqueValue());
gs.info('Populating journal fields is active: ' + hw. isWithJournalFields());

    Ausgabe:

    Populating journal fields is active: false

    HistoryWalker – isWithVariables()

    Gibt an, ob Werte für Variablen festgelegt werden, die im Verlauf aufgezeichnet werden.

    Tabelle : 17. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 18. Ergebnisse
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob Werte für Variablen festgelegt sind, die im Verlauf aufgezeichnet werden.
    Gültige Werte:
    • Wahr: Werte sind festgelegt.
    • Falsch: Werte sind nicht festgelegt.

    Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    var incGr = new GlideRecord('incident');
incGr.get('number', 'INC0000015');

var hw = new sn_hw.HistoryWalker(incGr.getTableName(), incGr.getUniqueValue());
gs.info('Populating variables is active: ' + hw. isWithVariables());

    Ausgabe:

    Populating variables is active: false

    HistoryWalker – setFieldLevelSecurity(Boolean fieldLevelSecurity)

    Legt den Lesezugriff auf Feldebene für jedes Element fest, bevor der Verlaufswert dieses Elements im GlideRecord festgelegt wird. Wenn die Sicherheit auf Feldebene aktiviert ist, wird verhindert, dass die API die Felder des Walk-Datensatzes ausfüllt, auf die der Anwender der API keinen Zugriff hat.

    Tabelle : 19. Parameter
    Name Typ Beschreibung
    fieldLevelSecurity Boolean Kennzeichnung, die angibt, wie die Lesezugriffssicherheit auf Feldebene festgelegt wird.
    Gültige Werte:
    • Wahr: Sicherheit auf Feldebene aktivieren.
    • Falsch: Sicherheit auf Feldebene deaktivieren.

    Standardwert: wahr
    Tabelle : 20. Rückgaben
    Typ Beschreibung
    void

    Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    var incGr = new GlideRecord('incident');
incGr.get('number', 'INC0000015');
 
var hw = new sn_hw.HistoryWalker(incGr.getTableName(), incGr.getUniqueValue());
hw.setFieldLevelSecurity(false);
hw.walkForward();

    HistoryWalker – setRecordLevelSecurity(Boolean recordLevelSecurity)

    Legt den Lesezugriff auf Datensatzebene für den Datensatz fest, wenn er aus der Datenbank abgerufen wird. Die Sicherheit auf Datensatzebene verhindert, dass die API den Walking-Datensatz abruft, wenn der Anwender der API keinen Zugriff auf GlideRecord hat.

    Tabelle : 21. Parameter
    Name Typ Beschreibung
    recordLevelSecurity Boolean Kennzeichnung, die angibt, wie die Lesezugriffssicherheit auf Datensatzebene festgelegt wird.
    Gültige Werte:
    • Wahr: Sicherheit auf Datensatzebene aktivieren.
    • Falsch: Sicherheit auf Datensatzebene deaktivieren.

    Standardwert: wahr
    Tabelle : 22. Rückgaben
    Typ Beschreibung
    void

    Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    var incGr = new GlideRecord('incident');
incGr.get('number', 'INC0000015');

var hw = new sn_hw.HistoryWalker(incGr.getTableName(), incGr.getUniqueValue());
hw.setRecordLevelSecurity(false);
hw.walkForward();

    HistoryWalker – setWithChanges(Boolean withChanges)

    Legt die Datenunterstützung „Changes“ für jedes Element für eine Methode fest, die den Datensatz von einem Update zum anderen weiterleitet.

    Tabelle : 23. Parameter
    Name Typ Beschreibung
    withChanges Boolean Kennzeichnung, die angibt, ob die Change-Daten für jedes Element unterstützt werden.
    Gültige Werte:
    • Wahr: Change-Daten werden für jedes Element unterstützt.
    • Falsch: Change-Daten werden nicht für jedes Element unterstützt.

    Standardwert: wahr
    Tabelle : 24. Rückgaben
    Typ Beschreibung
    void

    Dieses Codebeispiel zeigt, wie diese Methode mit der Unterstützung von Changes-Daten aufgerufen wird. Dieses Beispiel muss im globalen Bereich ausgeführt werden.

    var incGr = new GlideRecord('incident');
incGr.get('number', 'INC0000015');
var hw = new sn_hw.HistoryWalker(incGr.getTableName(), incGr.getUniqueValue());
while (hw.walkForward()) {
  printChangedFields(hw);
}

function printChangedFields(hw) {
  var walkedGr = hw.getWalkedRecord();
  var fields = GlideScriptRecordUtil.get(walkedGr).getChangedFieldNames();
  gs.info("Fields changed at update " + hw.getUpdateNumber() + " were:");
  for (var j = 0; j < fields.size(); j++)
    gs.info(" " + fields.get(j));
  gs.info("");
}

    Dieses Codebeispiel zeigt, wie diese Methode ohne Change-Datenunterstützung aufgerufen wird. Dieses Beispiel wird sowohl in bereichsbezogenen als auch in globalen Umgebungen ausgeführt.

    var incGr = new GlideRecord('incident');
incGr.get('number', 'INC0000015');
var hw = new sn_hw.HistoryWalker(incGr.getTableName(), incGr.getUniqueValue());
hw.setWithChanges(false);

while (hw.walkForward()) {
  var oldPriority = hw.getWalkedRecord().priority;
  gs.info('Incident priority in update number ' + hw.getUpdateNumber() + ' was ' + oldPriority);
}

    HistoryWalker – setWithJournalFields(Boolean withJournalFields)

    Gibt an, ob Felder des Journaltyps über die Verlaufswerte aufgefüllt werden.

    Tabelle : 25. Parameter
    Name Typ Beschreibung
    withJournalFields Boolean Kennzeichnung, die angibt, ob Journalfelder eingeschlossen werden sollen.
    Gültige Werte:
    • Wahr: Journaltypfelder einschließen.
    • Falsch: Schließen Sie keine Journaltypfelder ein.

    Standardwert: false
    Tabelle : 26. Ergebnisse
    Typ Beschreibung
    void

    Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    var incGr = new GlideRecord('incident');
incGr.get('number', 'INC0000015');
var hw = new sn_hw.HistoryWalker(incGr.getTableName(), incGr.getUniqueValue());
hw.setWithJournalFields(true);
if (hw.walkForward()) {
  var workNotes = hw.getWalkedRecord().work_notes;
  gs.info('Work Notes in update number ' + hw.getUpdateNumber() + ' was ' + workNotes);
}

    HistoryWalker – setWithVariables(Boolean withVariables)

    Gibt an, ob Variablen aus den Verlaufswerten aufgefüllt werden.

    Tabelle : 27. Parameter
    Name Typ Beschreibung
    withVariables Boolean Kennzeichnung, die angibt, ob Variablen aus den Verlaufswerten ausgefüllt werden.
    Gültige Werte:
    • Wahr: Variable ist ausgefüllt.
    • Falsch: Variable ist nicht ausgefüllt.

    Standardwert: false
    Tabelle : 28. Ergebnisse
    Typ Beschreibung
    void

    Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    var incGr = new GlideRecord('incident');
incGr.get('number', 'INC0000015');

var hw = new sn_hw.HistoryWalker(incGr.getTableName(), incGr.getUniqueValue());
hw.setWithVariables(true);
hw.walkTo(0);
if (hw.walkTo(0)) {
    var varUrgency = hw.getWalkedRecord().variables.urgency;
    gs.info('Variable Urgency in update number ' + hw.getUpdateNumber() + ' was ' + varUrgency);
}

    HistoryWalker – walkBackward()

    Wendet die entsprechenden Verlaufs-/Audit-Daten an, um einen durchlaufenen GlideRecord in dem Status zu erhalten, in dem er eine Aktualisierungsnummer zurück war. Wenn die vorherige Aktualisierungszählung in den Verlaufs-/Audit-Daten fehlt, erfolgt das Durchlaufen zur vorherigen verfügbaren Aktualisierungszählung.

    Tabelle : 29. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 30. Ergebnisse
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob ein Gehen zur angegebenen Update-Nummer möglich war.
    Gültige Werte:
    • Wahr: Kann zur angegebenen Update-Nummer gehen.
    • Falsch: Der Gehen zur angegebenen Update-Nummer ist nicht möglich.

      Mögliche Gründe: Bereits zur Update-Nummer 0 gegangen.

    Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    var incGr = new GlideRecord('incident');
incGr.get('number', 'INC0000015');
var hw = new sn_hw.HistoryWalker(incGr.getTableName(), incGr.getUniqueValue());

while (hw.walkBackward()) {
  var oldPriority = hw.getWalkedRecord().priority;
  gs.info('Incident priority in update number ' + hw.getUpdateNumber() + ' was ' + oldPriority);
}

    Ausgabe:

    Incident priority in update number 5 was 2
Incident priority in update number 4 was 4
Incident priority in update number 3 was 4
Incident priority in update number 2 was 4
Incident priority in update number 1 was 4
Incident priority in update number 0 was 4

    HistoryWalker – walkForward()

    Wendet die entsprechenden Verlaufs-/Audit-Daten an, um einen durchlaufenen GlideRecord in dem Status zu erhalten, in dem er eine Aktualisierungsnummer vorwärts war. Wenn die nächste Aktualisierungszählung in den Verlaufs-/Audit-Daten fehlt, erfolgt das Durchlaufen zur nächsten verfügbaren Aktualisierungszählung.

    Tabelle : 31. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 32. Ergebnisse
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob ein Gehen zur angegebenen Update-Nummer möglich war.
    Gültige Werte:
    • Wahr: Kann zur angegebenen Update-Nummer gehen.
    • Falsch: Der Gehen zur angegebenen Update-Nummer ist nicht möglich.

      Mögliche Gründe: Bereits zur Anzahl der GlideRecord-Updates gegangen.

    Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    var incGr = new GlideRecord('incident');
incGr.get('number', 'INC0000015');
var hw = new sn_hw.HistoryWalker(incGr.getTableName(), incGr.getUniqueValue());

while (hw.walkForward()) {
  var oldPriority = hw.getWalkedRecord().priority;
  gs.info('Incident priority in update number ' + hw.getUpdateNumber() + ' was ' + oldPriority);
}

    Ausgabe:

    Incident priority in update number 0 was 4
Incident priority in update number 1 was 4
Incident priority in update number 2 was 4
Incident priority in update number 3 was 4
Incident priority in update number 4 was 4
Incident priority in update number 5 was 2

    HistoryWalker – walkTo(int updateCount)

    Wendet die entsprechenden Verlaufs-/Audit-Daten an, um einen GlideRecord auf den Status einer bestimmten Aktualisierungszählung zu bringen. Verwenden GetWalkedRecord() Oder GetWalkedRecordCopy() Nachdem Sie zu einer Update-Nummer gegangen sind, um den „Walking“-GlideRecord abzurufen.

    Hinweis:
    Diese Methode wird von der Checkpoint Walker-Implementierung nicht unterstützt. Rufen Sie an HistoryWalker – WalkTo(Zeichenfolgenprüfpunkt) Methode bei Verwendung des Prüfpunkt-Walkers.
    Tabelle : 33. Parameter
    Name Typ Beschreibung
    updateCount Ganzzahl Aktualisieren Sie die Nummer, zu der Sie gehen möchten.
    Tabelle : 34. Rückgaben
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob ein Gehen zur angegebenen Update-Nummer möglich war.
    Gültige Werte:
    • Wahr: Kann zur angegebenen Update-Nummer gehen.
    • Falsch: Der Gehen zur angegebenen Update-Nummer ist nicht möglich.

      Mögliche Gründe: Das angeforderte Update ist größer als die Update-Anzahl des GlideRecord, oder es sind keine Verlaufs-/Audit-Daten für die angeforderte Update-Nummer vorhanden.

    Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    var incGr = new GlideRecord('incident');
incGr.get('number', 'INC0000015');

var hw = new sn_hw.HistoryWalker(incGr.getTableName(), incGr.getUniqueValue());
if (hw.walkTo(3)) {
    var oldPriority = hw.getWalkedRecord().priority;
    gs.info('Incident priority in update number ' + hw.getUpdateNumber() + ' was ' + oldPriority);
} else
    gs.info('Incident does not have update number 3');

    Ausgabe:

    Incident priority in update number 3 was 4

    HistoryWalker – WalkTo(Zeichenfolgenprüfpunkt)

    Wendet die entsprechenden Verlaufs-/Audit-Daten an, um einen GlideRecord in den Status zu versetzen, in dem er sich für einen bestimmten internen Prüfpunkt des Datensatzes befand. Verwenden Sie GetWalkedRecord() Oder GetWalkedRecordCopy() Methode nach dem Gehen zum internen Prüfpunkt eines Datensatzes, um den „Walking“-GlideRecord abzurufen.

    Hinweis:
    Diese Methode wird nur von der Checkpoint Walker-Implementierung unterstützt.
    Tabelle : 35. Parameter
    Name Typ Beschreibung
    Prüfpunkt Zeichenfolge Interner Prüfpunkt des Datensatzes, zu dem gegangen werden soll. Sie finden diesen Wert im Feld internal_checkpoint der Tabelle „SYS-Audit“ [sys_Audit] oder „Verlauf“ [sys_history_line].
    Tabelle : 36. Rückgaben
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob ein Gehen zum internen Prüfpunkt des angegebenen Datensatzes möglich war.
    Mögliche Werte:
    • Wahr: Kann zum internen Prüfpunkt des angegebenen Datensatzes gehen.
    • Falsch: Der interne Prüfpunkt des angegebenen Datensatzes kann nicht erreicht werden.

      Mögliche Gründe: Der interne Prüfpunkt ist nicht vorhanden.

    Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird, um die am GlideRecord vorgenommenen Änderungen zu durchlaufen.

    
var gr_Hw = new GlideRecord('sc_req_item');
gr_Hw.get('b0d3335d49534210f877468e89703a7c');
 
var hw = new sn_hw.HistoryWalker(gr_Hw.getTableName(), gr_Hw.getUniqueValue(), 'CHECKPOINT');
hw.walkTo('19096afcc800000001');
printChangedFields(hw);
 
function printChangedFields(hw) {
   var walkedGr = hw.getWalkedRecord();
   var fields = GlideScriptRecordUtil.get(walkedGr).getChangedFieldNames();
   gs.info('Fields changed at update ' + hw.getUpdateNumber() + ' were:');
   for (var j = 0; j < fields.size(); j++) {
      var fieldName = fields.get(j) + '';
      if (fieldName !== 'variables')
         gs.info(walkedGr.getValue('sys_updated_on') + ' ' + fieldName + '=' + walkedGr.getValue(fieldName));
   }
 
   var variables = walkedGr.variables;
   for (var variableName in variables) {
      if (variables[variableName].changes())
         gs.info(walkedGr.getValue('sys_updated_on') + ' ' + variableName + '=' + variables[variableName].getValue());
   }
   gs.info('');
}

    Ausgabe:

    Fields changed at update 3 were:
2024-07-09 08:50:21 price=1499
2024-07-09 08:50:21 state=2
2024-07-09 08:50:21 priority=2
2024-07-09 08:50:21 recurring_price=100