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

Type de question Survey123 ConnectType de question du concepteur Web Survey123DescriptionPris en charge dans l’application de terrain Survey123Pris en charge dans l’application Web Survey123

entier

Nombre

Saisie de nombre entier.

Oui

Oui

decimal

Saisie de nombre décimal.

Oui

Oui

plage

N/D

Saisie d’une plage de nombres.

Oui

Non

Texte

Texte uniligne, texte multiligne, courrier électronique, site Web, adresse

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

select_one list_name

Choix unique, grille à choix unique, liste déroulante, échelle de Likert, évaluation

Question à choix multiples ; une seule réponse peut être sélectionnée. Remplace list_name par le nom de votre liste de choix.

Oui

Oui

select_multiple list_name

Choix multiples

Question à choix multiples ; plusieurs réponses peuvent être sélectionnées. Remplace list_name par le nom de votre liste de choix.

Oui

Oui

rank list_name

Classement

Question de type Classement ; classe une liste de choix. Remplace list_name par le nom de votre liste de choix.

Oui

Oui

note

Remarque

Affiche du texte à l’écran. Permet aussi de gérer des calculs masqués.

Oui

Oui

geopoint

Carte

Recueille des coordonnées GPS. Prend par défaut la valeur de l’emplacement actuel.

Oui

Oui

géotrace

Collecte une ligne sur une carte.

Oui

Oui

géoforme

Collecte un polygone sur une carte.

Oui

Oui

date

Date

Saisie de date.

Oui

Oui

heure

Durée

Saisie d’heure.

Oui

Oui

dateTime

Date et heure

Saisie de date et heure.

Oui

Oui

image

Image, signature

Accepte une image issue de fichiers d’un appareil ou d’une photo prise directement.

Oui

Oui

begin group

Groupe, page

Commence un groupe de questions.

Oui

Oui

end group

Groupe, page

Termine un groupe de questions.

Oui

Oui

begin repeat

N/D

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

Oui

Oui

end repeat

N/D

Termine 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

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

adresse électronique

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

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

barcode

N/D

Scanne un code à barres ou un code QR.

Oui

Non

start

N/D

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

Oui

Oui

à la fin

N/D

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

Oui

Oui

deviceid

N/D

UUID représentant l’appareil spécifique sur lequel l’enquête a été exécutée.

Oui

Non

audio

N/D

Enregistre un clip audio dans l’application de terrain. Accepte un fichier audio dans l’application Web.

Oui

Oui

fichier

Téléchargement de fichiers

Accepte un fichier sur l’appareil.

Oui

Oui

Différences de questions entre application et Web

Si le tableau ci-dessus indique quels types de questions sont disponibles dans Survey123 Connect, l’application de terrain Survey123, le concepteur Web Survey123 et l’application Web Survey123, il existe des différences en ce qui concerne leur comportement et leur mise en œuvre sur les différentes plateformes.

  • 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 types de questions e-mail fournis dans Survey123 Connect et le concepteur Web Survey123 sont mis 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 géopoint, géotrace et géoforme 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 n’autorisent pas l’enregistrement dans l’application Web Survey123. En revanche, elles autorisent la navigation et le fait de joindre un fichier audio existant sur leur appareil.
  • Plusieurs apparence disponibles dans Survey123 Connect ne sont disponibles que sous la forme de types de questions distinctes dans le concepteur Web Survey123. Ceci inclut le texte multiligne, les listes déroulantes, et l’é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 Image, File Upload (Téléchargement de fichiers) et Signature.

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.

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.

Caractères spéciaux

Ces caractères ne peuvent pas être utilisés dans le nom d'une question. Si certains d’entre eux peuvent également déclencher des avertissements lorsqu’ils sont utilisés dans des listes de choix, ils peuvent tout de même être générés et utilisés, à l’exception des espaces dans une liste de choix utilisée par une question select_multiple (qui échouera).

Caractères spéciauxNom

