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.
Éléments d’enquête
Les options de l’onglet Add (Ajout) du concepteur Web de Survey123 permettent de contrôler la visibilité des éléments suivants :
- Survey header (En-tête de l’enquête) : l'en-tête s’affiche en haut du formulaire. Il peut s’agir de texte ou d’une image. Pour un en-tête de type image, indiquez l’URL d’une image hébergée en ligne ou téléchargez un fichier image.
- Survey description (Description de l’enquête) : la description s’affiche sous l’en-tête. Elle peut contenir du texte formaté, des liens et des images.
- Survey footer (Pied de page de l’enquête) : le pied de page s’affiche sous le bouton Submit (Envoyer) sous forme d’hyperlien. Indiquez un texte et une URL pour l’hyperlien.
Cliquez sur un élément dans l’aperçu du formulaire pour le personnaliser dans l’onglet Edit (Mise à jour).
Types de questions
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 |
---|---|---|---|---|
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 | N/D | Scanne un code à barres ou un code QR. | Oui | Non |
begin group | Commence un groupe de questions. | Oui | Oui | |
N/D | Commence un ensemble de questions répétées. | Oui | Oui | |
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 | Saisie de nombre décimal. | Oui | Oui | |
Saisie de date. | Oui | Oui | ||
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 |
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 |
à la fin | N/D | Date et heure de fin de l’enquête. | Oui | Oui |
end group | Termine un groupe de questions. | Oui | Oui | |
end repeat | N/D | Termine un ensemble de questions répétées. | Oui | Oui |
fichier | Accepte un fichier sur l’appareil. | Oui | Oui | |
Recueille des coordonnées GPS. Prend par défaut la valeur de la localisation actuelle. | Oui | Oui | ||
Collecte un polygone sur une carte. | Oui | Oui | ||
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 |
entier | Saisie de nombre entier. | Oui | Oui | |
Accepte une image issue de fichiers d’un appareil ou d’une photo prise directement. | Oui | Oui | ||
Affiche du texte à l’écran. Permet aussi de gérer des calculs masqués. | Oui | Oui | ||
plage | N/D | Saisie d’une plage de nombres. | Oui | Oui |
Question de type Classement ; classe une liste de choix. Remplace list_name par le nom de votre liste de choix. | Oui | Oui | ||
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. Remplace list_name par le nom de votre liste de choix. | Oui | Oui | |
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 de média de l’enquête qui contient la liste des choix. | Oui | Oui | |
Question à choix multiples ; plusieurs réponses peuvent être sélectionnées. Remplace list_name par le nom de votre liste de choix. | Oui | Oui | ||
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 de média 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 |
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 |
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 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 apparence disponibles dans Survey123 Connect ne sont disponibles que sous la forme de types de questions distinctes dans le concepteur Web Survey123. Cela inclut Multiline text (Texte multiligne), Dropdown (Menu déroulant) et Likert scale (É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 (Image), File upload (Téléchargement de fichiers) et Signature (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
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.
Date, nombre, texte et heure
Les types de questions suivants permettent aux utilisateurs de saisir des réponses ou de sélectionner des dates et heures.
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.
Date et heure
L'option Date and time (Date et heure) fournit 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.
Adresse électronique
L'option Email (Adresse électronique) 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.
Texte multiligne
Le texte multiligne fournit à l’utilisateur une zone de texte de grande taille dans laquelle le texte est renvoyé à la ligne à mesure qu’il est saisi. Les retours chariot sont également pris en charge. Ce type de question est idéal 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.
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).
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.
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.
Site web
L'option Website (Site web) 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.
Choix
Les types de questions ci-après permettent aux utilisateurs de sélectionner une réponse dans une liste de choix. La manière dont les choix sont présentés dépend du type de question.
Menu déroulant
L'option Dropdown (Menu déroulant) fournit une liste de réponses potentielles dans laquelle l’utilisateur sélectionne en sélectionne une. Vous pouvez en définir une comme valeur par défaut dans l’onglet Edit (Mettre à jour). 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 Autocomplete (Terminer automatiquement) 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 à sélection 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 à sélection 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.
Échelle de Likert
L’échelle de Likert fournit une liste de réponses potentielles dans laquelle l’utilisateur en sélectionne une. Vous pouvez définir une réponse comme valeur par défaut dans l’onglet Edit (Mettre à jour). Le fonctionnement est le même que celui de la question à sélection unique, mais les réponses sont présentées sous forme d’é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 à sélection unique, les questions de type Échelle de Likert 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 à sélection unique avec une apparence Likert (Likert) dans Survey123 Connect.
Sélection multiple
L'option Multiple select (Sélection multiple) fournit une liste de réponses potentielles dans laquelle l’utilisateur peut en sélectionner plusieurs. Vous pouvez en définir quelques-unes par défaut dans l’onglet Edit (Mettre à jour). 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.
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.
Évaluation
L'évaluation fournit une liste de réponses potentielles dans laquelle l’utilisateur en sélectionne une. Vous pouvez définir une réponse comme valeur par défaut dans l’onglet Edit (Mettre à jour). Le fonctionnement est le même que celui de la question à sélection 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 à sélection 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.
Sélection unique
L'option Single select (Sélection unique) fournit une liste de réponses potentielles dans laquelle l’utilisateur en sélectionne une. Vous pouvez en définir une comme valeur par défaut dans l’onglet Edit (Mettre à jour). 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 de type Single select (Sélection 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 à sélection unique
L’option Single select grid (Grille à sélection 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 (Mettre à jour). 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).
Sur les appareils mobiles, si la largeur de la grille à sélection unique est supérieure à celle de l’écran, la mise en page est ajustée automatiquement de sorte que les questions apparaissent sous forme d’un groupe de questions à choix unique plutôt qu’une grille. Cela permet de s’assurer que toutes les questions et les choix sont ajustés à l’écran.
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.
Emplacement
Les types de questions ci-après permettent aux utilisateurs de spécifier une localisation, sur une carte ou en saisissant une adresse.
Adresse
L’adresse propose une zone de texte pour saisir une adresse. Commencez à saisir une adresse et 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 l’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 Map (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 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.
Éléments multimédias et fichiers
Les types de questions ci-après permettent aux utilisateurs de capturer ou charger des éléments multimédias et fichiers.
Sonore
La version audio comporte des boutons permettant d’enregistrer ou de charger un fichier audio. La section Validation permet au concepteur de l’enquête de définir la durée maximale des fichiers audio enregistrés ou d’indiquer qu’une question requiert une réponse.
Le comportement de ce type de question est identique à celui d’une question audio 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 à envoyer plusieurs fichiers dans une réponse à la question, 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.
Image
L’option Image fournit un bouton permettant de sélectionner 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 à envoyer plusieurs images dans une réponse à la question, 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.
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. Pour ce type de question, la seule option supplémentaire dont vous disposiez est de rendre la question obligatoire.
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.
Affichage et structure
Les types de questions ci-après permettent aux utilisateurs de contrôler la mise en page du formulaire d'enquête.
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.
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.
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.
Vous avez un commentaire à formuler concernant cette rubrique ?