JavaScript-Aufgabe

Mitteilung: Application Integration ist jetzt für Ihr Google Cloud-Projekt verfügbar. Sie können jetzt Apigee Integration und Application Integration im selben Google Cloud-Projekt verwenden. Weitere Informationen

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. Wählen Sie in der Apigee-Benutzeroberfläche Ihre Apigee-Organisation aus.
2. Klicken Sie auf Entwickeln > Integrationen.
3. Wählen Sie eine vorhandene Integration aus oder erstellen Sie eine neue Integration, indem Sie auf Integration erstellen klicken.

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

   1. Geben Sie im Dialogfeld Integration erstellen einen Namen und eine Beschreibung ein.
   2. Wählen Sie eine Region für die Integration aus der Liste der unterstützten Regionen aus.
   3. Klicken Sie auf Erstellen.

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

4. Klicken Sie in der Navigationsleiste Integrationsdesigner auf + Aufgabe/Trigger hinzufügen > Aufgaben, 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.
   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ührungslogs finden Sie unter Ausführungslogs.

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() ist die Funktion, die aufgerufen wird, wenn Apigee Integration die JavaScript-Aufgabe während der Ausführung einer Integration ausführt.
• event ist das In-Memory-Objekt von Apigee Integration.

  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.

Die von Apigee Integration verwendete JavaScript-Ausführungs-Engine basiert auf Rhino 1.7.14, das nicht alle ES6-Syntaxen unterstützt. Es wird nur die automatische Vervollständigung der ES5-Syntax unterstützt. Informationen zu der unterstützten ES6-Syntax finden Sie unter Rhino ES2015-Support.

Auf Integrationsvariablen zugreifen

Auf Variablen, die in Ihrer Integration definiert sind, kann über den JavaScript-Editor mit dem In-Memory-Ereignis von Apigee 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("value") Eingabeparameter: Name der Integrationsvariable. 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(value, value) Eingabeparameter: Diese Funktion verwendet die folgenden Argumente: Erstes Argument: Variablenname Zweites Argument: Wert. Beispiel: function executeScript(event) { event.setParameter("var1", "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.