Espace

,

Virgule

:

Deux-points

;

Point-virgule

-

Tiret

/

Barre oblique

$

Signe Dollar

.

Point

(

Parenthèse ouverte

)

Parenthèse fermée

Texte uniligne

Fournit à l’utilisateur une zone de texte unique. Si le texte dépasse la taille de la zone de texte, il conserve sa taille et défile à l’horizontale, sans sauts de ligne. Cette option est idéale pour les réponses courtes. Vous pouvez également appliquer un masque de saisie pour définir le format obligatoire que l’entrée est tenue de respecter.

Ce type de question se comporte de la même façon qu’une question de type texte dans Survey123 Connect.

Texte multiligne

Fournit à l’utilisateur une zone de texte simple unique. Il ne présente aucune limite de texte, renvoie à la ligne suivante et introduit une barre de défilement si le texte est suffisamment long. Cette option est idéale pour les réponses longues.

Ce type de question se comporte de la même façon qu’une question de type texte avec une apparence multiligne dans Survey123 Connect.

Choix unique

L'option Choix unique fournit une liste de réponses potentielles dans laquelle l’utilisateur effectue un seul choix. Vous pouvez définir un comme valeur par défaut dans l’onglet Modifier. Il y a également une case à cocher Allow "Other" (Autoriser Autres), qui permet à l’utilisateur de spécifier un choix supplémentaire ne se trouvant pas dans la liste. Il y a également une option permettant de présenter l’ordre d’apparition des choix de manière aléatoire. La section Appearance (Apparence) permet de choisir si vous souhaitez que vos réponses soient présentées verticalement ou horizontalement.

Les questions à choix unique contiennent un bouton Set rule (Définir la règle) dans la section de création sur la gauche. Cliquez sur ce bouton pour que s’ouvre une fenêtre permettant de définir une règle de visibilité pour toute question venant par la suite. La finalité est la même que celle de la colonne pertinente dans XLSForm.

Ce type de question se comporte de la même façon qu’une question à choix unique dans Survey123 Connect.

Grille à choix unique

L’option Grille à choix unique dresse la liste des réponses potentielles à une série de questions. L’utilisateur choisit une seule réponse dans cette liste. Vous pouvez définir une réponse comme valeur par défaut dans l’onglet Edit (Modifier). Le fonctionnement est le même que celui d’une série de questions à choix unique, sans bouton Set rule (Définir la règle).

Ce type de question se comporte de la même façon qu’un groupe de questions select_one (choix unique) avec une apparence table-list dans Survey123 Connect.

Choix multiples

L'option Choix multiples fournit une liste de réponses potentielles dans laquelle l’utilisateur peut effectuer plusieurs choix. Vous pouvez en définir quelques-unes par défaut dans l’onglet Modifier. Il y a également une case à cocher Allow "Other" (Autoriser Autres), qui permet à l’utilisateur de spécifier un choix supplémentaire ne se trouvant pas dans la liste. Il y a également une option permettant de présenter l’ordre d’apparition des choix de manière aléatoire. La section Appearance (Apparence) permet de choisir si vous souhaitez que vos réponses soient présentées verticalement ou horizontalement.

Ce type de question se comporte de la même façon qu’une question à choix multiples dans Survey123 Connect.

Menu déroulant

L'option Menu déroulant fournit une liste de réponses potentielles dans laquelle l’utilisateur effectue un seul choix. Vous pouvez définir un comme valeur par défaut dans l’onglet Modifier. Une case à cocher Allow "Other" (Autoriser « Autre ») permet à l’utilisateur de spécifier un choix supplémentaire ne se trouvant pas dans la liste. Il y a également une option permettant de présenter l’ordre d’apparition des choix de manière aléatoire. La case à cocher de renseignement automatique permet à l’utilisateur de saisir du texte dans le champ qui restreint la liste aux seules réponses contenant du texte. Le fonctionnement de ce type de questions est analogue à celui de la question à choix unique, mais elle présente les réponses dans une liste déroulante. Cette option est idéale pour une liste de choix plus longue, car la liste est visible uniquement lorsqu’un choix est fait.

