Choices

Syntaxe

Paramètres

Description

Cette fonction permet de retourner une table de choix pour un champ de recherche.

Remarques

• La fonction Choices est principalement utilisée pour récupérer les valeurs disponibles d'un champ de type Choix ou Recherche dans Dataverse. Elle permet de dynamiser les interfaces en affichant automatiquement les options définies dans le schéma de données. Cela évite d'avoir à coder manuellement les listes déroulantes et rend les applications plus maintenables.
• Le paramètre column-reference doit pointer vers un champ valide d'une table qui utilise une liste de valeurs prédéfinies, comme un champ à options. Cela permet d'obtenir toutes les valeurs autorisées à être sélectionnées dans ce champ, y compris leurs libellés. Cette référence garantit que les choix affichés sont toujours synchronisés avec la configuration du modèle de données.
• L'ajout du paramètre facultatif text-filter permet de restreindre dynamiquement la liste des choix retournés par la fonction. Cela est utile pour proposer des résultats contextuels ou personnalisés selon ce que l'utilisateur a déjà saisi. On peut ainsi créer des interfaces plus réactives et plus conviviales, en simulant une recherche dans la liste des options.
• Les résultats de Choices sont retournés sous forme de table, ce qui permet de les utiliser dans des galeries, des listes déroulantes ou des filtres. Cette table contient souvent non seulement les valeurs techniques mais aussi les libellés lisibles pour l'utilisateur. Elle peut être combinée avec d'autres fonctions comme Filter, Sort, ou LookUp pour des traitements avancés.
• Lorsque utilisée avec un champ de type relation un-à-plusieurs (lookup), la fonction Choices retourne les enregistrements de la table liée. Cela permet d'afficher une liste dynamique d'entités à sélectionner, par exemple une liste de clients ou de produits. Elle s'adapte au modèle relationnel de Dataverse tout en facilitant la création de formulaires.
• Dans les applications multilingues, les libellés retournés par Choices s'affichent dans la langue configurée pour l'environnement ou l'utilisateur. Cela renforce l'internationalisation sans nécessiter de logique conditionnelle supplémentaire dans l'application. C'est un avantage important pour les organisations internationales ou multi-régionales.
• La fonction Choices permet une séparation claire entre la donnée brute (valeurs techniques) et l'affichage utilisateur (libellés). Cela facilite la gestion des données en backend, tout en conservant une interface utilisateur simple et compréhensible. Elle s'inscrit ainsi parfaitement dans les bonnes pratiques de conception d'interfaces connectées à Dataverse.
• En résumé, Choices est essentielle dans Power Fx pour générer dynamiquement les options disponibles dans un champ de type choix ou relation. Elle améliore l'interaction utilisateur, réduit les erreurs de saisie et garantit la cohérence avec les métadonnées du modèle. Son intégration dans les contrôles comme ComboBox ou Dropdown en fait une fonction centrale pour les formulaires dynamiques.