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

Generiert ein Array von Zeichenfolgen aus einer Liste von Anwenderrollendatensätzen. Erfahren Sie, wie Sie mit einem Skriptschritt eine Liste der Datensätze durchlaufen.

Vorbereitungen

Erforderliche Rolle: admin von flow_designer

Warum und wann dieser Vorgang ausgeführt wird

Verwenden Sie dieses Beispiel, um sich Demonstrationen dieser Vorgänge und Schritte anzusehen.

• Erstellen Sie eine Aktionseingabe für einen Rollendatensatz.
• Suchen Sie nach maximal drei Anwenderrollen-Datensätzen, die die Rollenaktionseingabe enthalten.
• Konfigurieren Sie einen Skriptschritt, um eine Liste von Anwenderrollendatensä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 die Liste der Anwenderrollendatensätze durchläuft.
• 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 aus Zeichenfolgen als Datenpille aus.
• Testen Sie die Aktion mit drei Beispielanwendern.

Prozedur

1. Wahlweise: Erstellen Sie eine Anwendung zum Speichern Ihrer Arbeit.
   Mit App Engine Studio können Sie Anwendungen planen, erstellen und bereitstellen. Weitere Informationen zum Erstellen einer anwenderdefinierten Anwendung finden Sie unter Building apps in App Engine Studio.
   Erstellen Sie beispielsweise eine Anwendung mit der Bezeichnung My Application(Meine Anwendung).
2. Navigieren zu Alle > Prozessautomatisierung > Workflow-Studio.
3. Wählen Sie auf der Homepage 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 aus 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 der globalen.
6. Wählen Sie Build-Aktion aus.
   Das System zeigt die Schnittstelle Workflow-Studio an.
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.

   

   Feld	Wert
   Bezeichnung	Rolle
   Typ	Referenz.Rolle [Reference.sys_user_role]
   Obligatorisch	Wahr

9. Wählen Sie in der Aktionsgliederung die Option Neuen Schritt hinzufügenaus.
   Das System zeigt eine Liste der verfügbaren Schritte an.
10. Wählen Sie Datensätze suchen aus
11. Konfigurieren Sie den Schritt mit diesen Werten.

    

    Feld	Wert
    Tabelle	Benutzerrolle [sys_user_has_role]
    Bedingungen	[Rolle][ist][Aktion->Rolle] Hinweis: Wählen Sie die Datenpille Rolle aus den Eingabevariablen aus.
    Anordnen nach	Rolle
    Sortiertyp	A bis Z
    Max. Ergebnisse	3

    Hinweis:

    In diesem Beispiel wird die Einstellung Max. Ergebnisse nur zu Demonstrationszwecken auf drei Datensätze beschränkt.
12. Wählen Sie in der Aktionsgliederung die Option Neuen Schritt hinzufügenaus.
    Das System zeigt eine Liste der verfügbaren Schritte an.
13. Wählen Sie Skript aus.
14. Wählen Sie im Abschnitt Eingabevariablen die Option Variable erstellenaus.
15. Konfigurieren Sie die Eingabevariable mit diesen Werten.

    

    Feld	Wert
    Name	userRoleRecords
    Wert	[Schritt->Datensätze suchen Schritt->Anwenderrollendatensätze] Hinweis: Wählen Sie die Datenpille „Benutzerrollendatensätze“ im Schritt „Datensätze nachschlagen“ aus.

    Hinweis:

    Sie können die Datenpille „Benutzerrollendatensätze “ im Datenbereich oder über die Schaltfläche Datenpillenauswahl auswählen.
16. Geben Sie für Skriptden 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 Variable erstellenaus.
18. Konfigurieren Sie die Ausgabevariable mit diesen Werten.

    

    Bezeichnung	Name	Typ	Obligatorisch
    users	users	Array.Zeichenfolge	True

19. Erweitern Sie den Anwender Array.String, und benennen Sie die untergeordnete Zeichenfolge in Anwenderum.
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 erstellen.
22. Konfigurieren Sie die Aktionsausgabe mit diesen Werten.

    

    Bezeichnung	Name	Typ	Obligatorisch
    users	users	Array.Zeichenfolge	True

23. Erweitern Sie den Anwender Array.String, und benennen Sie die untergeordnete Zeichenfolge in Anwenderum.
24. Konfigurieren Sie das untergeordnete Element mit diesen Werten.

    Bezeichnung	Name	Typ	Obligatorisch
    Anwender	Anwender	Zeichenfolge	Falsch

25. Wählen Sie Bearbeitungsmodus beenden aus.
    Das System zeigt die von Ihnen erstellten Ausgabefelder an.
26. Wählen Sie für Benutzer[step->Script step->users]aus.

    

    Hinweis:

    Sie können die Datenpille Skriptschrittanwender im Datenbereich oder über die Schaltfläche Datenpillenauswahl auswählen.
27. Klicken Sie auf Speichern.
28. Wählen Sie Testaus.
    Das System zeigt das Dialogfeld Testaktion an.
29. Geben Sie den folgenden Testwert ein:

    

    Eingabe	Wert
    Rolle	Administrator

30. Wählen Sie Test ausführen.
    Das System führt die Aktion mit den bereitgestellten Testwerten aus.
31. Wählen Sie aus. Die Ausführung des Tests wurde abgeschlossen. Zeigen Sie die Details der Aktionsausführung an.
    Das System zeigt die Details der Aktionsausführung an.
32. Überprüfen Sie den Laufzeitwert für die Aktion Ausgabedaten.

    

    Das System zeigt Ausgabedaten im JSON-Format an.
    In diesem Beispiel enthält das Array users drei Benutzer mit der Rolle admin.

    {
        "users": [
            "System Administrator",
            "Rob Phillips",
            "Fred Luddy"
        ]
    }
    

Ergebnisse

Sie haben eine anwenderdefinierte Aktion, die nach den Anwendern sucht, die eine bestimmte Rolle aufweisen, und diese Anwender in ein Array von Anwendernamen-Zeichenfolgen umwandelt.

Nächste Maßnahme

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