Comme avec les questions à choix unique, les questions à menu déroulant contiennent un bouton Set rule (Définir la règle) dans la section de création sur la gauche. Cliquez sur ce bouton pour que s’ouvre une fenêtre permettant de définir une règle de visibilité pour toute question venant par la suite. La finalité est la même que celle de la colonne pertinente dans XLSForm.

Ce type de question se comporte de la même façon qu’une question à choix unique avec une apparence minimale dans Survey123 Connect.

Évaluation

L'évaluation fournit une liste de réponses potentielles dans laquelle l’utilisateur effectue un seul choix. Vous pouvez définir une réponse comme valeur par défaut dans l’onglet Edit (Modifier). Le fonctionnement est le même que celui de la question à choix unique, mais les réponses sont présentées sous forme d’icônes. Par défaut, ce type de question présente une échelle allant d’une à cinq étoiles, mais cette valeur maximale et l’icône proposée peuvent être modifiées dans l’onglet Edit (Modifier).

Comme pour les questions à choix unique, les questions d’évaluation comportent un bouton Set rule (Définir la règle) dans la section de création sur la gauche. Cliquez sur ce bouton pour que s’ouvre une fenêtre permettant de définir une règle de visibilité pour toute question venant par la suite. La finalité est la même que celle de la colonne pertinente dans XLSForm.

Ce type de question se comporte de la même façon qu’une question à choix unique dans Survey123 Connect.

Échelle de Likert

L’échelle de Likert fournit une liste de réponses potentielles dans laquelle l’utilisateur effectue un seul choix. Vous pouvez définir une réponse comme valeur par défaut dans l’onglet Edit (Modifier). Le fonctionnement est le même que celui de la question à choix unique, mais les réponses sont présentées sous forme d’une échelle de Likert. Par défaut, ce type de question présente une échelle allant d’un à cinq, mais cette échelle peut être modifiée dans l’onglet Edit (Modifier).

Comme avec les questions à choix unique, les questions à menu déroulant contiennent un bouton Set rule (Définir la règle) dans la section de création sur la gauche. Cliquez sur ce bouton pour que s’ouvre une fenêtre permettant de définir une règle de visibilité pour toute question venant par la suite. La finalité est la même que celle de la colonne pertinente dans XLSForm.

Ce type de question se comporte de la même façon qu’une question à choix unique avec une apparence Likert dans Survey123 Connect.

Nombre

L'option Nombre fournit une question qui permet à l'utilisateur de faire appel uniquement à des valeurs numériques. Par défaut elle autorise également une seule décimale. Dans la section Validation, vous pouvez utiliser une case à cocher pour indiquer que la valeur doit être un entier. Le fait d’activer cette case à cocher supprime la possibilité de saisir une décimale.

Au lieu du nombre de caractères minimal et maximal, les questions numériques ont des valeurs minimale et maximale qui empêchent l’utilisateur d’envoyer l’enquête si la réponse ne se situe pas dans la plage donnée. Le comportement est le même que celui de la colonne contrainte dans XLSForm.

Ce type de question se comporte de la même manière qu’une question de type entier ou décimale dans Survey123 Connect, selon la façon dont vous avez défini la valeur (en tant qu’entier ou non).

Date

Cette option propose un calendrier dans lequel sélectionner une date. Vous pouvez définir une réponse par défaut à cette question comme une date spécifique ou la date d’envoi de l’enquête. Dans la section Validation, vous pouvez définir une plage de dates dans laquelle l’utilisateur doit effectuer une sélection.

Ce type de question se comporte de la même façon qu’une question de type date dans Survey123 Connect.

Durée

