Utiliser les variables

Variable basique : la variable de formulaire

Si j'attribue l'identifiant « telephone » à un champ de formulaire, je pourrai récupérer la valeur de ce champ dans la variable « form_var_telephone ». Les noms de variables sont soumis à des règles, ils peuvent contenir des chiffres ou des lettres, mais pas de caractères spéciaux à l'exception du caractère underscore (on remplace généralement les espaces par le caractère underscore : "_").

Une fois que l'on a attribué un identifiant à un champ, son nom de variable apparaît entre doubles accolades dans le listing des champs, à côté de son libellé et de son type : {{form_var_telephone}}

Différents types de variables

Mais outre ces variables liées à des champs de formulaire, il existe beaucoup d'autres types de variables utilisables :

• les variables concernant le workflow,
• les variables concernant le formulaire,
• les variables concernant l'usager,
• les variables concernant le canal de saisie,
• les variables système,
• les variables de session.

Ces variables sont utilisables dans un modèle de courriel, dans un modèle de document, dans l'affichage d'un message ou dans la définition d'une logique de traitement d'un formulaire (workflow).

Lors du traitement, le mail, le message ou le document généré contiendra la valeur de la variable. Si par exemple, j'écris dans mon modèle d'envoi de mail  « Bonjour {{form_var_prenom}} », l'email envoyé à un usager, ayant saisi Arnold dans le champ prénom, contiendra « Bonjour Arnold ».

Variables concernant le workflow

Comme dans les formulaires, on peut définir un certain nombre de variables dans les workflows. Il est conseillé de lire au préalable les explications concernant le paramétrage avancé des workflows pour bien comprendre l'utilisation des variables.

Variables concernant le formulaire

Variables concernant l'usager (le demandeur)

Les données contiennent aussi des informations sur l'utilisateur ayant complété le formulaire. Et en particulier les informations de son profil (le nom des variables du profil est paramétrable, nous affichons ici le nom par défaut).

Si un champ utilisateur personnalisé dispose d'un identifiant, alors la valeur de ce champ est accessible sous la forme form_user_var_variableduchamp, par exemple form_user_var_prenom.

Variables sur le canal de saisie

Les données contiennent aussi des informations sur le contexte de saisie de la demande. Elles sont utilisables uniquement après que la demande a été saisie, dans le workflow donc.

query_string_allowed_vars = departement,une_autre_variable