Notions élémentaires concernant XLSForm

XLSForm est une norme ouverte qui simplifie la création de formulaires. La création s’effectue dans un format intelligible avec une feuille de calcul. Pour plus d’informations sur XLSForm, consultez le site https://xlsform.org/. Survey123 prend en charge la plupart des entités (mais pas toutes) de la norme XLSForm.

De nombreuses options permettent de créer des feuilles de calcul conformes à la spécification XLSForm. Microsoft Excel est le plus souvent utilisé. Toutefois, d’autres options comme Kingsoft Spreadsheets, Google Sheets et OpenOffice Calc sont disponibles. Certains générateurs XForms en ligne exportent des feuilles de calcul XLSForm que vous pouvez utiliser avec ArcGIS Survey123.

Pour vous aider à créer vos formulaires, ArcGIS Survey123 inclut l’outil bureautique Survey123 Connect qui fonctionne avec votre outil de création XLSForm pour vous permettre de créer des fichiers XLS. Survey123 Connect Vous permet d’afficher un aperçu de vos fichiers XLSForm au fur et à mesure que vous les créez ou les mettez à jour, de publier vos formulaires sur ArcGIS Online et ArcGIS Enterprise, et de créer des couches d’entités basées sur votre spécification de formulaire en vue de la collecte de données. ArcGIS Survey123 Connect est disponible pour Windows, macOS et Ubuntu.

Une fois vos formulaires publiés sur ArcGIS, vous pouvez utiliser le site Web Survey123 pour partager vos formulaires avec les membres de vos organisations ArcGIS. Vous pouvez également analyser les cartes et les tables correspondant à toutes les données recueillies via l’application de terrain Survey123 et exporter les résultats de votre enquête. Si vous débutez avec le processus entre Survey123 Connect et le site Web, consultez ces didacticiels vidéo.

Pour les besoins de cette rubrique, nous supposons que vous utilisez ArcGIS Survey123 Connect et Microsoft Excel pour créer vos formulaires.

Chaque classeur Excel contient généralement deux feuilles de calcul : survey (enquête) et choices (choix). Une troisième feuille de calcul, paramètres, est également décrite ci-dessous. Les feuilles de calcul comprennent un ensemble de colonnes obligatoires qui doivent être présentes pour que le formulaire fonctionne. En outre, chaque feuille de calcul contient un ensemble de colonnes facultatives qui permettent de mieux contrôler le comportement de chaque entrée du formulaire. Chaque entrée doit contenir des valeurs pour chacune des colonnes obligatoires, mais les colonnes facultatives peuvent être laissées vides. 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 omises. Vous pouvez laisser plusieurs lignes vierges. Toute mise en forme de fichier .xls est ignorée, de telle sorte que vous pouvez utiliser des lignes de séparation, des ombres, et autres formatages des polices pour que le formulaire soit plus lisible.

Feuille de calcul d’enquête

Cette feuille de calcul donne à votre formulaire sa structure globale. Elle contient la liste complète des questions et informations et la façon dont elles doivent apparaître dans le formulaire. Chaque ligne correspond généralement à une question. Vous pouvez toutefois ajouter au formulaire certaines autres fonctions décrites ci-après afin d’améliorer l’expérience utilisateur.

La feuille de calcul d’enquête contient trois colonnes obligatoires : type, nom, et étiquette ou astuce.

  • La colonne type spécifie le type de question XLSForm que vous ajoutez. Il existe une liste de types de questions possibles bien définie pour cette colonne.
  • La colonne nom détermine le nom de la colonne de la couche d’entités ArcGIS dans laquelle la réponse à la question sera stockée. Aucun espace ni caractère spécial n’est autorisé dans cette colonne. Aucune ligne ne peut avoir le même contenu qu’une autre.
  • Les colonnes étiquette et astuce contiennent le texte de vos questions. Il s’agit du texte que vous verrez dans le formulaire. Une question requiert au moins une étiquette ou une astuce. Il est conseillés de fournir une étiquette pour éviter les messages d’avertissement. Les espaces et les caractères spéciaux sont autorisés dans ces colonnes. Vous pouvez également utiliser des colonnes de traduction. En outre, les étiquettes et les astuces prennent en charge un nombre limité de variables et de code HTML qui, dans votre enquête, seront remplacés par la réponse donnée à une autre question. Pour plus d’informations, reportez-vous à la rubrique Notes.

