<info> <desc>Les variables disponibles pour personnaliser les mails, le thème et les workflows</desc> </info> Utiliser les variables dans les workflows
Généralités

Les variables sont des éléments permettant d'appeler les détails de la demande ou/et de l'usager afin de personnaliser les messages. Une variable mise dans un modèle de message sera remplacée dans le message reçu par l'utilisateur par son contenu : le nom de la personne, le lien vers sa demande, etc..

Il y a deux grands types de variables, les « variables système », invariables d'un formulaire à l'autre et les « variables spécifiques », propres à un formulaire ou un workflow.

Les variables système disponibles sont de quatre types : les variables liées au formulaire, les variables liées au site, les variables liées au catégories et les variables liées à la session de l'utilisateur en cours.

Les variables disponibles pour chaque type d'action sont rappelées sur l'écran d'édition des actions.

Une bonne utilisation de ces variables permettra de personnaliser les mails ou les templates

Toujours entre crochets

Dans le corps du modèle de message, les variables doivent toujours impérativement être mise entre crochets : `[nom_de_la_variable]`

Utiliser les variables dans les thèmes

Les variables sont également accessibles dans les thèmes et les templates, pour le préremplissage des champs par exemple.

Les variables spécifiques

Variables spécifiques liées aux formulaires des demande

Le contenu de chaque champ d'un formulaire est stocké dans une variable. Pour appeler ces contenus il faut saisir le nom de la variable (toujours entre crochets), sous la forme : `form_var_nom_de_variable_du_champ`

Par exemple pour un formulaire de contact, on obtiendra le contenu du champ téléphone (dont le nom de variable est `telephone`) en mettant dans le modèle de message `[form_var_telephone]`).

Variables spécifiques liés aux formulaires de workflows

Dans le cas des formulaires définis dans les workflows, le contenu de la totalité des champs est stocké dans une variable (un tableau).

Chaque champ du formulaire est ensuite stocké dans une variable. Pour appeler ces contenus il faut donc saisir le nom de la variable du formulaire suivi de celle du champ (toujours entre crochets), sous la forme : `nom_de_variable_du_formulaire_var_nom_de_variable_du_champ`

Par exemple pour un formulaire de contact dont le nom de variable est `contact_interne`, on obtiendra le contenu du champ téléphone (dont le nom de variable est `telephone`) en mettant dans le modèle de message `[contact_interne_var_telephone]`).

Les variables système
Variables système liées au formulaire <list> <item>

`[form_details]` : L'ensemble des données du formulaire

</item> <item>

`[form_name]` : Nom du formulaire

</item> <item>

`[form_number]` : Numéro du formulaire

</item> <item>

`[form_receipt_date]` : Date de réception du formulaire

</item> <item>

`[form_receipt_time]` : Heure de réception du formulaire

</item> <item>

`[form_evolution]` : L'ensemble de l'historique du traitement

</item> <item>

`[form_status]` : Statut actuel du formulaire

</item> <item>

`[form_previous_status]` : Statut précédent du formulaire

</item> <item>

`[form_status_changed]` : Un booléen précisant que le formulaire vient de changer de statut

</item> <item>

`[form_status_url]` : URL du statut du formulaire

</item> <item>

`[form_uri]` : URI du formulaire

</item> <item>

`[form_url]` : URL du formulaire

</item> <item>

`[form_url_backoffice]` : L'adresse du backoffice du formulaire

</item> <item>

`[form_number]` : Le numéro attribué au formulaire

</item> <item>

`[form_user]` : Expéditeur du formulaire

</item> <item>

`[form_user_display_name]` : Nom de l'expéditeur du formulaire

</item> <item>

`[form_user_email]` : Courriel de l'expéditeur du formulaire

</item> <item>

`[form_user_var_adresse]` : Champ de l'expéditeur du formulaire

</item> <item>

`[form_user_var_codepostal]` : Champ de l'expéditeur du formulaire

</item> <item>

`[form_user_var_nom]` : Champ de l'expéditeur du formulaire

</item> <item>

`[form_user_var_prenom]` : Champ de l'expéditeur du formulaire

</item> <item>

`[form_user_var_ville]` : Champ de l'expéditeur du formulaire

</item> </list>

Variables système liées au site <list> <item>

`[site_name]` : Titre du site

</item> <item>

`[site_theme]` : Nom du thème actuel

</item> <item>

`[site_url]` : L'adresse du site

</item> <item>

`[site_url_backoffice]` : L'adresse du backoffice du site

</item> <item>

`[site_lang]` : le code de langue utilisée par le site

</item> <item>

`[today]` : Date actuelle

</item> <item>

`[now]` : Date et heure actuelles

</item> </list>

Variables système liées aux catégories <list> <item>

`[category_name]` : L'intitulé de la catégorie

</item> <item>

`[category_description]` : La description de la catégorie

</item> <item>

`[category_id]` : L'identifiant de la catégorie

</item> </list>
Variables système liées à l'utilisateur <list> <item>

`[session_user]` : Utilisateur connecté

</item> <item>

`[session_user_display_name]` : Nom complet de l'utilisateur connecté

</item> <item>

`[session_user_email]` : Courriel de l'utilisateur connecté

</item> <item>

`[session_user_var_adresse]` : Champ utilisateur connecté : Adresse

</item> <item>

`[session_user_var_codepostal]` : Champ utilisateur connecté : Code postal

</item> <item>

`[session_user_var_nom]` : Champ utilisateur connecté : Nom

</item> <item>

`[session_user_var_prenom]` : Champ utilisateur connecté : Prénom

</item> <item>

`[session_user_var_ville]` : Champ utilisateur connecté : Ville

</item> </list>