Data Transformer-Aufgabe

Die Aufgabe Data Transformer bietet zwei Modi – Diagramm und Script – zum Transformieren Ihrer Daten. Im Modus Diagramm verwenden Sie einen visuellen Canvas, den Data Transformer-Editor, um Datenzuweisungen und Zuordnungen in Ihrer Integration vorzunehmen. Außerdem können Sie die unterstützten Transformationen verwenden, um Ihre Daten in aussagekräftige Variablen und Formate umzuwandeln, sodass sie für die anderen Aufgaben oder Trigger in Ihrer Integration zugänglich sind. Im Modus Script können Sie benutzerdefinierte Jsonnet-Vorlagen schreiben, bearbeiten und auswerten, um eine Datenzuordnung in Ihrer Integration durchzuführen.

Informationen zur Datenzuordnung in Application Integration finden Sie unter Datenzuordnung – Übersicht.

Data Transformer-Aufgabe konfigurieren

Führen Sie die folgenden Schritte aus, um der Integration eine Aufgabe vom Typ Data Transformer hinzuzufügen:

Rufen Sie in der Google Cloud Console die Seite Application Integration auf.
Zu „Application Integration“
Klicken Sie im Navigationsmenü auf Integrationen.
Die Seite Integrationen wird angezeigt. Dort sind alle Integrationen aufgeführt, die im Google Cloud-Projekt verfügbar sind.
Wählen Sie eine vorhandene Integration aus oder klicken Sie auf Integration erstellen, um eine neue zu erstellen.
Wenn Sie eine neue Integration erstellen, gehen Sie so vor:
1. Geben Sie im Bereich Integration erstellen einen Namen und eine Beschreibung ein.
2. Wählen Sie eine Region für die Integration aus.
  Hinweis: Im Drop-down-Menü Regionen werden nur die in Ihrem Google Cloud-Projekt bereitgestellten Regionen aufgeführt. Klicken Sie zum Bereitstellen einer neuen Region auf Region aktivieren. Weitere Informationen finden Sie unter Neue Region aktivieren.
3. Wählen Sie ein Dienstkonto für die Integration aus. Sie können die Details des Dienstkontos einer Integration jederzeit im Bereich Integrationsübersicht in der Symbolleiste für Integrationen ändern oder aktualisieren.
  Hinweis:Die Option zum Auswählen eines Dienstkontos wird nur angezeigt, wenn Sie die Integrationsverwaltung für die ausgewählte Region aktiviert haben.
4. Klicken Sie auf Erstellen.
Dadurch wird die Integration auf der Seite Integrationseditor geöffnet.
Klicken Sie in der Navigationsleiste des Integrationseditors auf Aufgaben, um eine Liste der verfügbaren Aufgaben und Verbindungen aufzurufen.
Klicken Sie auf das Element Data Transformer und platzieren Sie es im Integrationseditor.
Klicken Sie auf das Element Datentransformator, um den Konfigurationsbereich der Aufgabe aufzurufen.
Klicken Sie auf Data Transformer-Editor öffnen. Wählen Sie auf der Seite Data Transformer-Aufgabeneditor (Vorabversion) eine der folgenden Optionen aus:

Standardmäßig wird der Modus Diagramm geöffnet. Im Modus Diagramm können Sie über eine Konsole Eingabe- und Ausgabevariablen auswählen und Transformationen im Editor für Datentransformationen ausführen.
Im Modus Diagramm können Sie den Datenabgleich zwischen Eingabe- und Ausgabevariablen visuell vornehmen.
Wenn Sie Datentransformationen in Ihrer Integration durchführen möchten, indem Sie benutzerdefinierte Jsonnet-Vorlagen schreiben, bearbeiten und auswerten, klicken Sie auf Script, um den Script-Modus aufzurufen. Sie können den Modus Script verwenden, wenn Sie komplexe Datentransformationsanforderungen haben und Jsonnet-Funktionen nutzen möchten.
Der Data Transformer-Editor wird mit einem Standardbeispiel für eine Jsonnet-Vorlage mit Kommentaren angezeigt. Schreiben Sie Ihren Jsonnet-Code und schließen Sie den Editor, wenn er abgeschlossen ist. Alle Änderungen werden automatisch gespeichert.

Ausführliche Schritte zum Hinzufügen einer Zuordnung finden Sie unter Zuordnung hinzufügen.

Zuordnung hinzufügen

Sie können eine Zuordnung entweder im Modus Diagramm oder Script hinzufügen.

Diagrammmodus verwenden

Im Modus Diagramm können Sie über eine Konsole Eingabe- und Ausgabevariablen auswählen und Transformationen im Editor für Datentransformationen ausführen. So fügen Sie eine Zuordnung im Modus Diagramm hinzu:

