GlideImportLog: Bereichsbezogen, global

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 2 Minuten Lesedauer
  • Die GlideImportLog -API bietet Methoden zum Schreiben von Protokolleinträgen direkt in die Importprotokolltabelle [import_log].

    Ein GlideImportLog-Objekt kann von der GlideImportSetTransformer -API verwendet werden. Dieses Objekt ist für die GlideImportSetTransformer -API nicht erforderlich. Sie können damit Importprotokolle einer bestimmten Importsatz-Transformation zuordnen.

    GlideImportLog - GlideImportLog(GlideImportSetRun importSetRun, Zeichenfolgenquelle)

    Instanziiert ein GlideImportLog-Objekt.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    importSetRun GlideImportSetRun Optional. Importsatz-Ausführungsdatensatz, dem alle Protokolle zugeordnet werden sollen.
    Quelle Zeichenfolge Optional. Quellfeldwert, der an den Importprotokolldatensatz angehängt ist und definiert, wo im Importsatzprozess diese Nachricht protokolliert wurde. Beispielsweise könnte „Laden“ für den Ladeschritt stehen, „Bereinigung“ während der Bereinigung nach der Transformation usw.

    Beispiel ohne optionalen Quellparameter.

    var importSetRun = new GlideImportSetRun();
    var importLog = new GlideImportLog(importSetRun);
    

    Beispiel mit optionalem Quellparameter

    var importSetRun = new GlideImportSetRun();
    var importLog = new GlideImportLog(importSetRun, 'Scripted ImportSetTransformer');
    

    GlideImportLog – Fehler (Zeichenfolgennachricht, Zeichenfolgenquelle)

    Protokolliert eine Meldung vom Typ „Fehler“ in der Importprotokolltabelle [import_log].

    GlideImportProtokoll

    Tabelle : 2. Parameter
    Name Typ Beschreibung
    Nachricht Zeichenfolge Protokollnachricht. Maximale Länge 4000 Zeichen.
    Quelle Zeichenfolge Optional. Quellfeldwert, der an den Importprotokolldatensatz angehängt ist und definiert, wo im Importsatzprozess diese Nachricht protokolliert wurde. Beispielsweise könnte „Laden“ für den Ladeschritt stehen, „Bereinigung“ während der Bereinigung nach der Transformation usw.
    Tabelle : 3. Rückgaben
    Typ Beschreibung
    Keine
    var importLog = new GlideImportLog();
    importLog.error('Error executing transform');
    

    GlideImportLog – getImportRunHistory()

    Gibt eine sys_id des Importausführungsdatensatzes zurück, der diesem Importprotokoll zugeordnet ist.

    Tabelle : 4. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 5. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Sys_id eines Importsatz-Ausführungsdatensatzes aus der Tabelle „Transformationsverlauf“ [sys_import_set_run].
    var importSet = new GlideRecord('sys_import_set');
    importSet.name = 'Scripted Import Set';
    importSet.short_description = 'Import set from scripted rest api';
    importSet.table_name = importSetTableName;
    var importSetID = importSet.insert();
    var importLog = new GlideImportLog();
    var transformer = new GlideImportSetTransformer();
    transformer.setLogger(importLog);
    transformer.transformAllMaps(importSet);
    var importRunSysId = importLog.getImportRunHistory();
    

    GlideImportLog – info (Zeichenfolgennachricht, Zeichenfolgenquelle)

    Protokolliert eine Nachricht vom Typ „Info“ in der Importprotokolltabelle [import_log].

    GlideImportProtokoll

    Tabelle : 6. Parameter
    Name Typ Beschreibung
    Nachricht Zeichenfolge Protokollnachricht. Maximale Länge 4000 Zeichen.
    Quelle Zeichenfolge Optional. Quellfeldwert, der an den Importprotokolldatensatz angehängt ist und definiert, wo im Importsatzprozess diese Nachricht protokolliert wurde. Beispielsweise könnte „Laden“ für den Ladeschritt stehen, „Bereinigung“ während der Bereinigung nach der Transformation usw.
    Tabelle : 7. Rückgaben
    Typ Beschreibung
    Keine
    var importLog = new GlideImportLog();
    importLog.info('Successfully executed transform');
    

    GlideImportLog - setImportRunHistory(String importRunHistory)

    Ordnet das GlideImportLog-Objekt einem bestimmten Datensatz für die Importsatzausführung zu.

    Tabelle : 8. Parameter
    Name Typ Beschreibung
    importRunHistory Zeichenfolge Die sys_id eines Datensatzes aus der Tabelle „Transformationsverlauf“ [sys_import_set_run].
    Tabelle : 9. Rückgaben
    Typ Beschreibung
    void
    var importRunSysId = '4aa3a8d55ba10010953330ad5981c79f';
    var importLog = new GlideImportLog();
    importLog.setImportRunHistory(importRunSysId);
    

    GlideImportLog – warn(Zeichenfolgennachricht, Zeichenfolgenquelle)

    Protokolliert eine Meldung vom Typ „Warnen“ in der Importprotokolltabelle [import_log].

    GlideImportProtokoll

    Tabelle : 10. Parameter
    Name Typ Beschreibung
    Nachricht Zeichenfolge Protokollnachricht. Maximale Länge 4000 Zeichen.
    Quelle Zeichenfolge Optional. Quellfeldwert, der an den Importprotokolldatensatz angehängt ist und definiert, wo im Importsatzprozess diese Nachricht protokolliert wurde. Beispielsweise könnte „Laden“ für den Ladeschritt stehen, „Bereinigung“ während der Bereinigung nach der Transformation usw.
    Tabelle : 11. Rückgaben
    Typ Beschreibung
    Keine
    var importLog = new GlideImportLog();
    importLog.warn('Transform taking longer than expected.');