Feuille de calcul de choix

Cette feuille de calcul permet de préciser les choix de réponses pour les questions à choix multiples. Chaque ligne représente un choix de réponse. Les choix de réponses portant le même nom de liste sont considérés comme faisant partie d’un ensemble de choix associés et apparaissent ensemble pour une question. Cela permet également de réutiliser un ensemble de choix pour plusieurs questions (par exemple, questions oui ou non).

La feuille de calcul de choix contient trois colonnes obligatoires : nom de la liste, nom et étiquette.

  • La colonne de nom de la liste permet de regrouper un ensemble de choix de réponses associées. Les choix portant le même nom de liste sont présentés comme l’ensemble de réponses à une question.
  • La colonne de nom précise la valeur qui est conservée dans ArcGIS. Les valeurs contenues dans la colonne de nom n’acceptent pas de caractères spéciaux.
  • La colonne d’étiquette présente les choix de réponses exactement comme vous souhaitez les voir apparaître dans le formulaire. Vous pouvez également utiliser des colonnes de traduction d’étiquette.

Lorsque vous créez des formulaires dans Excel, la syntaxe utilisée doit être précise. Par exemple, si vous écrivez Choix au lieu de choix, le formulaire ne fonctionnera pas.

Feuille de calcul de paramètres

La feuille de calcul de paramètres est facultative et vous permet de personnaliser votre formulaire. La personnalisation disponible comprend un titre qui s’affiche pendant que le formulaire est en cours de modification, un nom d’instance pour identifier de manière unique chaque formulaire complété, un identifiant de version unique pour votre enquête, entre autres. Pour plus d'informations, reportez-vous à la rubrique Paramètres.

Feuilles de calcul complémentaires

Les modèles Survey123 comprennent des feuilles de calcul qui comportent les propriétés, opérateurs et fonctions que vous pouvez utiliser dans votre formulaire. Ces feuilles de calcul permettent également de renseigner les listes déroulantes et d’autres règles de validation des données dans les feuilles de calcul enquête et paramètres. Pour assurer le bon fonctionnement de la validation des données, il est conseillé de ne pas modifier le contenu des feuilles de calcul supplémentaires.

Types de questions

XLSForm prend en charge un certain nombre de types de questions. Le tableau ci-dessous répertorie les questions que vous pouvez saisir dans la colonne de type de votre XLSForm, l’entrée qui est acceptée pour la question et le type de champ créé dans la couche d’entités ArcGIS associée correspondant à cette question lors de la publication du formulaire. L’auteur de l’enquête peut modifier le type de champ de nombreux types de questions. Les types de questions dont le type de champ ne peut pas être modifié sont identifiés dans le tableau ci-dessous. Pour plus d’informations relatives aux types de champs, reportez-vous à la rubrique Colonnes personnalisées Esri.

Type de questionRéponse saisieType de champ par défaut

entier

Saisie de nombre entier.

esriFieldTypeInteger

decimal

Saisie de nombre décimal.

esriFieldTypeDouble

plage

Saisie d’une plage de nombres.

esriFieldTypeInteger

Texte

Réponse sous forme de texte libre.

esriFieldTypeString

select_one list_name

Question à choix multiples ; une seule réponse peut être sélectionnée. Remplace list_name par le nom de votre liste de choix. Le type de champ peut être modifié. Toutefois, le nom de choix est toujours traité comme une chaîne dans l’application de champ lorsqu’il est utilisé dans des expressions.

esriFieldTypeString

select_multiple list_name

