5.4 Contrôle de vue
Les contrôles de vue permettent de spécifier des représentations alternatives pour un document. L'utilisateur pourra choisir parmi ces représentations, en fonction de ses droits, ou alors le contrôle de vue peut déterminer dynamiquement la vue en fonction des droits de l'utilisateur.
Chaque modalité de représentation est appelée une vue.
Chaque vue est composées de :
- un identifiant système (obligatoire)
- une chaîne alphanumérique, qui doit être unique au sein du contrôle de vue. Elle permet de désigner la vue de manière non ambiguë.
- un libellé (obligatoire)
- une chaîne permettant de désigner la vue à l'utilisateur. Traduisible, elle sera notamment utilisée dans les menus.
- un type (obligatoire)
- consultation ou édition, détermine pour quelle type de représentation la-dite vue est utilisable.
- une zone (sous la forme
APP:ZONE:OPTIONS:TRANSFORMATION) - permet d'indiquer un template de représentation. se reporter à vues de documents pour plus de précisions.
- un masque
- permet de spécifier un masque à appliquer lors de l'utilisation de cette vue
- un numéro d'ordre
- entier utilisé pour le choix automatique, il permet d'indiquer un ordre de préférence pour les vues.
- un caractère affichable
-
indique si la vue doit être présentée à l'utilisateur sous forme de menu (pour lui permettre de choisir cette représentation), ou ne sera accessible que par programmation.
Si la vue est affichable, alors elle sera présentée au moyen de son libellé.
Si la vue affichable est la vue d'édition par défaut, celle-ci est affichée à la place du menu "Modifier" avec le nom de la vue. Elle n'est pas affichée ailleurs même si le paramètre "menu" est défini.
- un nom de menu
- si la vue est affichable, indique le libellé du menu sous lequel doit être présentée la vue
5.4.1 Profilage du contrôle de vue
Il est possible d'appliquer un profil à un contrôle de vue. Ce profile détermine alors pour chaque vue qui a le droit d'y accéder.
Le profil en question peut être statique, mais également dynamique.
5.4.2 Choix automatique de la vue
La vue à utiliser peut être explicitement spécifiée au moyen du paramètre d'url
vid=[VIEW_ID] où [VIEW_ID] est l'identifiant système de la vue à
utiliser. Dynacase va alors vérifier que l'utilisateur a bien accès à la vue
spécifiée. Dans le cas contraire, un message d'erreur est retourné. Si le
paramètre vid référence une vue non existante, ou lorsqu'aucune vue n'est
spécifiée, la vue est automatiquement choisie selon le mécanisme suivant :
-
Restriction à la liste des vues pour lesquelles
- le type (consultation/édition) correspond à l'action courante,
- l'utilisateur est autorisé à y accéder ,
- l'ordre est strictement positif (≥ 1).
Classement des vues restantes par numéro d'ordre croissant.
Utilisation de la première des vues restantes (n° d'ordre le plus petit ≥ 1). Si aucune des vues n'est utilisable, c'est la vue par défaut qui est utilisée.
Exemple : Soit le contrôle de vue suivant
| Identifiant de la vue | Label | Type | Ordre de sélection | Affichable | Droit User #1 | Droit User #2 |
|---|---|---|---|---|---|---|
| VUE1 | Vue n°1 | Consultation | 0 | Oui | X | X |
| VUE2 | Vue n°2 | Consultation | 10 | Non | X | |
| VUE3 | Vue n°3 | Consultation | 30 | Non | X | |
| VUE4 | Vue n°4 | Consultation | 20 | Oui | X | |
| VUE5 | Vue n°5 | Édition | 0 | Oui | X | |
| VUE6 | Vue n°6 | Édition | 10 | Non | X | |
| VUE7 | Vue n°7 | Édition | Non | X | X | |
| VUE8 | Vue n°8 | Édition | 20 | Oui | X |
Soit l'url : ?app=FDL&action=OPENDOC&mode=view&id=1234
Pour l'utilisateur n°1 :
- Vue utilisée : VUE3
- Vue de modification proposée dans le menu "Modifier" : Défaut (aucune vue d'édition n'est sélectionnable automatiquement)
- Vue proposée sur le menu : VUE1, VUE5, VUE7
Pour l'utilisateur n°2 :
- Vue utilisée : VUE2
- Vue de modification proposée dans le menu "Modifier" : VUE6
- Vues proposées sur le menu : VUE1, VUE4, VUE8
5.4.3 Libellé du menu modifier
Lors de la consultation, le libellé du menu modifier correspondra au libellé de la vue de modification choisie selon l'algorithme précédent.
5.4.4 Astuces
Les ordres ne sont pas obligés de se suivre. Aussi, vous pouvez numéroter vos vues de 10 en 10, afin de faciliter l'ajout futur d'une nouvelle vue.
Il est recommandé de restreindre la visibilité des attributs sur la famille, et d'élargir ces visibilités au moyen des contrôles de vue et des masques associés. Ainsi, il devient aisé d'avoir une vue d'administration, utilisant un masque dédié, et ayant le plus faible ordre, et les autres vues restreintes, sans masque et avec un ordre supérieur.