Vous êtes sur la page 1sur 22

Qu'est-ce qu'un XLSForm?

XLSForm est un standard de formulaire créé pour simplifier la création de formulaires


dans Excel. La création se fait dans un format lisible par l'homme, à l'aide d'un outil
familier que presque tout le monde connaît: Excel. XLSForms fournit un standard
pratique pour le partage et la collaboration sur les formulaires de création. Ils sont
simples à utiliser mais permettent la création de formulaires complexes par une
personne familiarisée avec la syntaxe décrite ci-dessous.
Le XLSForm est ensuite converti en un XForm, un standard de formulaire ouvert
populaire, qui vous permet de créer un formulaire avec des fonctionnalités complexes,
telles que la logique de saut, de manière cohérente sur plusieurs plateformes de collecte
de données Web et mobiles. XLSForms sont compatibles avec le sous-ensemble de
fonctionnalités XForm prises en charge par Javarosa Project . XLSForms sont pris en
charge par un certain nombre de plates-formes de collecte de données populaires.

Format de base
Chaque classeur Excel comporte généralement deux feuilles de
travail: enquête et choix . Une troisième feuille de calcul facultative
appelée paramètres peut ajouter des spécifications supplémentaires à votre formulaire
et est décrite ci-dessous.
La fiche de sondage
Cette feuille de calcul donne à votre formulaire sa structure générale et contient la
majeure partie de son contenu. Il contient la liste complète des questions et des
informations sur la manière dont elles devraient apparaître dans le formulaire. Chaque
ligne représente généralement une question; Cependant, vous pouvez ajouter au
formulaire certaines autres fonctionnalités décrites ci-dessous pour améliorer
l'expérience de l'utilisateur.
La fiche de choix
Cette feuille de travail est utilisée pour spécifier les choix de réponses pour les questions
à choix multiples. Chaque ligne représente un choix de réponse. Les choix de réponse
portant le même nom de liste sont considérés comme faisant partie d'un ensemble de
choix connexe et apparaissent ensemble pour une question. Cela permet également de
réutiliser un ensemble de choix pour plusieurs questions (par exemple, des questions oui
/ non).
Ces deux feuilles de calcul comportent un ensemble de colonnes obligatoires qui doivent
être présentes pour que le formulaire fonctionne. En outre, chaque feuille de calcul
comporte un ensemble de colonnes facultatives qui permettent de contrôler davantage le
comportement de chaque entrée du formulaire, mais ne sont pas
indispensables. Chaque entrée doit avoir des valeurs pour chacune des colonnes
obligatoires, mais les colonnes facultatives peuvent rester vides.
 La feuille de travail de l' enquête comporte 3 colonnes
obligatoires: type , nom et libellé .
o La colonne type spécifie le type d'entrée que vous ajoutez.
o La colonne name spécifie le nom unique de la variable pour cette entrée. Deux entrées
ne peuvent pas avoir le même nom. Les noms doivent commencer par une lettre ou un
trait de soulignement. Les noms ne peuvent contenir que des lettres, des chiffres, des
tirets, des traits de soulignement et des points. Les noms sont sensibles à la casse.
o La colonne d' étiquette contient le texte que vous voyez dans le formulaire. Vous pouvez
également utiliser des colonnes de traduction d'étiquette .
type prénom étiquette
type prénom étiquette
aujourd'hui aujourd'hui
select_one genre le sexe Le sexe du répondant?
entier âge L'âge du répondant?
paramètres dechoix d'enquête
 La feuille de travail Choix comporte également 3 colonnes obligatoires: nom de la
liste , nom et libellé .
o La colonne Nom de la liste vous permet de regrouper un ensemble de choix de réponse
associés, c'est-à-dire des choix de réponse devant apparaître ensemble sous une
question.
o La colonne name spécifie le nom unique de la variable pour ce choix de réponse.
o La colonne d' étiquette indique le choix de réponse exactement comme vous souhaitez
qu'il apparaisse sur le formulaire. Vous pouvez également utiliser des colonnes de
traduction d'étiquette .
liste de noms prénom étiquette
le sexe transgenres transgenres
le sexe femelle Femelle
le sexe mâle Mâle
le sexe autre Autre
paramètres dechoix d'enquête
Les colonnes que vous ajoutez à votre classeur Excel, qu'elles soient obligatoires ou
facultatives, peuvent apparaître dans n'importe quel ordre. Les colonnes facultatives
peuvent être complètement omises. N'importe quel nombre de lignes peut être laissé
vide. Tous les formats de fichier .xls sont ignorés. Vous pouvez donc utiliser des lignes
de séparation, des ombres et autres formats de polices pour rendre le formulaire plus
lisible.
Une chose à garder à l'esprit lors de la création de formulaires dans Excel est que la
syntaxe que vous utilisez doit être précise. Par exemple, si vous
écrivez Choix ou choix au lieu de choix , le formulaire ne fonctionnera pas.

Types de questions
XLSForm prend en charge un certain nombre de types de questions. Voici quelques-
unes des options que vous pouvez entrer dans la colonne Type de la feuille de calcul
de l' enquêtedans votre XLSForm:
Type de
Réponse entrée
question
entier Entier (c.-à-d. Un nombre entier).
décimal Entrée décimale.
intervalle Entrée de gamme .
texte Réponse en texte libre.
select_one [options] Question à choix multiples; une seule réponse peut être sélectionnée.
select_multiple
Question à choix multiples; plusieurs réponses peuvent être sélectionnées.
[options]
rang [options] Question de classement ; commander une liste.
Remarque Afficher une note à l'écran, ne prend aucune entrée.
géopoint Recueillir une seule coordonnée GPS .
Type de
Réponse entrée
question
géotrace Enregistrez une ligne de deux ou plusieurs coordonnées GPS.
Enregistrez un polygone de plusieurs coordonnées GPS. le dernier point
geoshape
est le même que le premier point.
rendez-vous
Date entrée.
amoureux
temps Saisie du temps.
date et heure Accepte une date et une heure.
image Prenez une photo ou téléchargez un fichier image.
l'audio Prendre un enregistrement audio ou télécharger un fichier audio.
vidéo Prendre un enregistrement vidéo ou télécharger un fichier vidéo.
fichier Entrée de fichier générique (txt, pdf, xls, xlsx, doc, docx, rtf, zip)
Scannez un code-barres, nécessite que l'application scanner de codes-
code à barre
barres soit installée.
calculer Effectuer un calcul; voir la section Calcul ci-dessous.
reconnaître Acquittez l'invite qui définit la valeur sur «OK» si elle est sélectionnée.
caché Un champ sans élément d'interface utilisateur associé
xml-external Ajoute une référence à un données XML externe fichier