Question à choix multiples ; plusieurs réponses peuvent être sélectionnées. Remplace list_name par le nom de votre liste de choix. Le type de champ ne peut pas être modifié, et le nom de choix est toujours traité comme une chaîne dans l’application de champ lorsqu’il est utilisé dans des expressions.

esriFieldTypeString

rank list_name

Question de type Classement ; classe une liste de choix. Remplace list_name par le nom de votre liste de choix. Le type de champ ne peut pas être modifié, et le nom de choix est toujours traité comme une chaîne dans l’application de champ lorsqu’il est utilisé dans des expressions.

esriFieldTypeString

note

Affiche une note à l’écran ; n’accepte pas de saisie. Permet aussi d’afficher des calculs masqués.

esriFieldTypeString

geopoint

Recueille des coordonnées GPS uniques. Le type de champ ne peut pas être modifié.

esriFieldTypeGeometry

géotrace

Collecte une ligne sur une carte. Le type de champ ne peut pas être modifié.

esriFieldTypeGeometry

géoforme

Collecte un polygone sur une carte. Le type de champ ne peut pas être modifié.

esriFieldTypeGeometry

date

Saisie de date.

esriFieldTypeDate

heure

Saisie d’heure.

esriFieldTypeString

dateTime

Accepte une saisie de date et d’heure.

esriFieldTypeDate

image

Prend une photo.

Pièce jointe

begin group

Commence un groupe de questions.

Sans objet

end group

Termine un groupe de questions.

Sans objet

begin repeat

Commence un ensemble de questions répétées.

Sans objet

end repeat

Termine un ensemble de questions répétées.

Sans objet

calculate

Effectue un calcul sur les valeurs contenues dans le formulaire. Ce type de question est caché et ne s’affiche pas dans le formulaire.

esriFieldTypeString

nom d’utilisateur

Lorsque vous êtes connecté à ArcGIS Online ou à ArcGIS Enterprise, ce champ est rempli automatiquement avec le nom de l’utilisateur du compte. Ce type de question est caché et ne s’affiche pas dans le formulaire.

esriFieldTypeString

adresse électronique

Lorsque vous êtes connecté à ArcGIS Online ou à ArcGIS Enterprise, ce champ est renseigné automatiquement avec l’adresse électronique du compte. Ce type de question est caché et ne s’affiche pas dans le formulaire.

esriFieldTypeString

masqué

Champ qui ne s’affiche pas à l’écran. Utilisez les colonnes bind::esri:fieldType et bind::esri:fieldLength pour préciser la structure des données.

esriFieldTypeString

barcode

Scannez un code à barres.

esriFieldTypeString

start

Date et heure de début de l’enquête.

esriFieldTypeDate

à la fin

Date et heure de fin de l’enquête.

esriFieldTypeDate

deviceid

ID unique généré par Survey123 représentant l’appareil spécifique sur lequel l’enquête a été exécutée. Cet ID est différent de l’IMEI (identité internationale d’équipement mobile) d’un appareil mobile car Survey123 s’exécute sur des appareils susceptibles de ne pas avoir d’IMEI.

esriFieldTypeString

audio

Enregistrez un échantillon audio.

Pièce jointe

fichier

Chargez un fichier sur l’appareil.

Pièce jointe

Par exemple, pour recueillir le nom et les coordonnées GPS d’un magasin, écrivez le code suivant :

Questions de type texte et géopoint dans un formulaire

Le formulaire exemple Question Types (Types de questions) comprend tous les types de questions pris en charge par ArcGIS Survey123. Vous pouvez également vous reporter à la référence rapide pour savoir comment ces types de questions sont représentés dans le concepteur Web et l’application Web Survey123.

Question à choix multiples

XLSForm prend en charge les questions de type select_one (ne sélectionner qu’une seule réponse), select_multiple (sélectioner plusieurs réponses) et rank (classer une liste de choix). La création d’une question à choix multiples nécessite d’ajouter une feuille de calcul choices (choix) à votre classeur Excel. Voici un exemple de question select_one :

Question à choix unique dans un formulaire
Propositions uniques dans un formulaire

