GlideImportSetTransformer: Bereichsbezogen, global

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 3 Minuten Lesedauer

    • Die GlideImportSetTransformer -API bietet Methoden zum Erstellen eines Importsatz-Umwandlerobjekts, das zum Ausführen einer Importsatz-Transformation verwendet wird.

    So führen Sie eine Importsatz-Transformation aus:
    1. Erstellt eine Importsatztabelle mit der GlideImportSetTable -API.
    2. Erstellt eine Transformationszuordnung mithilfe der GlideImportSetTransformMap -API.
    3. Erstellen oder verwenden Sie einen vorhandenen Importsatz mithilfe der GlideRecord -API.
    4. Führt eine Importsatztransformation mit der GlideImportSetTransformer -API aus.
    Sobald Sie den Importsatz-Datensatz erstellt haben, muss er von der GlideImportSetTransformer -API verwendet werden, um die Transformation auszulösen.
    var transformer = new GlideImportSetTransformer();
transformer.transformAllMaps(importSetGr);

    GlideImportSetTransformer: GlideImportSetTransformer()

    Instanziiert ein GlideImportSetTransformer-Objekt.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    Keine 
    var transformer = new GlideImportSetTransformer();

    GlideImportSetTransformer - getImportSetRun()

    Ruft das Importsatz-Ausführungsobjekt ab, das einem GlideImportSetTransformer-Objekt zugeordnet ist.

    Tabelle : 2. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 3. Ergebnisse
    Typ Beschreibung
    GlideImportSetRun GlideImportSetRun-Objekt, das durch Ausführen einer Transformation oder des an die setImportSetRun()- Methode übergebenen Arguments erstellt wurde. 
    var importSet = new GlideRecord('sys_import_set');
importSet.short_description = 'Import set from scripted rest api';
importSet.table_name = importSetTableName;
var importSetID = importSet.insert();
var transformer = new GlideImportSetTransformer();
transformer.transformAllMaps(importSet);
var importSetRun = transformer.getImportSetRun();

    GlideImportSetTransformer - isError()

    Gibt einen booleschen Wert zurück, der angibt, ob während einer Transformation ein Fehler aufgetreten ist.

    Tabelle : 4. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 5. Ergebnisse
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob ein Fehler vorliegt.
    • true: Fehler.
    • false: Erfolg
    		 
    var importSet = new GlideRecord('sys_import_set');
importSet.short_description = 'Import set from scripted rest api';
importSet.table_name = importSetTableName;
var importSetID = importSet.insert();
var transformer = new GlideImportSetTransformer();
transformer.transformAllMaps(importSet);
if(transformer.isError()) {
	gs.error('Error executing the transform');
}

    GlideImportSetTransformer - setImportSetID(String id)

    Ordnet einen Importsatz-Datensatz einem bestimmten GlideImportSetTransformer-Objekt zu.

    Tabelle : 6. Parameter
    Name Typ Beschreibung
    id Zeichenfolge Die sys_id eines Importsatz-Datensatzes aus der Importsatz-Tabelle [sys_import_set].
    Tabelle : 7. Rückgaben
    Typ Beschreibung
    void 
    var importSet = new GlideRecord('sys_import_set');
importSet.short_description = 'Import set from scripted rest api';
importSet.table_name = importSetTableName;
var importSetID = importSet.insert();
var transformer = new GlideImportSetTransformer();
transformer.setImportSetID(importSetID);
transformer.transformAllMaps(importSet);

    GlideImportSetTransformer - setImportSetRun(GlideImportSetRun importSetRun)

    Ordnet ein Importsatz-Ausführungsobjekt einem bestimmten GlideImportSetTransformer-Objekt zu.

    Tabelle : 8. Parameter
    Name Typ Beschreibung
    importSetRun GlideImportSetRun GlideImportSetRun-Objekt, das den ImportSetRun-Datensatz zur Nachverfolgung des Transformationsverlaufs darstellt.
    Tabelle : 9. Rückgaben
    Typ Beschreibung
    void 
    var importSet = new GlideRecord('sys_import_set');
