Aufgabe „Data Transformer“

Die Aufgabe Data Transformer bietet zwei Modi zum Transformieren Ihrer Daten: Diagramm und Script. Im Modus Diagramm verwenden Sie einen visuellen Canvas für die Zuordnung, 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 andere Aufgaben oder Trigger in Ihrer Integration zugänglich sind. Im Script-Modus können Sie benutzerdefinierte Jsonnet-Vorlagen schreiben, bearbeiten und auswerten, um eine Datenzuordnung in Ihrer Integration durchzuführen.

Informationen zum Datenabgleich in Application Integration finden Sie unter Datenabgleich – Übersicht.

Data Transformer-Aufgabe konfigurieren

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

  1. Rufen Sie in der Google Cloud Console die Seite Application Integration auf.

    Zu Application Integration

  2. Klicken Sie im Navigationsmenü auf Integrationen.

    Die Seite Integrationen wird geöffnet. Dort werden alle im Google Cloud-Projekt verfügbaren Integrationen aufgeführt.

  3. 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.
    3. Wählen Sie ein Dienstkonto für die Integration aus. Sie können die Dienstkontodetails einer Integration jederzeit in der Symbolleiste der Integration im Bereich Integrationszusammenfassung ändern oder aktualisieren.
    4. Klicken Sie auf Erstellen. Die neu erstellte Integration wird im Integrationseditor geöffnet.

  4. Klicken Sie in der Navigationsleiste des Integrationseditors auf Aufgaben, um die Liste der verfügbaren Aufgaben und Connectors aufzurufen.
  5. Klicken Sie auf das Element Data Transformer und platzieren Sie es im Integrationseditor.
  6. Klicken Sie auf das Element Data Transformer, um den Konfigurationsbereich der Aufgabe aufzurufen.
  7. Klicken Sie auf Data Transformer-Editor öffnen. Wählen Sie auf der Seite Data Transformer Task Editor eine der folgenden Optionen aus:
    • Standardmäßig wird der Diagrammmodus geöffnet. Der Diagrammmodus bietet eine konsolenbasierte Oberfläche, auf der Sie die Eingabe- und Ausgabevariablen auswählen und Transformationen im Datentransformationseditor ausführen können.

      Im Modus Diagramm können Sie den Datenabgleich zwischen Eingabe- und Ausgabevariablen visuell durchführen.

    • Wenn Sie Datentransformationen in Ihrer Integration durchführen möchten, indem Sie benutzerdefinierte Jsonnet-Vorlagen schreiben, bearbeiten und auswerten, rufen Sie den Scriptmodus auf, indem Sie auf Script klicken. Sie können den Script-Modus verwenden, wenn Sie komplexe Anforderungen an die Datentransformation 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

Wenn Sie eine Zuordnung hinzufügen möchten, können Sie entweder den Modus Diagramm oder den Modus Skript verwenden.

Diagrammmodus verwenden

