Erstellen Sie eine Datenerfassungsaktion für eine dynamische Auswahl

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 2 Minuten Lesedauer
  • 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

    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 entsprechenden Anwendungsbereich aus, und wählen Sie dann Absendenaus.
    4. Klicken Sie in der Aktionsgliederung unter Eingaben auf das Symbol zum Hinzufügen eines neuen Schritts (Symbol zum Hinzufügen eines neuen Schritts ), 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.
    5. Wählen Sie in der Aktionsgliederung unter dem REST-Schritt das Symbol „ NeuenSchritt hinzufügen“ (Symbol „Neuen Schritt hinzufügen“ ) und dann den Schritt Skript aus.
      1. Wählen Sie unter Eingabevariablen die Option Variable erstellenaus.
        Diese Eingabevariable speichert den REST-Antworttext.
        Geben Sie beispielsweise für die Eingabevariable Name payloadein.
      2. Wählen Sie für die Eingabevariable Wert die Datenpille für die Antworttextausgabe des REST-Schritts aus.
      3. 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 eine Bezeichnung und eine Namenseigenschaft haben, 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.
      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 Typ der Skriptausgabevariablen 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 fest, und benennen Sie Ausgabe.
      3. Legen Sie den Ausgabetyp auf JSON fest.
        Hinweis:
        Die Aktion kann mehrere Ausgaben haben, aber es kann nur eine vom Typ JSON geben.
      4. Wählen Sie Bearbeitungsmodus beenden.
      5. Wählen Sie neben dem Feld Wert die Datenpillenauswahl ( Datenpillenauswahl) und dann die Ausgabevariable des Skriptschritts aus, die Sie erstellt haben, um Auswahllistenoptionen zu speichern.
    7. Klicken Sie auf Speichern, und testen Sie die Aktion.
      Der Laufzeitwert für die Ausgabe muss ein JSON-Objekt mit einer Dateneigenschaft und einem Array von Auswahllistenoptionen sein.
      Beispielausgabe der Testaktion
    8. Wählen Sie Veröffentlichen aus, um die Aktion für andere Flows und Aktionen innerhalb desselben Anwendungsbereichs verfügbar zu machen.

    Ergebnisse

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