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.
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.
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. Vous pouvez omettre les colonnes facultatives et 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 vont apparaître dans le formulaire. Chaque ligne correspond généralement à une question. Vous pouvez toutefois ajouter au formulaire d’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 name (nom) détermine le nom du champ dans la couche d’entités dans laquelle les réponses à la question sont stockées. Aucun espace ni caractère spécial n’est autorisé dans cette colonne. Les noms doivent être uniques pour toutes les questions de chaque couche.
- 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.
Pour une vue d'ensemble des colonnes de la feuille de calcul d’enquête, reportez-vous à la rubrique Colonnes de feuille de calcul d’enquête.
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. Il n’est pas recommandé d’inclure des noms de choix dupliqués dans une liste de choix. Pour plus d’informations sur les noms de choix en double, reportez-vous à la rubrique Questions à choix multiples.
- 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. Par exemple, pour collecter le nom et la localisation d’un magasin, écrivez le code suivant :
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. Pour plus d’informations relatives aux types de champs, reportez-vous à la rubrique Colonnes personnalisées Esri.
| Type de question | Réponse saisie | Type de champ par défaut |
|---|---|---|
| integer | Saisie de nombre entier. | esriFieldTypeInteger |
| decimal | Saisie de nombre décimal. | esriFieldTypeDouble |
| range | Saisie d’une plage de nombres. | esriFieldTypeInteger |
| text | Réponse sous forme de texte libre. | esriFieldTypeString |
| select_one list_name | Question à choix multiples pour laquelle l’utilisateur ne peut sélectionner qu’une seule réponse. Remplace list_name par le nom de votre liste de choix. Vous pouvez changer de type de champ. Toutefois, le nom de choix est toujours traité comme une chaîne dans l’application de terrain lorsqu’il est utilisé dans des expressions. | esriFieldTypeString |
| select_multiple list_name | Question à choix multiples pour laquelle l’utilisateur peut sélectionner plusieurs réponses. Remplace list_name par le nom de votre liste de choix. Vous ne pouvez pas changer de type de champ. Le nom de choix est toujours traité comme une chaîne dans l’application de terrain 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. Vous ne pouvez pas changer de type de champ. Le nom de choix est toujours traité comme une chaîne dans l’application de terrain 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. Vous ne pouvez pas changer de type de champ. | esriFieldTypeGeometry |
| geotrace | Collecte une ligne sur une carte. Vous ne pouvez pas changer de type de champ. | esriFieldTypeGeometry |
| geoshape | Collecte un polygone sur une carte. Vous ne pouvez pas changer de type de champ. | esriFieldTypeGeometry |
| date | Saisie de date. | esriFieldTypeDate |
| time | 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 |
| username¹ | Lorsque vous êtes connecté à ArcGIS Online ou à ArcGIS Enterprise, ce champ est renseigné automatiquement avec le nom d’utilisateur du compte. Ce type de question est caché et ne s’affiche pas dans le formulaire. | esriFieldTypeString |
| email¹ | 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 |
| hidden | 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 | Scanne un code à barres. | esriFieldTypeString |
| start | Date et heure de début de l’enquête. | esriFieldTypeDate |
| end | 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 |
| file | Chargez un fichier sur l’appareil. | Pièce jointe |
¹Une option plus souple consiste à utiliser la fonction pulldata("@property") pour récupérer des valeurs. Consultez Propriétés concernant l’appareil et l’utilisateur.
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 Survey123 et l’application Web.
Métadonnées
XLSForm offre les options de types de données suivantes pour la collecte de métadonnées :
| Type de métadonnées | Description |
|---|---|
| start | Date et heure de début de l’enquête. |
| end | Date et heure de fin de l’enquête. |
| username | Enregistre le nom de l’utilisateur actuellement connecté à ArcGIS Online ou à ArcGIS Enterprise. Ce type de données n’admet aucune saisie. |
| 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 :
Les entrées de métadonnées décrites ci-dessus sont automatiquement capturées par ArcGIS Survey123. Elles ne sont 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 :
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.
Texte de l'espace réservé
Vous pouvez également fournir le texte de l’espace réservé pour les questions qui acceptent une saisie (texte, entier, questions décimales et questions à choix unique avec apparence autocomplete) en définissant le paramètre placeholderText dans la colonne body::esri:style. Avec placeholderText=@[hint] ou placeholderText=@[guidance_hint], l’astuce ou le conseil est masqué et l’astuce textuelle apparaît à la place à l’intérieur de la zone de saisie de la question. Le texte de l’espace réservé s’affiche dans la zone de saisie si la question est vide.
Remarque :
Les astuces ne sont pas compatibles avec les questions begin repeat et begin group.
Survey123 ne prend pas en charge le texte de l’espace réservé.
Mettre à jour le modèle
L’option Advanced Template (Modèle avancé) inclut toutes les entités XLSForm prises en charge dans Survey123 et est disponible dans la boîte de dialogue New Survey (Nouvelle enquête) dans Survey123 Connect. Ce modèle est mis à jour régulièrement pour ajouter de nouvelles fonctionnalités et améliorer l’expérience de création d’enquête. Vous pouvez continuer d’utiliser les versions précédentes du modèle sans problème, mais il peut être judicieux de mettre à jour vos enquêtes existantes avec le modèle XLSForm le plus récent pour bénéficier des dernières améliorations.
L’outil Mettre à jour le modèle XLSForm met à jour le modèle XLSForm existant vers la dernière version du modèle avancé. Pour ce faire, il copie le contenu des feuilles de calcul survey (enquête), choices (choix) et settings (paramètres) dans les colonnes et sur les lignes respectives dans le nouveau modèle. Les colonnes que vous avez ajoutées sont également copiées dans le nouveau modèle, ainsi que la feuille de calcul external_choices (choix_externes) si vous utilisez des sélections externes.
Pour pouvoir exécuter l’outil, vous devez configurer un environnement Python dans Survey123 Connect. Pour plus d'informations, reportez-vous à la rubrique Configurer Python.
Dans Survey123 Connect, ouvrez l’enquête à mettre à jour. Cliquez sur Tools (Outils), puis sur Mettre à jour le modèle XLSForm. Une boîte de dialogue affiche des messages au fur et à mesure de l’exécution de l’outil. Une fois le processus terminé, le fichier .xlsx qui se trouve dans le dossier de l’enquête est mis à jour vers le modèle le plus récent et l’aperçu du formulaire dans Survey123 Connect est rechargé. Si une erreur survient lors de l’exécution de l’outil, le modèle XLSForm existant est conservé.
Remarque :
Le modèle XLSForm de l’enquête doit être un fichier .xlsx. L’outil Mettre à jour le modèle XLSForm ne fonctionne pas avec les fichiers .xls.
Il est recommandé de vérifier que les colonnes, la validation des données, la mise en forme des cellules et les styles de police du modèle XLSForm d’origine existent dans le modèle XLSForm mis à jour. L’outil crée une sauvegarde du modèle XLSForm existant et un fichier journal dans C:\Users\<username>\ArcGIS\My Survey Designs\<surveyName>\debug\template_updater. Pour restaurer une enquête à partir d’une sauvegarde, copiez le fichier .xlsx depuis le dossier template_updater dans le dossier racine de l’enquête. Supprimez le modèle XLSForm existant et renommez la sauvegarde de sorte que son nom corresponde au nom d’origine.
Remarque :
La couleur de remplissage de la cellule dans la première colonne de chaque ligne est appliquée à l’ensemble de la ligne dans le modèle mis à jour.
Pour les enquêtes multilingues, les colonnes de langues par défaut, telles que label::language (xx) et hint::language (xx), sont exclues du modèle mis à jour.
Vous avez un commentaire à formuler concernant cette rubrique ?