Cette option propose une question permettant de sélectionner une heure au format heure:minute sur 12 heures. Un menu déroulant permet à l’utilisateur de sélectionner des heures à des intervalles de 15 minutes. Les heures sélectionnées sont présentée dans des zones de texte, ce qui permet aux utilisateurs de saisir une heure plus précise. Vous pouvez définir une réponse par défaut à cette question comme une heure spécifique ou l’heure de chargement de l’enquête.

Ce type de question se comporte de la même façon qu’une question de type heure dans Survey123 Connect.

Date et heure

Cette option ouvre un calendrier pour la sélection de la date et un champ pour la sélection de l’heure. Ces champs fonctionnent de la même manière que les types de question date et heure, respectivement, et comportent les mêmes contrôles de valeurs par défaut et de validation.

Ce type de question se comporte de la même façon qu’une question de type date/heure dans Survey123 Connect.

Image

Image fournit un bouton permettant de choisir un fichier image sur l’appareil, ou de prendre une photo à l’aide de la caméra de l’appareil, le cas échéant. Vous pouvez empêcher l’utilisateur d’envoyer un fichier image à partir de l’appareil en sélectionnant Camera only (Caméra uniquement) comme source de l’image. Vous pouvez également autoriser l’utilisateur à soumettre plusieurs images dans la réponse à la question à choix unique, jusqu’à un maximum de 99 images.

Attention :

Si une question de type image contient plusieurs images, les données EXIF ne peuvent pas être extraites des images. Si vous devez extraire des données EXIF de plusieurs images soumises à la même question, envisagez d’utiliser une répétition.

Ce type de question se comporte de la même façon qu’une question de type image dans Survey123 Connect.

Téléchargement de fichiers

Le téléchargement de fichiers fournit un bouton permettant de choisir un fichier sur l'appareil. La section Validation permet au créateur de l’enquête de définir les types de fichiers autorisés, tout d’abord par catégorie (Document, Archive ou une sélection personnalisée), puis par l’intermédiaire d’une liste de contrôles ou d’une liste d’extensions de nom de fichier séparées par une virgule. Vous pouvez autoriser l’utilisateur à soumettre plusieurs fichiers dans la réponse à la question à choix unique, jusqu’à un maximum de 99 fichiers.

Ce type de question se comporte de la même façon qu’une question de type fichier dans Survey123 Connect.

Signature

L’option signature fournit une zone de dessin libre pour recueillir une signature. Cette signature est enregistrée sous forme d’image et ajoutée à la réponse à l’enquête en tant que pièce jointe. Rendre cette question obligatoire est l’unique option supplémentaire disponible pour cette question.

Ce type de question se comporte de la même façon qu’une question de type image avec une apparence signature dans Survey123 Connect.

Adresse

L’adresse propose une zone de texte pour saisir une adresse. Commencez à saisir une adresse ; une série d’options destinées au renseignement automatique apparaît. Celles-ci suggèrent des localisations basées sur le service de localisation défini pour la question. Si aucun service n’est défini, la question utilise le localisateur choisi par votre organisation, qui est par défaut ArcGIS World Geocoding Service. Vous pouvez définir cette question pour envoyer l’adresse sélectionnée sous forme de texte ou envoyer l’adresse sélectionnée sous forme de texte ainsi que son emplacement sous forme de géométrie ponctuelle. Si une question Carte est déjà présente dans l’enquête, vous pouvez seulement envoyer l’adresse sous forme de texte.

Cette question se comporte de la même façon qu’une question de type texte avec une apparence geocode dans Survey123 Connect.

Carte

L’option Carte offre une interface de carte permettant à l’utilisateur de spécifier un point, une ligne ou une surface. Sélectionnez le type de géométrie et le style de dessin à utiliser dans l’enquête. Le type de géométrie utilisé s’applique à la couche d’entités sous-jacente de l’enquête et ne peut pas être modifié après la publication ; le style de dessin peut en revanche être modifié à tout moment. Les paramètres Map and extent (Carte et étendue) permettent de sélectionner le fond de carte en ligne, l’étendue de la carte par défaut et le service de localisation que l’utilisateur va utiliser. Une option permet également de s’assurer que la localisation de l’utilisateur sera uniquement capturée à la première interaction avec la question.

