Weitere Informationen finden Sie unter Unterstützte Connectors für Application Integration.

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.

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

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 Create Integration (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 Dienstkontodetails einer Integration jederzeit in der Symbolleiste der Verknüpfung im Bereich Integrationsübersicht ändern oder aktualisieren.
      Hinweis:Die Option zur Auswahl eines Dienstkontos wird nur angezeigt, wenn Sie die Integration Governance für die ausgewählte Region aktiviert haben.
   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 eine Liste der verfügbaren Aufgaben und Verbindungen 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.
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.
   Warnung: Löschen Sie die Funktion executesScript(event) nicht. Diese Funktion wird aufgerufen, wenn die Aufgabe JavaScript ausgeführt wird.

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

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

Die folgende Abbildung zeigt ein Beispiellayout für den 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), wobei:

• 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 der Anwendungsintegration.

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

Warnung: Löschen Sie die Funktion executesScript(event) nicht. Diese Funktion wird aufgerufen, wenn die Aufgabe JavaScript ausgeführt wird.

JavaScript-Ausführungs-Engine

Die Anwendungsintegration verwendet die JavaScript-Ausführungs-Engine, die auf Rhino 1.7.14 basiert. Diese unterstützt nicht die gesamte ES6-Syntax. Beispielsweise wird die Variablendeklaration mit let nicht unterstützt. Es wird nur die automatische Vervollständigung der ES5-Syntax unterstützt. Eine vollständige Liste der unterstützten ES6-Syntax finden Sie unter Rhino ES2015-Unterstützung.

Auf Integrationsvariablen zugreifen

Auf die in Ihrer Integration definierten Variablen kann über den JavaScript-Editor mit dem In-Memory-event-Objekt 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ührungsprotokolle finden Sie unter Ausführungsprotokolle.	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 die variable_name eine automatisch generierte Variable ist, schließen Sie sie in Graviszeichen (``) ein. 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 (Anwendungsintegration) auf.

   Zu „Application Integration“

2. Wählen Sie eine Integration aus. Der Integrationseditor wird geöffnet.
3. Klicken Sie auf Aktion > Integration herunterladen > Integrationsversion. Die Integrationsversion wird als JSON-Datei heruntergeladen.
4. Öffnen Sie die Datei mit der Integrationsversion in einem Editor und führen Sie dann die folgenden Schritte aus:
   1. Suchen Sie das Feld taskConfigs mit der Aufgabe JavaScriptTask. Suchen Sie im Feld parameters den Parameter 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 das Feld parameters Parameter ein, die im Feld JavaScriptTask verwendet werden. Verwenden Sie dazu die folgende Vorlage:

      "ParamName": {
        "key": "ParamName",
        "value": {
          "stringValue": "$ParamName$"
        }
      }
      

5. Speichern Sie die Änderungen, die Sie an der Integrationsversionsdatei vorgenommen haben.
6. Laden Sie die Datei „Integrationsversion“ in die Integration hoch.

API

1. Rufen Sie zum Herunterladen der Integrationsversion die Methode projects.locations.integrations.versions.download auf und setzen Sie filFormat auf JSON.
2. Öffnen Sie die Datei mit der Integrationsversion in einem Editor und führen Sie dann die folgenden Schritte aus:
   1. Suchen Sie das Feld taskConfigs mit der Aufgabe JavaScriptTask. Suchen Sie im Feld parameters den Parameter 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 das Feld parameters Parameter ein, die im Feld JavaScriptTask verwendet werden. Verwenden Sie dazu die folgende Vorlage:

      "ParamName": {
        "key": "ParamName",
        "value": {
          "stringValue": "$ParamName$"
        }
      }
      

3. Rufe zum Hochladen der Integrationsversion die projects.locations.integrations.versions.upload-Methode 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

• Alle Aufgaben und Trigger.
• Hier erfahren Sie, wie Sie eine Integration testen und veröffentlichen.
• Weitere Informationen zur Fehlerbehandlung.
• Weitere Informationen zu Ausführungslogs der Integration.