---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# RTEUmwandler -- Umfang

# RTEUmwandler -- Umfang {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 Minuten Lesedauer

Die RTEUmwandler Die API bietet eine Methode zum Transformieren und Speichern eines Arrays von Nachrichten in einen Datensatz in der zugeordneten ServiceNowInstanz basierend auf einer angegebenen ETL-Definition (Extrahieren, Transformieren und Laden).
Sie können diese API beispielsweise verwenden, wenn Sie über JSON-Nutzlasten verfügen, die Anwenderinformationen enthalten, und Sie diese Informationen mithilfe der robusten Transformationsmaschine (RTE) in die Tabelle „sys_user" umwandeln möchten.

Verwenden Sie `sn_impex `Namespace beim Zugriff auf diese API.

Weitere Informationen finden Sie unter [Definieren Sie robuste Transformations-Engine-Vorgänge](https://www.servicenow.com/docs/access?context=define-rte-operations&version=yokohama&pubname=yokohama-integrate-applications&ft:locale=en-US).

## RTETransformer -- rteTransform (Zeichenfolge transformationDefinitionId, boolesches verboseLogging, Zeichenfolgenquelle, Anzahl BatchSize) {#ariaid-title2}

Instanziiert ein RTETransformer-Objekt.
{#RTETrans-RTETrans_S_B_S_N__table_rsd_fk2_jtb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| TransformationsdefinitionId | Zeichenfolge | SYS_ID der ETL-Definition (Extrahieren, Transformieren und Laden), die für die Transformation verwendet werden soll. Informationen zum Erstellen einer ETL finden Sie unter [Erstellen Sie ETL-Definitionen (Extrahieren Transformationsladen)](https://www.servicenow.com/docs/access?context=create-etl-definitions&version=yokohama&pubname=yokohama-integrate-applications&ft:locale=en-US). Tabelle: ETL-Definitionen \[sys_rte_eb_etl_definition\] |
| VerboseLogging | Boolean | Kennzeichnung, die angibt, ob die ausführliche Protokollierung und die Erstellung von Importsatzzeilen für das Debugging aktiviert werden sollen. Gültige Werte: * Wahr: Protokollierung und Zeilenerstellung des Importsatzes aktivieren. * Falsch: Protokollierung und Zeilenerstellung des Importsatzes nicht aktivieren. {#RTETrans-RTETrans_S_B_S_N__ul_u1v_fm2_jtb} |
| Quelle | Zeichenfolge | Namensfeld des Importsatzdatensatzes. |
| batchSize | Nummer | Anzahl der gleichzeitig zu verarbeitenden Nachrichten (Batch). Wenn eine Nutzlast beispielsweise 10 Nachrichten enthält und dieser Wert auf 2 festgelegt ist, führt die Methode fünf separate Batch-Aufträge aus, um alle Nachrichten in der Nutzlast zu verarbeiten. |
[Tabelle : 1. Parameter]

{#RTETrans-RTETrans_S_B_S_N__table_rsd_fk2_jtb}  
Das folgende Codebeispiel zeigt, wie ein RTETransformer-Objekt für den Quell-testSourceRecord instanziiert wird, das eine Batchgröße von 10 hat.

    (function(/*CTIOperationRequest*/ request, /*CTIOperationResponse*/ response, /*Context*/ ctx) {    
      // Uses an ETL definition with a target table of incident, and mappings for the number and short description field
      var transformer = new sn_impex.RTETransformer("c58f1c6377110110f5455d14cd5a998b", true, "testSourceRecord", 10);
      var messages = ["{\"number\":\"testnumber\",\"short_description\":\"testdesc\"}"];
      var results = transformer.transform(messages);

      for (var i = 0; i < results.length; i++) {
        var dataList = results[i].data.incident;
        gs.log("source record id: " + results[i].sourceRecordSysId);
        gs.log("status: " + results[i].status);
        for (var j = 0; j < dataList.length; j++) {
          gs.log("number:" + dataList[j].number);
          gs.log("short desc:" + dataList[j].short_description);
        }
      }
    })(request, response, ctx);

## RTETransformer -- Transform(Array-Nachricht) {#ariaid-title3}

Transformiert und speichert ein Array von Nachrichten in einem Datensatz in der zugeordneten ServiceNowInstanz basierend auf einer angegebenen ETL-Definition (Extrahieren, Transformieren und Laden).
Wenn Sie beispielsweise Anwenderinformationen in einen sys_user-Datensatz umwandeln möchten, können Sie ein Nachrichten-Array mit einer einzelnen Nachricht erstellen und an diese Transformationsmethode übergeben.
{#RTETrans-transform_A__table_xsb_bq2_jtb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Nachricht | Objekt-Array | Stringifizierte JSON-Objekte, die die Datensätze darstellen, die basierend auf der ETL-Definition transformiert werden sollen. Wenn Sie beispielsweise einen einzelnen Anwender mit den aktiven Daten, E-Mail, Vorname und Nachname in die Tabelle „sys_user" transformieren möchten, würde die Nachricht ähnlich aussehen: [ { "active":"true", "email":"example@servicenow.com", "first_name":"Jane", "last_name":"Doe" } ] Hinweis: Die Feldnamen müssen mit dem Feld/Pfad der Quellentitätsfelder übereinstimmen. |
[Tabelle : 2. Parameter]

{#RTETrans-transform_A__table_xsb_bq2_jtb} {#RTETrans-transform_A__table_ysb_bq2_jtb__entry__2}

| Name | Beschreibung |
|-|-|
| Daten | Daten für die transformierten Datensätze, organisiert nach Tabellenname. Die zurückgegebenen Datensatzdaten stimmen mit den in der ETL-Definition angegebenen zugeordneten Feldern überein. Datentyp: Objekt "data": { "tableName": [] } |
| Daten.tableName | Details der Tabelle, die die Datensätze enthält. Datentyp: Array von Objekten "tableName": [{ "sys_id": String, // Other data for a single transformed record }] } Zum Beispiel: "sys_user": [{ "sys_id":"b29e629877130110f5455d14cd5a99ad", "active": "true", "email": "example@servicenow.com", "first_name": "Jane", "last_name": "Doe" }] |
| Daten.tableName.sys_ID | SYS_ID des Datensatzes in der Tabelle. Datentyp: Zeichenfolge |
| Daten.tableName.\<other_ETL_info\> | Zusätzliche Felder, die in der übergebenen ETL angegeben wurden. Datentyp: Beliebig |
| Nachricht | Wenn beim Transformieren des angegebenen Datensatzes ein Fehler auftritt, eine Meldung, die den Fehler beschreibt. Null, wenn die Transformation erfolgreich ist. Datentyp: Zeichenfolge |
| sourceRecordSysId | SYS_ID des Datensatzes der Importsatztabelle. Der Tabellenname des Importsatzes ist JSON-Ereignissenke \[imp_json_event_sink\]. Datentyp: Zeichenfolge |
| Status | Status der Transformation, z. B. „verarbeitet" oder „Fehler". Datentyp: Zeichenfolge |
[Tabelle : 3. Rückgaben]

{#RTETrans-transform_A__table_ysb_bq2_jtb}  
Das folgende Codebeispiel zeigt, wie ein Datensatz in der Anwendertabelle \[sys_user\] transformiert und gespeichert wird.

    (function(/*CTIOperationRequest*/ request, /*CTIOperationResponse*/ response, /*Context*/ ctx) { 
      // Uses an ETL definition with a target table of sys_user, and mappings for the active, 
      //email, first name, and last name fields
      var transformer = new sn_impex.RTETransformer("c58f1c6377110110f5455d14cd5a998b", true, "testSourceRecord", 10);
      var messages = [JSON.stringify({
        "active":"true",
        "email":"example@servicenow.com",
        "first_name":"Jane",
        "last_name":"Doe"
      }), 
      JSON.stringify({
        "active":"true",
        "email":"example2@servicenow.com",
        "first_name":"John",
        "last_name":"Deer"
      })];
      var results = transformer.transform(messages);

      for (var i = 0; i < results.length; i++) { 
        var dataList = results[i].data.sys_user;
        gs.log("source record id: " + results[i].sourceRecordSysId); gs.log("status: " + results[i].status);
        for (var j = 0; j < dataList.length; j++) { 
          gs.log("First Name: " + dataList[j].first_name);
          gs.log("Last Name: " + dataList[j].last_name);
          gs.log("Email: " + dataList[j].email;
          gs.log("Active: " + dataList[j].active;
        }
      }
    }

Ergebnisse:

    source record id: b29e629877130110f5455d14cd5a99ad
    status: PROCESSED
    First Name: Jane
    Last Name: Doe
    Email: example@servicenow.com
    Active: true
    First Name: John
    Last Name: Deer
    Email: example2@servicenow.com
    Active: true