Remarque :

Si l’option Do not submit the answer (Ne pas envoyer la réponse) est cochée pour une question de type carte, le type de géométrie ne sera pas utilisé pour la couche d’entités sous-jacente et vous pouvez la changer après publication.

Ce type de question est équivalent aux questions de type géopoint, géotrace ou géoforme dans Survey123 Connect. Les entités suivantes sont prises en charge dans l’application de terrain Survey123, mais pas dans l’application Web :

  • Fonds de carte en mode hors connexion.
  • Calcul de la moyenne des emplacements pour les questions géopoint.
  • Symbologie de géopoint.
  • Seuils de précision d’emplacement et expressions relatives à la qualité de l’emplacement.
  • Toutes les propriétés pulldata("@geopoint"). L’application Web prend maintenant en charge les propriétés x, y, z, horizontalAccuracy, verticalAccuracy, speed et direction.
  • Calculs sur des questions de type géotrace et géoforme, y compris la fonction sum().
  • Options de style fournies pour les questions de type géotrace et géoforme.

Classement

Le classement fournit une liste de choix pour lesquels l’utilisateur spécifie un ordre préféré. L’utilisateur peut sélectionner ces choix dans un ordre quelconque, puis faire glisser ceux qui ont déjà été sélectionnés pour les réorganiser. L’utilisateur doit classer tous les choix disponibles avant que les réponses à l’enquête puissent être envoyées. Un bouton Reset (Réinitialiser) est disponible pour effacer tous les classements. Lors de la création de l’enquête, le concepteur peut également choisir de présenter ou non l’ordre d’apparition des choix de manière aléatoire.

Ce type de question se comporte de la même façon qu’une question de type Classement dans Survey123 Connect.

Adresse électronique

Cette option fournit un champ de texte limité qui rejette automatiquement les réponses non conformes au format d’une adresse électronique. Les seules options supplémentaires disponibles pour ce type de question permettent de rendre cette question obligatoire ou de mettre la réponse en cache pour des réponses ultérieures.

Ce type de question ne se comporte pas de la même façon qu’une question de type e-mail dans Survey123 Connect. Au lieu de cela, ce type de question fonctionne comme une question de type texte avec l’application d’une expression régulière.

Site web

Cette option fournit un champ de texte limité qui rejette automatiquement les réponses non conformes au format d’une URL de site web. Les seules options supplémentaires disponibles pour ce type de question permettent de rendre cette question obligatoire ou de mettre la réponse en cache pour des réponses ultérieures.

Ce type de question fonctionne comme une question de type texte avec l’application d’une expression régulière.

Remarque

L’option Remarque fournir une étiquette pour afficher un message détaillé. Ceci peut inclure un formatage HTML, des hyperliens, ou des images. Aucune option supplémentaire n’est disponible. Un champ n’est pas créé dans la couche d’entités pour une question de type note.

Ce type de question se comporte de la même façon qu’une question de type note dans Survey123 Connect.

Groupe

Groupe dans lequel il est possible de déposer des questions. Ce groupe peut être réduit, l’onglet Edit (Modifier) donnant la possibilité de réduire le groupe par défaut.

Ce type de question se comporte de la même façon qu’un couple de questions de type début et fin du groupe dans Survey123 Connect.

Page

Crée une page distincte pour l’enquête pouvant contenir des questions indépendantes créées dans la page ou déposées dans celle-ci. Dans la fenêtre de conception, il est possible de dupliquer une page ou de fusionner une page avec une autre.

Ce type de question se comporte de la même façon qu’un couple de questions de type début et fin du groupe utilisant le style pages dans Survey123 Connect.