---
sourceDocument: Xanadu-Build-Workflows
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/xanadu/build-workflows

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu-Build-Workflows

ft:clusterId :

    - crworkflow

bundleId :

    - crworkflow

workflow :

    - Creator


---

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

# Erstellen Sie eine anwenderdefinierte Aktion, um ein Array von Zeichenfolgen aus einer Liste von Datensätzen zu generieren {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 Minuten Lesedauer

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.
{#create-custom-action-array-strings__ul_c5v_rdw_lhb}

## 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](https://www.servicenow.com/docs/access?context=aes-app-creation&version=xanadu&pubname=xanadu-application-development&ft:locale=en-US).  
   Erstellen Sie beispielsweise eine Anwendung mit der Bezeichnung <kbd class="ph userinput">My Application</kbd>(Meine Anwendung).
2. Navigieren zu AlleProzessautomatisierungWorkflow-Studio.
3. Wählen Sie auf der Homepage Aktionen.
4. Auswahlvorgang NeuAktion  
   Das System zeigt das Dialogfeld Aktionseigenschaften an.
5. Geben Sie diese Beispielwerte ein.  
   {#create-custom-action-array-strings__table_tjt_xxp_lhb__entry__2}

   | Feld | Wert |
   |-|-|
   | Name | Erstellen Sie Anwender mit Rollen-Array aus Zeichenfolgen |
   | Anwendung | Global |
   | Zugänglich von | Alle Anwendungsbereiche |
   [ ]

   {#create-custom-action-array-strings__table_tjt_xxp_lhb}  
   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 EingabenEingabe erstellen  
   Das System zeigt eine neue Aktionseingabe an.
8. Konfigurieren Sie die Aktionseingabe mit diesen Werten.  
   {#create-custom-action-array-strings__table_ijj_myp_lhb__entry__2}

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

   {#create-custom-action-array-strings__table_ijj_myp_lhb}
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.  
    {#create-custom-action-array-strings__table_cvp_l5p_lhb__entry__2}

    | 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 |
    [ ]

    {#create-custom-action-array-strings__table_cvp_l5p_lhb}  
    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.  
    {#create-custom-action-array-strings__table_uby_5zp_lhb__entry__2}

    | 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. |
    [ ]

    {#create-custom-action-array-strings__table_uby_5zp_lhb}  
    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.  
    {#create-custom-action-array-strings__table_e3w_hbq_lhb__entry__4}

    | Bezeichnung | Name | Typ | Obligatorisch |
    |-|-|-|-|
    | users | users | Array.Zeichenfolge | True |
    [ ]

    {#create-custom-action-array-strings__table_e3w_hbq_lhb}
19. Erweitern Sie den Anwender Array.String, und benennen Sie die untergeordnete Zeichenfolge in <kbd class="ph userinput">Anwender</kbd>um.
20. Konfigurieren Sie das untergeordnete Element mit diesen Werten.  
    {#create-custom-action-array-strings__table_d3v_sbq_lhb__entry__4}

    | Bezeichnung | Name | Typ | Obligatorisch |
    |-|-|-|-|
    | Anwender | Anwender | Zeichenfolge | Falsch |
    [ ]

    {#create-custom-action-array-strings__table_d3v_sbq_lhb}
21. Wählen Sie in der Aktionsgliederung die Option aus AusgabenAusgabe erstellen.
22. Konfigurieren Sie die Aktionsausgabe mit diesen Werten.  
    {#create-custom-action-array-strings__table_ojs_pcq_lhb__entry__4}

    | Bezeichnung | Name | Typ | Obligatorisch |
    |-|-|-|-|
    | users | users | Array.Zeichenfolge | True |
    [ ]

    {#create-custom-action-array-strings__table_ojs_pcq_lhb}
23. Erweitern Sie den Anwender Array.String, und benennen Sie die untergeordnete Zeichenfolge in <kbd class="ph userinput">Anwender</kbd>um.
24. Konfigurieren Sie das untergeordnete Element mit diesen Werten.  
    {#create-custom-action-array-strings__table_qcx_t1t_rbc__entry__4}

    | Bezeichnung | Name | Typ | Obligatorisch |
    |-|-|-|-|
    | Anwender | Anwender | Zeichenfolge | Falsch |
    [ ]

    {#create-custom-action-array-strings__table_qcx_t1t_rbc}
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:  
    {#create-custom-action-array-strings__table_onv_z22_mhb__entry__2}

    | Eingabe | Wert |
    |-|-|
    | Rolle | Administrator |
    [ ]

    {#create-custom-action-array-strings__table_onv_z22_mhb}
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.