GPS
Par exemple, pour collecter le nom et les coordonnées GPS d'un magasin, vous devez
écrire ce qui suit:
type prénom étiquette
texte nom du magasin Quel est le nom de ce magasin?
géopoint store_gps Recueillir les coordonnées GPS de ce magasin.
paramètres dechoix d'enquête
Voir la question_types XLSForm pour voir chaque type de question utilisé dans un
formulaire.
GPS avec seuil de précision
Lors de l’enregistrement des coordonnées GPS dans ODK Collect, ODK Collect collecte
automatiquement le GPS lorsque le niveau de précision atteint 5 mètres ou moins. Vous
pouvez modifier ce comportement par défaut en spécifiant un precisionThreshold ; cela
pourrait être inférieur à 5 m ou supérieur à 5 m. Vous devrez ajouter une colonne avec
en-tête body :: precisionThreshold sur la feuille de sondage de votre
XLSForm. Ensuite, spécifiez votre valeur de seuil de précision préférée pour cette
colonne sur votre question de géopoint, comme dans l'exemple ci-dessous:
corps ::
type prénom étiquette
precisionThreshold
Recueillir les coordonnées GPS de ce
géopoint store_gps 1,5
magasin.
paramètres dechoix d'enquête
Voir la forme gps_accuracy_threshold pour un exemple utilisant cet attribut.
Questions à choix multiple
XLSForm prend en charge les questions select_one (sélectionnez une seule réponse)
et select_multiple (sélectionnez plusieurs réponses). La rédaction d'une question à
choix multiples nécessite l'ajout d'une feuille de calcul des choix à votre classeur
Excel. Voici un exemple de question sur select_one :
type prénom étiquette
select_one yes_no likes_pizza Aimes-tu la pizza?
paramètres dechoix d'enquête

liste de noms prénom étiquette


Oui Non Oui Oui
Oui Non non Non
paramètres dechoix d'enquête
Notez que yes_no dans la feuille de calcul de l' enquête doit correspondre
à yes_no dans la colonne Nom de la liste de la feuille de travail Choix . Cela garantit
que le formulaire affiche la liste correcte des choix de réponses pour une question
donnée.
Nous pouvons également ajouter des questions à choix multiples qui permettent de
sélectionner plusieurs réponses, comme ceci:
type prénom étiquette
select_multiple Quelles sont vos garnitures de pizza
favoris_toppings
pizza_toppings préférées?
paramètres dechoix d'enquête

liste de noms prénom étiquette


garnitures de pizza fromage Fromage
garnitures de pizza pepperoni Pepperoni
garnitures de pizza saucisse Saucisse
paramètres dechoix d'enquête

Spécifiez autre
Pour les questions à choix multiples, les enquêtes incluent souvent une option
permettant de marquer les autres lorsque leur choix de réponse ne figure pas dans la
liste. Ensuite, ils sont généralement invités à spécifier l'autre option. Ceci est possible via
XLSForm en incluant ou_other après le nom de la liste de choix de réponses dans la
feuille de calcul de l'enquête. La feuille de calcul des choix reste la même. Voir ci-
dessous:
type prénom étiquette
select_multiple pizza_toppings coup de Quelles sont vos garnitures de pizza
ou_other coeur préférées?
paramètres dechoix d'enquête

liste de noms prénom étiquette


liste de noms prénom étiquette
garnitures de pizza fromage Fromage
garnitures de pizza pepperoni Pepperoni
garnitures de pizza saucisse Saucisse
paramètres dechoix d'enquête
Cliquez sur le lien pour consulter le questionnaire complet de pizza_questionnaire .
Caveat
Lorsque vous exportez des données en utilisant cette or_other option dans
la favorite_topping colonne, vous verrez une valeur autre . Une colonne séparée aura
la réponse pour les questions dans lesquelles l'utilisateur a sélectionné autre . Cela
alourdit l’analyse des données et nous ne recommandons donc pas
la construction or_other pour les efforts de collecte de données à grande échelle. Voir
la section Pertinente ci-dessous pour une méthode alternative plus appropriée pour les
projets à grande échelle.
Rang
Le widget de classement peut être utilisé pour permettre aux répondants de classer une
liste d'options. La réponse est enregistrée sous la forme d'une liste ordonnée de valeurs
d'options, séparées par des espaces, où toutes les options sont toujours incluses. La
syntaxe est très similaire aux questions à choix multiples.
type prénom étiquette
classer Commandez des garnitures de pizza avec votre favori sur le
garnitures
pizza_toppings dessus
paramètres dechoix d'enquête

liste de noms prénom étiquette


garnitures de pizza fromage Fromage
garnitures de pizza pepperoni Pepperoni
garnitures de pizza saucisse Saucisse
paramètres dechoix d'enquête
Pour éviter les biais, il est souvent recommandé d'utiliser la fonctionnalité de
randomisationen conjonction avec ce widget.
Intervalle
Pour limiter les entrées entières ou décimales à une plage spécifique, vous pouvez
utiliser la question plage . Cette question peut être utilisée avec 3 paramètres facultatifs
séparés par des espaces: début , fin et étape dans une colonne de paramètres . Les
valeurs par défaut sont respectivement 0, 10 et 1. L'exemple ci-dessous créera une
question permettant la saisie de 0 à 17 avec un pas de 1. L'utilisation d'un pas décimal
entraînera la collecte de valeurs décimales.
type prénom étiquette paramètres
intervalle montant Quel est l'âge de l'enfant? début = 0 fin = 17 pas = 1
paramètres dechoix d'enquête

Métadonnées
XLSForm dispose d'un certain nombre d'options de types de données disponibles pour
la collecte de métadonnées:
Type de métadonnées Sens
début Date et heure de début de l'enquête.
fin Date et heure de fin de l'enquête.
aujourd'hui Jour de l'enquête.
Reference de l'appareil IMEI (identité internationale d'équipement mobile)
ID d'abonné IMSI (identité internationale d'abonné mobile)
Type de métadonnées Sens
simserial Numéro de série de la carte SIM.
numéro de téléphone Numéro de téléphone (si disponible).
Nom d'utilisateur Nom d'utilisateur configuré (si disponible).
email Adresse e-mail configurée (si disponible).
Notez que certains champs de métadonnées ne s'appliquent qu'aux formulaires basés
sur un téléphone mobile.
Si je voulais que mon enquête recueille toutes ces métadonnées, je mettrais ceci au
début de l'enquête:
type prénom étiquette
début début
fin fin
aujourd'hui aujourd'hui
Reference de l'appareil Reference de l'appareil
ID d'abonné ID d'abonné
simserial simserial
numéro de téléphone numéro de téléphone
Nom d'utilisateur Nom d'utilisateur
email email
paramètres dechoix d'enquête
Notez qu’aucune étiquette n’est associée aux types de question de métadonnées. En
effet, le téléphone enregistre automatiquement ces variables. Ces questions
n'apparaîtront pas sur l'écran du téléphone, mais vous les verrez lors de la visualisation
des données de votre enquête. Le didacticiel XLSForm montre comment les
métadonnées sont utilisées dans un formulaire.
Données XML externes
Pour les utilisateurs avancés, qui doivent effectuer des requêtes complexes sur des
données externes sans restrictions, un fichier de données XML externe peut être ajouté
avec le type de question xml-external . La valeur du nom colonne peut être utilisée pour
faire référence à ces données dans une formule (par exemple , pour un calcul,
contrainte, pertinente, ou choice_filter) en utilisant l' instance ( « nom ») fonction. Un
fichier portant le même nom et l' extension .xml doit être chargé avec le formulaire. Voir
ci-dessous un exemple qui nécessite le téléchargement d'un fichier appelé houses.xml
avec le formulaire.
type prénom étiquette calcul
xml-
Maisons
external
Combien de
entier pièces
chambres?
nombre (exemple ('maisons') / maison [pièces =
calculer compter
courant () /../ pièces])
paramètres dechoix d'enquête

