Données et paramètres récoltés par le formulaire

Paramètres liés à une zone de saisie de texte <input type="text">

Le nom du paramètre est donné par l'élément <nom> placé dans l'élément <input type="text">. Si cet élément n'existe pas, le paramètre n'existera pas.

Paramètre envoyé

Si le paramètre n'existe pas ou si vous utilisez un attribut envoyer="non" sur l'élément <input type="text">, rien ne sera envoyé à l'application distante concernant ce champ. Il en va de même si le champ se trouve dans une section conditionnelle et que la condition n'est pas vérifiée (voir ci-dessous), sauf à utiliser l'attribut envoyer="oui".

La valeur envoyée sera celle présente dans la zone de saisie de texte après que celle-ci ait été formatée (majuscules, minuscules, trim...).

Paramètres dans l'ensemble des paramètres du formulaire

Si le paramètre existe, l'ensemble de paramètres lié au formulaire contiendra les paramètres suivants, où form représente le nom du formulaire et nom le nom du paramètre (ils sont illustrés avec le formulaire donné en exemple):

<input>
  <nom>nom</nom>
  <libellé>votre nom</libellé>
  <valeur>Lampion</valeur>
  <majuscule/>
</input>

Paramètres liés à une zone de saisie de texte multilignes <input type="textarea">

Le nom du paramètre est donné par l'élément <nom> placé dans l'élément <input type="textarea">. Si cet élément n'existe pas, le paramètre n'existera pas.

Paramètre envoyé

