Créer une action personnalisée pour générer un tableau de chaînes à partir d’une liste d’enregistrements

Générez un tableau de chaînes à partir d’une liste d’enregistrements de rôles d’utilisateur. Découvrez comment utiliser une étape de script pour itérer dans une liste d’enregistrements.

Avant de commencer

Rôle requis : admin de flow_designer

Pourquoi et quand exécuter cette tâche

Utilisez cet exemple pour voir des démonstrations de ces opérations et étapes.

• Créez une entrée d’action pour un enregistrement de rôle.
• Recherchez un maximum de trois enregistrements de rôle d’utilisateur qui ont l’entrée d’action du rôle.
• Configurez une étape de script pour traiter une liste d’enregistrements de rôles d’utilisateur.
• Créez une variable d’entrée de script contenant la liste des enregistrements de rôles d’utilisateur.
• Écrivez un script qui crée un tableau d’utilisateurs vide.
• Écrivez un script qui itère à travers la liste des enregistrements de rôles d’utilisateur.
• Écrivez un script qui remplit le tableau des utilisateurs avec la valeur du champ utilisateur actuel.
• Créez des variables de sortie de script pour le tableau des utilisateurs et la chaîne d’utilisateur enfant.
• Sortez le tableau de chaînes des utilisateurs générés sous forme de pastille de données.
• Testez l’action avec trois exemples d’utilisateurs.

Procédure

1. Facultatif : Créez une application pour stocker votre travail.
   Vous pouvez l’utiliser App Engine Studio pour planifier, créer et déployer des applications. Pour plus d’informations sur la création d’une application personnalisée, reportez-vous à la section Building apps in App Engine Studio.
   Par exemple, créez une application appelée Mon application.
2. Accédez à la Tout > Automatisation des processus > Studio de workflow.
3. Sur la page d’accueil, sélectionnez Actions.
4. Sélectionner Nouvelle > Action
   Le système affiche la boîte de dialogue Propriétés de l’action.
5. Entrez ces exemples de valeurs.

   Champ	Valeur
   Nom	Créer des utilisateurs avec un tableau de chaînes de rôles
   Demande	Global
   Accessible depuis	Tous les périmètres de l'application

   Remarque :

   Si vous avez créé une application pour stocker et déployer votre action personnalisée, utilisez cette application au lieu de globale.
6. Sélectionnez l’action de version.
   Le système affiche l’interface Studio de workflow .
7. Dans le Plan d’action, sélectionnez Entrées > Créer une entrée
   Le système affiche une nouvelle entrée d’action.
8. Configurez l’entrée d’action avec ces valeurs.

   

   Champ	Valeur
   Étiquette	Rôle
   Type	Rôle.Référence [Reference.sys_user_role]
   Obligatoire	Vrai

9. Dans le Plan d’action, sélectionnez Ajouter une nouvelle étape.
   Le système affiche une liste des étapes disponibles.
10. Sélectionner Rechercher des enregistrements
11. Configurez l’étape avec ces valeurs.

    

    Champ	Valeur
    Table	Rôle d'utilisateur [sys_user_has_role]
    Conditions	[Rôle][est][action->rôle] Remarque : Sélectionnez la pastille de données de rôle dans les variables d’entrée.
    Trier par	Rôle
    Type de tri	a à z
    Nombre maximal de résultats	3

    Remarque :

    Cet exemple limite le paramètre Nombre maximal de résultats à trois enregistrements uniquement à des fins de démonstration.
12. Dans le Plan d’action, sélectionnez Ajouter une nouvelle étape.
    Le système affiche une liste des étapes disponibles.
13. Sélectionnez Script.
14. Dans la section Variables d’entrée, sélectionnez Créer une variable.
15. Configurez la variable d’entrée avec ces valeurs.

    

    Champ	Valeur
    Nom	userRoleRecords
    Valeur	[step->Rechercher des enregistrements step->enregistrements du rôle d’utilisateur] Remarque : Sélectionnez la pastille de données d’enregistrements de rôle d’utilisateur à partir de l’étape Rechercher des enregistrements.

    Remarque :

    Vous pouvez sélectionner la pastille de données des enregistrements de rôle d’utilisateur à partir du panneau de données ou du bouton Sélecteur de pastilles de données.
16. Pour Script, saisissez le texte suivant.

    (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. Dans Variables de sortie, sélectionnez Créer une variable.
18. Configurez la variable de sortie avec ces valeurs.

    

    Étiquette	Nom	Type	Obligatoire
    utilisateurs	utilisateurs	Array.String	Vrai

19. Développez la chaîne Array.String des utilisateurs et renommez la chaîne enfant en utilisateur.
20. Configurez l’élément enfant avec ces valeurs.

    Étiquette	Nom	Type	Obligatoire
    utilisateur	utilisateur	Chaîne	Faux

21. Dans le Plan d’action, sélectionnez Sorties > Créer une sortie.
22. Configurez la sortie de l’action avec ces valeurs.

    

    Étiquette	Nom	Type	Obligatoire
    utilisateurs	utilisateurs	Array.String	Vrai

23. Développez la chaîne Array.String des utilisateurs et renommez la chaîne enfant en utilisateur.
24. Configurez l’élément enfant avec ces valeurs.

    Étiquette	Nom	Type	Obligatoire
    utilisateur	utilisateur	Chaîne	Faux

25. Sélectionnez Quitter le mode d’édition.
    Le système affiche les champs de sortie que vous avez créés.
26. Pour les utilisateurs, sélectionnez [step->Script step->users].

    

    Remarque :

    Vous pouvez sélectionner la pastille de données des utilisateurs de l’étape Script à partir du panneau de données ou du bouton Sélecteur de pastilles de données.
27. Cliquez sur Enregistrer.
28. Sélectionnez Test.
    Le système affiche la boîte de dialogue Action de test.
29. Entrez la valeur de test suivante :

    

    Entrée	Valeur
    Rôle	administrateur

30. Sélectionnez Exécuter le test.
    Le système exécute l’action avec les valeurs de test fournies.
31. Sélectionnez L’exécution de votre test terminée. Affichez les détails d’exécution de l’action.
    Le système affiche les détails d’exécution de l’action.
32. Examinez la valeur d’exécution de l’action Données de sortie.

    

    Le système affiche les données de sortie au format JSON.
    Pour cet exemple, le tableau des utilisateurs contient trois utilisateurs qui ont le rôle administrateur.

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

Résultats

Vous disposez d’une action personnalisée qui recherche les utilisateurs disposant d’un rôle donné et convertit ces utilisateurs en un tableau de chaînes de noms d’utilisateur.

Que faire ensuite

Personnalisez cette action pour utiliser votre propre logique.