Aller au contenu principal

Department Select

Department Select sélectionne un ou plusieurs départements dans l’annuaire d’organisation. Le champ appartient à l’état, à la validation et au périmètre de soumission du formulaire.

1. Cas d’utilisation​

Usages courants :

  • Département propriétaire
  • Organisation responsable
  • Traitement limité à un département

2. Ajouter et configurer​

  1. Ajoutez Department Select dans la zone Fields d’une Form Section.
  2. Définissez un Field Key / Name stable et unique, identique à la propriété du DTO backend.
  3. Configurez les propriétés ci-dessous, puis Required, Help Text, Full row ou les conditions selon le besoin.
  4. Vérifiez la valeur initiale et la mise en page dans Design Preview, puis testez le parcours avec Validate / Submit.

3. Propriétés principales​

PropriétéRôle
Display NameContrôle l’affichage du champ dans Design Preview et Runtime.
MultipleActive ou désactive ce comportement.
RequiredActive ou désactive ce comportement.
Help TextContrôle l’affichage du champ dans Design Preview et Runtime.
Visible WhenDéfinit la forme des données de liaison, de soumission ou de réponse.

Les propriétés communes Field Key, Required, Help Text, Full row et Visible When proviennent du contrat de champ Form. Le tableau met en avant les réglages propres à Department Select.

4. Valeur du formulaire et contrat backend​

Valeur soumise : Une valeur stable en mode simple, ou un tableau de valeurs en mode multiple.

"dept-product"

["dept-product", "dept-sales"]

L’exemple montre uniquement la forme des données. L’API doit toujours valider le type, les limites et les autorisations du DTO métier.

5. Validation, conditions et interactions​

Tous les champs peuvent utiliser Required, Visible When, Disabled When, Required When, Dependencies et Clear When Hidden. Ces conditions améliorent l’interface mais ne remplacent jamais la validation ni les autorisations du backend.

Capacités du composant : La valeur appartient à l’état du Form ; seuls les événements visibles dans le panneau sont utilisables.

6. Recommandations​

Conseils : Soumettez des ID stables ; les noms servent uniquement à l’affichage. Le backend doit revérifier le tenant et les autorisations.

Revenez à la présentation de Form pour la mise en page, la validation, la soumission, les brouillons et le protocole backend.

Dernière mise à jour le