Si le paramètre n'existe pas ou si vous utilisez un attribut envoyer="non" sur l'élément <input type="textarea">, rien ne sera envoyé à l'application distante concernant ce champ. Il en va de même si le champ se trouve dans une section conditionnelle et que la condition n'est pas vérifiée (le champ ne sera pas visible dans le formulaire et l'utilisateur ne pourra donc pas y répondre).

La valeur envoyée sera celle présente dans la zone de saisie de texte après que celle-ci ait été formatée (majuscules, minuscules, trim...).

Paramètres dans l'ensemble des paramètres du formulaire

Si le paramètre existe, l'ensemble de paramètres lié au formulaire contiendra les paramètres suivants, où form représente le nom du formulaire et nom le nom du paramètre (ils sont illustrés avec le formulaire donné en exemple. Dans cet exemple, le nom est à remplacer par extract):

{f2:extract}

{f2:extract/format}

<input>
  <nom>extract</nom>
  <libellé>votre extrait</libellé>
  <valeur>
Quand il se fut assis sur sa chaise dans l'ombre
Et qu'on eut sur son front fermé le souterrain,
L'oeil était dans la tombe et regardait Caïn.
  </valeur>
  <majuscule/>
</input>

Paramètres liés à une zone de saisie de texte au format enrichi multilignes <input type="richtext">

Le nom du paramètre est donné par l'élément <nom> placé dans l'élément <input type="richtext">. Si cet élément n'existe pas, le paramètre n'existera pas.

Paramètre envoyé

Si le paramètre n'existe pas ou si vous utilisez un attribut envoyer="non" sur l'élément <input type="richtext">, rien ne sera envoyé à l'application distante concernant ce champ. Il en va de même si le champ se trouve dans une section conditionnelle et que la condition n'est pas vérifiée (le champ ne sera pas visible dans le formulaire et l'utilisateur ne pourra donc pas y répondre).

La valeur envoyée sera celle présente dans la zone de saisie de texte après que celle-ci ait été formatée (majuscules, minuscules, trim...).

Paramètres dans l'ensemble des paramètres du formulaire

Si le paramètre existe, l'ensemble de paramètres lié au formulaire contiendra les paramètres suivants, où form représente le nom du formulaire et nom le nom du paramètre (ils sont illustrés avec le formulaire donné en exemple. Dans cet exemple, le nom est à remplacer par extract):

<input type="richtext">
  <nom>extract</nom>
  <libellé>votre extrait</libellé>
  <valeur>
&lt;i>  
Quand il se fut assis sur sa chaise dans l'ombre
Et qu'on eut sur son front fermé le souterrain,
L'oeil était dans la tombe et regardait Caïn.
&lt;/i>
</valeur>
  <majuscule/>
</input>

Paramètres liés à une liste déroulante <input type="select">

Le nom du paramètre est généralement donné par l'élément <nom> placé dans l'élément <input type="select">. Si c'est le cas, ce paramètre sera associé à chacune des options de la liste déroulante.

Il est également possible d'associer un paramètre différent à une ou plusieurs options, grâce à un attribut nom="..." placé sur les éléments <option> correspondants. Cet attribut aura la priorité sur l'élément <nom> (si les deux sont présents, c'est l'attribut qui sera utilisé pour le nom du paramètre associé a cette option).

Si pour une option, ni l'un ni l'autre existe, l'option ne possèdera pas de paramètre.

Paramètre envoyé, en cas de sélection simple

Si aucune option n'est sélectionnée, aucun paramètre ne sera envoyé à l'application distante concernant ce champ.

Si le paramètre correspondant à l'option sélectionnée n'existe pas ou si vous utilisez un attribut envoyer="non" sur l'élément <input type="select">, rien ne sera envoyé également. Il en va de même si le champ se trouve dans une section conditionnelle et que la condition n'est pas vérifiée (le champ ne sera pas visible dans le formulaire et l'utilisateur ne pourra donc pas y répondre).

La valeur envoyée sera la valeur de l'option, donnée par l'attribut valeur (ou value) de l'élément <option>.

Paramètres dans l'ensemble des paramètres du formulaire, en cas de sélection simple

Si le paramètre existe, l'ensemble de paramètres lié au formulaire contiendra les paramètres suivants, où form représente le nom du formulaire et nom le nom du paramètre (ils sont illustrés avec le formulaire donné en exemple. Dans cet exemple, le nom est à remplacer par choix):

<input type="select">
   <nom>choix</nom>
   <libellé>votre choix</libellé>
   <option valeur="ANC">des anchois</option>
   <option valeur="OLI" cochée="oui">des olives</option>
   <option valeur="CAP">des câpres</option>
   <option valeur="MOZ">de la mozarella</option>
</input>

Paramètres envoyés, en cas de sélections multiples

Si aucune option n'est sélectionnée, aucun paramètre ne sera envoyé à l'application distante concernant ce champ.

Si tous les paramètres correspondants aux options sélectionnées n'existent pas ou si vous utilisez un attribut envoyer="non" sur l'élément <input type="select">, rien ne sera envoyé également. Il en va de même si le champ se trouve dans une section conditionnelle et que la condition n'est pas vérifiée (le champ ne sera pas visible dans le formulaire et l'utilisateur ne pourra donc pas y répondre).

Mode de fonctionnement normal

Pour chaque option sélectionnée qui possède un paramètre, celui-ci sera envoyé avec la valeur de l'option, donnée par l'attribut valeur.

Si plusieurs options sélectionnées sont associées au même paramètre, ce paramètre sera envoyé plusieurs fois, avec la valeur de chacune des options. Il faudra programmer correctement l'application de manière à récupérer l'ensemble de ces valeurs. Dans le cas particulier du langage PHP, il faut utiliser un nom de paramètre qui se termine par "[]". Cela indique au serveur PHP qu'il devra construire une Array (un tableau) avec les paramètres reçus.

Envoyer un seul paramètre avec plusieurs valeurs

Vous pouvez modifier ce mode de fonctionnement normal, en mettant un attribut type="string" sur l'élément <nom> qui définit le nom du paramètre.

Dans ce cas, si plusieurs options sont sélectionnées et que ces options utilisent ce nom de paramètre, le paramètre sera envoyé une seule fois avec comme valeur la liste des valeurs des options sélectionées séparées par le caractère | (exemple OLI|CAP).

Paramètres dans l'ensemble des paramètres du formulaire, en cas de sélections multiples

Si le paramètre existe, l'ensemble de paramètres lié au formulaire contiendra les paramètres suivants, où form représente le nom du formulaire et nom le nom du paramètre (ils sont illustrés avec le formulaire donné en exemple. Dans cet exemple, le nom est à remplacer par choix[]):

<input type="select"  multiple="oui">
   <nom>choix[]</nom>
   <libellé>votre choix</libellé>
   <option valeur="ANC">des anchois</option>
   <option valeur="OLI" cochée="oui">des olives</option>
   <option valeur="CAP" cochée="oui">des câpres</option>
   <option valeur="MOZ">de la mozarella</option>
</input>

Paramètres liés aux boutons radio <input type="radio">

Le nom du paramètre est généralement donné par l'élément <nom> placé dans l'élément <input type="radio">. Si c'est le cas, ce paramètre sera associé à chacune des options des boutons radio.

Il est également possible d'associer un paramètre différent à une ou plusieurs options, grâce à un attribut nom="..." placé sur les éléments <option> correspondants. Cet attribut aura la priorité sur l'élément <nom> (si les deux sont présents, c'est l'attribut qui sera utilisé pour le nom du paramètre associé a cette option).

Si pour une option, ni l'un ni l'autre existe, l'option ne possèdera pas de paramètre.

Paramètre envoyé

Si aucun bouton radio n'est coché, aucun paramètre ne sera envoyé à l'application distante concernant ce champ.

Si le paramètre correspondant à l'option cochée n'existe pas ou si vous utilisez un attribut envoyer="non" sur l'élément <input type="radio">, rien ne sera envoyé également. Il en va de même si le champ se trouve dans une section conditionnelle et que la condition n'est pas vérifiée (le champ ne sera pas visible dans le formulaire et l'utilisateur ne pourra donc pas y répondre).

La valeur envoyée sera la valeur de l'option, donnée par l'attribut valeur (ou value) de l'élément <option>.

Paramètres dans l'ensemble des paramètres du formulaire

Si le paramètre existe, l'ensemble de paramètres lié au formulaire contiendra les paramètres suivants, où form représente le nom du formulaire et nom le nom du paramètre (ils sont illustrés avec le formulaire donné en exemple. Dans cet exemple, le nom est à remplacer par choix):

<input type="radio" cols="1">
   <nom>choix</nom>
   <libellé>votre pizza au choix</libellé>
   <option valeur="FRO">Quatre fromages</option>
   <option valeur="MAR">Margharita</option>
   <option valeur="SAI">Quatre saisons</option>
   <option valeur="BOL" cochée="oui">Bolognaise</option>
</input>

Paramètres liés aux cases à cocher <input type="checkbox">

Le nom du paramètre est généralement donné par l'élément <nom> placé dans l'élément <input type="checkbox">. Si c'est le cas, ce paramètre sera associé à chacune des options représentant les cases à cocher.

Il est également possible d'associer un paramètre différent à une ou plusieurs options, grâce à un attribut nom="..." placé sur les éléments <option> correspondants. Cet attribut aura la priorité sur l'élément <nom> (si les deux sont présents, c'est l'attribut qui sera utilisé pour le nom du paramètre associé a cette option).

Si pour une option, ni l'un ni l'autre existe, l'option ne possèdera pas de paramètre.

Paramètres envoyés

Si aucune case n'est cochée, aucun paramètre ne sera envoyé à l'application distante concernant ce champ.

Si tous les paramètres correspondants aux options sélectionnées n'existent pas ou si vous utilisez un attribut envoyer="non" sur l'élément <input type="select">, rien ne sera envoyé également. Il en va de même si le champ se trouve dans une section conditionnelle et que la condition n'est pas vérifiée (le champ ne sera pas visible dans le formulaire et l'utilisateur ne pourra donc pas y répondre).

Pour chaque option cochée qui possède un paramètre, celui-ci sera envoyé avec la valeur de l'option, donnée par l'attribut valeur (ou value) de l'élément <option>.

Si plusieurs options cochées sont associées au même paramètre, ce paramètre sera envoyé plusieurs fois, avec la valeur de chacune des options. Il faudra programmer correctement l'application de manière à récupérer l'ensemble de ces valeurs. Dans le cas particulier du langage PHP, il faut utiliser un nom de paramètre qui se termine par "[]". Cela indique au serveur PHP qu'il devra construire une Array (un tableau) avec les paramètres reçus.

Paramètres dans l'ensemble des paramètres du formulaire

Si le paramètre existe, l'ensemble de paramètres lié au formulaire contiendra les paramètres suivants, où form représente le nom du formulaire et nom le nom du paramètre (ils sont illustrés avec le formulaire donné en exemple. Dans cet exemple, le nom est à remplacer par garnitures[]):

<input type="checkbox" cols="2">
   <nom>garnitures[]</nom>
   <libellé>votre choix de garnitures</libellé>
   <option valeur="ANC">des anchois</option>
   <option valeur="OLI" cochée="oui">des olives</option>
   <option valeur="CAP" cochée="oui">des câpres</option>
   <option valeur="MOZ">de la mozarella</option>
</input>

Paramètres liés à une zone de saisie de date <input type="date">

Le nom du paramètre ou des paramètres est donné par l'élément <nom> placé dans l'élément <input type="date">. Si cet élément n'existe pas, aucun paramètre n'existera.

Si cet élément <nom> possède un attribut type="string", un seul paramètre sera utilisé, dont le nom est donné par cet élément. La date sera alors envoyée sous la forme d'une seule chaîne de caractères "JJ/MM/AAAA".

Si cet élément <nom> ne possède pas d'attribut, ou s'il possède un attribut type="3-valeurs" (ou "3-values"), trois paramètres seront utilisés, dont le nom est donné par cet élément auquel on ajoute les suffixes _Day, _Month et _Year. La date sera alors envoyée sous la forme de trois valeurs distinctes ("JJ", "MM" et "AAAA")

Paramètre envoyé si l'attribut type est égal à type="string"

Si le paramètre n'existe pas ou si vous utilisez un attribut envoyer="non" sur l'élément <input type="date">, rien ne sera envoyé à l'application distante concernant ce champ. Il en va de même si le champ se trouve dans une section conditionnelle et que la condition n'est pas vérifiée (le champ ne sera pas visible dans le formulaire et l'utilisateur ne pourra donc pas y répondre).

La valeur envoyée sera celle présente dans la zone de saisie de date après que celle-ci ait été formatée sous la forme d'une chaîne de caractères "JJ/MM/AAAA".

Paramètres envoyés si l'attribut type n'existe pas ou est égal à type="3-valeurs"

Si les paramètres n'existent pas ou si vous utilisez un attribut envoyer="non" sur l'élément <input type="date">, rien ne sera envoyé à l'application distante concernant ce champ. Il en va de même si le champ se trouve dans une section conditionnelle et que la condition n'est pas vérifiée (le champ ne sera pas visible dans le formulaire et l'utilisateur ne pourra donc pas y répondre).

Les valeurs envoyées seront celles présentes dans la zone de saisie de date après que celle-ci ait été formatée.

Paramètres dans l'ensemble des paramètres du formulaire

Si le ou les paramètres existent, l'ensemble de paramètres lié au formulaire contiendra les paramètres suivants, où form représente le nom du formulaire et nom le nom du paramètre (ils sont illustrés avec le formulaire donné en exemple):

L'ensemble de ces paramètres existeront quelle que soit la valeur de l'attribut type (au contraire du ou des paramètres envoyés à l'application).

<input type="date">
   <nom>date</nom>
   <libellé>votre date de naissance</libellé>
   <valeur>7/2/98</valeur>
</input>

Paramètres liés à une zone de saisie de période <input type="période">

Le nom du paramètre ou des paramètres est donné par l'élément <nom> placé dans l'élément <input type="période">. Si cet élément n'existe pas, aucun paramètre n'existera.

Si cet élément <nom> possède un attribut type="string", un seul paramètre sera utilisé, dont le nom est donné par cet élément. Les dates de début et de fin seront alors envoyées sous la forme d'une seule chaîne de caractères "JJ/MM/AAAA-JJ/MM/AAAA".

Si cet élément <nom> possède un attribut type="2-strings", deux paramètres seront utilisés, dont le nom est donné par cet élément auquel on ajoute le suffixe "_From" et "_To". Les dates de début et de fin seront alors envoyées sous la forme de deux chaînes de caractères "JJ/MM/AAAA".

Si cet élément <nom> ne possède pas d'attribut, ou s'il possède un attribut type="6-valeurs" (ou "6-values"), six paramètres seront utilisés, dont le nom est donné par cet élément auquel on ajoute les suffixes _fromDay, _fromMonth, _fromYear, _toDay, _toMonth et _toYear. Les dates de début et de fin seront alors envoyées sous la forme de six valeurs distinctes ("JJ", "MM", "AAAA", "JJ", "MM" et "AAAA").

Paramètre envoyé si l'attribut type est égal à type="string"

Si le paramètre n'existe pas ou si vous utilisez un attribut envoyer="non" sur l'élément <input type="date">, rien ne sera envoyé à l'application distante concernant ce champ. Il en va de même si le champ se trouve dans une section conditionnelle et que la condition n'est pas vérifiée (le champ ne sera pas visible dans le formulaire et l'utilisateur ne pourra donc pas y répondre).

La valeur envoyée sera celle présente dans la zone de saisie de période après que celle-ci ait été formatée sous la forme d'une chaîne de caractères "JJ/MM/AAAA-JJ/MM/AAAA".

Paramètres envoyés si l'attribut est égal à type="2-strings"

Si les paramètres n'existent pas ou si vous utilisez un attribut envoyer="non" sur l'élément <input type="date">, rien ne sera envoyé à l'application distante concernant ce champ. Il en va de même si le champ se trouve dans une section conditionnelle et que la condition n'est pas vérifiée (le champ ne sera pas visible dans le formulaire et l'utilisateur ne pourra donc pas y répondre).

Les valeurs envoyées seront les dates de début et les dates de fin sous la forme de deux chaînes de caractères "JJ/MM/AAAA", après que celles-ci aient été formatées.

Paramètres envoyés si l'attribut type n'existe pas ou est égal à type="6-valeurs"

Si les paramètres n'existent pas ou si vous utilisez un attribut envoyer="non" sur l'élément <input type="date">, rien ne sera envoyé à l'application distante concernant ce champ. Il en va de même si le champ se trouve dans une section conditionnelle et que la condition n'est pas vérifiée (le champ ne sera pas visible dans le formulaire et l'utilisateur ne pourra donc pas y répondre).

Les valeurs envoyées seront celles présentes dans la zone de saisie de période, après que celle-ci ait été formatée.

Paramètres dans l'ensemble des paramètres du formulaire

Si le ou les paramètres existent, l'ensemble de paramètres lié au formulaire contiendra les paramètres suivants, où form représente le nom du formulaire et nom le nom du paramètre (ils sont illustrés avec le formulaire donné en exemple):

L'ensemble de ces paramètres existeront quelle que soit la valeur de l'attribut type (au contraire du ou des paramètres envoyés à l'application).

<input type="période">
   <nom>congés</nom>
   <libellé>dates de vos vacances</libellé>
   <valeur>1/8/15-7/9/16</valeur>
</input>

Paramètres liés à un champ <input type="file">

Le nom du paramètre est donné par l'élément <nom> placé dans l'élément <input type="file">. Si cet élément n'existe pas, le paramètre n'existera pas.

Paramètre envoyé

Si le paramètre n'existe pas ou si vous utilisez un attribut envoyer="non" sur l'élément <input type="file">, rien ne sera envoyé à l'application distante concernant ce champ. Il en va de même si le champ se trouve dans une section conditionnelle et que la condition n'est pas vérifiée.

La valeur envoyée sera le contenu du fichier sélectionné dans le champs en question.

Des règles très particulières doivent être respectées pour récupérer le fichier sur le serveur distant.

Paramètres dans l'ensemble des paramètres du formulaire

Aucun paramètre n'est associé au fichier sélectionné.

Paramètres liés à un champ caché <input type="hidden">

Le nom du paramètre est donné par l'élément <nom> placé dans l'élément <input type="hidden">. Si cet élément n'existe pas, le paramètre n'existera pas.

Paramètre envoyé

Si le paramètre n'existe pas ou si vous utilisez un attribut envoyer="non" sur l'élément <input type="hidden">, rien ne sera envoyé à l'application distante concernant ce champ. Il en va de même si le champ se trouve dans une section conditionnelle et que la condition n'est pas vérifiée.

La valeur envoyée sera celle définie dans le champs en question.

Paramètres dans l'ensemble des paramètres du formulaire

Si le paramètre existe, l'ensemble de paramètres lié au formulaire contiendra les paramètres suivants, où form représente le nom du formulaire et nom le nom du paramètre (ils sont illustrés avec le formulaire donné en exemple):

<input type="hidden">
   <nom>nomPrénom</nom>
   <valeur>Séraphin Lampion</valeur>
</input>

Paramètres liés à un bouton <bouton>

Le nom du paramètre est donné par l'élément <nom> placé dans l'élément <bouton>. Si cet élément n'existe pas, le paramètre n'existera pas.

Paramètre envoyé

Si le paramètre n'existe pas ou si vous utilisez un attribut envoyer="non" sur l'élément <bouton>, le bouton permettra d'envoyer le formulaire, mais rien ne sera envoyé à l'application distante concernant ce bouton.

La valeur envoyée sera égale au libellé du bouton.

Paramètres dans l'ensemble des paramètres du formulaire

Si le paramètre existe, l'ensemble de paramètres lié au formulaire contiendra les paramètres suivants, où form représente le nom du formulaire et nom le nom du paramètre (ils sont illustrés avec le formulaire donné en exemple):

<bouton>
  <nom>ok</nom>
  <libellé>Envoyer</libellé>
</input>

Traitement des champs situés dans une section conditionnelle

Une question d'un formulaire peut être placée dans une section conditionnelle. Si la condition énoncée par l'attribut options n'est pas vérifiée, la question ne sera pas visible par l'utilisateur.

Il en va de même si la question fait partie d'une option avec un contenu sélectionnable dans une liste déroulante, un bouton radio ou une case à cocher: la question ne sera visible que si l'utilisateur sélectionne cette option-là.

Qand le formulaire est envoyé, le comportement par défaut est de ne pas tenir compte des questions cachées. Vous pouvez modifier ce comportement par défaut afin d'envoyer quand même le contenu du champs (mais sans validation) ou d'envoyer une valeur particulière (qui indiquerait à l'application distante que la question est cachée, par exemple).

Comportement par défaut

Dans les deux cas cités ci-dessus, le comportement par défaut est de ne pas valider les réponses aux questions cachées et de n'envoyer aucun paramètre concernant ces questions-là.

Modifier le comportement par défaut

Vous pouvez modifier le comportement par défaut cité ci-dessus, en utilisant l'attribut envoyer="oui" ou envoyer="oui:xxxx". Dans les deux cas, le ou les paramètres associés aux questions cachées seront envoyés à l'application distante. Cet envoi se fera sans valider la question (car ni la question, ni le message d'erreur après validation ne seront visibles par l'utilisateur, et il ne saura donc pas en mesure de se rendre compte du problème).

Dans le premier cas, envoyer="oui", le ou les paramètres contiendront le contenu du champ sans validation.

Dans le deuxième cas, envoyer="oui:xxxx", le ou les paramètres contiendront la valeur donnée par xxxx (le contenu du champ sera ignoré et remplacé par xxxx).