Astuces
Astuces régulières
Parfois, vous souhaitez ajouter un petit indice à une question de votre formulaire,
indiquant à l'utilisateur comment répondre à la question, mais vous ne souhaitez pas que
cet indice fasse partie de la question. Il est facile d'ajouter des astuces aux questions
dans XLSForms. Ajoutez simplement une colonne de conseil et ajoutez votre message
de conseil. Voir ci-dessous pour un exemple.
type prénom étiquette allusion
Regardez sur le panneau si le
texte prénom Quel est le nom de ce magasin?
magasin a un panneau.
Recueillir les coordonnées GPS
géopoint géopoint
de ce magasin.
paramètres dechoix d'enquête
Le didacticiel XLSForm fournit plus d'exemples de questions avec des astuces.
Conseils d'orientation
Il existe un type particulier d'indice qui n'est normalement pas indiqué dans le
formulaire. Il n'est affiché que dans des vues spéciales. Un exemple serait de montrer
ces astuces sur des impressions ou au cours d’une formation pour les recenseurs. Ces
astuces sont appelées indications de guidage et peuvent être ajoutées dans
la colonne guidance_hint . Voir ci-dessous pour un exemple.
type prénom étiquette guidance_hint pertinent
entier âge Âge?
texte prénom Prénom? Ce ne sera montré que pour l'âge> 18. $ {age}> 18
paramètres dechoix d'enquête

Contraintes
Une façon de garantir la qualité des données consiste à ajouter des contraintes aux
champs de données de votre formulaire. Par exemple, lorsque vous demandez l'âge
d'une personne, vous souhaitez éviter les réponses impossibles, telles que -22 ou 200. Il
est facile d'ajouter des contraintes de données dans votre formulaire. Vous ajoutez
simplement une nouvelle colonne, appelée contrainte , et vous tapez la formule en
spécifiant les limites de la réponse. Dans l'exemple ci-dessous, la réponse pour l'âge de
la personne doit être inférieure ou égale à 150. Notez comment le .dans la formule
renvoie à la variable question.
type prénom étiquette contrainte
entier âge Quel âge avez-vous? . <= 150
paramètres dechoix d'enquête
Dans cet exemple, la formule . <= 150indique que la valeur entrée .pour la question
doit être inférieure ou égale à 150. Si l'utilisateur donne 151 ou plus comme réponse, il
ne sera pas autorisé à passer à la question suivante ou soumettre le formulaire.
Vous trouverez ici d' autres expressions utiles à utiliser dans la colonne
de contrainte . Regardez dans la section Opérateurs .
Message de contrainte
Si vous souhaitez inclure un message avec votre contrainte, indiquant à l'utilisateur
pourquoi la réponse n'est pas acceptée, vous pouvez ajouter
une colonne constraint_message à votre formulaire. Voir l'exemple ci-dessous.
type prénom étiquette contrainte message de contrainte
type prénom étiquette contrainte message de contrainte
Âge du Le répondant doit avoir 18 ans ou plus
entier respondent_age . > = 18
répondant pour répondre au sondage.
paramètres dechoix d'enquête
Dans cet exemple, si l'utilisateur entre moins de 18 ans, le message d'erreur de
la colonne constraint_message apparaît. Plus d'exemples sur les contraintes ont été
illustrés dans ce XLSForm .

Pertinent
Une excellente fonctionnalité de XLSForm est la possibilité de sauter une question ou de
faire apparaître une question supplémentaire en fonction de la réponse à une question
précédente. Vous trouverez ci-dessous un exemple de la manière de le faire en ajoutant
une colonne pertinente pour une question select_one , en utilisant notre exemple de
garniture de pizza d’avant:
type prénom étiquette pertinent
select_one yes_no likes_pizza Aimes-tu la pizza?
select_multiple pizza_toppings coup de Garnitures $ {likes_pizza} =
ou_other coeur préférées 'yes'
paramètres dechoix d'enquête
Dans cet exemple, on demande au répondant: «Aimez-vous la pizza?». Si la réponse
est oui, la question «garniture de pizza» apparaît ci-dessous. Notez le ${ }autour de la
variable likes_pizza . Celles-ci sont requises pour que le formulaire fasse référence à la
variable de la question précédente.
Dans l'exemple suivant, ci-dessous, nous utilisons la syntaxe appropriée pour
une question select_multiple , légèrement différente de l' exemple select_one
concernant la question ci-dessus.
type prénom étiquette pertinent
select_one yes_no likes_pizza Aimes-tu la pizza?
select_multiple coup de
Garnitures préférées $ {likes_pizza} = 'yes'
pizza_toppings ou_other coeur
sélectionné ($
fromage Quel est votre type de
texte {favourite_topping},
préféré fromage préféré?
'fromage')
paramètres dechoix d'enquête

liste de noms prénom étiquette


garnitures de pizza fromage Fromage
garnitures de pizza pepperoni Pepperoni
garnitures de pizza saucisse Saucisse
paramètres dechoix d'enquête
Étant donné que la question de la garniture de pizza permet des réponses multiples,
nous devons utiliser l' selected(${favorite_topping}, 'cheese')expression, car nous
voulons que la question du fromage apparaisse à chaque fois que l'utilisateur
sélectionne le fromage comme l'une des réponses (que des réponses supplémentaires
soient sélectionnées ou non).
Nous avons mentionné précédemment qu'il existait une méthode alternative pour
spécifier d'autres questions à choix multiples, plus appropriée pour les enquêtes à
grande échelle. Cela peut être fait en utilisant la même syntaxe pertinente de l'exemple
ci-dessus:
type prénom étiquette pertinent
Quelles sont vos
select_multiple
favoris_toppings garnitures de pizza
pizza_toppings
préférées?
sélectionné ($
texte favorite_toppings_other Spécifiez autre: {favorite_toppings},
'other')
paramètres dechoix d'enquête

liste de noms prénom étiquette


