Attribuer une fonction de traitement

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é. L'action va permettre au choix d’attribuer un rôle particulier à la fonction, d'ajouter un nouveau rôle à la fonction en plus du ou des rôle(s) existant(s) ou de retirer un rôle à la fonction. Il est également possible de vider la fonction de tous les rôles préalablement liés.

Plutôt que d'indiquer un rôle donné, il est possible de « construire » dynamiquement le rôle qui sera associé à la fonction. Pour cela il faut sélectionner « Autre : » dans la liste déroulante et indiquer la variable, ou le gabarit, qui contient le slug (i.e. identifiant court), l’UUID ou le nom du rôle auquel la fonction doit être associée, par exemple {{ form_var_role_calcule }}. Le gabarit peut renvoyer plusieurs slugs (uniquement slugs, pas plusieurs UUID ou plusieurs libellés).

Attention, le nom de la variable doit correspondre très exactement au libellé du rôle visé (majuscules, espaces, tirets, accents...), si le libellé est utilisé.

Cas d'usage

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.

Liaison simple

La liaison simple est à utiliser lorsque l'on souhaite lier la fonction à un rôle donné.

Plutôt que d'indiquer un rôle donné, il est possible de « construire » dynamiquement le rôle qui sera associé à la fonction. Pour cela il faut sélectionner « Autre : » dans la liste déroulante et indiquer la variable qui contient le nom, le slug ou l’UUID du rôle auquel la fonction doit être associé, par exemple {{ form_var_role_calcule }}.

Attention, le nom de la variable doit correspondre très exactement au libellé du rôle visé (majuscules, espaces, tirets, accents...).

Liaison multiple

La liaison multiple est à utiliser lorsque 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 }}, je vais indiquer en dessous les rôles correspondant aux différentes valeurs de {{ form_var_type }}.

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 }}).

Édition

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

Choisir dans la liste déroulante la fonction à attribuer
Choisir manuel
1. Sélectionner le rôle qui va désormais être attribué à la fonction concernée
Choisir automatique
1. Indiquez le nom de la variable sur base de laquelle le rôle sera sélectionné
2. Indiquez pour chaque valeur de la variable quel est le rôle qui sera attribué à la fonction (exemple : si la variable form_var_type_probleme prend la valeur voirie, alors la fonction destinataire prend le rôle « voirie »)

Utilisation d'un gabarit django

Dans le cas d'action « multiple », il est possible d'utiliser un gabarit Django dans le champ « Variable ».

Documentation en ligne