Commandes avancées pour les listes déroulantes

Les tutoriels de cette page illustrent l’utilisation de listes déroulantes avec le concepteur de formulaires UiPath, dans le cadre de l’activité Créer une tâche de formulaire (Create Form Task) . La propriété la plus utilisée pour obtenir les résultats des tutoriels est FormData(Collection).

Création de listes déroulantes dynamiques

Utilisez-les dans les workflows où vous souhaitez envoyer des données dynamiques pour remplir un contrôle déroulant dans une action de formulaire.

Avec cette méthode, une variable du type Liste de chaînes (List of Strings) contient les valeurs de la liste déroulante au lieu d'ajouter des valeurs statiques dans l'onglet Données (Data ) du Concepteur de formulaires UiPath.

Dans l'exemple suivant, nous créons une liste déroulante dynamique de pays, initialisons une variable avec la liste des pays et créons une variable supplémentaire pour capturer le pays sélectionné par les utilisateurs.

Pour créer une liste déroulante dynamique:

1. Dans l'activité Créer une tâche de formulaire (Create Form Task) , cliquez sur les points de suspension (...) à droite de DonnéesFormulaires.

2. Ajoutez un argument pour la liste déroulante dynamique comme suit :

   • Nom : countryList_dropdown
   • Sens : Entrée
   • Type : liste de chaînes (List<String>)
   • Valeur : appuyez sur Ctrl + K et saisissez listOfCountries comme nom de variable.
     La variable listOfCountries contient les éléments de la liste déroulante.
     Remarque : Un tableau de chaînes est également pris en charge, mais vous devez ajouter manuellement le composant déroulant dans le Concepteur de formulaires et ajouter la valeur Clé de champ .

3. Si vous souhaitez rétablir la sélection de l'utilisateur dans le workflow, ajoutez un autre argument pour capturer la valeur sélectionnée :

   • Nom : country (la clé de champ du composant déroulant)
   • Direction : Entrée/Sortie ou Sortie
   • Type : Chaîne
   • Valeur : appuyez sur Ctrl + K et saisissez selectedCountry comme nom de variable.
4. Cliquez sur OK pour fermer Données de formulaire.
5. Ouvrez le panneau Variables (Variables) et initialisez listOfCountries avec la valeur par défaut new List(of string) from { "India", "Romania", "US" }.
   Conseil : vous pouvez également choisir de remplir listOfCountries via d'autres activités au lieu de l'initialiser.

Création de listes déroulantes en cascade

Utilisez-les dans les formulaires basés sur les tâches lorsque vous souhaitez que la sélection dans une liste déroulante (parent) renseigne les valeurs dans la deuxième liste déroulante (enfant).

Pour créer une liste déroulante en cascade :

1. Dans l'activité Créer une tâche de formulaire (Create Form Task) , cliquez sur les points de suspension (...) à droite de DonnéesFormulaires.

2. Liez la liste déroulante parente au workflow.

   Pour cet exemple, créez un argument qui transmet la variable listOfCountries List<String> au workflow sous forme de liste déroulante.
   Remarque : la variable listOfCountries contient les éléments de la liste déroulante parente, c'est-à-dire la liste des pays.
   1. Nommez l’argument CountryList_dropdown. Le nom de la propriété Clé de champ pour cet argument est CountryList.
   2. Définissez la direction sur In 2.3. Définissez le Type sur System.Collections.Generic.List<System.String>
   3. Définissez la valeur comme variable listOfCountries List<String>.

3. Liez la liste déroulante enfant au workflow.

   Pour cet exemple, créez un argument qui transmet la variable stateDictionaryList Dictionary<String, List<String>> au workflow sous forme de liste déroulante.
   Remarque : la variable stateDictionaryList contient les éléments de la liste déroulante enfant, c'est-à-dire les états de chaque pays.
4. Nommez l’argument stateDictList_dropdown. Le nom de la propriété Clé de champ pour cet argument est stateDictList.
5. Définissez la direction sur Dans 3.3. Définissez le Type sur System.Collections.Generic.Dictionary<System.String, System.Collections.Generic.List<System.String>
6. Définissez la valeur comme variable stateDictionaryList Dictionary<String, List<String>