Klicken Sie im Konfigurationsbereich der Aufgabe „Data Transformer“ auf Data Transformer-Editor öffnen.
Standardmäßig ist der Modus Diagramm geöffnet.
Klicken Sie auf + Eingabe hinzufügen, um die Eingabevariable für die Zuordnung hinzuzufügen. Das Dialogfeld Eingabevariable oder -wert auswählen wird angezeigt. Der Tab Variable ist standardmäßig ausgewählt.
Eingabe: Quelle der Datentransformationseingabe. Die Quelle kann ein Literalwert, eine Basisfunktion oder eine Eingabevariable mit Abgleichsfunktionen sein.

Gehen Sie anschließend so vor:
1. Wählen Sie in der Liste Variable(n) auswählen die Eingabevariable(n) aus. Wenn Sie eine neue Variable erstellen möchten, klicken Sie auf + Neue Variable hinzufügen.
2. Klicken Sie auf Senden.
Wenn Sie eine Konstante hinzufügen möchten, klicken Sie auf den Tab Konstante.

Im Gegensatz zu Variablen sind Konstanten für andere Aufgaben oder Trigger in Ihrer Integration nicht zugänglich und können nur in der Aufgabe Datentransformation verwendet werden, in der sie erstellt werden. Sie können beispielsweise Konstanten verwenden, um Trennzeichen hinzuzufügen oder einer Variablen einen konstanten Wert zuzuordnen.

Gehen Sie anschließend so vor:
1. Geben Sie im Feld Konstanten-ID den Namen der Konstante ein.
2. Wählen Sie in der Liste Datentyp einen der folgenden Datentypen aus:
  - String
  - Boolesch
  - Number
3. Geben Sie im Feld Enter the constant value (Konstantenwert eingeben) den Wert ein.
4. Klicken Sie auf Senden.
Klicken Sie auf + Ausgabe hinzufügen, um die Ausgabevariable für die Zuordnung hinzuzufügen, und wählen Sie die Ausgabevariable aus oder erstellen Sie eine neue Variable.
Konfigurieren Sie die Zuordnung:
1. Fügen Sie eine Zuordnung von einer Variablen oder einem untergeordneten Feld aus der Liste Variablen im Bereich Eingabe zur Variablen oder dem untergeordneten Feld aus der Liste Variablen im Bereich Ausgabe hinzu.
2. Wenn Sie eine Transformationsfunktion hinzufügen möchten, bewegen Sie den Mauszeiger auf die Zuordnungslinie und klicken Sie auf settings. Die Schaltfläche Transformation wird auf dem Canvas angezeigt.
  Alternativ können Sie auf Transformation hinzufügen klicken, um die Transformationsfunktion hinzuzufügen.
  
  Gehen Sie anschließend so vor:
  1. Klicken Sie auf die Schaltfläche Transformation, um die Transformation hinzuzufügen. Der Bereich Transformation wird angezeigt.
    
    Gehen Sie anschließend so vor:
    1. Klicken Sie auf + Vorgang hinzufügen. Das Dialogfeld Vorgang hinzufügen wird angezeigt.
    2. Geben Sie im Feld Suchvorgänge den Vorgang ein, den Sie hinzufügen möchten. Alternativ können Sie den Vorgang auch aus der Liste der Vorgänge auswählen.
      Wenn Sie einen benutzerdefinierten Vorgang hinzufügen möchten, wählen Sie Funktionsausdruck aus und geben Sie den Funktionsausdruck ein. Wenn Sie die Variablen kopieren möchten, klicken Sie in der Liste Variablen auf und fügen Sie sie in den Ausdruckseditor ein.
    3. Klicken Sie auf Fertig.
  2. Geben Sie je nach Vorgang die erforderlichen Details ein. Optional können Sie einer Transformation mehrere Vorgänge hinzufügen. Wenn Sie das Ergebnis der vorherigen Operation für die nachfolgende Operation auswählen möchten, wählen Sie die Variable Ergebnis der vorherigen Operation aus, wie in der folgenden Abbildung dargestellt:
  3. Wenn Sie den Vorgang entfernen möchten, klicken Sie neben dem Vorgang auf Löschen.
3. Optional können Sie einer Transformationsfunktion eine Zuordnung von mehreren Eingabevariablen hinzufügen. Für jede Ausgabevariable einer Transformationsfunktion kann jedoch nur eine Zuordnung hinzugefügt werden.
4. Wenn Sie die Eingabe- und Ausgabevariablen entfernen möchten, klicken Sie auf > Löschen.
5. Wenn Sie eine Abgleichszeile oder eine Transformation löschen möchten, wählen Sie die entsprechende Zeile aus und drücken Sie die Taste Löschen.
6. Schließen Sie den Datenableichseditor, sobald die Zuordnung abgeschlossen ist. Alle Änderungen werden automatisch gespeichert.
Beispiel: Ein altes Ticketsystem für Fehlerberichte einem neuen Ticketsystem zuordnen

