Groupe de cases à cocher

Vue d'ensemble

Le composant Avonni Checkbox Group permet aux utilisateurs de sélectionner une ou plusieurs options dans une liste, ce qui le rend idéal pour une utilisation dans des formulaires, des filtres ou des sélections de préférences au sein des composants dynamiques Salesforce. Il prend en charge diverses sources de données pour remplir dynamiquement les options à partir de Salesforce.

Dans le Dynamic Components Builder, le composant Checkbox Group est appelé "Input Choice Set" lorsque vous travaillez avec ses attributs (par exemple, pour des liaisons comme $Component.InputChoiceSet.Value).

Principales fonctionnalités

• Sources de données flexibles : Se connecter à des listes manuelles, des variables, des requêtes ou des picklists pour peupler les options.

• Modes de sélection : Sélection unique ou multiple avec valeurs liées.

• Personnalisation : Variantes, types (par ex. boutons, bascules), orientations et dispositions pour s'adapter à l'interface utilisateur.

• Contrôles d'interactivité : États requis, en lecture seule ou désactivés.

Astuce : Utilisez pour des scénarios à choix multiple ; pour des bascules simples, considérez le composant Avonni Toggle.

Cas d'utilisation

• Filtrer des enregistrements dans les Data Tables (par ex. sélectionner plusieurs phases pour les Opportunities).

• Capturer les préférences des utilisateurs (par ex. sujets de newsletter).

