Référence rapide

ArcGIS Survey123 prend en charge une grande partie de la spécification XLSForm. Ce guide de référence présente un récapitulatif des entités XLSForm que vous pouvez utiliser dans Survey123. Les enquêtes peuvent être créées à l’aide de Survey123 Connect ou du site Web Survey123. Certaines entités sont uniquement disponibles dans l’un ou l’autre, et certaines dans les deux.

Types de questions

Le tableau suivant décrit les types de questions disponibles dans Survey123 Connect, l’application de terrain Survey123, le concepteur Web Survey123 et l’application Web Survey123. Pour certaines questions, il existe des différences en matière de comportement et de mise en œuvre sur les plateformes ; consultez les notes figurant sous le tableau pour en savoir plus.

Type de question Survey123 Connect	Type de question du concepteur Web Survey123	Description	Pris en charge dans l’application de terrain Survey123	Pris en charge dans l’application Web Survey123
audio⁴	Audio⁴ ⁶	Enregistre un clip audio dans l’application de terrain. Enregistre un clip audio ou accepte un fichier audio téléchargé dans l’application Web.	Oui	Oui
barcode	Code à barres	Numérise un code à barres ou un QR Code.	Oui	Oui
begin group	Groupe, page	Commence un groupe de questions.	Oui	Oui
begin repeat	N/D	Commence un ensemble de questions répétées.	Oui	Oui
calculate	N/D	Effectue un calcul sur les valeurs contenues dans le formulaire. Le champ de calcul contient le résultat du calcul.	Oui	Oui
decimal¹	Nombre¹ ⁶	Saisie de nombre décimal.	Oui	Oui
date	Date⁶	Saisie de date.	Oui	Oui
dateTime	Date et heure⁶	Saisie de date et heure.	Oui	Oui
deviceid	N/D	UUID représentant l’appareil spécifique sur lequel l’enquête a été exécutée.	Oui	Non
e-mail²	N/D	Lorsque vous êtes connecté avec un compte d’organisation, cette question est renseignée automatiquement avec l’adresse e-mail de l'utilisateur du compte.	Oui	Oui
à la fin	N/D	Date et heure de fin de l’enquête.	Oui	Oui
end group	Groupe, page	Termine un groupe de questions.	Oui	Oui
end repeat	N/D	Termine un ensemble de questions répétées.	Oui	Oui
fichier	Téléchargement de fichiers	Accepte un fichier sur l’appareil.	Oui	Oui
geopoint³	Carte³ ⁶	Recueille des coordonnées GPS. Prend par défaut la valeur de la localisation actuelle.	Oui	Oui
geoshape³		Collecte un polygone sur une carte.	Oui	Oui
geotrace³		Collecte une ligne sur une carte.	Oui	Oui
masqué	N/D	Crée un champ dans votre couche d’entités qui ne s’affiche pas dans le formulaire. Utilisez les colonnes bind::esri:fieldType et bind::esri:fieldLength pour préciser le schéma de date pour ce champ.	Oui	Oui
integer¹	Nombre¹ ⁶	Saisie de nombre entier.	Oui	Oui
image	Image, signature	Accepte une image issue de fichiers d’un appareil ou d’une photo prise directement.	Oui	Oui
note	Remarque⁶	Affiche du texte à l’écran. Permet aussi de gérer des calculs masqués.	Oui	Oui
plage	Curseur⁶	Saisie d’une plage de nombres.	Oui	Oui
rank list_name	Classement⁶	Question de type Classement ; classe une liste de choix. Remplacez list_name par le nom de votre liste de choix.	Oui	Oui
select_one list_name	Menu déroulant⁵ ⁶, Échelle de Likert⁵ ⁶, Évaluation⁶, Sélection unique⁶, Grille à sélection unique⁶	Question à choix multiples ; une seule réponse peut être sélectionnée. Remplacez list_name par le nom de votre liste de choix.	Oui	Oui
select_one_from_file file_name.csv	N/D	Question à choix multiples ; une seule réponse peut être sélectionnée. Remplacez file_name.csv par le nom du fichier situé dans le dossier media de l’enquête qui contient la liste des choix.	Oui	Oui
select_multiple list_name	Sélection multiple⁶	Question à choix multiples ; plusieurs réponses peuvent être sélectionnées. Remplacez list_name par le nom de votre liste de choix.	Oui	Oui
select_multiple_from_file file_name.csv	N/D	Question à choix multiples ; plusieurs réponses peuvent être sélectionnées. Remplacez file_name.csv par le nom du fichier situé dans le dossier media de l’enquête qui contient la liste des choix.	Oui	Oui
start	N/D	Date et heure de début de l’enquête.	Oui	Oui
Texte	Adresse⁶, Courrier électronique⁶, Texte multiligne⁵ ⁶, Texte uniligne⁶, Site Web⁶	Réponse sous forme de texte libre. Une expression régulière est appliquée pour les courriers électroniques et les sites Web. L’apparence de type geocode s’applique à une adresse.	Oui	Oui
heure	Heure⁶	Saisie d’heure.	Oui	Oui
nom d’utilisateur	N/D	Lorsque vous êtes connecté avec un compte d’organisation, cette question est renseignée automatiquement avec le nom d'utilisateur du compte.	Oui	Oui