Angenommen, Sie haben ein altes Ticketsystem für Fehler, das Sie zu einem neuen Ticketsystem migrieren möchten. Mit der Option Diagramm können Sie die Felder wie im folgenden Bild dargestellt vom alten in das neue System zuordnen:

Wenn Sie einem Feld einen konstanten Wert hinzufügen möchten, klicken Sie auf Eingabe hinzufügen und fügen Sie eine neue Konstante hinzu. Sie können die neu hinzugefügte Konstante aus dem Abschnitt Eingabe dem Feld im Abschnitt Ausgabe zuordnen.

Wenn Sie die Transformation für Felder hinzufügen möchten, die nicht direkt zugeordnet werden können, klicken Sie auf Transformation und dann auf + Vorgang hinzufügen:

Nachdem die Umwandlung abgeschlossen ist, können Sie die Integration ausführen, um das alte Ticketsystem dem neuen System zuzuordnen.

Script-Modus verwenden

Mit dem Data Transformer-Script-Editor können Sie auf die Integrationsvariablen zugreifen, Variablenzuweisungen vornehmen und Variablen in Ihre Integration einfügen oder ändern. Der Data Transformer-Script-Editor bietet folgende Funktionen zur Bereicherung Ihrer Scripterstellung:
- Syntax/Code-Hervorhebung, Einzug und Zeilennummerierung erleichtern die Code Lesbarkeit und Strukturerkennung.
- Eine Minimap mit einer allgemeinen Übersicht über den Skriptcode und Hilfe bei der schnellen Navigation.
- Klicken Sie, um den Skriptcode in die Zwischenablage zu kopieren.
Öffnen Sie den Aufgabenkonfigurationsbereich Data Transformer Script und klicken Sie auf Data Transformer-Script-Editor öffnen, um den Editor zu öffnen.

Der Data Transformer-Script-Editor importiert standardmäßig functions, eine vordefinierte benutzerdefinierte Bibliothek mit einer Reihe von Jsonnet-Funktionen für die Datenzuordnung in Application Integration. Weitere Informationen zu den verfügbaren benutzerdefinierten Funktionen finden Sie unter Data Transformer-Funktionen.

Die folgende Abbildung zeigt das Beispiellayout für den Data Transformer-Script-Editor:

Auf Integrationsvariablen zugreifen

Wenn Sie eine vorhandene Integrationsvariable aus dem Data Transformer-Script-Editor lesen möchten, verwenden Sie die Funktion extVar aus der vordefinierten functions-Bibliothek.

Achtung: Jsonnet lässt keine Bindestriche (-) als Teil eines ID-Namens zu. Beispiel: ein Variablenname oder ein Funktionsname. Wenn Sie einen Bindestrich (-) als Teil eines Variablennamens verwenden möchten, muss die Variable in doppelten Anführungszeichen deklariert werden, wie im folgenden Beispiel gezeigt.
Beispiel: Vorhandene Integrationsvariablen können mit dem Data Transformer-Script-Editor gelesen und aktualisiert werden.
Jsonnet-Script
local f = import "functions"; // Import predefined Data Transformer function library local str1 = f.extVar("inputVar1"); // Access integration input variable "Inputstr1" with value "Hello" local str2 = f.extVar("inputVar2"); // Access integration input variable "Inputstr2" with value "World" { OutputVar: str1 + " " + str2 + "!", // Write to Jsonnet output variable "OutputVar" "output-str-var": str1 + " Integration " + str2 + "!", // Write to Jsonnet output variable "output-str-var" }
Ausgabe
Jsonnet-Nutzungsreferenz

Jsonnet ist eine rein funktionale Sprache und ihre Programme bestehen aus Ausdrücken. Informationen zum Erstellen dieser Ausdrücke finden Sie unter Jsonnet-Ausdrücke.

Fehlerbehebungsstrategie

Eine Strategie zur Fehlerbehandlung für eine Aufgabe legt die Aktion fest, die ausgeführt werden soll, wenn die Aufgabe aufgrund eines temporären Fehlers fehlschlägt. Informationen zur Verwendung einer Fehlerbehandlungsstrategie und zu den verschiedenen Arten von Fehlerbehandlungsstrategien finden Sie unter Strategien zur Fehlerbehebung.

Kontingente und Limits

Informationen zu den Nutzungslimits für die Aufgabe Data Transformer finden Sie unter Nutzungslimits.

Nächste Schritte
- Hier erfahren Sie mehr über:

Data Transformer-Aufgabe