Notez que la réponse yes_no (oui_non) dans la feuille de calcul de l’enquête doit correspondre à yes_no (oui_non) dans la colonne de nom de liste de la feuille de calcul de choix. Cela permet de s’assurer que le formulaire affiche la liste correcte des choix de réponses pour une question donnée.

Lorsque vous publiez vos enquêtes dans ArcGIS avec Survey123 Connect, les choix des questions de type select_one (ne sélectionner qu’une seule réponse) sont convertis en domaines de géodatabase pour votre couche d’entités ArcGIS.

Vous pouvez également ajouter des questions à choix multiples qui permettent de sélectionner plusieurs réponses, par exemple :

Questions à choix multiples dans un formulaire
Propositions multiples dans un formulaire

Par défaut, ces choix apparaissent dans l’ordre indiqué dans la feuille de calcul de choix. Vous pouvez présenter l’ordre d’apparition des choix de manière aléatoire en saisissant randomize=true dans la colonne des paramètres.

Attention :

Toutes les valeurs recueillies dans une question select_multiple (choix multiples) ou rank (classement) sont enregistrées sous forme de liste séparée par des virgules, de façon à éviter l’utilisation de virgules dans la colonne de nom de votre liste de choix. Notez également que les questions select_multiple (choix multiples) et rank (classement) n’envoient que le nom du choix à la couche d’entités, tandis que les questions select_one (choix unique) transmettent le nom et l’étiquette.

La valeur d’une question de type rank (classement) n’est pas renseignée tant que l’utilisateur n’a pas modifié l’ordre des choix. Si une valeur par défaut a été définie, l’ordre par défaut est appliqué sauf si l’utilisateur modifie l’ordre des choix.

Il est possible de renvoyer une réponse individuelle à une question de type select_multiple (choix multiples) à l’aide de la fonction selected-at. La fonction suivante renvoie la valeur de nom de la première réponse donnée à une question select_multiple (choix multiples) :

selected-at(${species}, 0)

La fonction jr:choice-name permet d’envoyer l’étiquette d’une réponse. Pour obtenir la valeur d’étiquette de la deuxième réponse donnée à la même question select_multiple (choix multiples), utilisez ce qui suit :

jr:choice-name(selected-at(${species}, 1), '${species}')

Préciser d’autres choix

Pour les questions à choix multiples, les enquêtes comprennent souvent l’option de choix différente lorsqu’un choix de réponse n’est pas répertorié. Puis le sondé est généralement invité à préciser l’autre option. Cela est possible dans XLSForm, en ajoutant or_other après le nom de la liste de choix dans la feuille de calcul de l’enquête. La feuille de calcul de choix reste identique. Consultez l'exemple ci-dessous :

Question à choix multiples ou autre question dans un formulaire

Listes de choix externes

Les listes de choix correspondant aux questions de type select_one (choix unique) et select_multiple (choix multiples) peuvent être enregistrées dans un fichier CSV externe. Il s’agit d’une possibilité idéale pour les listes de choix volumineuses, ainsi que pour les listes de choix gérées hors de Survey123. Le fichier CSV doit contenir des colonnes de nom et d’étiquette. Vous pouvez inclure un fichier CSV de deux manières : en plaçant manuellement le fichier dans le dossier media de l’enquête ou en créant un lien vers un fichier CSV hébergé dans ArcGIS.

Pour inclure une question avec une liste de choix externes, entrez le type de question (select_one_from_file ou select_multiple_from_file) suivi du nom du fichier CSV, par exemple, select_one_from_file CoverType.csv. Les noms de fichier CSV sont sensibles à la casse et n’acceptent pas les espaces.

Remarque :

Si vous placez manuellement le fichier CSV dans le dossier media de l’enquête et que chargez ultérieurement un fichier CSV du même nom dans ArcGIS puis que vous le liez à l’enquête, le fichier CSV de l’enquête est mis à jour avec le contenu lié (s’il est plus récent).

