Dans un formulaire, un élément de questionnement (ou une question) est une unité de contenu conçue pour recueillir une réponse spécifique de la part de l’utilisateur.
Champ texte (ex. : Quel est votre nom ?)
Choix multiple (ex. : Quelle est votre couleur préférée ?)
Cases à cocher
Menus déroulants, etc
Son objectif est de collecter des données précises, standardisées et souvent exploitables automatiquement.
Dans l'index "éléments de questionnement", vous trouverez les différents types de question ou plus précisément les types "box" que vous pourrez exploiter au sein de nos formulaires.
Une question s'insère dans un paragraphe ou dans un élément spécifique appelé "QuestionSet" qui permet de regrouper plusieurs questions dans une même structure paramétrable.
Le studio propose également un assistant pour vous faciliter la pose des questions.
Mais avant de se lancer dans l'utilisation des questions dans un formulaire, il est nécessaire de se poser les bonnes questions :
Questions à se poser | Réponses possibles |
|---|---|
Quelle est l'information que je désire collecter ? | Du texte libre Un choix dans une liste de choix Une validation |
Quel est le type de donnée attendu ? | Un string (texte) Une date, un nombre entier (integer) Un booléen (vrai/faux) |
Faut-il appliquer un format particulier cette donnée ? | Mail, Téléphone N° sécurité social |
Existe t-il un schéma de données, les informations collectées seront-elles insérer dans une base de données ou dans une application, comment faut-il nommer la box 'nom' ou 'name' ? | L' attribut "Name" est le nom unique, obligatoire qui identifie le champ de saisie. Il permet également de l'enregistrer dans le dictionnaire de données. Son écriture doit respecter les règles de syntaxe précises ci-après. |
Les réponses à ces différents points, permettent de définir la question la plus approprié à utiliser et de définir ses attributs.
L' attribut "Name" est le nom unique, obligatoire qui identifie le champ de saisie. Il permet également de l'enregistrer dans le dictionnaire de données. Son écriture doit respecter les règles de syntaxe précises ci-après :
Règle de nommage des variables | Exemples valides en camelCase (recommandé) |
|---|---|
Le 1er caractère doit être une lettre (a-z ou A-Z). Convention recommandée : utiliser le camelCase (première lettre en minuscule, mots suivants avec une majuscule). ⚠️ Pas d’accent (é, à, ü… interdits) | clientNom montantTotal validationFormulaire |
Les autres caractères peuvent être des chiffres et/ou des lettres (accents non autorisés). | client1Nom montant2Total validation3Formulaire |
Règle sur l’utilisation du caractère [ dans les noms de variables
| client[0], fait référence au premier élément d’une liste client. adresse[1], fait référence à la deuxième adresse dans une liste. ligne[$(index)], fait référence à la ligne correspondant à la valeur d’une variable index. |
Règle sur l’utilisation du caractère | dans les noms de variables
| Demandeur|nom , variable nom appartenant au bloc demandeur. Demandeur|identification|prenom, champ prenom dans la sous-section Identification du demandeur. Adresse|codePostal, champ codePostal rattaché à adresse. |
Imaginons un service qui doit recueillir les informations d’identité d’un utilisateur à travers un formulaire. Ces informations incluent son sexe, son prénom, son nom, sa date de naissance et son adresse e-mail.
Champ | Label (affiché) | Type de champ | Exemple d’affichage | Name |
|---|---|---|---|---|
Civilité | Civilité | Choix unique (liste déroulante, boutons radio) L’utilisateur choisit une seule option parmi plusieurs. | Sexe : ⭘ Mme ⭘ M. ⭘ Autre | Identification|civilite |
Prénom | Prénom | Texte (contenu libre) et de type "String" | Prénom : [_________] | Identification|prenom |
Nom | Nom | Texte (contenu libre) et de type "String" | Nom : [_________] | Identification|nom |
Date de naissance | Date de naissance | Date (format particulier) et de type "Date" | Date de naissance : [__/__/____] | Identification|dateNaissance |
Adresse email | Adresse email | Données formatées (email) et de type "string" | Email : [_______@_____.__] | Identification|email |

En consultant les informations sur les différentes box, vous trouverez de plus amples informations sur les spécificités et les différents attributs qui leur sont associés.