Erstellen Sie eine Datenerfassungsaktion für eine dynamische Auswahl
Erstellen Sie eine Datenerfassungsaktion, um eine Liste mit Auswahloptionen für eine dynamische Auswahleingabe zu generieren.
Vorbereitungen
- Erforderliche Rolle: action_designer oder admin
- Erstellen Sie Anmeldeinformationen und Verbindungen für Ihren REST-Endpunkt
Prozedur
- Navigieren zu Alle > Prozessautomatisierung > Flow Designer.
- Auswahlvorgang Neu erstellen > Aktion.
- Geben Sie im Feld Name einen Namen für Ihre Aktion ein, wählen Sie den entsprechenden Anwendungsbereich aus, und wählen Sie dann Absendenaus.
-
Klicken Sie in der Aktionsgliederung unter Eingaben auf das Symbol zum Hinzufügen eines neuen Schritts (Symbol zum
), und wählen Sie den REST- Schritt aus.
Konfigurieren Sie Ihren REST-Schritt, um Daten von der richtigen Basis-URL und dem Ressourcenpfad mit allen zutreffenden Abfrageparametern für die HTTP-Methode GET abzurufen. Weitere Informationen zur Verwendung des REST-Schritts in IntegrationHubfinden Sie unter REST-Schritt und REST in IntegrationHub. -
Wählen Sie in der Aktionsgliederung unter dem REST-Schritt das Symbol „
Schritt hinzufügen“ (Symbol „Neuen Schritt hinzufügen“ ) und dann den Schritt Skript aus.
-
Wählen Sie unter Eingabevariablen die Option Variable erstellenaus.
Diese Eingabevariable speichert den REST-Antworttext.Geben Sie beispielsweise für die Eingabevariable Name payloadein.
- Wählen Sie für die Eingabevariable Wert die Datenpille für die Antworttextausgabe des REST-Schritts aus.
-
Geben Sie unter Skript ein Skript ein, um eine JSON-Ausgabe aus der Eingabevariablen zu erstellen.
Ihr Skript muss diese Aufgaben ausführen.
- Analysieren Sie die Eingabevariable als JSON
- Sie können die API JSON - Global verwenden, um die Eingabevariable von einer Zeichenfolge in ein JSON-Objekt umzuwandeln.
- Erstellen Sie ein neues JSON-Objekt, das für eine dynamische Auswahl formatiert ist
- Sie müssen die Datenstruktur der REST-Antwort kennen, um Antwortwerte Auswahllistenoptionen zuzuordnen. Ihr Skript muss ein dynamisches JSON-Auswahlobjekt mit der Eigenschaft
data erstellen. Der Wert der Dateneigenschaft muss ein Array von Auswahllistenoptionen sein. Jede Auswahllistenoption muss eineBezeichnungund eineNamenseigenschafthaben, die auf Zeichenfolgenwerte festgelegt ist. Die Eigenschaft label bestimmt, wie die Option in der Auswahlliste angezeigt wird. Die Eigenschaft name bestimmt, wie die Option im System gespeichert und referenziert wird.Dieses JSON-Objekt definiert beispielsweise ein Array mit drei Auswahllistenoptionen.
{ data: [ { label: "Choice Option 1", name: "choice_option_1" }, { label: "Choice Option 2", name: "choice_option_2" }, { label: "Choice Option 3", name: "choice_option_3" } ] }Hinweis:Eine dynamische Auswahleingabe kann nur bis zu 5000 Auswahllistenoptionen anzeigen. Ein JSON-Objekt, das mehr als 5.000 Auswahllistenoptionen zurückgibt, wird beim Rendern abgeschnitten. - Legen Sie das Ausgabeobjekt fest
- Legen Sie das Ausgabeobjekt fest, um Ihr JSON-Objekt mit dynamischer Auswahl zurückzugeben.
-
Wählen Sie unter Ausgabevariablen die Option Variable erstellenaus.
Diese Ausgabevariable speichert die Auswahllistenoptionen, die Ihr Skript erstellt.
-
Wählen Sie als Ausgabevariablentyp JSONaus.
Der Typ der Skriptausgabevariablen muss JSON sein.
-
Wählen Sie unter Eingabevariablen die Option Variable erstellenaus.
-
Wählen Sie in der Aktionsgliederung die Option Ausgabenaus
- Wählen Sie Ausgabe erstellen aus.
- Legen Sie die Ausgabebezeichnung fest, und benennen Sie Ausgabe.
-
Legen Sie den Ausgabetyp auf JSON fest.
Hinweis:Die Aktion kann mehrere Ausgaben haben, aber es kann nur eine vom Typ JSON geben.
- Wählen Sie Bearbeitungsmodus beenden.
-
Wählen Sie neben dem Feld Wert die Datenpillenauswahl (
) und dann die Ausgabevariable des Skriptschritts aus, die Sie erstellt haben, um Auswahllistenoptionen zu speichern.
-
Klicken Sie auf Speichern, und testen Sie die Aktion.
Der Laufzeitwert für die
Ausgabemuss ein JSON-Objekt mit einerDateneigenschaftund einem Array von Auswahllistenoptionen sein. - Wählen Sie Veröffentlichen aus, um die Aktion für andere Flows und Aktionen innerhalb desselben Anwendungsbereichs verfügbar zu machen.