Tutoriel XLSForm : votre premier formulaire

Mathieu Bossaert, CEN Occitanie

2 juin 2024

traduction contribuée

Les formulaires ODK sont créés en utilisant des feuilles de calcul qui suivent les règles du standard XLSForm.

L'utilisation d'un tableur pour concevoir des formulaires est très avantageuse car vous pouvez visualiser un maximum d'informations relatives à votre formulaire sur un seul écran, partager facilement votre définition de formulaire, et utiliser les fonctions très pratiques proposées par les tableurs (formules, copier/coller, mise en forme automatique, etc.) pour concevoir votre formulaire.

Quiconque dispose d'un tableur peut créer un formulaire ! En moins de 20 minutes, vous allez construire un formulaire de recensement d'établissements scolaires.

Si vous souhaitez visualiser ce à quoi il ressemblera, vous pouvez essayer cet aperçu web.

Objectifs

Dans ce tutoriel, vous allez :

• Concevoir un court formulaire utilisant différents types de questions

• Utiliser les principaux éléments de structures logiques de XLSForm

• Apprendre quelles ressources utiliser pour développer vos compétences

Prêt/prête à partir à la découverte d'XLSForm ? Alors en route !

Ouvrez le modèle de XLSForm

Vous pouvez utiliser n'importe que logiciel de tableur pour créer et modifier un XLSForm : Excel, Google Sheets, LibreOffice Calc, et d'autres. Choisissez celui que vous préférez pour ouvrir le modèle de XLSForm proposé ci-dessous :

• Google Sheet (Utilisez Fichier > Créer une copie)

• Microsoft Excel (XLSX) file

Ajoutons une question obligatoire de type "text"

1. Dans le feuille survey, utilisez la liste déroulante de la colonne type pour choisir text. Ceci créera une question de type "text" à laquelle l'utilisateur pourra répondre.

2. Dans la colonne name, mettez le nom du champ qui stockera la donnée et qui sera utilisé dans les analyses. Utilisons nom_etablissement.

3. Dans la colonne label, mettez le texte que verra le collecteur de données pour cette question : Quel est le nom de l'établissement ?

4. Dans la colonne required, mettez yes pour indiquer qu'une réponse à cette question est obligatoire.

Ajoutons une question obligatoire de type "image"

Dans la ligne sous la question du nom de l'établissement, ajoutez une question obligatoire pour prendre une photo de l'établissement.

1. Dans la colonne type, mettez image

2. Dans la colonne name, mettez photo_etablissement

3. Dans la colonne label, mettez Prendre une photo de l'établissement ${nom_etablissement}

4. Ajoutons une astuce pour donner aux collecteurs plus d’informations sur ce que nous voulons photographier. Dans la colonne hint, mettez Inclure la porte d'entrée

5. Dans la colonne required, mettez yes

6. Dans la colonne parameters, mettez max-pixels=1024 pour limiter la taille des images à 1024 pixels.

Ajoutons une question optionnelle de type "emplacement"

1. Dans la colonne type, mettez geopoint

2. Dans la colonne name, mettez emplacement_etablissement

3. Dans la colonne label, mettez Quel est l'emplacement de l'établissement "${nom_etablissement}" ?

Ajoutons une question de type "integer" n'autorisant que des valeurs positives

1. Dans la colonne type, mettez integer

2. Dans la colonne name, mettez nombre_eleves

3. Dans la colonne label, mettez Combien d'élèves sont inscrits ?

4. Dans la colonne required, mettez yes

5. Faisons en sorte que seul un nombre positif puisse être renseigné. Dans la colonne constraint, mettez . > 0 pour spécifier que la valeur renseignée (.) doit être supérieure à 0.

6. Affichons un messages aux collecteurs de données s'ils renseignent une valeur non autorisée. Dans la colonne constraint_message, mettez La valeur doit être un nombre positif

Ajoutons une question permettant de choisir plusieurs réponses

Cette question portera sur les niveaux enseignés dans l'établissement. Nous proposerons quatre choix (maternelle, élémentaire, collège, lycée), et laisserons le collecteur de données en sélectionner un ou plusieurs.

1. Allez à la feuille "choices". Elle sert à définir les listes de choix utilisées dans les question de type "select".

2. Ajoutez un choix pour le niveau "maternelle" :

   1. Dans la colonne list_name, mettez le nom de la liste de choix qui contiendra les quatre options : niveaux

   2. Dans la colonne name, mettez la valeur qui sera stockée dans les données qui seront analysées : maternelle

   3. Dans la colonne label, mettez le texte qui sera montré au collecteur pour ce choix : maternelle (3-5 ans)

