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

Generieren Sie ein Array von Objekten aus einer Liste von Anwenderdatensä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 Abteilungsdatensatz.
• Suchen Sie nach maximal drei Anwenderdatensätzen für die Aktionseingabe „Abteilung“.
• Konfigurieren Sie einen Skriptschritt, um eine Liste von Anwenderdatensätzen zu verarbeiten.
• Erstellen Sie eine Skripteingabevariable, die die Liste der Anwenderdatensätze enthält.
• Schreiben Sie ein Skript, das ein leeres Kontakte-Array erstellt.
• Schreiben Sie ein Skript, das durch die Liste der Anwenderdatensätze iteriert.
• Schreiben Sie ein Skript, das ein Kontaktobjekt erstellt und Anwenderdatensatzfeldwerte dem Kontaktobjekt zuordnet.
• Schreiben Sie ein Skript, das das Kontakte-Array mit dem aktuellen Kontaktobjekt ausfüllt.
• Erstellen Sie Skriptausgabevariablen für das Kontakte-Array und das untergeordnete Kontaktobjekt.
• Speichern Sie das Kontaktobjekt als Vorlage.
• Geben Sie das generierte Kontakt-Array von Objekten als Datenpille aus.
• Testen Sie die Aktion mit einer Beispielabteilung.

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 Ein Kontakt-Array Von Objekten
   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.

   

   Feld	Wert
   Bezeichnung	Abteilung
   Typ	Referenz.Abteilung [Reference.cmn_Department]
   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.

    

    Feld	Wert
    Tabelle	Benutzer [sys_user]
    Bedingungen	[Abteilung][ist][Aktion->Abteilung] Hinweis: Wählen Sie die Abteilungsdatenpille aus den Eingabevariablen aus.
    Reihenfolge nach	Name
    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.

    

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

    Hinweis:

    Sie können auswählen Anwenderdatensä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 contactsArray = [];
      var i = 0;
      //Iterate through the list of User records
      while(inputs.userRecords.next()) {
        //Create an empty object for each iteration
        var contactObject = {};
        //Query User records to assign object values
        contactObject.first_name = inputs.userRecords.getValue('first_name');
        contactObject.last_name = inputs.userRecords.getValue('last_name');
        contactObject.email_address = inputs.userRecords.getValue('email');
        //Add current object to array
        contactsArray[i] = contactObject;
        i += 1;
      }
      outputs.contacts = contactsArray;
    })(inputs, outputs);

17. Wählen Sie unter Ausgabevariablen die Option aus Variable Erstellen .
18. Konfigurieren Sie die Ausgabevariable mit diesen Werten.

    

    Bezeichnung	Name	Typ	Obligatorisch
    Kontakte	Kontakte	Array.Object	True

19. Erweitern Sie „Kontakte Array.Object“, und benennen Sie das untergeordnete Objekt in um Kontakt .
20. Wählen Sie in der Zeile für das Kontaktobjekt aus Untergeordnetes Element Hinzufügen Symbol .
21. Konfigurieren Sie das untergeordnete Element mit diesen Werten.

    Bezeichnung	Name	Typ	Obligatorisch
    Vorname	first_name	Zeichenfolge	True

22. Wählen Sie in der Zeile für das Kontaktobjekt aus Untergeordnetes Element Hinzufügen Symbol .
23. Konfigurieren Sie das untergeordnete Element mit diesen Werten.

    Bezeichnung	Name	Typ	Obligatorisch
    Nachname	last_name	Zeichenfolge	True

24. Wählen Sie in der Zeile für das Kontaktobjekt aus Untergeordnetes Element Hinzufügen Symbol .
25. Konfigurieren Sie das untergeordnete Element mit diesen Werten.

    Bezeichnung	Name	Typ	Obligatorisch
    E-Mail-Adresse	email_address	Zeichenfolge	Wahr

26. Wählen Sie in der Zeile für das Kontaktobjekt aus Schalten Sie Erweiterte Eingaben Ein/Aus .
27. Wählen Sie in den erweiterten Optionen die Option aus Als Vorlage Speichern .
    Das System zeigt das Dialogfeld als Vorlage speichern an.
28. Für Geben Sie einen Namen ein , Eingabetaste Kontakt .
    
29. Klicken Sie auf Speichern.
30. Wählen Sie in der Aktionsgliederung die Option aus Ausgaben > Ausgabe erstellenan.
31. Konfigurieren Sie die Aktionsausgabe mit diesen Werten.

    

    Bezeichnung	Name	Typ	Obligatorisch
    Kontakte	Kontakte	Array.Object	True

32. Erweitern Sie die Kontakte Array.Object.
33. Wählen Sie in der Zeile für das Kontaktobjekt aus Schalten Sie Erweiterte Eingaben Ein/Aus .
34. Wählen Sie in den erweiterten Optionen die Option aus Struktur > Aus Vorlage startenan.
    Das System zeigt an Vorlage .
35. Für Vorlage , Wählen Sie die zuvor gespeicherte Vorlage aus.
    Wählen Sie beispielsweise aus Global: Kontakt .
36. Wählen Sie Aus Bearbeitungsmodus Beenden .
    Das System zeigt die von Ihnen erstellten Ausgabefelder an.
37. Für Kontakte , Wählen Sie aus [Schritt->Skriptschritt->Kontakte] .

    

    Hinweis:

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

    

    Eingabe	Wert
    Abteilung	Entwicklung

41. Wählen Sie Test ausführen.
    Das System führt die Aktion mit den angegebenen Testwerten aus.
42. 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.
43. Überprüfen Sie den Laufzeitwert für die Aktionsausgabedaten.

    

    Obwohl die Ausführungsdetails die Ausgabedaten als JSON-formatierte Zeichenfolge anzeigen, ist der tatsächliche Ausgabedatentyp ein Array von Objekten. Wenn Sie eine Zeichenfolgenversion Ihrer Ausgabe benötigen, können Sie das Objekt mithilfe der JSON-Klasse in eine Zeichenfolge konvertieren. Weitere Informationen zum Konvertieren eines JSON-Objekts in eine Zeichenfolge finden Sie unter Scoped JSON - stringify(Object jsonObject).
    In diesem Beispiel enthält das Kontaktobjekt ein Array von Kontaktobjekten mit Vorname, Nachname und E-Mail-Informationen für drei Anwender in der Entwicklungsabteilung.

    {
        "contacts": 
            "contact": [
                {
                    "email_address": "[e-mail]",
                    "first_name": "Allyson",
                    "last_name": "Gillispie"
                },
                {
                    "email_address": "[e-mail]",
                    "first_name": "Alva",
                    "last_name": "Pennigton"
                },
                {
                    "email_address": "[e-mail]",
                    "first_name": "Andrew",
                    "last_name": "Och"
                }
            ]
        }
    }
    

Ergebnisse

Sie haben eine anwenderdefinierte Aktion, die die Anwender für eine bestimmte Abteilung sucht und diese Anwender in ein Array von Kontaktobjekten konvertiert.

Nächste Maßnahme

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