JavaScript-Aufgabe

Mit der Aufgabe JavaScript können Sie benutzerdefinierte JavaScript-Code-Snippets für Ihre Integration schreiben.

Mit dem JavaScript-Editor können Sie komplexe Datenzuordnungslogik für Ihre Integration codieren, Variablenzuweisungen ausführen und Integrationsvariablen hinzufügen oder ändern.

Der JavaScript-Editor unterstützt die folgenden Funktionen:

  • Eine Minimap mit einer allgemeinen Übersicht über den Skriptcode und Hilfe bei der schnellen Navigation.
  • Syntax/Code-Hervorhebung, Einzug und Zeilennummerierung erleichtern die Code Lesbarkeit und Strukturerkennung.
  • Fehler, um Fehler im Code zu finden und zu verfolgen.
  • Fließen zum Maximieren und Minimieren von Regionen des Skriptcodes.
  • Klicken Sie, um den Skriptcode in die Zwischenablage zu kopieren.

JavaScript-Aufgabe konfigurieren

Führen Sie die folgenden Schritte aus, um Ihrer Integration eine JavaScript -Aufgabe 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.

    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 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 im Bereich Integrationsübersicht in der Symbolleiste der Integration ä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 JavaScript und platzieren Sie es im Integrationseditor.
  6. Klicken Sie im Designer auf das Element JavaScript, um den Konfigurationsbereich der Aufgabe JavaScript aufzurufen.
  7. Klicken Sie auf Skripteditor öffnen, um den JavaScript-Editor aufzurufen und zu bearbeiten. Sie können auch JavaScript-Code mit Gemini generieren lassen, indem Sie auf Script with Gemini klicken. Informationen zum Generieren von JavaScript-Code mit Gemini finden Sie unter JavaScript-Aufgaben mit Unterstützung durch Gemini konfigurieren.
  8. Schreiben Sie den JavaScript-Code in die Funktion executesScript(event), die automatisch im JavaScript-Editor erstellt wird. Schließen Sie den Editor, wenn der Vorgang abgeschlossen ist. Alle Änderungen werden automatisch gespeichert.

    Informationen zum Zugriff auf Integrationsvariablen und die unterstützten Funktionen finden Sie unter JavaScript-Editor verwenden.

    Informationen zum Aufrufen der generierten Ausführungslogs finden Sie unter Ausführungslogs.

Die folgende Abbildung zeigt ein Beispiellayout für den JavaScript-Editor: Abbildung mit JavaScript-Editor Abbildung mit JavaScript-Editor

JavaScript-Editor verwenden

Um den JavaScript-Editor anzuzeigen und zu bearbeiten, wechseln Sie zum Konfigurationsbereich JavaScript und klicken Sie auf Skripteditor öffnen. Der JavaScript-Editor enthält standardmäßig eine Funktion namens executesScript(event). Dabei gilt:

  • executesScript(): Die Funktion, die aufgerufen wird, wenn Application Integration die JavaScript-Aufgabe während der Ausführung einer Integration ausführt.
  • event: das In-Memory-Objekt von Application Integration.

    Informationen zu den unterstützten Methoden des Ereignis-Objekts finden Sie unter Auf Integrationsvariablen zugreifen.

JavaScript-Ausführungs-Engine

In Application Integration wurde Rhino bisher als JavaScript-Ausführungs-Engine zum Ausführen von JavaScript-Aufgaben unterstützt. Um die Leistungs- und Sicherheitsvorteile der Open-Source-Hochleistungs-JavaScript-Engine von Google zu nutzen, wird Rhino eingestellt. Alle JavaScript-Ausführungen werden jetzt mit V8, der Open-Source-Hochleistungs-JavaScript-Engine von Google, ausgeführt.

Vorteile von V8

Die V8-JavaScript-Engine bietet folgende Vorteile:

  • Leistung:V8 ist deutlich schneller als Rhino, was zu einer höheren Ausführungsgeschwindigkeit Ihrer JavaScript-Aufgaben führt. Skripts mit großen Variablen und komplexen Berechnungen können schneller ausgeführt werden.
  • Einhaltung von Standards:V8 unterstützt ECMAScript 2024 und sorgt so für bessere Kompatibilität und Wartungsfreundlichkeit.
  • Sicherheit:V8 profitiert von laufenden Sicherheitsupdates und ‑verbesserungen und bietet eine sicherere Umgebung für Ihre Integrationen.
  • Moderne Funktionen:V8 unterstützt die neuesten JavaScript-Funktionen, sodass Sie moderne Sprachkonstrukte und Bibliotheken nutzen können.

Vorhandene JavaScript-Aufgaben zu V8 migrieren

So migrieren Sie Ihre vorhandenen JavaScript-Aufgaben, die in Rhino ausgeführt werden, zu V8:

  1. Identifizieren Sie die veröffentlichten Integrationen, die JavaScript-Aufgaben enthalten, und heben Sie die Veröffentlichung auf.
  2. Klicken Sie für jedes JavaScript im Aufgabenkonfigurationsbereich auf Skripteditor öffnen.

    Application Integration aktualisiert das vorhandene Script automatisch, sodass V8 verwendet wird.

  3. Überprüfen und testen Sie den JavaScript-Code.
  4. Veröffentlichen Sie die Integrationen.

Auf Integrationsvariablen zugreifen

Auf Variablen, die in Ihrer Integration definiert sind, kann über den JavaScript-Editor mit dem In-Memory-Ereignis von Application Integration zugegriffen werden.

Die folgenden Methoden werden unterstützt, um von Ihrem JavaScript-Editor auf Integrationsvariablen zuzugreifen:

Funktionsname Beschreibung Nutzung

getEventExecutionInfoId

 Gibt die Ausführungs-ID der Integration zurück.

Ausgabetyp: String

Syntax: event.getEventExecutionInfoId()

Beispiel: 

function executeScript(event) {
  event.getEventExecutionInfoId();
  }

getGoogleCloudProjectId

 Gibt die ID des Google Cloud-Projekts zurück.

Ausgabetyp: String

Syntax: event.getGoogleCloudProjectId()

Beispiel: 

function executeScript(event) {
  event.getGcpProjectId();
  }

getIntegrationName

 Gibt den aktuellen Namen der Integration zurück.

Ausgabetyp: String

Syntax: event.getIntegrationName

Beispiel: 

function executeScript(event) {
  event.getIntegrationName();
  }

getParameter

 Gibt den Wert der angegebenen Integrationsvariablen zurück.

Rückgabetyp: Datentyp der Integrationsvariable

Syntax: event.getParameter("variable_name")

Eingabeparameter: Name der Integrationsvariable. Wenn variable_name eine automatisch generierte Variable ist, setzen Sie sie in Backticks (``). Beispiel: `responseBody`.

Beispiel:

function executeScript(event) { 
  event.getParameter("var1");
  }

getRegion

 Gibt den Namen der Integrationsregion zurück.

Ausgabetyp: String

Syntax: event.getRegion()

Beispiel: 

function executeScript(event) {
  event.getRegion();
  }

log

 Schreibt den angegebenen Wert in die Ausführungslogs.

Informationen zum Aufrufen der generierten Ausführungslogs finden Sie unter Ausführungslogs.

Syntax: event.log(value)

Eingabeparameter: Jede Variable oder Funktion, die im Skript verwendet wird.

Beispiel 1: 

function executeScript(event) {
  event.log(event.getParameter("var1"));
  }

Beispiel 2: 

function executeScript(event) {
  event.log("Lorem ipsum");
  }

setParameter

 Legt den Wert einer Integrationsvariable fest oder aktualisiert ihn.

Syntax: event.setParameter("variable_name", "variable_value")

Eingabeparameter: Diese Funktion verwendet die folgenden Argumente:

  • Erstes Argument: Variablenname Wenn variable_name eine automatisch generierte Variable ist, setzen Sie sie in Backticks (``). Beispiel: `responseBody`.
  • Zweites Argument: Wert.

Beispiel: 

function executeScript(event) {
  event.setParameter("`responseBody`", "NewStringValue");
  }

Aufgabenparameter festlegen

Wenn Ihre Integration mehrere große Parameter enthält, die von der JavaScript-Aufgabe nicht verwendet werden, können Sie das Feld TaskParameter für die JavaScript-Aufgabe festlegen, um die Leistung zu verbessern.

Wählen Sie eine der folgenden Optionen aus, um das Feld TaskParameter für die JavaScript-Aufgabe festzulegen:

Console

  1. Rufen Sie die Seite Application Integration auf.

    Zu „Application Integration“

  2. Wählen Sie eine Integration aus. Der Integrationseditor wird geöffnet.
  3. Klicken Sie auf  Vorgang > Integration herunterladen > Integrationsversion. Die Integrationsversion wird als JSON-Datei heruntergeladen.
  4. Öffnen Sie die Datei der Integrationsversion in einem Editor und gehen Sie dann so vor:
    1. Suchen Sie das Feld taskConfigs mit der Aufgabe JavaScriptTask. Suchen Sie im Feld parameters nach dem Parameter mit dem Namen script. 
      "taskConfigs": [{
  "task": "JavaScriptTask",
  "taskId": 1,
  "parameters": {
    "script": {
      "key": "script",
      "value": {
        "stringValue": "function that is called during the JavaScriptTask execution"
      }
  }"
}]
    2. Fügen Sie in diesem parameters-Feld Parameter hinzu, die im JavaScriptTask-Feld verwendet werden. Verwenden Sie dazu die folgende Vorlage: 
      "ParamName": {
  "key": "ParamName",
  "value": {
    "stringValue": "$ParamName$"
  }
}
  5. Speichern Sie die Änderungen, die Sie an der Datei der Integrationsversion vorgenommen haben.
  6. Laden Sie die Datei der Integrationsversion in die Integration hoch.

API

  1. Um die Integrationsversion herunterzuladen, rufen Sie die Methode projects.locations.integrations.versions.download auf und setzen Sie filFormat auf JSON.
  2. Öffnen Sie die Datei der Integrationsversion in einem Editor und gehen Sie dann so vor:
    1. Suchen Sie das Feld taskConfigs mit der Aufgabe JavaScriptTask. Suchen Sie im Feld parameters nach dem Parameter mit dem Namen script. 
      "taskConfigs": [{
  "task": "JavaScriptTask",
  "taskId": 1,
  "parameters": {
    "script": {
      "key": "script",
      "value": {
        "stringValue": "function that is called during the JavaScriptTask execution"
      }
  }"
}]
    2. Fügen Sie in diesem parameters-Feld Parameter hinzu, die im JavaScriptTask-Feld verwendet werden. Verwenden Sie dazu die folgende Vorlage: 
      "ParamName": {
  "key": "ParamName",
  "value": {
    "stringValue": "$ParamName$"
  }
}
  3. Rufen Sie zum Hochladen der Integrationsversion die Methode projects.locations.integrations.versions.upload mit der aktualisierten Integrationsversionsdatei auf.

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

Weitere Informationen zu allen Kontingenten und Limits finden Sie unter Kontingente und Limits.

Nächste Schritte