---
sourceDocument: Xanadu-API-Referenz
sourceDocumentLink: https://www.servicenow.com/docs/r/de-DE/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideImportSetTransformer: Bereichsbezogen, global

# GlideImportSetTransformer: Bereichsbezogen, global {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 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.

{#GlideImportSetTransformerAPI__ol_wnr_brf_ckb}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); 

**Zugehörige Konzepte**   

* [GlideImportLog](https://www.servicenow.com/docs/IGcYjdJctS4JQNwf8WwQRg#GlideImportLogAPI "Die GlideImportLog- API bietet Methoden zum Schreiben von Protokolleinträgen direkt in die Importprotokolltabelle [import_log].")
* [GlideImportSetRun](https://www.servicenow.com/docs/CTs3jYPgMS2nxBxIOgGW1A#GlideImportSetRunAPI "Die GlideImportSetRun- API bietet Methoden zum Erstellen eines Importsatz-Ausführungsdatensatzes, den die GlideImportSetTransformer- API verarbeiten kann.")
* [GlideImportSetTable](https://www.servicenow.com/docs/Fr2CnfCv9Dq2HRRSFRRA2g#GlideImportSetTableAPI "Die GlideImportSetTable- API bietet Methoden zum Erstellen temporärer Importsatztabellen.")
* [GlideImportSetTransformMap](https://www.servicenow.com/docs/f5siLtUhMNdPs7Ln3hlmsw#GlideImportSetTransformMapAPI "Die GlideImportSetTransformMap- API bietet Methoden zum Erstellen von Transformationszuordnungen und Transformationseinträgen.")
* [GlideRecord](https://www.servicenow.com/docs/g1N~QBZ9WXF6q3o57iuLTw#c_GlideRecordScopedAPI "Die bereichsbezogene GlideRecord- API wird für Datenbankvorgänge verwendet.")
* [GlideTransformLog](https://www.servicenow.com/docs/qOzf_dw2uFiKlTeOpb8BoA#GlideTransformLogAPI "Die GlideTransformLog- API bietet Methoden zum Erstellen eines GlideTransformLog-Objekts, um Nachrichten in Localhost-Protokollen zu protokollieren.")

## GlideImportSetTransformer: GlideImportSetTransformer() {#ariaid-title2}

Instanziiert ein GlideImportSetTransformer-Objekt.
{#GImpSetTrans-GlideImportSetTrans__table_xc4_sln_yjb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 1. Parameter]

{#GImpSetTrans-GlideImportSetTrans__table_xc4_sln_yjb}  

    var transformer = new GlideImportSetTransformer();

## GlideImportSetTransformer - getImportSetRun() {#ariaid-title3}

Ruft das Importsatz-Ausführungsobjekt ab, das einem GlideImportSetTransformer-Objekt zugeordnet ist.
{#GImpSetTrans-getImportSetRun__table_inr_wvq_xjb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 2. Parameter]

{#GImpSetTrans-getImportSetRun__table_inr_wvq_xjb} {#GImpSetTrans-getImportSetRun__table_jnr_wvq_xjb__entry__2}

| Typ | Beschreibung |
|-|-|
| GlideImportSetRun | GlideImportSetRun-Objekt, das durch Ausführen einer Transformation oder des an die setImportSetRun()- Methode übergebenen Arguments erstellt wurde. |
[Tabelle : 3. Ergebnisse]

{#GImpSetTrans-getImportSetRun__table_jnr_wvq_xjb}  

    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() {#ariaid-title4}

Gibt einen booleschen Wert zurück, der angibt, ob während einer Transformation ein Fehler aufgetreten ist.
{#GImpSetTrans-isError__table_inr_wvq_xjb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 4. Parameter]

{#GImpSetTrans-isError__table_inr_wvq_xjb} {#GImpSetTrans-isError__table_jnr_wvq_xjb__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob ein Fehler vorliegt. * true: Fehler. * false: Erfolg {#GImpSetTrans-isError__ul_ec3_j1y_bkb} |
[Tabelle : 5. Ergebnisse]

{#GImpSetTrans-isError__table_jnr_wvq_xjb}  

    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) {#ariaid-title5}

Ordnet einen Importsatz-Datensatz einem bestimmten GlideImportSetTransformer-Objekt zu.
{#GImpSetTrans-setImportSetID_S__table_inr_wvq_xjb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| id | Zeichenfolge | Die sys_id eines Importsatz-Datensatzes aus der Importsatz-Tabelle \[sys_import_set\]. |
[Tabelle : 6. Parameter]

{#GImpSetTrans-setImportSetID_S__table_inr_wvq_xjb} {#GImpSetTrans-setImportSetID_S__table_jnr_wvq_xjb__entry__2}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 7. Ergebnisse]

{#GImpSetTrans-setImportSetID_S__table_jnr_wvq_xjb}  

    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) {#ariaid-title6}

Ordnet ein Importsatz-Ausführungsobjekt einem bestimmten GlideImportSetTransformer-Objekt zu.
{#GImpSetTrans-setImportSetRun_O__table_inr_wvq_xjb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| importSetRun | GlideImportSetRun | GlideImportSetRun-Objekt, das den ImportSetRun-Datensatz zur Nachverfolgung des Transformationsverlaufs darstellt. |
[Tabelle : 8. Parameter]

{#GImpSetTrans-setImportSetRun_O__table_inr_wvq_xjb} {#GImpSetTrans-setImportSetRun_O__table_jnr_wvq_xjb__entry__2}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 9. Ergebnisse]

{#GImpSetTrans-setImportSetRun_O__table_jnr_wvq_xjb}  

    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) {#ariaid-title7}

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.
{#GImpSetTrans-setLogger_O__table_inr_wvq_xjb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Protokoll | GlideImportLog | 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 : 10. Parameter]

{#GImpSetTrans-setLogger_O__table_inr_wvq_xjb} {#GImpSetTrans-setLogger_O__table_jnr_wvq_xjb__entry__2}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 11. Ergebnisse]

{#GImpSetTrans-setLogger_O__table_jnr_wvq_xjb}  

    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) {#ariaid-title8}

Ordnet eine Transformationszuordnung einem bestimmten GlideImportSetTransformer-Objekt zu.
{#GImpSetTrans-setMapID_S__table_inr_wvq_xjb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| mapID | Zeichenfolge | Eine sys_id aus der Tabelle „Tabellentransformationszuordnungen" \[sys_transform_map\]. |
[Tabelle : 12. Parameter]

{#GImpSetTrans-setMapID_S__table_inr_wvq_xjb} {#GImpSetTrans-setMapID_S__table_jnr_wvq_xjb__entry__2}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 13. Ergebnisse]

{#GImpSetTrans-setMapID_S__table_jnr_wvq_xjb}  

    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) {#ariaid-title9}

Aktiviert die Ausführung synchroner Transformationen.
{#GImpSetTrans-setSyncImport_B__table_inr_wvq_xjb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| synchron | Boolean | Legt den Transformationsmodus fest. Gültige Werte: * „wahr": Transformation wird synchron ausgeführt * „falsch": Transformation wird asynchron ausgeführt {#GImpSetTrans-setSyncImport_B__ul_elk_qq4_bkb} Standardwert: false |
[Tabelle : 14. Parameter]

{#GImpSetTrans-setSyncImport_B__table_inr_wvq_xjb} {#GImpSetTrans-setSyncImport_B__table_jnr_wvq_xjb__entry__2}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 15. Ergebnisse]

{#GImpSetTrans-setSyncImport_B__table_jnr_wvq_xjb}  


    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) {#ariaid-title10}

Führt die Importsatz-Transformation aus.
{#GImpSetTrans-transformAllMaps_G_S__table_inr_wvq_xjb__entry__3}

| 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 : 16. Parameter]

{#GImpSetTrans-transformAllMaps_G_S__table_inr_wvq_xjb} {#GImpSetTrans-transformAllMaps_G_S__table_jnr_wvq_xjb__entry__2}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 17. Ergebnisse]

{#GImpSetTrans-transformAllMaps_G_S__table_jnr_wvq_xjb}  

    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);