Pour lier un fichier CSV à un enquête, procédez comme suit :

  • Assurez-vous que le fichier CSV est hébergé dans ArcGIS Online ou dans ArcGIS Enterprise et qu’il possède les mêmes autorisations de partage que l’enquête.
  • Vérifiez que l’enquête est publiée sur ArcGIS avant d’essayer de lier le contenu.
  • Dans Survey123 Connect, accédez à l’onglet Linked Content (Contenus liés) de l’enquête et cliquez sur le bouton Link content (Lier du contenu). Sélectionnez CSV, accédez au fichier CSV à lier et sélectionnez-le.

Pour afficher la liste externe dans Survey123 Connect, sur l’onglet Linked Content (Contenus liés), vous pouvez choisir de télécharger le fichier à l’aide du bouton de téléchargement télécharger. Une copie du fichier CSV est alors placée dans le dossier media de l’enquête. Les fichiers liés sont automatiquement téléchargés avec l’enquête dans l’application de terrain Survey123.

Les listes de choix externes ne doivent pas être confondues avec les sélections externes, dans lesquelles les choix doivent être répertoriés dans une feuille de calcul supplémentaire.

Métadonnées

XLSForm offre les options de types de données suivantes pour la collecte de métadonnées :

Type de métadonnéesDescription

start

Date et heure de début de l’enquête.

à la fin

Date et heure de fin de l’enquête.

nom d’utilisateur

Enregistre le nom de l’utilisateur actuellement connecté à ArcGIS Online ou à ArcGIS Enterprise. Ce type de données n’admet aucune saisie.

adresse électronique

Enregistre l’adresse électronique de l’utilisateur actuellement connecté à ArcGIS Online ou à ArcGIS Enterprise. Ce type de données n’admet aucune saisie.

deviceid

ID unique généré par Survey123 représentant l’appareil spécifique sur lequel l’enquête a été exécutée. Cet ID est différent de l’IMEI (identité internationale d’équipement mobile) d’un appareil mobile car Survey123 s’exécute sur des appareils susceptibles de ne pas avoir d’IMEI.

Remarque :

Ces éléments de métadonnées XLSForm ne sont pas pris en charge : subscriberid, simserial et phonenumber.

Pour recueillir toutes ces métadonnées, ajoutez les éléments suivants au début de votre enquête :

Questions de type métadonnées dans un formulaire

Les entrées de métadonnées décrites ci-dessus sont automatiquement capturées par ArcGIS Survey123. Elles ne seront pas représentées sous la forme de questions dans le formulaire, mais vous verrez les valeurs une fois l’enquête envoyée.

Lorsque vous ajoutez le type start (début) ou end (fin), ArcGIS Survey123 active automatiquement le temps de la couche d’entités pour votre enquête. Ainsi, vous pouvez filtrer le contenu de votre enquête selon la date à laquelle les données ont été envoyées. L’ajout d’entrées de début et de fin est également utile lorsque vous souhaitez connaître exactement le laps de temps écoulé entre le moment où le formulaire a été ouvert et celui où il a été signalé comme terminé.

Astuces

Vous pouvez ajouter une astuce à votre formulaire, pour préciser à l’utilisateur comment répondre à la question, sans pour autant que cette astuce fasse partie de la question. Vous pouvez ajouter des astuces aux questions dans XLSForm. Il suffit d’ajouter une colonne d’astuce et d’indiquer un message. Consultez l'exemple ci-dessous :

Astuces à propos des questions dans un formulaire

Vous pouvez également ajouter des conseils à une question à l’aide de la colonne guidance_hint. Les conseils donnent davantage d’indications à l’utilisateur sur la manière de répondre à une question ; ils sont masqués sauf si l’utilisateur clique sur le bouton des conseils situé en regard de l’astuce. Les conseils peuvent être utilisés uniquement s’il existe déjà une astuce pour la question.

Question comportant à la fois une astuce et un conseil
Remarque :

Les astuces ne sont pas compatibles avec les questions begin repeat et begin group. Les conseils ne sont pas pris en charge dans l’application Web Survey123.