7. Liez la liste déroulante enfant à la liste déroulante parent.

   Créez un argument avec le nom de la liste déroulante enfant et ajoutez le suffixe _parent . Définissez ensuite la valeur de l'argument sur le nom de la liste déroulante parente, comme ceci : ”ParentDropdownVariableName”.
   Pour cet exemple, créez un argument nommé stateDictList_parent. La liste déroulante enfant est stateDictList et vous y ajoutez le suffixe _parent .

   1. Définissez la Direction sur In ( In).

   2. Définissez le Type sur String.
   3. Définissez la Valeur sur ”CountryList”.
      Lors du remplissage de la variable de dictionnaire stateDictList , notez que la clé du dictionnaire est une valeur de la liste déroulante parente et que sa valeur correspondante est une liste d'options à afficher sur le formulaire si le parent est défini sur la clé.
      Astuce :

      Vous pouvez transmettre les valeurs à pré-remplir (par exemple, avec les champs de pays et d'état) dans la collection FormData .

      Si vous transmettez des valeurs enfants, assurez-vous d'inclure également la valeur parente pour éviter tout comportement inattendu.

8. Mappez chaque valeur de la liste déroulante parente à une variable Liste de chaînes. Vous pouvez remplir la liste (dictionnaire) de la liste déroulante parente de quelque manière que ce soit, mais pour cet exemple, nous utilisons une activité Ajouter au dictionnaire pour chaque valeur.

   • Dictionnaire: la liste déroulante du dictionnaire de l'enfant, stateDictList.
   • Clé: une valeur de la liste de chaînes de la liste déroulante parent, CountryList - dans cet exemple, "US", "India"et "Romania".
   • Valeur: appuyez sur Ctrl + K et saisissez un nom pour la variable Liste de chaînes (List of Strings) qui contient les valeurs à afficher dans la liste déroulante enfant lorsque la valeur Clé est sélectionnée dans le parent - usaStatesList, indianStatesListet romanianCountyList, respectivement.
9. Assurez-vous de placer la ou les activités de l'étape ci-dessus avant l'activité Créer une tâche de formulaire (Create Form Task) .
10. Cliquez sur OK pour fermer Données de formulaire.

11. Ouvrez le panneau Variables (Variables) et initialisez la nouvelle liste de variables List of String que vous avez créée avec les valeurs par défaut suivantes :

    • Pour indianStatesList : new List(of string) from { "Odisha", "Rajasthan", "Karnataka" }
    • Pour usaStatesList : new List(of string) from {"Florida", "Georgia", "Washington"}
    • pour romanianCountyList: new List(of string) from {"Cluj", "Prahova", "Constanta"}.

Téléchargez ces exemples ici.

Création de listes déroulantes en cascade dans les composants Modifier la grille (Edit Grid) et Grille de données (Data Grid)

Pour utiliser des listes déroulantes en cascade dans un composant Modifier la grille ( Edit Grid ) ou Grille de données ( Data Grid ) :

1. Créez les champs déroulants en suivant les étapes ci-dessus (à l'aide de l'assistant FormData ).
2. Ouvrez le Concepteur de formulaires.

3. Si les champs déroulants ne sont pas créés dans votre formulaire, vérifiez que :

   • Les arguments <dropdownKey> , <dropdownKey>_dropdownet <dropdownKey>_parent sont correctement ajoutés dans la collection FormData .

   • La case GenerateInputFields est cochée.

4. Faites glisser et déposez le composant Modifier la grille ( Edit Grid ) ou Grille de données ( Data Grid ).
5. Faites glisser et déposez les listes déroulantes créées à l'étape 1 dans le composant Modifier la grille ( Edit Grid ) ou Grille de données ( Data Grid ).
6. Ouvrez le menu de configuration de l'enfant (cliquez sur ).

7. Dans l'onglet Logic (Logic), notez la logique avancée préconfigurée.

   
   

   

   
   
8. Accédez au champ Actions > Définition de schéma (Schema Definition ).
9. Remplacez [data.<parent_dropdown_key>] par [row.<parent_dropdown_key>] dans l'expression de schéma.
   
   

   

   
   
   Remarque : le mot-clé row indique au formulaire d'utiliser la valeur parente de la ligne de grille.
10. Enregistrez le formulaire.

Définition du nombre de résultats de recherche pour les listes déroulantes

Les listes déroulantes affichent au maximum quatre résultats de recherche par défaut. Vous pouvez modifier cette limite en définissant une propriété dans la conception de formulaire.

Pour définir le nombre de résultats de recherche d'une liste déroulante:

1. Dans le Concepteur de formulaires UiPath, cliquez sur Modifier ( Edit ) pour ouvrir les paramètres de la liste déroulante, puis sélectionnez l'onglet Données (Data) .
2. Sous Options Choices.js, ajoutez { "searchResultLimit" : x }, où x est le nombre maximal de résultats que vous souhaitez afficher.

Affichage de toutes les options dans les listes déroulantes

Si les chaînes du menu déroulant comportent plus de 50 caractères, elles peuvent être omises de l'affichage.

Pour afficher toutes les options correspondant à votre terme de recherche:

1. Cliquez sur Modifier JSON (Edit JSON) pour le composant Liste déroulante (Drop-down List ) que vous souhaitez modifier.

2. Dans le champ Composant JSON , ajoutez les propriétés suivantes :

   ...
     "fuseOptions": {
       "distance": 800,
       },
     "threshold": 1,
     "useExactSearch": false,
   ...

Remarque : la propriété threshold détermine à quel moment l'algorithme arrête l'opération de recherche pour le terme de recherche donné. Par exemple, un threshold sur 0 nécessite une correspondance exacte des lettres et de l'emplacement. Un threshold sur 1 peut correspondre à n’importe quoi, même des fautes d’orthographe. Ajustez la valeur threshold en fonction de votre cas d'utilisation.