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 zur Datenzuordnung in Application Integration finden Sie unter Übersicht über die Datenzuordnung.

Data Transformer-Scriptaufgabe konfigurieren

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

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

    Zu Application Integration

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

    Auf der Seite Integrationen werden alle im Google Cloud-Projekt verfügbaren Integrationen aufgeführt.

  3. Wählen Sie eine vorhandene Integration aus oder klicken Sie auf Verknüpfung erstellen, um eine neue zu erstellen.

    Wenn Sie eine neue Integration erstellen, gehen Sie so vor:

    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 Details des Dienstkontos einer Integration jederzeit im Bereich Integrationsübersicht in der Symbolleiste für Integrationen ä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 Aufgaben, um die Liste der verfügbaren Aufgaben und Connectors 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 den Editor, wenn er abgeschlossen ist. Alle Änderungen werden automatisch gespeichert.

Data Transformer Script-Editor 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, deren Programme aus Ausdrücken bestehen. Informationen zum Bilden dieser Ausdrücke finden Sie unter Jsonnet-Ausdrücke.

Kontingente und Limits

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

Nächste Schritte