Aufgabe „Data Transformer-Script“

Mit der Aufgabe Data Transformer-Script 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 Datenzuordnung – Übersicht.

Data Transformer-Scriptaufgabe konfigurieren

Führe die folgenden Schritte aus, um der Integration eine Aufgabe für das Data Transformer-Skript hinzuzufügen:

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

    Zur Seite „Application Integration“

  2. Klicken Sie im Navigationsmenü auf Integrations (Integrationen).

    Die Seite Integrationen wird angezeigt. Dort sind alle im Google Cloud-Projekt verfügbaren Integrationen aufgeführt.

  3. Wähle eine vorhandene Integration aus oder klicke auf Verknüpfung erstellen, um eine neue zu erstellen.

    Wenn Sie eine neue Integration erstellen:

    1. Geben Sie im Bereich Create Integration (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 Integrationsübersicht in der Integrationssymbolleiste ändern oder aktualisieren.
    4. Klicken Sie auf Erstellen.

    Dadurch wird die Integration auf der Seite Integrationseditor geöffnet.

  4. Klicken Sie in der Navigationsleiste des Integrationseditors auf Tasks, um die Liste der verfügbaren Aufgaben aufzurufen.
  5. Klicken Sie auf das Element Data Transformer-Script und platzieren Sie es im Integrationseditor.
  6. Klicken Sie im Designer auf das Element Data Transformer Script, um den Aufgabenkonfigurationsbereich von Data Transformer Script aufzurufen.
  7. Klicken Sie auf Data Transformer-Script-Editor öffnen.
  8. Der Data Transformer-Script-Editor wird mit einem Standardbeispiel für eine Jsonnet-Vorlage mit Kommentaren angezeigt.
  9. Schreiben Sie Ihren Jsonnet-Code und schließen Sie danach den Editor. Alle Änderungen werden automatisch gespeichert.

Data Transformer Script-Editor verwenden

Mit dem Data Transformer-Script-Editor können Sie access, 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-Skripteditor 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

Best Practices

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

Nächste Schritte