¹Le concepteur Web combine les questions comportant des nombres entiers et décimaux en un seul type de question nommé Nombre. Une case à cocher dans les propriétés de la question permet au concepteur de l’enquête de définir le type d’entrée requis.

²Les questions de type courrier électronique dans Survey123 Connect et dans le concepteur Web Survey123 sont mises en œuvre différemment. L’implémentation dans Survey123 Connect renseigne automatiquement l’adresse électronique du compte d’organisation auquel l’utilisateur est connecté. L’implémentation dans le concepteur Web Survey123 est un champ de texte autorisant uniquement un format correspondant à une adresse électronique.

Les questions de type geopoint, geotrace et geoshape ont été fusionnées en un seul type de question nommé Carte. Une case à cocher dans les propriétés de la question permet au concepteur de l’enquête de définir le type d’entrée requis. Un type de question supplémentaire nommé Adresse autorise l’envoi de points géocodés.

⁴Les questions audio ne peuvent pas être téléchargées dans l’application de terrain Survey123, comme c’est le cas dans l’application Web. Pour pouvoir télécharger une question audio dans l’application de terrain, utilisez une question de type fichier.

⁵Plusieurs apparences disponibles dans Survey123 Connect ne sont disponibles que sous la forme de types de questions distinctes dans le concepteur Web Survey123. Cela inclut Texte multiligne, Menu déroulant et Échelle de Likert.

⁶Pour chaque question, le concepteur Web fournit une option permettant de mettre en cache la réponse. Dans l’application Web , après l’envoi d’un enregistrement d’enquête, la réponse à la question est mise en cache dans le navigateur et est préchargée lors de la soumission suivante effectuée pour cette enquête sur le même appareil. La mise en cache d’une réponse peut être définie pour tous les types de questions à l’exception des types Audio, Image, Téléchargement de fichiers et Signature.

Valeurs par défaut

La plupart des types de question permettent de définir une réponse par défaut qui sera renseignée automatiquement lors du chargement de l’enquête. La finalité est la même que celle de la colonne valeur par défaut dans XLSForm.

Validation des données

Activer la case à cocher Il s'agit d'une question obligatoire dans l’onglet Edit fait en sorte que la question de l’enquête requière que la question contienne une valeur pour que le formulaire puisse être renseigné.

La plupart des questions permettent également de définir une longueur minimale et une longueur maximale. Cela empêche l’envoi de l’enquête si la réponse à la question dépasse les limites définies. Cette fonction possède le même rôle que la colonne constraint ou bind::esri:fieldLength dans la spécification XLSForm de Survey123.

Caractères spéciaux

Les noms de question et de choix ne doivent pas contenir de caractères spéciaux, comme des espaces, virgules, traits d’union, parenthèses, crochets ou caractères tels que $, % et #. Il est important que les noms de choix des questions de type Multiple select (Sélection multiple) ne contiennent pas d’espace ou de virgule.