Skriptschritt
Fügen Sie benutzerdefiniertes JavaScript hinzu, um es innerhalb einer wiederverwendbaren Aktion auszuführen. Während die meisten zentralen Aktionen und Schritte für gängige Anwendungsfälle geeignet sind, können Sie einen Skriptschritt zum Ausführen von Verhalten erstellen, das von den zentralen Schritten nicht erfüllt wird.
Rollen und Verfügbarkeit
Felder
Der Skriptschritt enthält separate Eingabe- und Ausgabevariablen, mit denen Sie JavaScript-Daten Flow Designer -Daten zuordnen können. Durch die Definition von Ein- und Ausgangsvariablen innerhalb des Schritts können Sie festlegen, welche Flow Designer-Daten in Ihrem Skript zur Verfügung stehen und welche Skriptvariablen für andere Schritte Ihrer Aktion verfügbar sind.
| Feld | Beschreibung |
|---|---|
| Erforderliche Laufzeit | Die zur Unterstützung des Skripts erforderliche Laufzeitumgebung. Zur Auswahl stehen:
Die Laufzeit, die Sie auswählen, bestimmt die JavaScript-Objekte und -Methoden, die in der kontextbezogenen Hilfeangezeigt werden. Hinweis: Dieses Feld ist nur sichtbar, wenn IntegrationHub aktiviert ist. |
| MID-Server mithilfe von auswählen | Geben Sie den zu verwendenden MID Server-Auswahlprozess an. Zur Auswahl stehen:
Hinweis: Dieses Feld ist nur sichtbar, wenn IntegrationHub aktiviert ist und Sie MID aus Erforderliche Laufzeit auswählen. |
| Verbindungsalias | Datensatz des Alias für Verbindungen und Anmeldeinformationen, den das System zum Ausführen des Aktionsschritts verwendet. Benutzer mit der Rolle „flow_designer“ oder „admin“ können einen zugeordneten Verbindungsdatensatz erstellen oder auswählen. Wenn Sie einen Alias verwenden, müssen Sie nicht mehrere Anmeldeinformations- und Verbindungsinformationsprofile konfigurieren, wenn Sie eine Aktion in mehreren Umgebungen verwenden. Ebenso müssen Sie Ihre benutzerdefinierte Aktion nicht aktualisieren, wenn sich die Verbindungsinformationen ändern. Weitere Informationen zu Verbindungen und Anmeldeinformationen finden Sie unter Anmeldeinformationen, Verbindungen und Aliasnamen. Es werden nur Aliasse vom Verbindungstyp Basic unterstützt. Hinweis: Dieses Feld ist nur sichtbar, wenn IntegrationHub aktiviert ist und Sie Verbindungsalias verwenden aus MID-Server auswählen mithilfe von auswählen. |
| Host | Der vollständig qualifizierte Domänenname des MID Servers, auf dem das System den Aktionsschritt ausführt. Zum Beispiel mid-server.domain.com.
Hinweis: Dieses Feld ist nur sichtbar, wenn IntegrationHub aktiviert ist und Sie Inline-Auswahl verwenden aus MID-Server verwenden mithilfe von auswählen. |
| MID-Auswahl | Option zum Auswählen des spezifischen MID-Servers oder MID-Clusters.
|
| MID-Cluster | Datenpille für den MID-Cluster, den Sie verwenden möchten. Dieses Feld ist verfügbar, wenn MID in der Liste Erforderliche Laufzeit ausgewählt ist und Inline-Auswahl verwenden in der Liste MID Server auswählen mit ausgewählt ist. |
| MID-Anwendung | Geben Sie die Anwendung an, die der MID Server unterstützen muss, um ausgewählt zu werden. Das System führt den Aktionsschritt von einem MID-Server aus, der die ausgewählte Anwendung unterstützt. Dieses Feld ist nur sichtbar, wenn IntegrationHub aktiviert ist, MID Server automatisch auswählen in der Liste MID- Auswahl ausgewählt ist und Sie Inline-Auswahl verwenden unter MID Serverauswählen mit auswählen. |
| Fähigkeiten | Fähigkeiten, die MID-Server unterstützen müssen, um für die Auswahl in Frage zu kommen. Das System führt den Aktionsschritt von einem MID-Server aus, der die ausgewählten Fähigkeiten unterstützt. Dieses Feld ist nur sichtbar, wenn IntegrationHub aktiviert ist, MID Server automatisch auswählen in der Liste MID- Auswahl ausgewählt ist und Sie Inline-Auswahl verwenden unter MID Serverauswählen mit auswählen. |
| Spezifischer MID-Server | Datenpille des erforderlichen MID-Server. Dieses Feld ist nur sichtbar, wenn IntegrationHub aktiviert ist, Spezifischer MID Server in der MID-Auswahlliste ausgewählt ist und Sie Inline-Auswahl verwenden unter MID Serverauswählen mit auswählen. |
| Eingabevariablen | Name-Wert-Paare, die Daten aus der Aktion darstellen, sodass Sie Aktionseingaben und Daten aus anderen Schritten innerhalb eines Skripts verwenden können. |
| Skript | Skript, das innerhalb der Aktion ausgeführt wird. Verwenden Sie die globalen Objekte Eingänge und Ausgänge, um auf Eingabe- und Ausgabevariablen in Ihrem Skript zuzugreifen. Zum Beispiel:
inputs.myVariable.Hinweis: Ein- und Ausgabenamen von Skriptschritten dürfen keinen der folgenden reservierten Systemnamen enthalten:
Der Skriptschritt konvertiert Daten, die in den globalen Ein- und Ausgabenobjekten gespeichert sind, immer in Zeichenfolgen. Wenn Ihr Skriptschritt mit JSON-Daten arbeiten muss, können Sie das globale Eingabeobjekt verwenden, um die JSON-Daten in eine Zeichenfolge zu konvertieren. Alternativ können Sie eine JavaScript-Variable als Zeichenfolge und nicht als JavaScript-Objekt definieren. Dieses Skript veranschaulicht beispielsweise zwei Möglichkeiten, wie Sie JSON-Daten ausgeben können.
Standardmäßig führt Flow Designer Skripts für die Instanz aus. Zum Ausführen eines Skripts von einem MID Server ist ein IntegrationHub -Abonnement erforderlich. Flow Designer führt ein Skript in der Domäne aus, in der es ausgelöst oder initiiert wird. Weitere Informationen finden Sie unter Domain Separation und Flow Designer. Informationen zu verfügbaren Klassen und Methoden finden Sie in der kontextbezogenen Hilfe der JavaScript-API oder im API reference. |
| Ausgabevariablen | JavaScript-Ausgabe auf Flow Designer Data-Pills mappen. Definieren Sie Ausgabevariablen, wenn andere Schritte in der Aktion die Skriptausgabe verwenden sollen. |
Felder für Aktionsfehlerauswertung
| Feld | Beschreibung |
|---|---|
| Wenn dieser Schritt fehlschlägt | Option, um mit der Ausführung des nächsten Schritts fortzufahren oder zur Fehlerauswertung zu wechseln. Informationen zur Verwendung des Schrittstatuscodes oder der Meldung für eine Fehlerbedingung für eine benutzerdefinierte Aktion finden Sie unter Aktionsfehlerbewertung. |
Beispiel
In diesem Beispiel wird eine JSON-Nutzlast erstellt, die einfach aktualisiert oder geändert und einem nachfolgenden REST-Schritt hinzugefügt werden kann.
Indem Sie eine Ausgabevariable erstellen, die die Nutzdaten darstellt, können Sie den Data-Pill [Payload] in den REST-Schritt des Felds Text ziehen.