importSet.short_description = 'Import set from scripted rest api';
importSet.table_name = importSetTableName;
var importSetID = importSet.insert();
var importSetRun = new GlideImportSetRun(importSetID);
var transformer = new GlideImportSetTransformer();
transformer.setImportSetRun(importSetRun);
transformer.transformAllMaps(importSet);

    GlideImportSetTransformer - setLogger(GlideImportLog-Protokoll)

    Ordnet ein GlideImportLog-Objekt einem bestimmten GlideImportSetTransformer-Objekt zu.

    Wenn diese Methode nicht vor dem Aufrufen der transformAllMaps()- Methode aufgerufen wird, wird intern auf der Serverseite ein GlideImportLog-Objekt erstellt.

    Tabelle : 10. Parameter
    Name Typ Beschreibung
    log GlideImportProtokoll GlideImportLog-Objekt für die Verknüpfung mit dem Importsatzverlauf. Nach dem Festlegen wird jeder Aufruf vom GlideImportLog-Objekt dem Importsatz-Ausführungsverlauf für diese spezifische Transformation zugeordnet.
    Tabelle : 11. Rückgaben
    Typ Beschreibung
    void 
    var importSet = new GlideRecord('sys_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);

    GlideImportSetTransformer - setMapID(String mapID)

    Ordnet eine Transformationszuordnung einem bestimmten GlideImportSetTransformer-Objekt zu.

    Tabelle : 12. Parameter
    Name Typ Beschreibung
    mapID Zeichenfolge Eine sys_id aus der Tabelle „Tabellentransformationszuordnungen“ [sys_transform_map].
    Tabelle : 13. Rückgaben
    Typ Beschreibung
    void 
    var importSet = new GlideRecord('sys_import_set');
importSet.short_description = 'Import set from scripted rest api';
importSet.table_name = importSetTableName;
var importSetID = importSet.insert();
var transformMapId = '<sys id of transform map>';
var transformer = new GlideImportSetTransformer();
transformer.setMapID(transformMapId);
transformer.transformAllMaps(importSet);

    GlideImportSetTransformer - setSyncImport(Boolean synchronous)

    Aktiviert die Ausführung synchroner Transformationen.

    Tabelle : 14. Parameter
    Name Typ Beschreibung
    synchron Boolean Legt den Transformationsmodus fest.

    Gültige Werte:

    • „wahr“: Transformation wird synchron ausgeführt
    • „falsch“: Transformation wird asynchron ausgeführt

    Standardwert: false
    Tabelle : 15. Ergebnisse
    Typ Beschreibung
    void 
    
var importSet = new GlideRecord('sys_import_set');
importSet.short_description = 'Import set from scripted rest api';
importSet.table_name = importSetTableName;
var importSetID = importSet.insert();
var transformer = new GlideImportSetTransformer();
transformer.setSyncImport(true);
transformer.transformAllMaps(importSet);

    GlideImportSetTransformer - transformAllMaps(GlideRecord importSet, String rowSysId)

    Führt die Importsatz-Transformation aus.

    Tabelle : 16. Parameter
    Name Typ Beschreibung
    importSet GlideRecord GlideRecord des auszuführenden Importsatzes.
    zeilenSysId Zeichenfolge Optional. Beschränkt die Transformation auf einen einzelnen Datensatz, indem die sys_id eines Datensatzes aus der Tabelle „Importsätze“ [sys_import_set] übergeben wird.

    Standard: Alle Zeilen transformieren
    Tabelle : 17. Rückgaben
    Typ Beschreibung
    void 
    var importSet = new GlideRecord('sys_import_set');
importSet.short_description = 'Import set from scripted rest api';
importSet.table_name = importSetTableName;
var importSetID = importSet.insert();
var transformer = new GlideImportSetTransformer();
transformer.transformAllMaps(importSet);