Informationen zu den unterstützten 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.

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

    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ührungslogs.

Die folgende Abbildung zeigt ein Beispiellayout für den JavaScript-Editor: Bild mit JavaScript-Editor Bild 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).

Wobei:

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

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

Die von Application Integration verwendete JavaScript-Ausführungs-Engine basiert auf Rhino 1.7.14, die nicht die gesamte ES6-Syntax unterstützt. Es wird nur die automatische Vervollständigung für die ES5-Syntax unterstützt. Informationen zur unterstützten ES6-Syntax finden Sie unter Rhino ES2015-Support.

Auf Integrationsvariablen zugreifen

In der Integration definierte Variablen können über den JavaScript-Editor über das In-Memory-Ereignis von Application Integration aufgerufen werden.

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

  1. getEventExecutionInfoId
  2. getGoogleCloudProjectId
  3. getIntegrationName
  4. getParameter
  5. getRegion
  6. log
  7. setParameter
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 Graviszeichen (``), z. B. `responseBody`.

Example:

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ührungslogs.

Syntax: event.log(value)

Eingabeparameter:Eine Variable oder Funktion, die im Script 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 Graviszeichen (``), z. B. `responseBody`.
  • Zweites Argument: Wert.

Beispiel:

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

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.