3. Ajoutez un choix pour le niveau "élémentaire" :

   1. Dans la colonne list_name, mettez niveaux pour mettre ce choix dans la même liste que précédemment.

   2. Dans la colonne name, mettez : elementaire

   3. Dans la colonne label, mettez : Elémentaire (6-11 ans)

4. Ajoutez un choix pour le niveau "collège" :

   1. Dans la colonne list_name, mettez niveaux pour mettre ce choix dans la même liste que précédemment.

   2. Dans la colonne name, mettez college

   3. Dans la colonne label, mettez Collège (11-15 ans)

5. Ajoutez un choix pour le niveau "lycée" :

   1. Dans la colonne list_name, mettez niveaux pour mettre ce choix dans la même liste que précédemment.

   2. Dans la colonne name, mettez lycee

   3. Dans la colonne label, mettez Lycée (15-18 ans)

6. Retournez à la feuille survey.

7. Dans la ligne qui suit la question nombre_eleves, mettez select_multiple niveaux dans la colonne type

   Note

   Votre logiciel vous montrera un avertissement de validation car il ne connaît pas le nom de votre liste (niveaux). Ceci est normal pour les questions de type "select" qui sont complétées par le nom de la liste et cet avertissement peut donc être ignoré.

8. Dans la colonne name, mettez niveaux_enseignes

9. Dans la colonne label, mettez Quels niveaux sont enseignés ?

10. Dans la colonne required, mettez yes

11. Faisons apparaître les choix horizontalement, les uns à coté des autres. Dans la colonne appearance, mettez columns.

Ajoutons une question qui sera montrée en fonction d'une réponse précédente

Elle portera sur les options enseignées au lycée.

1. Dans la colonne type, mettez text

2. Dans la colonne name, mettez options_lycee

3. Dans la colonne label, mettez Quelles sont les options proposées au Lycée ?

4. Dans la colonne required, mettez yes

5. Affichons cette question seulement si l'établissement est un lycée. Dans la colonne relevant, mettez selected(${niveaux_enseignes}, 'lycee')

Définissons un titre et un identifiant pour ce formulaire

1. Allez à la feuille settings.

2. Dans la colonne form_title, mettez le titre que verront les utilisateurs du formulaire : Recensement des établissements scolaires 2024

3. Dans la colonne form_id, mettez an ID qui identifie de manière unique ce formulaire : recensement_etablissements_scolaires_24

4. Dans la colonne instance_name, mettez un nom qui identifie chaque soumission de données de ce formulaire : ${nom_etablissement}

Testez votre formulaire dans Central

Note

Vous n'avez pas encore de serveur ODK Central ? 1. Get a Central server ou utilisez XLSForm Online pour tester votre formulaire dans un navigateur web.

1. Enregistrez ou téléchargez votre formulaire dans un fichier XLSX.

2. Connectez vous à votre serveur Central.

3. Si vous n'avez pas encore de Projet, créez en un en nommez le.

4. Cliquez sur le bouton "Nouveau" à coté de Formulaires.

5. Glissez et déposez votre fichier XLSX ou cliquez sur le bouton "Parcourir".

   

6. Cliquez sur le bouton Aperçu pour voir votre formulaire dans votre navigateur web 🎉

   

7. Pour voir le formulaire dans l'application mobile ODK Collect, cliquez sur l'onglet guilabel:Tester et scannez le QR code avec Collect.

A vous de jouer

1. Pouvez vous rendre la question de la localisation obligatoire ?

2. Pouvez vous faire en sorte de n'afficher la question du niveau enseigné seulement si au moins 100 élèves sont inscrits ?

3. Pouvez vous afficher les options du niveau d'enseignement verticalement plutôt qu'horizontalement ? (Astuce : la mise en forme verticale est l'apparence par défaut des questions de type "select")

Prochaines étapes

Félicitations ! Vous venez de concevoir un premier formulaire qui utilise la plupart des briques de XLSForm. Vous trouverez ci-dessous des ressources pour développer vos compétences.

• Approfondissez votre compréhension

  • Introduction à XLSForm

  • Types de question

  • Questions obligatoires

  • Constraintes à la saisie

  • Questions de type "select"

  • Conditionner l'affichage des questions (Relevance)

• Élargissez vos connaissances

  • Groups of questions

  • Form Styling

  • Form language

  • Form Operators and Functions

• Introduction à ODK Collect

Did this page help you?

Selecting an option will open a 1-question survey

👍 Yes 👎 No