wcs/help/fr/misc-substvars.page

<page xmlns="http://projectmallard.org/1.0/"
      type="topic" id="misc-substvars" xml:lang="fr">

<info>
  <link type="seealso" xref="misc-ezt" />
  <revision docversion="0.1" date="2013-07-06" status="draft"/>
  <credit type="author">
    <name>Frédéric Péters</name>
    <email>fpeters@entrouvert.com</email>
  </credit>

</info>

<title>Variables de substitution</title>

<p>
<app>w.c.s.</app> dispose d'un système générique appelé « variables de
substittions » qui permet de faire référence à des données internes,
provenant du système, d'un formulaire, d'un champ, etc.
</p>

<p>
Ce système est particulièrement utile dans le paramétrage du contenu d'un
courriel ou dans la définition d'une logique de traitement d'un formulaire,
mais est également accessible depuis le thème, pour le préremplissage de
champs, etc.
</p>

<section id="system-variables">
  <title>Variables système</title>

  <p>
  Ces variables sont accessibles à tout endroit du site.
  </p>

  <table shade="rows">
    <tr>
      <td><p><code>site_name</code></p></td>
      <td><p>Le titre du site</p></td>
    </tr>
    <tr>
      <td><p><code>site_theme</code></p></td>
      <td><p>L'identifiant du thème en cours</p></td>
    </tr>
    <tr>
      <td><p><code>site_url</code></p></td>
      <td><p>L'adresse du site</p></td>
    </tr>
    <tr>
      <td><p><code>site_url_backoffice</code></p></td>
      <td><p>L'adresse vers le backoffice du site</p></td>
    </tr>
    <tr>
      <td><p><code>site_lang</code></p></td>
      <td><p>Le code de la langue utilisée par le site</p></td>
    </tr>
    <tr>
      <td><p><code>today</code></p></td>
      <td><p>La date du jour</p></td>
    </tr>
    <tr>
      <td><p><code>now</code></p></td>
      <td><p>La date et l'heure du jour</p></td>
    </tr>
    <tr>
      <td><p><code>session_user_display_name</code></p></td>
      <td><p>Le nom de l'utilisateur connecté</p></td>
    </tr>
    <tr>
      <td><p><code>session_user_email</code></p></td>
      <td><p>L'adresse électronique de l'utilisateur connecté</p></td>
    </tr>
  </table>

  <p>
  À l'intérieur d'une catégorie, les variables suivantes sont également
  définies :
  </p>

  <table shade="rows">
    <tr>
      <td><p><code>category_name</code></p></td>
      <td><p>L'intitulé de la catégorie</p></td>
    </tr>
    <tr>
      <td><p><code>category_description</code></p></td>
      <td><p>La description de la catégorie</p></td>
    </tr>
    <tr>
      <td><p><code>category_id</code></p></td>
      <td><p>L'identifiant de la catégorie</p></td>
    </tr>
  </table>

  <note><p>
  Des variables supplémentaires peuvent également être définies par
  l'administrateur système, via des variables d'environnement ou la
  configuration de l'instance de w.c.s.
  </p></note>

</section>

<section id="form-variables">
  <title>Variables de formulaire</title>

  <section id="general-info">
    <title>Informations générales</title>

    <table shade="rows">
    <tr>
      <td><p><code>form_receipt_date</code></p></td>
      <td><p>La date de réception du formulaire</p></td>
    </tr>
    <tr>
      <td><p><code>form_receipt_time</code></p></td>
      <td><p>La date et l'heure de réception du formulaire</p></td>
    </tr>
    <tr>
      <td><p><code>form_number</code></p></td>
      <td><p>Le numéro attribué au formulaire</p></td>
    </tr>
    <tr>
      <td><p><code>form_url</code></p></td>
      <td><p>L'adresse vers la vue du formulaire</p></td>
    </tr>
    <tr>
      <td><p><code>form_url_backoffice</code></p></td>
      <td><p>L'adresse vers le formulaire dans le backoffice</p></td>
    </tr>
    </table>
  </section>

  <section id="user-info">
    <title>Informations sur l'utilisateur (demandeur)</title>

    <p>
    Les données contiennent aussi des informations sur l'utilisateur ayant
    complété le formulaire.
    </p>

    <table shade="rows">
    <tr>
      <td><p><code>form_user_display_name</code></p></td>
      <td><p>Le nom de l'utilisateur</p></td>
    </tr>
    <tr>
      <td><p><code>form_user_email</code></p></td>
      <td><p>L'adresse électronique de l'utilisateur</p></td>
    </tr>
    <tr>
      <td><p><code>form_user_name_identifier_<var>n</var></code></p></td>
      <td><p>Identifiant SAML de l'utilisateur (NameID), pour le fournisseur
      d'identités numéro n (n commençant à 0)</p></td> </tr>
    </table>

    <p>
    Si un champ utilisateur personnalisé dispose d'un nom de variable, alors
    il est accessible sous la forme <code>form_user_var_<var>variable du
    champ</var></code>, par exemple <code>form_user_var_prenom</code>.
    </p>

  </section>

  <section id="form-data">
    <title>Données du formulaire</title>

    <table shade="rows">
    <tr>
      <td><p><code>form_details</code></p></td>
      <td><p>L'ensemble des champs et de leur valeurs</p></td>
    </tr>
    </table>

    <p>
    Il est également possible au moment de la définition d'un champ, de lui
    affecter un nom de variable, cela rendra la valeur associée à ce champ
    accessible via une variable de la forme <code>form_var_<var>variable du
    champ</var></code> (par exemple : <code>form_var_courriel</code>).
    </p>

  </section>

  <section id="workflow-data">
    <title>Statut et données relatives au traitement</title>

    <table shade="rows">
    <tr>
      <td><p><code>form_status</code></p></td>
      <td><p>Le statut actuel du formulaire</p></td>
    </tr>
    <tr>
      <td><p><code>form_previous_status</code></p></td>
      <td><p>Le statut précédent du formulaire</p></td>
    </tr>
    <tr>
      <td><p><code>form_status_changed</code></p></td>
      <td><p>Un booléen précisant que le formulaire vient de changer de statut</p></td>
    </tr>
    <tr>
      <td><p><code>form_evolution</code></p></td>
      <td><p>L'ensemble de l'historique du traitement</p></td>
    </tr>
    <tr>
      <td><p><code>form_role_receiver_name</code></p></td>
      <td><p>Le nom du rôle en charge du traitement</p></td>
    </tr>
    <tr>
      <td><p><code>form_role_receiver_emails</code></p></td>
      <td><p>Les adresses électroniques associées au rôle en charge du traitement</p></td>
    </tr>
  </table>
  </section>

</section>

</page>