garnitures de pizza fromage Fromage
garnitures de pizza pepperoni Pepperoni
garnitures de pizza saucisse Saucisse
garnitures de pizza autre Autre
paramètres dechoix d'enquête
Notez que vous devez inclure autre en tant que choix de réponse dans la feuille de
calcul des choix .

Formules
Les formules sont utilisées dans les colonnes de contrainte, pertinente et de calcul. Vous
avez déjà vu quelques exemples dans les sections Contraint et Pertinent ci-
dessus. Les formules vous permettent d'ajouter des fonctionnalités supplémentaires et
des mesures de qualité des données à vos formulaires.
Les formules sont composées de fonctions et d'opérateurs (+, *, div, etc.). Une liste
complète et bien documentée des opérateurs et des fonctions est disponible dans
la documentation ODK . Pour les utilisateurs techniques, la spécification XForms sous-
jacente est le document source des fonctions prises en charge .

Calcul
Votre enquête peut effectuer des calculs en utilisant les valeurs des questions
précédentes. Dans la plupart des cas, il faudra insérer une question de calcul . Par
exemple, dans l'enquête ci-dessous, nous avons calculé le pourboire d'un repas et
l'avons affiché à l'utilisateur:
type prénom étiquette calcul
décimal montant Quel était le prix du repas?
calculer pointe {montant} * 0,18
Remarque afficher Le pourboire de 18% pour votre repas est: $ {tip}
paramètres dechoix d'enquête
Notez que le $ {tip} de la dernière ligne sera remplacé par le montant du pourboire lors
de la visualisation et du remplissage du formulaire.

Champs obligatoires
Il est simple de cocher certaines questions comme requis dans votre formulaire. Les
marquer comme requis signifie que l'utilisateur ne pourra pas passer à la question
suivante ou soumettre le formulaire sans entrer de réponse pour cette question.
Pour créer des questions obligatoires, ajoutez une colonne requise à votre feuille de
travail. Sous cette colonne, cochez les questions requises en écrivant oui . Voir
l'exemple ci-dessous:
type prénom étiquette contrainte Champs obligatoires
entier âge Quel âge avez-vous? . <= 150 Oui
paramètres dechoix d'enquête

Message requis
Si vous souhaitez personnaliser le message affiché aux utilisateurs lorsqu'ils laissent une
question obligatoire en blanc, vous pouvez ajouter une colonne required_message à
votre formulaire. Voir l'exemple ci-dessous.
Champs
type prénom étiquette message requis
obligatoires
Âge du Désolé, cette réponse est
entier respondent_age Oui
répondant requise.
paramètres dechoix d'enquête

Randomiser les choix


Pour tout type de question affichant une liste de choix, l'ordre d'affichage des choix
affichés à l'utilisateur peut être aléatoire avec la colonne de paramètres . Voir ci-
dessous:
type paramètres prénom étiquette
select_one garnitures randomize = true Haut Préféré?
paramètres dechoix d'enquête
Pour une randomisation reproductible, une graine peut être explicitement fournie,
comme indiqué ci-dessous. Pour en savoir plus sur l'algorithme de randomisation utilisé,
voir ici .
type paramètres prénom étiquette calcul
Dakota du une fois (decimal-date-
calculer
Sud time (now ()))
select_one randomize = true, seed
Haut Préféré?
garnitures = $ {sd}
paramètres dechoix d'enquête
Notez que cela once()sert à empêcher une nouvelle randomisation, par exemple,
lorsqu'un brouillon d'enregistrement est chargé pour édition.

Regroupement des questions


Pour créer un groupe de questions dans votre formulaire, procédez comme suit:
type prénom étiquette
commencer le groupe intimé Intimé
texte prénom Entrez le nom du répondant
texte position Entrez la position du répondant dans l'école.
groupe d'extrémité
paramètres dechoix d'enquête
C’est un bon moyen de regrouper les questions liées à l’exportation et à l’analyse des
données. Notez que le groupe d'extrémité ne nécessite pas de nom ou d'étiquette, car
celui-ci est masqué dans le formulaire.
Groupes de nidification au sein de groupes
Des groupes de questions peuvent être imbriqués les uns dans les autres:
type prénom étiquette
commencer le
hôpital Hôpital
groupe
texte prénom Quel est le nom de cet hôpital?
commencer le
hiv_medication Médicaments contre le VIH
groupe
Est-ce que cet hôpital a des médicaments anti-
select_one yes_no avoir_hiv_medication
VIH?
groupe d'extrémité
groupe d'extrémité
paramètres dechoix d'enquête
Vous devez toujours mettre fin au groupe le plus récent créé en premier. Par exemple, le
premier groupe d'extrémités que vous voyez ferme le groupe de médicaments anti-VIH
et le second le groupe de début d'hospitalisation. Lorsque vous travaillez avec des
groupes et que vous continuez à recevoir des messages d'erreur lorsque vous essayez
de télécharger votre formulaire, vérifiez que pour chaque groupe de début, vous avez
un groupe de fin .
Saut
Une fonctionnalité intéressante de XLSForm est la possibilité de sauter un groupe de
questions en combinant la fonctionnalité de groupe avec la syntaxe appropriée. Si vous
souhaitez ignorer un groupe de questions en une fois, placez l'attribut approprié au début
du groupe, comme suit:
type prénom étiquette pertinent
entier âge Quel âge avez-vous?
commencer le $ {age} <=
enfant Enfant
groupe 5
Notez le tour de bras de cet enfant à mi-
entier muac
hauteur.
Le test de diagnostic rapide de l'enfant est-il
select_one yes_no mrdt
positif?
groupe d'extrémité
paramètres dechoix d'enquête
Dans cet exemple, les questions des deux groupes d'enfants ( muac et mrdt )
n'apparaîtront que si l' âge de l' enfant de la première question est inférieur ou égal à
cinq.
Répétitions
Un utilisateur peut répéter un groupe de questions en utilisant les constructions begin
repeatet end repeat :
type prénom étiquette
commencer à répéter reponse_enfant
type prénom étiquette
texte prénom Nom de l'enfant
décimal Poids à la naissance Poids de naissance de l'enfant
select_one male_female sexe Le sexe de l'enfant
fin de répéter
paramètres dechoix d'enquête

liste de noms prénom étiquette


homme Femme mâle Mâle
homme Femme femelle Femelle
paramètres dechoix d'enquête
Dans cet exemple, les champs nom , poids à la naissance et sexe sont regroupés
dans un groupe de répétition. L'utilisateur peut répéter ce groupe autant de fois que
nécessaire en sélectionnant l'option dans le formulaire pour en commencer une autre.
La colonne label est facultative pour begin repeat . L'attribution d'une étiquette à un
groupe de répétitions ajoutera l'étiquette en tant que titre au bloc de questions répétées
du formulaire.
Le résultat de livraison XLSForm illustre un autre exemple de groupe de répétition.
Au lieu de permettre un nombre infini de répétitions, l'utilisateur peut spécifier un nombre
exact de répétitions à l'aide de la colonne repeat_count :
type prénom étiquette repeat_count
commencer à répéter reponse_enfant 3
texte prénom Nom de l'enfant
Poids à la Poids de naissance de
décimal
naissance l'enfant
select_one
sexe Le sexe de l'enfant
male_female
fin de répéter
paramètres dechoix d'enquête

