---
sourceDocument: Xanadu: Integrationen mit Anwendungen erstellen
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/xanadu/integrate-applications

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu: Integrationen mit Anwendungen erstellen

ft:clusterId :

    - crint

bundleId :

    - crint

workflow :

    - Creator


---

# Verwenden Sie die ETL- und Transformationszuordnungs-Verbraucher, um Daten zu importieren

# Verwenden Sie die ETL- und Transformationszuordnungs-Verbraucher, um Daten zu importieren {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 Minuten Lesedauer

Verwenden Sie ETL-Definitionen und Transformationszuordnungen, um Kafka-Ereignisse zu verarbeiten. ETL-Definitionen und Transformationszuordnungen geben die Transformationslogik an, die beim Abrufen von Daten über geplante Importe verwendet werden soll. Sie können dieselben ETL-Definitionen und Transformationszuordnungen verwenden, um die über Kafka empfangenen Ereignisse zu transformieren.

## Vorbereitungen

* Erforderliche Rolle: integration_hub_admin
* Diese Seite ist Teil von [Stream Connect Schnellstarthandbuch](https://servicenow-prod.fluidtopics.net/c5L2Dtl2Ys3f_j1UGtvy0Q "Diese Schnellstartanleitung gibt Ihnen einen Überblick über die Einrichtung und Verwendung der sechs Stream Connect-Ersteller und -Verbraucher für den Datenaustausch zwischen Ihrer Instanz ServiceNow und einer Kafka-Umgebung.").
* In diesem Dokument erfahren Sie, wie Sie Nachrichten über Ihre Verbindung zu Hermes verbrauchen. Informationen zum Einrichten und Testen Ihrer Verbindung finden Sie unter [Set up a secure connection to the Hermes Messaging Service](https://www.servicenow.com/docs/access?context=set-up-secure-connection-to-hermes&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US) und [Verbindung mit Hermes über das ADCv2-Gateway testen](https://servicenow-prod.fluidtopics.net/m8xUkhIPdH1NF69iyyy9nw "Stellen Sie sicher, dass der Schlüsselspeicher und der Truststore ordnungsgemäß generiert wurden, indem Sie die Verbindung zu Hermes über das ADCv2-Gateway testen.").
* Im ersten Teil dieser Seite erfahren Sie, wie Sie mit dem -ETL-Verbraucher Nachrichten verbrauchen. Zur Verwendung des -ETL-Verbrauchers benötigen Sie einen [robusten Importsatz-Umwandler](https://servicenow-prod.fluidtopics.net/cQ9XD0tbYyicYEnSAlmfVA "Verwenden Sie robuste Transformatoren für Importsatz anstelle von Transformationszuordnungen, wenn Sie Daten extrahieren, transformieren und in eine oder mehrere Zieltabellen laden möchten.").
* Im zweiten Teil dieser Seite erfahren Sie, wie Sie mit einem Transformationszuordnungs-Verbraucher Nachrichten verbrauchen. Zur Verwendung des Transformationszuordnungsverbrauchers benötigen Sie eine [Transformationszuordnung](https://servicenow-prod.fluidtopics.net/muoq9mzh_zTArrIEmnt1jA "Eine Transformationszuordnung ist ein Satz von Feldzuordnungen, die die Beziehungen zwischen Feldern in einem Importsatz und Feldern in einer vorhandenen Tabelle ServiceNow, z. B. Incident [incident] oder Anwender [sys_user], bestimmen.").
{#use-etl-transform-map-consumers__ul_gm5_njx_cyb}

## Prozedur

1. Erstellen Sie ein Thema, um ETL zu verbrauchen und Verbrauchernachrichten für Transformationszuordnungen zu transformieren.
   1. Verwenden Sie den folgenden Befehl, um ein Thema in Hermes zu erstellen.  
      In diesem Beispiel lautet der Themenname topic2.

          bin/kafka-topics.sh --create --command-config config/bootcamp.properties  --bootstrap-server <instance name>.service-now.com:4000,<instance name>.service-now.com:4001,<instance name>.service-now.com:4002, <instance name>.service-now.com:4003 --topic snc.<instance name>.topic2

      Ersetzen Sie unbedingt\<instance name\> mit dem Namen Ihrer Instanz.
   2. Um das Thema anzuzeigen, melden Sie sich bei der Instanz an, und navigieren Sie zu AlleIntegrationHubStream ConnectThemen.  
      Hinweis:  
      Das Erstellen eines Themas dauert ungefähr 10 Minuten.
   {#use-etl-transform-map-consumers__substeps_lv3_ylx_cyb}
2. Erstellen Sie einen -ETL-Verbraucher, um Daten aus dem Thema zu verbrauchen.
   1. Navigieren zu AlleIntegrationHubVerbraucherETL-Verbraucher.
   2. Wählen Sie Neu.
   3. Geben Sie im Formular „Kafka-Verbraucher" im Feld Name einen Namen ein.  
      In diesem Beispiel wird der Name Mitgliedsimport verwendet.
   4. Wählen Sie für das Feld „ Robuster Importsatz-Umwandler " einen vorhandenen robusten Importsatz-Umwandler aus.  
      Wählen Sie für den robusten Transformator für Importsatz einen Umwandler aus, bei dem die Option zum Speichern von Daten in einer einzelnen Spalte nicht verwendet wird. Um die Nachrichten sehen zu können, stellen Sie sicher, dass für den robusten Importsatz -Umwandler die Option Ausführlich aktiviert ist.
   5. Deaktivieren Sie die Option Daten in einzelner Spalte.  
      Diese Option sollte nur für Importsatztabellen mit Daten in einer einzelnen Spalte ausgewählt werden.
   6. Legen Sie die Spaltenzuordnung auf Bezeichnung fest.  
      Dies bedeutet, dass die JSON-Schlüssel der Eingabenachricht den Spaltenbezeichnungen der Importsatztabelle zugeordnet sind.  
   7. Speichern Sie das Formular.
   8. [Erstellen Sie einen Kafka-Stream](https://servicenow-prod.fluidtopics.net/Qvigf6C~XYqIHz7CuIetsw "Definieren Sie einen Datenstrom für einen Extraktor der Transformationslast (ETL), eine Transformationszuordnung oder einen Skript-Verbraucher. Ein Kafka-Stream definiert den Datenstrom zu Ihrem Verbraucher.") für den Verbraucher.
   9. Legen Sie im Formular „Kafka-Stream" die folgenden Feldwerte fest.  
      * Name des <kbd class="ph userinput">Streams „Thema2“</kbd>.
      * Thema zum zuvor erstellten Thema, topic2.
      * Max. Gleichzeitigkeit bis <kbd class="ph userinput">1</kbd>.
      * Verwendung von für Nachrichtenstarten, die nach der ersten Aktivierung empfangen wurden.
      * Nachrichtenverarbeitungautomatisch optimieren.
      {#use-etl-transform-map-consumers__ul_pbp_rqm_2yb}
   10. Wählen Sie unter Zugehörige Links den Link Aktivieren aus.  
       Sie sollten das aktivierte Abonnement sehen können.  
   {#use-etl-transform-map-consumers__substeps_ajg_hkx_cyb}
3. Veröffentlichen Sie Nachrichten in topic2.
   1. Führen Sie den folgenden Befehl aus, um Nachrichten in topic2 zu veröffentlichen.  

          bin/kafka-console-producer.sh --topic snc.<instance name>.topic2  --producer.config  config/bootcamp.properties  --bootstrap-server <instance name>.service-now.com:4000,<instance name>.service-now.com:4001,<instance name>.service-now.com:4002,<instance name>.service-now.com:4003

      Ersetzen Sie unbedingt\<instance name\> mit dem Namen Ihrer Instanz.

      Dieser Befehl fordert Sie zur Eingabe von Nachrichten auf.
   2. Senden Sie die folgende JSON-Nachricht.  

          {"city":"San Diego","name":"Jhon","id":"SN001","state":"California"}

      Sie können diese Nachricht mit beliebigen Werten senden, aber der JSON-Nachrichtenschlüssel muss mit den Tabellenbezeichnungen des Importsatzes übereinstimmen.
   3. Navigieren Sie zurück zu dem von Ihnen erstellten -ETL-Verbraucher.  
      Nach etwa einer Minute sollten die Daten über den Importsatz importiert worden sein.  
   4. Um detaillierte Informationen zum Importsatz anzuzeigen, wählen Sie die Importsatznummer aus.  
   5. Um detaillierte Informationen zu einer Importsatzzeile anzuzeigen, wählen Sie die Nummer der Importsatzzeile aus.  
   {#use-etl-transform-map-consumers__substeps_uzy_4kx_cyb}
4. Erstellen Sie einen Transformationszuordnungsverbraucher, um Daten zu verbrauchen.
   1. Navigieren zu AlleIntegrationHubVerbraucherVerbraucher der Transformationszuordnung.
   2. Wählen Sie Neu.
   3. Geben Sie im Formular „Verbraucher der Kafka-Transformationszuordnung" im Feld Name einen Namen ein.
   4. Wählen Sie im Feld Transformationszuordnung eine vorhandene Transformationszuordnung aus.  
   5. Speichern Sie das Formular.
   6. [Erstellen Sie einen Kafka-Stream](https://servicenow-prod.fluidtopics.net/Qvigf6C~XYqIHz7CuIetsw "Definieren Sie einen Datenstrom für einen Extraktor der Transformationslast (ETL), eine Transformationszuordnung oder einen Skript-Verbraucher. Ein Kafka-Stream definiert den Datenstrom zu Ihrem Verbraucher.") für den Verbraucher.
   7. Legen Sie im Formular „Kafka-Stream" die folgenden Feldwerte fest.  
      * Name für die <kbd class="ph userinput">Transformation des Zuordnungs-Streams</kbd>.
      * Thema zum zuvor erstellten Thema, topic2.
      * Max. Gleichzeitigkeit bis <kbd class="ph userinput">1</kbd>.
      * Verwendung von für Nachrichtenstarten, die nach der ersten Aktivierung empfangen wurden.
      * Nachrichtenverarbeitungautomatisch optimieren.
      {#use-etl-transform-map-consumers__ul_u4q_1wm_2yb}
   8. Wählen Sie unter Zugehörige Links den Link Aktivieren aus.  
      Sie sollten das aktivierte Abonnement sehen können.  
   {#use-etl-transform-map-consumers__substeps_yt5_vkx_cyb}
5. Veröffentlichen Sie Nachrichten in topic2.
   1. Führen Sie den folgenden Befehl aus, um Nachrichten in topic2 zu veröffentlichen.  

          bin/kafka-console-producer.sh --topic snc.<instance name>.topic2  --producer.config  config/bootcamp.properties  --bootstrap-server <instance name>.service-now.com:4000,<instance name>.service-now.com:4001,<instance name>.service-now.com:4002,<instance name>.service-now.com:4003

      Ersetzen Sie unbedingt\<instance name\> mit dem Namen Ihrer Instanz.

      Dieser Befehl fordert Sie zur Eingabe von Nachrichten auf.
   2. Senden Sie die folgende JSON-Nachricht.  

          {"city":"San Diego","name":"Jhon","id":"SN001","state":"California"}

      Sie können diese Nachricht mit beliebigen Werten senden, aber der JSON-Nachrichtenschlüssel muss mit den Tabellenbezeichnungen des Importsatzes übereinstimmen.
   3. Wechseln Sie zu dem von Ihnen erstellten Verbraucher der Transformationszuordnung.  
      Nach etwa einer Minute sollten die Daten über den Importsatz importiert worden sein.
   4. Um detaillierte Informationen zum Importsatz anzuzeigen, wählen Sie die Importsatznummer wie in Schritt 3d oben beschrieben aus.
   {#use-etl-transform-map-consumers__substeps_t4b_clx_cyb}

## Nächste Maßnahme

[Verwenden Sie den Kafka-Ersteller-Schritt und die ProduzentenV2-API, um Nachrichten zu veröffentlichen](https://servicenow-prod.fluidtopics.net/x9Sn1wGXZ_jNX7GhK2Xwxg "Übertragen Sie Daten aus ServiceNow an Hermes, damit die Kafka-Verbraucher sie lesen können.").