Der Diagrammmodus bietet eine konsolenbasierte Oberfläche, auf der Sie die Eingabe- und Ausgabevariablen auswählen und Transformationen im Datentransformationseditor ausführen können. So fügen Sie eine Zuordnung im Modus Diagramm hinzu:

  1. Klicken Sie im Konfigurationsbereich der Aufgabe „Data Transformer“ auf Data Transformer-Editor öffnen.

    Standardmäßig ist der Modus Diagramm geöffnet.

    Bild, das den Diagrammmodus zeigt Bild, das den Diagrammmodus zeigt

  2. 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.

    Abbildung mit dem Dialogfeld „Eingabe hinzufügen“ Abbildung mit dem Dialogfeld „Eingabe hinzufügen“

    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.

    Optional: 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 wurden. Sie können beispielsweise Konstanten verwenden, um Trennzeichen hinzuzufügen oder einer Variablen einen konstanten Wert zuzuordnen.

    Abbildung mit dem Dialogfeld „Konstante hinzufügen“ Abbildung mit dem Dialogfeld „Konstante hinzufügen“

    Gehen Sie anschließend so vor:

    1. Geben Sie im Feld Konstantenkennung den Namen der Konstante ein.
    2. Wählen Sie in der Liste Datentyp einen der folgenden Datentypen aus:
      • String
      • Boolesch
      • Zahl
    3. Geben Sie im Feld Konstantenwert eingeben den Wert ein.
    4. Klicken Sie auf Senden.
  3. Wenn Sie die Ausgabevariable für die Zuordnung hinzufügen möchten, klicken Sie auf + Ausgabe hinzufügen und wählen Sie die Ausgabevariable aus oder erstellen Sie eine neue Variable.

    Abbildung des Dialogfelds „Ausgabe hinzufügen“ Abbildung des Dialogfelds „Ausgabe hinzufügen“

  4. Konfigurieren Sie die Zuordnung:
    1. Fügen Sie eine Zuordnung von einer Variablen oder einem untergeordneten Feld aus der Liste Variablen im Abschnitt Eingabe zu der Variablen oder dem untergeordneten Feld aus der Liste Variablen im Abschnitt Ausgabe hinzu.

      Abbildung mit dem Diagrammmodus des Data Transformers Abbildung mit dem Diagrammmodus des Data Transformers

    2. Wenn Sie eine Transformationsfunktion hinzufügen möchten, bewegen Sie den Mauszeiger auf die Zuordnungslinie und klicken Sie auf , um die Datentransformationsfunktion hinzuzufügen. 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 den Button Transformation, um die Transformation hinzuzufügen. Der Bereich Transformation wird angezeigt.

        Abbildung mit Datentransformation Abbildung mit Datentransformation

        Gehen Sie anschließend so vor:

        1. Klicken Sie auf + Vorgang hinzufügen. Das Dialogfeld Vorgang hinzufügen wird angezeigt.

          Abbildung mit Datentransformationsvorgängen Abbildung mit Datentransformationsvorgängen

        2. Geben Sie im Feld Vorgänge suchen den Vorgang ein, den Sie hinzufügen möchten. Alternativ können Sie den Vorgang 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.

          Bild mit Funktionsausdruck Bild mit Funktionsausdruck

        3. Klicken Sie auf Fertig.
      2. Geben Sie die erforderlichen Details für den Vorgang ein. Optional können Sie einer Transformation mehrere Vorgänge hinzufügen. Wenn Sie das Ergebnis des vorherigen Vorgangs im nachfolgenden Vorgang auswählen möchten, wählen Sie die Variable Ergebnis des vorherigen Vorgangs aus, wie in der folgenden Abbildung dargestellt:

        Bild mit mehreren Transformationsvorgängen Bild mit mehreren Transformationsvorgängen

      3. Wenn Sie den Vorgang entfernen möchten, klicken Sie daneben auf Löschen.
    3. Optional können Sie einer Transformationsfunktion die Zuordnung mehrerer 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. Optional: Wenn Sie eine Zuordnungszeile oder eine Transformation löschen möchten, wählen Sie die Zuordnung aus und drücken Sie Löschen.
    6. Schließen Sie den Datenabgleichs-Editor, sobald die Zuordnung abgeschlossen ist. Alle Änderungen werden automatisch gespeichert.

    Beispiel: Zuordnung eines alten Bug-Ticketsystems zu einem neuen Ticketsystem

    Angenommen, Sie haben ein Legacy-Ticketsystem für Fehler, das Sie zu einem neuen Ticketsystem migrieren möchten. Mit der Option Diagramm können Sie die Felder aus dem alten System dem neuen System zuordnen, wie in der folgenden Abbildung dargestellt:

    Abbildung mit dem Diagrammmodus des Data Transformers Abbildung mit dem Diagrammmodus des Data Transformers

    Wenn Sie für eines der Felder 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 Bereich Eingabe dem Feld im Bereich Ausgabe zuordnen.

    Abbildung mit Data Transformer, der eine Konstante hinzufügt Abbildung mit Data Transformer, der eine Konstante hinzufügt

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

    Abbildung mit dem Data Transformer, der eine Transformation hinzufügt Abbildung mit dem Data Transformer, der eine Transformation hinzufügt

    Nach Abschluss der Transformation können Sie die Integration ausführen, um das alte Ticketsystem dem neuen System zuzuordnen.

    Skriptmodus 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:

    Abbildung mit dem Data Transformer-Script-Editor Abbildung mit dem 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.

    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

    Abbildung mit Beispiel für ein Data Transformer-Script Abbildung mit Beispiel für ein Data Transformer-Script

    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.

    Fehlerbehandlungsstrategie

    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