liste de noms prénom étiquette


homme Femme mâle Mâle
homme Femme femelle Femelle
paramètres dechoix d'enquête
Dans l'exemple ci-dessus, le groupe de répétitions est limité à 3 répétitions.
Certaines plates-formes prennent également en charge le nombre de répétitions
dynamiques. Dans l'exemple ci-dessous, le nombre saisi par l'utilisateur pour
le champ num_hh_members détermine le nombre de répétitions du
groupe hh_member :
type prénom étiquette repeat_count
Nombre de membres du
entier num_hh_members
ménage?
$
commencer à répéter hh_member
{num_hh_members}
texte prénom prénom
entier âge Âge
type prénom étiquette repeat_count
select_one
le sexe Le sexe
male_female
fin de répéter
paramètres dechoix d'enquête

liste de noms prénom étiquette


homme Femme mâle Mâle
homme Femme femelle Femelle
paramètres dechoix d'enquête

Support multilingue
Il est facile d'ajouter plusieurs langues à un formulaire. Vous devez simplement nommer
votre label :: language1 (code) , label :: language2 (code) , etc., et vos formulaires
seront disponibles dans plusieurs langues. Voir l'exemple ci-dessous. Sélectionnez une
autre langue de formulaire dans le menu déroulant de l'application de collecte de
données (il peut être situé sous la touche Menu ). Pour le formulaire ci-dessous, English
et Español apparaîtront comme les options possibles.
type prénom label :: anglais (en) label :: Español (es) contrainte
entier âge Quel âge avez-vous? Quel âge as-tu? . <= 150
paramètres dechoix d'enquête
La langue de la forme et la langue de l'interface utilisateur peuvent être déterminées
séparément par l'application et peuvent ne pas correspondre. Pour faciliter la mise en
correspondance des deux (à l'avenir), il est recommandé, bien que facultatif, d'ajouter un
code de langue à 2 caractères après le nom de la langue. Les codes de langue officiels
à deux caractères, appelés sous- étiquettes, sont publiés ici (recherchez la page avec
Ctrl-F ou Cmd-F).
Remarque
Vous pouvez également ajouter une colonne de langue différente pour les conseils et les
fichiers multimédias. vous utilisez simplement la ::languageconstruction à nouveau. Voir
le document standard XLSForm pour voir exactement quels types d'en-têtes de colonnes
peuvent accepter une modification de langue.

Médias
Vous pouvez inclure dans votre formulaire des questions d'affichage d'images ou de
lecture de fichiers vidéo ou audio. Si vous utilisez le client mobile ODK pour la
soumission de formulaire, vous devez placer les fichiers multimédias à inclure dans
le dossier / odk / forms / formname-media de votre téléphone, puis référencer le nom
exact du fichier dans la colonne Média de votre forme. Voir ci-dessous pour un exemple
de la procédure à suivre.
type prénom étiquette médias :: image médias :: vidéo
Remarque exemple_média Exemple de média exemple.jpg exemple.mp4
paramètres dechoix d'enquête
Découvrez le Birds XLSForm qui illustre l'utilisation de fichiers multimédias. Vous pouvez
également cliquer sur le lien pour voir le formulaire Web Birds .

Chargement préalable des données CSV


Le préchargement des données est effectué lorsque l’on souhaite référencer des
données préexistantes dans un formulaire d’enquête. Vous pouvez être en mesure de
référencer des données dans votre formulaire d’enquête (l’enquête que vous êtes en
train de créer), à partir de données préexistantes dans un formulaire d’enquête
spécifique ou de toute autre source. Par exemple, si vous disposez de données
préexistantes issues d'une enquête auprès des ménages et que vous souhaitez collecter
des données de suivi sur les occupants du ménage. Vous pouvez être en mesure de
référencer les données de l'enquête auprès des ménages dans votre formulaire
d'enquête. Pour référencer des données préexistantes dans un formulaire d'enquête:
 Téléchargez un ou plusieurs fichiers .csv en tant que fichiers de support lorsque vous
téléchargez la définition de formulaire (de la même manière que vous importez des
fichiers de support de support, comme expliqué dans la section Support ). La première
ligne de chaque fichier .csv doit être un en-tête comprenant:
o noms uniques pour chaque colonne
o les lignes suivantes qui doivent contenir les données elles-mêmes
Chaque fichier csv doit contenir au moins une colonne pouvant être utilisée pour
identifier chaque ligne de manière unique. Ces colonnes seront utilisées, au moment de
l'enquête, pour rechercher les données de la ligne à extraire de l'enquête. Pour les
colonnes qui seront utilisées pour rechercher des lignes, ajoutez _key à la fin du nom de
la colonne dans la première ligne. Toutes les colonnes dont le nom se termine
par _key seront indexées pour accélérer les recherches sur vos appareils de
sondage. Voir ci-dessous un exemple des colonnes d'un fichier .csv:
name_key prénom
mangue Mangue
Orange Orange

Comment extraire des données de CSV


Vous pouvez extraire des données d'un fichier .csv en incluant un ou plusieurs fichiers
.csv dans votre formulaire au cours de la période d'enquête. Pour chaque champ de
données que vous souhaitez extraire de votre enquête:
 Ajoutez un champ de calcul à votre enquête.
 Donnez un nom à ce champ
 Ensuite, dans sa colonne de calcul , appelez la fonction pulldata () , indiquant quel
champ extraire de quelle ligne de quel fichier .csv.
Voir ci-dessous pour un exemple:
type prénom étiquette calcul
pulldata ('fruits', 'nom', 'nom_clé',
calculer fruit
'mangue')
Le fruit $ {fruit} est extrait de
Remarque note_fruit
CSV.
paramètres dechoix d'enquête
Une fois que vous avez chargé des données .csv dans un champ d’enquête à l’aide de
la fonction pulldata () , vous pouvez référencer ce champ dans des conditions, des
contraintes et des libellés de pertinence ultérieurs, comme vous le feriez pour tout autre
champ renseigné par l’utilisateur.
Cliquez sur le lien pour voir un exemple de formulaire de pré-chargement. Le fichier .csv
utilisé avec le formulaire est disponible ici.
Remarques importantes sur l'utilisation des données préchargées
 Compressez un fichier .csv volumineux dans une archive .zip avant de le télécharger.
 Enregistrez le fichier .csv au format UTF-8 si les données préchargées contiennent des
polices non anglaises ou des caractères spéciaux, ce qui permettra à votre appareil
Android de restituer correctement le texte.
 Les champs de données extraits d'un fichier .csv sont considérés comme des chaînes de
texte. Par conséquent, utilisez les fonctions int () ou number () pour convertir un champ
pré-chargé en format numérique.
 Si le fichier .csv contient des données sensibles que vous pouvez ne pas télécharger sur
le serveur, téléchargez un fichier .csv vierge dans le formulaire, puis remplacez-le par le
fichier .csv réel en le copiant à la main sur chacun de vos fichiers. dispositifs.

Sélection dynamique à partir de données pré-


chargées
Une fois que votre formulaire contient un ou plusieurs fichiers .csv pré-chargés, vous
pouvez extraire dynamiquement les listes de choix pour
les champs select_one et select_multiplede ces fichiers .csv. Les champs à choix
multiples avec des listes de choix dynamiques suivent la même syntaxe générale que les
champs habituels statiques select_one et select_multiple décrits précédemment dans
la section Questions à choix multiples .
Ce qui suit devrait être fait:
 spécifiez select_one listname ou select_multiple listname dans la colonne type
(où listname est le nom de votre liste de choix)
 spécifier les styles d'apparence spéciaux dans la colonne d'apparence
 inclure une ou plusieurs lignes pour votre nom de liste sur la feuille de calcul des choix.
Vous trouverez ci-dessous un exemple de fiche d’ enquête :
type prénom étiquette apparence
select_one fruits fruits Sélectionnez un fruit recherche ('fruits')
paramètres dechoix d'enquête
Il existe trois différences lorsque la liste de choix doit être extraite de l’un de vos fichiers
.csv préchargés:
 Dans la colonne Apparence:
 Incluez une expression search () qui spécifie les lignes .csv à inclure dans la liste de
choix.
 Si le champ doit utiliser un style d’apparence autre que celui par défaut. Le style
d’apparence autre que celui par défaut se trouve d’abord dans la colonne, suivi
d’un espace , puis de l’ expression search () . [p. ex. recherche rapide () ]
 Sur la fiche de choix :
 une ligne doit indiquer les colonnes .csv à utiliser pour l'étiquette et la valeur
sélectionnée. Comme suit:
o list_name column: spécifiez le nom de votre liste de choix comme vous le feriez
normalement.
o colonne name : inclut le nom de la colonne .csv à utiliser pour identifier de manière
unique les choix sélectionnés.
o label column: inclut le nom de la colonne .csv à utiliser pour étiqueter les choix.
Remarque :
Si vous souhaitez inclure plusieurs colonnes dans les étiquettes, incluez une liste de
toutes les colonnes, séparées par des virgules, à inclure. La colonne de nom sera
renseignée de manière dynamique en fonction du nom de colonne que vous avez
indiqué, et la colonne d'étiquette sera renseignée de manière dynamique en fonction du
nom de la colonne que vous avez indiquée.
 Dans la ligne de votre feuille de travail Choix, vous pouvez également inclure un nom de
colonne .csv dans la colonne image. Si vous le faites, le nom du fichier image à utiliser
sera extrait de la colonne .csv spécifiée.
Remarque :
Si vous faites référence à des fichiers image de cette manière, vous devez toujours
télécharger ces fichiers image en tant que pièces jointes lorsque vous téléchargez votre
formulaire sur le serveur.
Voir ci-dessous un exemple de fiche de choix:
liste de noms prénom étiquette
fruits name_key prénom
paramètres dechoix d'enquête
Cliquez sur le lien pour voir un exemple de formulaire de recherche et de sélection.
Le fichier .csv utilisé avec le formulaire se trouve ici .
Il existe une série d'options pour indiquer les lignes .csv à inclure dans la liste de choix à
l'aide de l' expression search () . Voir cet article pour plus d'informations sur ces
expressions search ().

Sélection en cascade
Beaucoup de formulaires commencent par demander l’emplacement du répondant,
chaque emplacement spécifiant les choix d’emplacement ultérieurs (par exemple, village
»État»). Au lieu d'ajouter un champ select_one pour chaque option d'emplacement,
vous pouvez utiliser la sélection en cascade. Pour utiliser les sélections en cascade,
vous devez créer une colonne choice_filter dans votre feuille de calcul d’enquête et
ajouter les colonnes attributaires d’emplacement dans la feuille de calcul de vos
choix. Découvrez un exemple XLSForm ici .

Sélections externes
Si un formulaire est sélectionné avec un grand nombre de choix (par exemple, des
centaines ou des milliers), ce formulaire peut ralentir le chargement du formulaire et la
navigation dans les clients tels que ODK Collect. La meilleure solution à ce problème
consiste à utiliser des sélections externes.
L'activation de sélections externes est simple.
 Au lieu de select_one pour le type d'invite, utilisez select_one_external .
 Au lieu de la feuille de choix , placez des choix externes dans
la feuille external_choices.
Voir formulaire select_one_external pour un exemple utilisant des choix normaux et
externes.
Quand un XLSForm avec des choix externes est converti en un XForm, deux fichiers
sont générés, le XForm (par exemple, form-filename.xml) avec tous les choix normaux
et un itemsets.csv avec les choix externes.
Le fichier itemsets.csv peut être téléchargé sur tout serveur compatible ODK (par
exemple, ODK Aggregate) en tant que fichier multimédia. Il sera téléchargé dans
n’importe quel fichier multimédia compatible avec ODK (par exemple, ODK Collect) et
enregistré dans le dossier [form-filename] -media. Des clients tels que ODK Collect
charge les fichiers multimédia chargés sur la carte SD. Ainsi, votre formulaire comportant
un grand nombre de choix se chargera désormais très rapidement.

Défaut
L'ajout d'un champ par défaut signifie qu'une question sera pré-renseignée avec une
réponse lorsque l'utilisateur verra la question pour la première fois. Cela peut aider à
gagner du temps si la réponse est celle qui est généralement sélectionnée ou peut servir
à montrer à l'utilisateur le type de choix de réponse attendu. Voir les deux exemples ci-
dessous.
type prénom étiquette défaut
aujourd'hui aujourd'hui
rendez-vous amoureux date_enquête Date du sondage? 2010-06-15
paramètres dechoix d'enquête
Dans l'exemple suivant, le poids est automatiquement réglé à 51,3 kg. Vous pouvez
simplement changer la réponse en tapant dans le champ de réponse et en entrant une
autre réponse.
type prénom étiquette défaut
décimal poids Poids du répondant? (en kg) 51,3
paramètres dechoix d'enquête

Lecture seulement
L'ajout d'un champ en lecture seule signifie qu'une question ne peut pas être
modifiée. Les champs en lecture seule peuvent être combinés avec les champs par
défaut pour renvoyer des informations à un utilisateur.
type prénom étiquette lecture seulement défaut
entier num S'il vous plaît patient est: Oui 5
paramètres dechoix d'enquête

Apparence
La colonne Apparence vous permet de modifier l'apparence des questions dans votre
formulaire. Le tableau suivant répertorie les attributs d'apparence possibles et indique
comment la question apparaît dans le formulaire.
Attribut Type de
La description
d'apparence question
Idéalement utilisé avec les clients Web, la zone de texte
multiligne texte
est composée de plusieurs lignes.
select_one, Les choix de réponse apparaissent dans un menu
minimal
select_multiple déroulant.
Pertinent pour les clients mobiles uniquement, cet attribut
rapide select_one avance automatiquement le formulaire à la question
suivante après la sélection d'une réponse.
pas de rendez-vous Pour les appareils mobiles uniquement, utilisé pour
calendrier amoureux supprimer le calendrier.
rendez-vous Sélectionnez un mois et une année uniquement pour la
mois année
amoureux date.
rendez-vous
année Sélectionnez seulement une année pour la date.
amoureux
horizontal- select_one, Pour les clients Web uniquement, cette option affiche les
compact select_multiple choix de réponse horizontalement.
Pour les clients Web uniquement, cette option affiche les
select_one,
horizontal choix de réponse horizontalement, mais sous forme de
select_multiple
colonnes.
Likert select_one Idéalement utilisé avec les clients Web, les choix de
Attribut Type de
La description
d'apparence question
réponse apparaissent sous forme d’échelle de Likert.
Affiche les choix de réponse côte à côte avec un
select_one,
compact remplissage minimal et sans boutons radio ni cases à
select_multiple
cocher.Particulièrement utile avec les choix d'image.
Identique à la précédente, mais avance automatiquement
quickcompact select_one à la question suivante (dans les clients mobiles
uniquement).
Tout un groupe de questions apparaît sur un seul écran
liste de champ groupes
(pour les clients mobiles uniquement).
select_one, Affiche les étiquettes de choix de réponse (et non les
étiquette
select_multiple entrées).
Utilisé conjointement avec l' attribut label ci-dessus,
select_one, affiche les entrées de réponse sans les étiquettes (veillez
list-nolabel
select_multiple à placer leschamps label et list-nolabel dans un groupe
avec l' attributfield-list si vous utilisez un client mobile).
Pour obtenir plus facilement le même aspect que ci-
liste de table groupes dessus, appliquez cet attribut à l’ensemble du groupe de
questions (cela pourrait ralentir un peu la forme).
Vous permet de tracer votre signature dans votre
Signature image
formulaire (clients mobiles uniquement).
Vous permet de dessiner un dessin avec votre doigt sur
dessiner image
l'écran de l'appareil mobile.
Un XLSForm avec tous les attributs d'apparence de ce tableau est disponible ici .

Fiche de paramétrage
La feuille de calcul des paramètres est facultative, mais elle vous permet de
personnaliser davantage votre formulaire, notamment en cryptant vos enregistrements
ou en définissant un thème de style global pour votre formulaire, entre autres.
Un exemple de fiche de configuration est ci-dessous:
langag
form_titl form_i Clé
submission_url e par version
e d publique
défaut
IIBIjANBg https://example.com/submissio 201702150
Exemple ex_id Anglais
… n 1
paramètres dechoix d'enquête
Les en-têtes de colonne de cet exemple de feuille de travail de configuration ont
lespropriétés suivantes:
 form_title : titre du formulaire affiché aux utilisateurs. Le titre du formulaire est extrait
de form_id si formulaire_title est vide ou manquant.
 ID_formulaire : nom utilisé pour identifier de manière unique le formulaire sur le
serveur. L'identifiant de formulaire est extrait du nom de fichier XLS si id_formulaire est
vide ou manquant.
 public_key : pour les formulaires activés pour le cryptage, il s'agit de l'endroit où la clé
publique est copiée et collée.
 submission_url : cette URL peut être utilisée pour remplacer le serveur par défaut
auquel les enregistrements finalisés sont soumis.
 default_language : Dans les formulaires localisés, définit la langue à utiliser par défaut.
 version : Chaîne de 10 chiffres au maximum décrivant cette révision. Les définitions de
formulaire révisées doivent avoir des versions numériquement plus grandes que les
précédentes. Une convention courante consiste à utiliser des chaînes de la forme
'yyyymmddrr'. Par exemple, 2017021501 est la 1ère révision du 15 février 2017.
Formulaires cryptés
Les formulaires activés pour le chiffrement fournissent un mécanisme permettant de
garder les enregistrements finalisés confidentiels à tout moment. Cela inclut le
temps après l'enregistrement définitif d'un enregistrement qu'il est stocké sur l'appareil et
sur le serveur, ainsi que pendant le transport, même lorsque http est utilisé pour la
communication. Les enregistrements cryptés, y compris leurs fichiers téléchargés, tels
que des photos, sont totalement inaccessibles à quiconque ne possédant pas la clé
privée.
Pour chiffrer les formulaires XLS, ajoutez la colonne public_key à la feuille de calcul
des paramètres et collez la clé RSA publique codée en base64 comme valeur.
form_i
Clé publique
d
mysurve IIBIjANBgklawWEserewrwesgdreewrwe32serfserfewrwerewtwer23sgfrqjwerk3423432
y …
paramètres dechoix d'enquête
Pour plus d'informations sur les formulaires cryptés et sur la génération des clés RSA,
consultez la documentation ODK et cet exemple de formulaire .
Spécifier un serveur alternatif
Il est possible de spécifier un autre serveur auquel envoyer vos soumissions dans
la colonne submission_url de la feuille de calcul des paramètres . Assurez-vous
d'utiliser l'URL complète à laquelle les soumissions doivent être envoyées, y compris le
chemin .
Si cette colonne est laissée de côté ou laissée vide, les soumissions deviendront la
destination par défaut du fournisseur que vous utilisez pour vos enquêtes.
Spécifiez le nom de soumission du formulaire
Dans la feuille de calcul des paramètres , vous pouvez spécifier un nom unique pour
chaque soumission de formulaire à l'aide des champs renseignés par l'utilisateur lors de
l'enquête. Dans la feuille de travail sur les paramètres, ajoutez une colonne
appelée nom_instance . Ecrivez dans l'expression qui définit le nom unique de
l'instance de formulaire à l'aide des champs de la feuille de calcul de l'enquête.
Découvrez cet exemple XLSForm qui calcule le nom de l'instance en tant que nom et
prénom de l'utilisateur, associé à la soumission du formulaire uuid.
Plusieurs formulaires de page Web
Les formulaires Web peuvent être divisés en plusieurs pages à l'aide des pages
de thème de style .
Un exemple de formulaire divisé en plusieurs pages est visible sur le formulaire
Web Widgets on Pages .
Dans l' onglet Paramètres , créez une colonne appelée style et définissez-la en pages ,
comme suit:
form_title form_id style
titre d'exemple exemple_id des pages
paramètres dechoix d'enquête
Dans votre onglet Enquête , regroupez les questions que vous souhaitez voir apparaître
sur chaque page, puis définissez l’apparence du groupe sur liste de champs . Voir
l'exemple ci-dessous.
type prénom étiquette apparence
type prénom étiquette apparence
commencer le groupe groupe 1 liste de champ
texte prénom Nom du répondant
entier âge Âge du répondant
chaîne adresse Adresse du répondant
groupe d'extrémité
paramètres dechoix d'enquête
Voir cet article de blog pour plus d'informations sur la création de formulaires Web de
plusieurs pages. La source XLSForm est ici .
Formes de thème de grille
Le style de grille de thèmes permet à votre formulaire d'imiter l'apparence des enquêtes
papier traditionnelles en compactant plusieurs questions en une rangée. Ce style est
mieux utilisé avec des écrans plus grands (ordinateurs ou tablettes, par exemple). Cela
fait aussi une belle impression!
Veuillez cliquer sur le lien pour voir un exemple de formulaire Web à thème Grid .
Pour créer un formulaire Grille, dans l' onglet Paramètres , sous la colonne Style ,
écrivez thème-grille , comme suit:
form_title form_id style
titre d'exemple exemple_id grille de thèmes
paramètres dechoix d'enquête
Dans l' onglet Enquête , regroupez les questions que vous souhaitez voir apparaître
dans chaque section, puis définissez l'apparence de chaque champ en fonction de la
largeur souhaitée (la largeur par défaut est 4). Voir l'exemple ci-dessous.
type prénom étiquette apparence
commencer le groupe groupe 1
texte prénom Nom du répondant w3
entier âge Âge du répondant w1
chaîne adresse Adresse du répondant w4
groupe d'extrémité
paramètres dechoix d'enquête
Voir cet article de blog pour plus d'informations sur la création de formulaires de
grille. L'exemple XLSForm du thème Grid est ici .

Invites de style
La prise en charge de Markdown dans XLSForm permet une emphase accrue grâce à
des caractères gras et italiques, des en-têtes de tailles différentes, des polices et
couleurs différentes et des liens Web cliquables dans ODK Collect 1.4.9 et Enketo.
 souligner les mots en les enveloppant à l'intérieur _ou*
 insister fortement sur les mots en les enveloppant à l'intérieur __ou**
 ajouter un lien en utilisant [name of link](url)
 ajoutez des en-têtes de tailles variées en ajoutant # (le plus grand ) à ###### (le plus
petit) au texte de l'en-tête
 Texte de style pour la couleur ou la police avec des balises span (par exemple, <span
style="color:#f58a1f">orange</span> , <span style="color:red; font-
family:cursive">rouge et cursif</span> )
 ajoutez un saut de ligne à l'endroit souhaité avec Ctrl-Entrée ou Ctrl-Alt-Entrée (la
combinaison de touches peut être différente pour certains logiciels de feuille de calcul)
 ajoutez vos emojis préférés!
 utiliser exposant avec la <sup>balise (p. ex. 100 m<sup>2</sup>se transforme en 100
m2)
 utilise l'indice avec la <sub>balise (par exemple, H<sub>2</sub>Ose transforme en H 2 O)
 utiliser le \caractère avant #, *, _et \pour prévenir les effets de style spéciaux pour être
déclenchées par ces caractères

Utilisation avancée et extensibilité


Il est possible d'utiliser XLSForm pour créer des XForm avec des fonctionnalités
personnalisées ou expérimentales. C'est idéal pour les applications personnalisées avec
une fonctionnalité spécifique qui ne convient pas à la communauté plus large.
La feuille de sondage prend en charge les préfixes de 3 colonnes ( instance :: , bind
:: , body : :) qui ajoutent des attributs à la sortie XForm, que ce soit dans l' instance
principale , la liaison ou le contrôle de formulaire . Pour en savoir plus sur XForms,
consultez la spécification ODK XForms . L'exemple ci-dessous ajoute un attribut
personnalisé «hxl» au nœud d'instance primaire d'une question.
type prénom étiquette instance :: hxl
entier population Combien de personnes présentes? #population
paramètres dechoix d'enquête
La feuille de paramètres prend en charge la définition d’espaces de noms personnalisés
supplémentaires (préfixes d'espaces de noms séparés) à l'aide de la colonne espaces
de noms (plusieurs espaces séparés) . Vous pourrez ensuite utiliser ces espaces de
noms dans la feuille d'enquête, par exemple pour définir correctement un attribut
personnalisé avec le propre espace de noms de votre organisation . Voir l'exemple ci-
dessous qui ajoute 2 espaces de nom supplémentaires et les utilise pour ajouter des
attributs personnalisés:
Titre espaces de noms
Ma forme esri = ”http://esri.com/xforms” enk = ”http://enketo.org/xforms
paramètres dechoix d'enquête

type prénom étiquette bind :: esri: fieldLength bind :: enk: for


texte desc Décrire 50
texte desc_comment commentaires $ {a}
paramètres dechoix d'enquête

Outils prenant en charge XLSForms


 Sur un
 Enketo
 Open Data Kit (ODK)
 Kobo ToolBox
 CommCare
 SurveyCTO
 DataWinners
 Kit de données sécurisé (SDK)
 Tattara

Plus de ressources
Le document standard XLSform peut vous guider à travers les types d'entrée
spécifiques, les en-têtes de colonne, etc., qui constituent une syntaxe légitime dans
XLSForms. Si vous souhaitez approfondir pour comprendre XForms et aller au-delà de
XLSForms, voici quelques ressources pour les comprendre:
 Instructions de
formulaire: http://code.google.com/p/opendatakit/wiki/XFormDesignGuidelines
 Didacticiel sur la conception de
formulaire: https://bitbucket.org/javarosa/javarosa/wiki/buildxforms
 Exemples de
formulaires: http://code.google.com/p/opendatakit/source/browse/?repo=forms
 Université Formhub
 Ona Form Gallery
 XForms supportés par JavaRosa: https://bitbucket.org/javarosa/javarosa/wiki/xform-jr-
compat

A propos de ce site
XLSForm.org est un projet soutenu par la communauté qui vise à créer un point de
référence commun pour le standard XLSForm.
Si vous souhaitez contribuer ou améliorer cette documentation, veuillez visiter le dépôt
GitHub de notre projet .

L'histoire
Le XLSForm a été développé à l'origine par Andrew Marder et Alex Dorey
du Sustainable Engineering Lab de l'Université Columbia . Lorsque XLSForms a été
adopté par la communauté ODK, SEL a travaillé avec l’équipe ODK de l’Université de
Washington pour développer les spécifications actuelles. PyXForm , la bibliothèque
utilisée pour convertir XLSForms en XForms, est un projet open source pris en charge
par les membres d'ODK, SEL, Ona, SurveyCTO et Kobo.

http://xlsform.org/en/ : l’original en Anglais