Gestion des lecteurs supplémentaires

Présentation générale

Cet outil permet aux utilisateurs finaux d’indiquer des lecteurs supplémentaires sur les documents de processus. Il permet également d’ajouter des droits supplémentaires (pas seulement le droit de lecture) par code en modifiant les champs de type “annuaire” (groupe, utilisateur, organisation).

Information

Cette fonctionnalité s’applique uniquement sur un groupe de processus déclaré comme confidentiel dans le Studio. Dans l’exemple ci-dessous, les lecteurs supplémentaires sont indiqués via 2 champs : 1 champ Listes de personnes et 1 champ Listes de groupes.

Description rapide	Confidentialité	Observation
1. Tous les utilisateurs voient tous les documents	Désactivée	Disponible en standard, fonctionnement par défaut de VDoc
2. Les utilisateurs ne voient que les documents sur lesquels ils interviennent ou sont intervenus	Activée	Disponible en standard, mode à activer volontairement
3. Cas ci-dessus + par les lecteurs supplémentaires indiqués dans le document	Activée	Disponible via vdoc.kit

Note : Le cas « l’application est confidentielle et le document, lui, n’est pas confidentiel » doit être traité comme un sous-cas de 3, en indiquant comme lecteur supplémentaire un groupe contenant tous les utilisateurs de l’annuaire.

Configuration

Activer la confidentialité

Allez dans le Studio > Propriétés du groupe de processus > Tâches administratives et activez la confidentialité.

Paramètres de configuration

La configuration suivante est à renseigner dans le Studio > Propriétés du groupe de processus > onglet Paramètres.

Exemple de configuration à remplacer selon votre processus :

Attribut et Exemple de valeur	Description
vdoc.kit.behaviors.document.permissions.DocumentQualite.permission.levels=10	Niveau de permission à donner aux lecteurs supplémentaires désignés par l’utilisateur
vdoc.kit.behaviors.document.permissions.DocumentQualite.buttons.addPermissions.label=LG_KIT_ADD_PERMISSION_BUTTON_TITLE	Libellé du bouton “Lecteurs supplémentaires”
vdoc.kit.behaviors.document.permissions.DocumentQualite.buttons.addAfter.name=history	Emplacement du bouton “Lecteurs supplémentaires”
vdoc.kit.behaviors.document.permissions.DocumentQualite.fields.enableReaders.name=ActiverLesLecteursSupplementaires	Active ou désactive la gestion de la sécurité sur les lecteurs supplémentaires
vdoc.kit.behaviors.document.permissions.DocumentQualite.fields.users.name=LecteursSupplementairesPersonnes	Champ utilisateurs multiples
vdoc.kit.behaviors.document.permissions.DocumentQualite.fields.groups.name=LecteursSupplementairesGroupes	Champ groupes multiples
vdoc.kit.behaviors.document.permissions.DocumentQualite.methods.event.name=onbeforesubmit;onbeforesave	Événements où la sécurité est appliquée

Exemple de configuration

#add document permissions
vdoc.kit.behaviors.document.permissions.DocumentQualite.permission.levels=10
vdoc.kit.behaviors.document.permissions.DocumentQualite.buttons.addAfter.name=history
vdoc.kit.behaviors.document.permissions.DocumentQualite.buttons.addPermissions.label=LG_KIT_ADD_PERMISSION_BUTTON_TITLE
vdoc.kit.behaviors.document.permissions.DocumentQualite.fields.forcePermission.value=false
vdoc.kit.behaviors.document.permissions.DocumentQualite.fields.enableReaders.name=ActiverLesLecteursSupplementaires
vdoc.kit.behaviors.document.permissions.DocumentQualite.fields.users.name=LecteursSupplementairesPersonnes
vdoc.kit.behaviors.document.permissions.DocumentQualite.fields.groups.name=LecteursSupplementairesGroupes

Paramétrage du formulaire “Lecteurs supplémentaires”

Concevoir le sous-formulaire

Le formulaire doit contenir un fragment nommé “tmp_display_readers_fragment”. Ce fragment regroupe l’ensemble des champs de gestion des permissions.

Script à mettre dans le bouton “Afficher la liste des lecteurs additionnels” :

Packages.com.vdoc.kit.utils.PermissionsUtils.showDocumentPermissions(workflowInstance);

Utiliser le sous-formulaire

2 cas :

Si les lecteurs doivent être définis à toutes les étapes, ajoutez le sous-formulaire au formulaire général.
Si les lecteurs doivent être définis à certaines étapes, ajoutez le sous-formulaire dans les formulaires d’étapes souhaitées.

Utilisation

Exemple d’affichage du formulaire des lecteurs :

Liste des lecteurs supplémentaires :

Qui peut modifier les lecteurs ?

Lorsque le document est en cours : les intervenants courants ou les profils “Managers”.
Lorsque le document est terminé : l’utilisateur sysadmin.

Droits sur les documents de sous-processus

Le mécanisme de lecteurs supplémentaires de vdoc.kit n’a aucun impact sur les droits de lecture sur les documents de sous-processus.

Cas particulier : retrait de la confidentialité

En cas de changement de confidentialité au niveau du groupe de processus, les documents repassent aux droits par défaut. Les champs lecteurs supplémentaires restent renseignés mais sans effet.

Remarque

[Interne Visiativ - Capitalisation] cette fonctionnalité kit a été déployée chez un client en s’appuyant sur des groupes et une table de réservoir de données : voir https://wiki.myvdoc.net/xwiki/bin/view/ProfessionalServices/PiloterDroitLectureSelonDU (cette article n’est disponible que pour les personnes internes à Visiativ)