Erstellen Sie eine anwenderdefinierte Aktion, um ein Array von Zeichenfolgen aus einer Liste von Datensätzen zu generieren

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 4 Minuten Lesedauer
  • Generieren Sie ein Array von Zeichenfolgen aus einer Liste von Anwenderrollendatensätzen. Erfahren Sie, wie Sie einen Skriptschritt verwenden, um durch eine Liste von Datensätzen zu iterieren.

    Vorbereitungen

    Erforderliche Rolle: administrator von Flow_Designer

    Warum und wann dieser Vorgang ausgeführt wird

    Verwenden Sie dieses Beispiel, um Demonstrationen dieser Vorgänge und Schritte anzuzeigen.
    • Erstellen Sie eine Aktionseingabe für einen Rollendatensatz.
    • Suchen Sie nach maximal drei Anwenderrollendatensätzen, die die Eingabe „Rollenaktion“ enthalten.
    • Konfigurieren Sie einen Skriptschritt, um eine Liste von Anwenderrollen-Datensätzen zu verarbeiten.
    • Erstellen Sie eine Skripteingabevariable, die die Liste der Anwenderrollendatensätze enthält.
    • Schreiben Sie ein Skript, das ein leeres Anwender-Array erstellt.
    • Schreiben Sie ein Skript, das durch die Liste der Anwenderrollendatensätze iteriert.
    • Schreiben Sie ein Skript, das das Anwender-Array mit dem aktuellen Anwenderfeldwert ausfüllt.
    • Erstellen Sie Skriptausgabevariablen für das Anwender-Array und die untergeordnete Anwenderzeichenfolge.
    • Geben Sie das generierte Anwender-Array von Zeichenfolgen als Datenpille aus.
    • Testen Sie die Aktion mit drei Beispielanwendern.

    Prozedur

    1. Wahlweise: Erstellen Sie eine Anwendung, um Ihre Arbeit zu speichern.
      Sie können verwenden App Engine Studio Zum Planen, Erstellen und Bereitstellen von Anwendungen. Weitere Informationen zum Erstellen einer anwenderdefinierten Anwendung finden Sie unter Building apps in App Engine Studio.
      Erstellen Sie beispielsweise eine Anwendung namens Meine Anwendung .
    2. Navigieren zu Alle > Prozessautomatisierung > Workflow-Studioan.
    3. Wählen Sie auf der Homepage aus Aktionen .
    4. Auswahlvorgang Neu > Aktion
      Das System zeigt das Dialogfeld „Aktionseigenschaften“ an.
    5. Geben Sie diese Beispielwerte ein.
      Feld Wert
      Name Erstellen Sie Anwender Mit Rollen-Array Von Zeichenfolgen
      Anwendung Global
      Zugänglich von Alle Anwendungsbereiche
      Hinweis:
      Wenn Sie eine Anwendung zum Speichern und Bereitstellen Ihrer anwenderdefinierten Aktion erstellt haben, verwenden Sie diese Anwendung anstelle von global.
    6. Wählen Sie Aus Build-Aktion .
      Das System zeigt an Workflow-Studio Schnittstelle.
    7. Wählen Sie in der Aktionsgliederung die Option aus Eingaben > Eingabe erstellen
      Das System zeigt eine neue Aktionseingabe an.
    8. Konfigurieren Sie die Aktionseingabe mit diesen Werten.

      Erstellen Sie eine Aktionseingabe, die einen Rollendatensatz speichert.

      Feld Wert
      Bezeichnung Rolle
      Typ Reference.role [Reference.sys_user_role]
      Obligatorisch Wahr
    9. Wählen Sie in der Aktionsgliederung die Option aus Fügen Sie einen neuen Schritt hinzu .
      Das System zeigt eine Liste der verfügbaren Schritte an.
    10. Wählen Sie Aus Suchen Sie Nach Datensätzen
    11. Konfigurieren Sie den Schritt mit diesen Werten.

      Konfigurieren Sie die Schrittbedingung „Datensätze suchen“, um die Rolleneingabevariable zu verwenden.

      Feld Wert
      Tabelle Benutzerrolle [sys_user_has_role]
      Bedingungen [Rolle][ist][Aktion->Rolle]
      Hinweis:
      Wählen Sie die Rollendatenpille aus den Eingabevariablen aus.
      Reihenfolge nach Rolle
      Sortiertyp A bis Z
      Max. Ergebnisse 3
      Hinweis:
      Dieses Beispiel begrenzt die Max. Ergebnisse Einstellung auf drei Datensätze nur zu Demonstrationszwecken.
    12. Wählen Sie in der Aktionsgliederung die Option aus Fügen Sie einen neuen Schritt hinzu .
      Das System zeigt eine Liste der verfügbaren Schritte an.
    13. Wählen Sie Aus Skript .
    14. Wählen Sie im Abschnitt Eingabevariablen die Option aus Variable Erstellen .
    15. Konfigurieren Sie die Eingabevariable mit diesen Werten.

      Konfigurieren Sie die Eingabevariable „Skriptschritt“, um die Datenpille „Anwenderrollendatensätze“ aus dem Schritt „Datensätze suchen“ zu verwenden.

      Feld Wert
      Name UserRoleRecords
      Wert [Schritt->Schritt „Datensätze suchen“->Anwenderrollendatensätze]
      Hinweis:
      Wählen Sie im Schritt Datensätze suchen die Datenpille Anwenderrollendatensätze aus.
      Hinweis:
      Sie können auswählen Anwenderrollendatensätze Datenpille aus dem Datenbereich oder über die Schaltfläche „Datenpillenauswahl“.
    16. Für Skript Geben Sie den folgenden Text ein.
      (function execute(inputs, outputs) {
        //Create an empty array
        var usersArray = [];
        var i = 0;
        //Iterate through the list of User Role records
        while(inputs.userRoleRecords.next()) {
          //Query User Role records for user field value
          var user = inputs.userRoleRecords.getDisplayValue('user');
          //Add current user name to array
          usersArray[i] = user;
          i += 1;
        }
        outputs.users = usersArray;
      })(inputs, outputs);
    17. Wählen Sie unter Ausgabevariablen die Option aus Variable Erstellen .
    18. Konfigurieren Sie die Ausgabevariable mit diesen Werten.

      Erstellen Sie ein Array von Zeichenfolgen, die „Anwender“ genannt werden. Erstellen Sie innerhalb des Arrays eine Zeichenfolgenvariable namens Anwender.

      Bezeichnung Name Typ Obligatorisch
      users users Array.Zeichenfolge True
    19. Erweitern Sie Array.String des Anwenders, und benennen Sie die untergeordnete Zeichenfolge in um Anwender .
    20. Konfigurieren Sie das untergeordnete Element mit diesen Werten.
      Bezeichnung Name Typ Obligatorisch
      Anwender Anwender Zeichenfolge Falsch
    21. Wählen Sie in der Aktionsgliederung die Option aus Ausgaben > Ausgabe erstellenan.
    22. Konfigurieren Sie die Aktionsausgabe mit diesen Werten.

      Erstellen Sie eine Aktionsausgabe namens Anwender, um ein Array von Zeichenfolgen zu speichern.

      Bezeichnung Name Typ Obligatorisch
      users users Array.Zeichenfolge True
    23. Erweitern Sie Array.String des Anwenders, und benennen Sie die untergeordnete Zeichenfolge in um Anwender .
    24. Konfigurieren Sie das untergeordnete Element mit diesen Werten.
      Bezeichnung Name Typ Obligatorisch
      Anwender Anwender Zeichenfolge Falsch
    25. Wählen Sie Aus Bearbeitungsmodus Beenden .
      Das System zeigt die von Ihnen erstellten Ausgabefelder an.
    26. Für Anwender , Wählen Sie aus [Schritt->Skriptschritt->Anwender] .

      Konfigurieren Sie die Aktionsausgabevariable so, dass die Anwenderdatenpille aus dem Skriptschritt verwendet wird.

      Hinweis:
      Sie können den Skriptschritt auswählen Anwender Datenpille aus dem Datenbereich oder über die Schaltfläche „Datenpillenauswahl“.
    27. Klicken Sie auf Speichern.
    28. Wählen Sie Aus Testen .
      Das System zeigt das Dialogfeld „Testaktion“ an.
    29. Geben Sie den folgenden Testwert ein:

      Wählen Sie die Administratorrolle aus, um Ihre Aktion zu testen.

      Eingabe Wert
      Rolle Administrator
    30. Wählen Sie Test ausführen.
      Das System führt die Aktion mit den angegebenen Testwerten aus.
    31. Wählen Sie Aus Die Ausführung Ihres Tests wurde abgeschlossen. Zeigen Sie die Aktionsausführungsdetails an.
      Das System zeigt die Ausführungsdetails der Aktion an.
    32. Überprüfen Sie den Laufzeitwert für die Aktionsausgabedaten.

      Seite mit Ausführungsdetails, die drei Anwendernamen im Anwender-Array auflistet.

      Das System zeigt Ausgabedaten im JSON-Format an.
      In diesem Beispiel enthält das Anwender-Array drei Anwender mit der Administratorrolle.
      {
          "users": [
              "System Administrator",
              "Rob Phillips",
              "Fred Luddy"
          ]
      }
      

    Ergebnisse

    Sie haben eine anwenderdefinierte Aktion, die nach Anwendern mit einer bestimmten Rolle sucht und diese Anwender in ein Array von Anwendernamenzeichenfolgen konvertiert.

    Nächste Maßnahme

    Passen Sie diese Aktion an, um Ihre eigene Logik zu verwenden.