• Sélections multiples dans les formulaires (par ex. centres d'intérêt dans les formulaires de leads).

• Requêtes dynamiques (par ex. choisir des catégories de produits à partir d'une picklist).

• Indicateurs d'état (par ex. boutons ressemblant à des bascules pour des listes de contrôle de tâches).

Configuration

Sélectionnez le Checkbox Group sur la zone de conception pour accéder aux propriétés dans le panneau des propriétés à droite.

Propriétés de base

Celles-ci gèrent l'identification, l'étiquetage et l'approvisionnement en données.

Propriété	Type	Description	Exemple
Nom API	Texte	Identifiant unique pour l'instance.	StageFilter
Étiquette	Texte	Étiquette principale du groupe.	"Sélectionnez les phases :"
Texte d'aide du champ	Texte (Optionnel)	Conseils supplémentaires à côté de l'étiquette.	"Choisissez une ou plusieurs options."
Source de données	Sélectionner	Source des options : manuel (liste statique), variable (depuis la ressource Variable), requête (requête Salesforce), picklist (depuis un champ d'objet).	picklist (par ex. Opportunity StageName).

Fonctionnalité principale et liaison de données

Ceci définit les sélections et les liaisons.

Propriété	Type/Condition	Description
Est sélection multiple	Booléen (basculer)	Activé : permet plusieurs sélections (utilise Value Collection) ; Désactivé : sélection unique (utilise Value).
Valeur	Texte	Lié à la valeur sélectionnée (par ex. Variable ou Formule).
Collection de valeurs	Texte (Actif si sélection multiple)	Lié au tableau des valeurs sélectionnées (par ex. Variable de collection).

Apparence et formatage

Ces paramètres contrôlent le style visuel et la mise en page.

Propriété	Type/Condition	Description	Options/Exemples
Variante	Sélectionner	Positionnement de l'étiquette : standard (au-dessus), label-hidden, label-inline (à côté), label-stacked.	standard.
Type	Sélectionner	Style d'affichage : par défaut (cases à cocher), bouton (groupe de boutons), bascule (interrupteurs).	bouton pour un aspect moderne.
Orientation	Sélectionner	Disposition : verticale (empilée), horizontale (côte à côte).	horizontale.
Mise en page	Paramètres (Actifs si horizontal)	Sous-options : Plusieurs lignes (basculer pour le retour à la ligne), Nombre de colonnes (par ex. 2-12, selon la taille du conteneur).	Plusieurs lignes : Activé, Colonnes : 3.
Position de la case	Sélectionner	Placement de la case à cocher/bascule : gauche ou droite de l'étiquette.	gauche.

Conseil

Pour les dispositions horizontales, définissez les colonnes en fonction de la largeur du conteneur pour un design réactif.

Propriétés de comportement

Celles-ci gèrent l'interaction utilisateur.

Propriété	Type	Description
Requis	Booléen	Exige au moins une sélection ; utiliser avec la validation.
Lecture seule	Booléen	Affiche les sélections mais empêche les modifications.
Désactivé	Booléen	Désactive toutes les interactions.

Exemples

Exemple 1 : Filtre de phase à sélection unique

Cet exemple crée un groupe de cases à cocher en sélection unique pour les phases d'Opportunity, lié à une picklist.

1

Configurer les propriétés

• Étiquette: "Sélectionner la phase"

• Source de données: picklist (Opportunity > StageName)

• Est sélection multiple: Désactivé

• Variante: standard

• Type: bouton

• Orientation: vertical

2

Intégrer avec une Data Table pour un filtrage dynamique

Connectez le Checkbox Group à une Avonni Data Table. Cela filtre les enregistrements Opportunity en fonction de la/les phase(s) sélectionnée(s), n'affichant que les données correspondantes. La requête de la table récupère les données depuis Salesforce et répond aux sélections de l'utilisateur.

1. Ajouter le composant Data Table : Faites glisser le "Data Table" depuis la bibliothèque de composants sur la zone de conception, sous le Checkbox Group.

2. Configurer la source de données de la requête : Dans le panneau des propriétés de la Data Table :

   • Définir la source de données en mode "Query".

   • Choisir l'objet : "Opportunity".

   • Ajouter un filtre réactif : StageName equals {!selectedStage} (lier à la Value ou à la Value Collection du Checkbox Group ; pour la sélection multiple, utiliser l'opérateur "in" et la collection).

3. Ajouter des colonnes : Sélectionner les champs Opportunity à afficher (par ex. Name, Amount, Close Date).

Résultat : Les utilisateurs sélectionnent une phase, mettant à jour la variable pour le filtrage.

---

Exemple 2 : Contrôler la visibilité d'autres composants

Combinez le Checkbox Group avec la "Définir la visibilité du composant" fonctionnalité pour afficher/masquer d'autres composants dynamiquement en fonction des sélections de l'utilisateur. Ceci est utile pour des interfaces conditionnelles, comme révéler un tableau Kanban uniquement lorsque des filtres spécifiques sont sélectionnés.

1

Configurer le Checkbox Group

• Nom API : statusFilter

• Étiquette : "Sélectionner le statut"

• Source de données : manuel (options : "Actif", "Inactif", "En attente")

• Est sélection multiple : Désactivé (pour sélection unique ; ajuster pour multiple)

• Valeur : Lier à {!selectedStatus} (créer une Variable Texte)

• Variante : standard

• Type : par défaut

• Orientation : verticale

2

Ajouter le composant cible (par ex. Kanban)

Faites glisser un composant Kanban sur la zone de conception

3

Définir la règle de visibilité sur le Kanban

• Sélectionnez le Kanban.

• Dans Panneau des propriétés > Définir la visibilité des composants, ajoutez une condition de visibilité comme Input Choice Set value égal à un nom spécifique.

Résultat : Le Kanban n'apparaît que lorsque "Toutes les divisions" est sélectionné (ou contient la valeur en sélection multiple), se masquant sinon pour une interface plus propre et contextuelle

Principales considérations

• Correspondance de la source de données : Assurez-vous que les options correspondent au mode sélectionné (par ex. picklist pour des énumérations) ; testez les requêtes pour de grands ensembles de données.

• Réactivité de la mise en page : Pour l'horizontal, ajustez les colonnes selon la taille de l'écran pour éviter le débordement.

• Validation : Combinez Requis avec des flows pour imposer des sélections dans les formulaires.

• Accessibilité : Utilisez des étiquettes descriptives ; les bascules/boutons améliorent la convivialité tactile.

Dépannage des problèmes courants

• Options non chargées : Vérifiez la configuration de la source de données (par ex. permissions de requête, champ picklist).

• Débordement de la mise en page : Si horizontal, activez Plusieurs lignes ou réduisez le nombre de colonnes.

• Désactivé ne fonctionnant pas : Assurez-vous qu'il n'y a pas d'interactions contradictoires ; testez en aperçu.

• Pas de valeurs par défaut : Préremplissez les Variables pour les sélections initiales si nécessaire.

Résumé

Le composant Avonni Checkbox Group offre une sélection d'options polyvalente avec intégration des données Salesforce et styles personnalisables. Il est idéal pour les filtres et les formulaires dans des interfaces dynamiques. Pour les composants connexes, voir Avonni Picklist ou le Guide des sources de données