Erstellen Sie eine Datensammlungsaktion für eine dynamische Auswahl

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 2 Minuten Lesedauer

    • Erstellen Sie eine Datensammlungsaktion, 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
    Hinweis:
    Dynamische Eingaben sind im Basissystem nicht verfügbar. Um dynamische Eingaben in Workflow-Studiozu verwenden, müssen Sie Fordern Sie eine an IntegrationHub Plugin.

    Prozedur

    1. Navigieren zu Alle > Prozessautomatisierung > Flow Designer.
    2. Auswahlvorgang Neu erstellen: > Aktion.
    3. Geben Sie im Feld Name einen Namen für Ihre Aktion ein, wählen Sie den richtigen Anwendungsbereich aus, und wählen Sie dann Absendenaus.
    4. Wählen Sie in der Aktionsgliederung unter Eingaben das Symbol zum Hinzufügen eines neuen Schritts (Symbol zum Hinzufügen eines neuen Schritts ) und anschließend den REST- Schritt.
      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.
    5. Wählen Sie in der Aktionsgliederung unter dem REST-Schritt das Symbol zum Hinzufügen eines neuen Schritts (Symbol zum Hinzufügen eines neuen Schritts) und anschließend den Schritt Skript.
      1. Wählen Sie unter Eingabevariablen die Option Variable erstellenaus.
        Diese Eingabevariable speichert den REST-Antworttext.
        Geben Sie beispielsweise für den Namen der Eingabevariablen „ payload“ein.
      2. Wählen Sie für die Eingabevariable „Wert“ die Datenpille für die Ausgabe des Antworttexts des REST-Schritts aus.
      3. Geben Sie unter Skript ein Skript ein, um aus der Eingabevariablen eine JSON-Ausgabe zu erstellen.
        Ihr Skript muss diese Aufgaben ausführen.
        Analysieren Sie die Eingabevariable als JSON
        Sie können die JSON - Global API 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 zuordnen zu können. Das Skript muss ein JSON-Objekt für die dynamische Auswahl mit einer Eigenschaft namens „ data“ erstellen. Der Wert der Dateneigenschaft muss ein Array von Auswahllistenoptionen sein. Jede Auswahllistenoption muss eine Bezeichnung und eine Namenseigenschaft haben, die auf Zeichenfolgenwerte festgelegt ist. Die Eigenschaft label bestimmt, wie die Option in der Auswahlliste angezeigt wird. Die Namenseigenschaft bestimmt, wie die Option gespeichert und im System aufgerufen 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 gekürzt.
        Legen Sie das Ausgabeobjekt fest
        Legen Sie das Ausgabeobjekt so fest, dass Ihr JSON-Objekt für die dynamische Auswahl zurückgegeben wird.
      4. Wählen Sie unter Ausgabevariablen die Option Variable erstellenaus.
        Diese Ausgabevariable speichert die Auswahllistenoptionen, die Ihr Skript erstellt.
      5. Wählen Sie als Ausgabevariablentyp JSONaus.
        Der Variablentyp der Skriptausgabe muss JSON sein.
    6. Wählen Sie in der Aktionsgliederung die Option Ausgabenaus
      1. Wählen Sie Ausgabe erstellen aus.
      2. Legen Sie die Ausgabebezeichnung und den Namen der Ausgabe fest.
      3. Legen Sie den Ausgabetyp auf JSON fest.
        Hinweis:
        Die Aktion kann mehrere Ausgaben haben, es darf jedoch nur eine vom Typ JSON vorhanden sein.
      4. Wählen Sie Bearbeitungsmodus beenden aus.
      5. Wählen Sie neben dem Feld Wert die Datenpillenauswahl ( Datenpillenauswahl) und anschließend Skriptschritt-Ausgabevariable aus, die Sie erstellt haben, um Auswahllistenoptionen zu speichern.
    7. Wählen Sie Speichern und testen Sie die Aktion.
      Der Laufzeitwert für die Ausgabe muss ein JSON-Objekt sein, das über eine Dateneigenschaft und ein Array von Auswahllistenoptionen verfügt.
      Beispielausgabe der Testaktion
    8. Wählen Sie Veröffentlichen, um die Aktion für andere Flows und Aktionen innerhalb desselben Anwendungsbereichs verfügbar zu machen.

    Ergebnisse

    Sie können jetzt Ihre Datensammlungsaktion verwenden, um die Optionen auszufüllen, die für eine dynamische Auswahleingabe in einer übergeordneten Aktion angezeigt werden.Verwenden Sie Ihre Datensammlungsaktion, um Optionen für eine dynamische Auswahl auszufüllen.