Liaison fonction/rôle

Généralités

L'action « Liaison fonction/rôle »,  permet de changer, à une étape du workflow, le ou les rôles attribués à une fonction de traitement existante. Par exemple, cela va permettre de changer le destinataire (l'agent en charge du traitement) de la demande.

Cette action correspond à un « dispatch » car elle va permettre de distribuer une demande à des agents différents selon un critère donné.

Cas d'usage

Par exemple, si la réponse d'un usager à une question du formulaire « type de problème constaté » il a répondu « Éclairage », la demande ira au service concerné. S'il a répondu « Trou dans la chaussée », elle partira vers un autre service.

Paramétrage de l'action

Les étapes de paramétrage de l'action « Liaison fonction/rôle » sont les suivantes :

1. Choisir dans la liste déroulante la fonction à attribuer
2. Choisir le mode opératoire : 
   • Positionner le rôle sur cette fonction : Supprimer toutes les affectations précédentes et les remplacer
   • Ajouter le rôle à la fonction : ajouter un ou plusieurs rôle à la fonction
   • Retirer le rôle de la fonction: supprimer un ou plusieurs rôles à la fonction
   • Vider la fonction : supprimer tous les rôles de la fonction (même ceux paramétrés initialement sur le formulaire) ?
3. Choisir l'assignation :
   • Simple : (un seul rôle)
   • Multiple : (plusieurs rôles selon la valeur d'un gabarit ou d'une variable)

Liaison simple

La liaison simple est à utiliser lorsque l'on souhaite lier la fonction à un rôle donné (ou même plusieurs comme l'explique la note ci-dessous).

Il suffit alors de choisir le rôle souhaité dans la liste "Rôle". 

Liaison multiple

La liaison multiple est à utiliser lorsque on souhaite associer la fonction à des rôles différents selon la valeur d'une variable.

En imaginant que le champ « Variable » contienne {{ form_var_type }}, il faut indiquer en dessous les rôles correspondant aux différentes valeurs de {{ form_var_type }}.

Paramétrage avancé

Utilisation d'un gabarit django

Dans le cas d'action « multiple », il convient d'utiliser un gabarit Django dans le champ « variable ». Il peut s'agir d'un champ de formulaire, d'une donnée de traitement, ou d'un filtre de requête sur un modèle de fiche contenant les associations.

Lier la fonction à un utilisateur

L'action va permettre de lier directement un utilisateur à une fonction, cela se fait en paramétrant le rôle sur un gabarit calculé (en choissisant « Autre : » en bas de la liste déroulante des rôles), qui doit pointer l’utilisateur (ex: {{ session_user }}), son identifiant (ex: {{ session_user_nameid }}), voire son adresse électronique (ex: {{ session_user_email }}).