Notions élémentaires concernant le concepteur Web

Avec le concepteur Web ArcGIS Survey123, vous pouvez créer des enquêtes pour l’application Web et l’application de terrain à l’aide d’une interface par glisser-déposer. Le concepteur Web Survey123 offre un large éventail de types de questions que vous pouvez configurer de plusieurs manières. En arrière-plan, le concepteur Web utilise la spécification XLSForm. Pour disposer de fonctionnalités XLSForm plus avancées, vous pouvez poursuivre la conception dans Survey123 Connect. Pour plus d’informations, consultez la rubrique Notions élémentaires concernant XLSForms.

É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.
• CAPTCHA : un CAPTCHA est un exercice affiché à la fin du formulaire que les utilisateurs doivent résoudre pour pouvoir soumettre leur réponse. Pour résoudre le CAPTCHA, les utilisateurs doivent saisie les caractères qui apparaissent sur l’image. Vous pouvez modifier le texte qui s’affiche au-dessus du CAPTCHA en cliquant dessus dans l’aperçu du formulaire. Les CAPTCHA peuvent être activés lors de l’utilisation de https://survey123.arcgis.com/ et sont pris en charge dans l’application Web Survey123. Les CAPTCHA ne peuvent pas être configurés lorsque le site Web Survey123 est installé sur l’infrastructure et ne sont pas pris en charge dans l’application de terrain Survey123.

Cliquez sur un élément dans l’aperçu du formulaire pour le personnaliser dans l’onglet Edit (Mise à jour).

Types de questions

Le tableau ci-dessous répertorie les types de questions que vous pouvez ajouter à votre enquête par l’intermédiaire du concepteur Web Survey123, et la manière dont ils sont implémentés dans la spécification XLSForm.

Attention :

Si une enquête créée avec le concepteur Web Survey123 est republiée dans Survey123 Connect, vous ne pouvez plus mettre à jour les portions de l’enquête qui ont été modifiées par le XLSForm dans le concepteur Web. Par exemple, les questions et le titre de l’enquête ne peuvent pas être mis à jour. Il est toujours possible de mettre à jour les thèmes, les webhooks et les options de partage dans le concepteur Web.

Question du concepteur Web Survey123	Description	Implémentation XLSForm
Texte uniligne	Zone de texte avec une ligne unique en entrée	Question à texte
Texte multiligne	Zone de texte avec plusieurs lignes en entrée.	Question de type texte, apparence multiligne
Nombre	Entrée numérique, peut être un nombre entier ou un nombre décimal.	Question de type entier ou décimal
Date	Saisie de date.	Question de type date
Durée	Saisie d’heure.	Question de type durée
Date et heure	Saisie de date et heure.	Question DateTime
Adresse électronique	Zone de texte limitée qui refuse toutes les entrées qui ne se présentent pas sous la forme d’une adresse électronique.	Question de type texte avec contrainte d’expression régulière
Site web	Zone de texte limitée qui refuse toutes les entrées qui ne se présentent pas sous la forme d’une URL de site Web.	Question de type texte avec contrainte d’expression régulière
Single select (Sélection unique)¹	Question à choix multiples ; un seul choix peut être sélectionné.	Question Select_one
Multiple select (Sélection multiple)¹	Question à choix multiples ; plusieurs choix peuvent être sélectionnés.	Question Select_multiple
Single select grid (Grille à sélection unique)¹	Séries de questions à choix multiples avec des choix identiques ; un seul choix peut être sélectionné par question.	Plusieurs questions select_one utilisant la même liste de choix, dans un groupe utilisant l’apparence de liste de tables
Dropdown (Menu déroulant)¹	Question à choix multiples dont les choix sont affichés dans une liste déroulante ; un seul choix peut être sélectionné.	Question Select_one, apparence de saisie minimale ou automatique.
Likert scale (Échelle de Likert)¹	Question à choix multiples ; sélectionnez l’une des séries de choix sur une échelle symétrique d’accord-désaccord.	Question Select_one, apparence Likert
Rating (Évaluation)¹	Question à choix multiples ; sélectionnez l’une des séries de nombres.	Question Select_one
Ranking (Classement)¹	Liste de choix qui peuvent être triés.	Question de type rank (classement)
Carte	Collecte un point, une ligne ou un polygone sur la carte.	Question de type géopoint, géotrace ou géoforme
Adresse	Zone de texte utilisée pour rechercher une adresse. Remarque : Le géocodage des adresses à l’aide de ArcGIS Geocoding service consomme des crédits. Pour plus d'informations, reportez-vous à la rubrique Présentation des crédits.	Question de type texte, apparence d’un géocode
Image	Prendre une ou plusieurs photos avec la caméra ou charger les fichiers image depuis l’appareil.	Question de type image, potentiellement avec apparence multiligne
Téléchargement de fichiers	Accepte un fichier sur l’appareil.	Question de type fichier
Sonore	Enregistrer ou télécharger un fichier audio.	Question audio
Signature	Accepte une entrée sous forme de dessin pour une signature.	Question de type image, apparence de signature
Remarque	Affiche du texte à l’écran.	Question de type note
Page	Présente les questions sur une autre page.	Commence un groupe et termine un groupe de questions, style de pages
Groupe	Dispose les questions dans un groupe.	Commence un groupe et termine un groupe de questions

¹ Les noms de choix sont limités à 31 caractères. Les caractères supplémentaires sont tronqués.

Après la configuration d’une question, certains types de question acceptent le changement en un autre type doté du même type de champ sous-jacent. Vous pouvez par exemple modifier une question à sélection unique en question à liste déroulante après avoir configuré tous les choix. Pour changer le type d’une question existante, cliquez dessus dans l’aperçu du formulaire pour ouvrir l’onglet Edit (Mettre à jour), cliquez sur le bouton Change question type (Modifier le type de question) en haut de la fenêtre et sélectionnez dans la liste l’un des types de question pris en charge. Après la publication, certains types de question ne peuvent pas être sélectionnés dans la liste. Pour plus d’informations, voir Mettre à jour une enquête. Lorsque vous changez le type de question, les paramètres courants sont conservés (la validation et le comportement, par exemple), vous n’avez donc pas à reconfigurer la question.

Options de question

Lorsque vous ajoutez une question à votre enquête, un certain nombre d’options sont disponibles pour modifier l’apparence ou le comportement de la question lorsque l’enquête est remplie et envoyée par un utilisateur. Ces options sont représentées dans la spécification XLSForm.

Les options disponibles pour plusieurs types de questions sont décrites ci-dessous. Toutefois, toutes ne sont pas disponibles pour chaque type de question. Pour plus d’informations sur les options uniquement disponibles pour des types de questions particuliers, consultez la rubrique Référence rapide.

Options générales et d’apparence

Option	Questions applicables	Description	XLSForm équivalent
Valeur par défaut	Toutes sauf Image (Image), File upload (Téléchargement de fichiers), Audio (Audio), Note (Note), Page (Page) et Group (Groupe)	La valeur par défaut sera présente à l’ouverture de l’enquête, même si la valeur peut être mise à jour.	Indiquez une valeur dans la colonne default (par défaut).
Calcul	Singleline text (Texte uniligne), Multiline text (Texte multiligne), Number (Nombre), Map (Carte), Date (Date) et Date and time (Date et heure)	Le champ sera renseigné avec le résultat d’une expression, contenant potentiellement des réponses à d’autres questions. Le bouton Edit (Mettre à jour) permet de construire des calculs numériques incluant les champs de date et d’heure, les concaténations de chaîne et l’extraction de données provenant d’autres parties de l’enquête. Pour plus d’informations, reportez-vous à la rubrique Calculs.	Indiquez une expression dans la colonne calculation (calcul).
Affichez les choix dans un ordre aléatoire	Single select (Sélection unique), Multiple select (Sélection multiple), Dropdown (Menu déroulant) et Ranking (Classement)	Les choix correspondant à cette question s’afficheront dans un ordre aléatoire.	Définir la colonne parameters (paramètres) sur randomize.
Permettre « Autre »	Single select (Sélection unique), Multiple select (Sélection multiple) et Dropdown (Menu déroulant)	Un autre choix sera disponible, une zone de texte supplémentaire apparaissant au moment de la sélection.	Ajoutez or_other au type de question.
Valeur maximale	Rating (Évaluation) et Likert scale (Échelle de Likert)	Définit le nombre maximal de réponses possibles à la question.	Le nombre de choix dans une liste de choix d’une question select_one.
Localisateur	Address (Adresse) et Map (Carte)	Définit le service de localisation à utiliser pour la question. S’il n’est pas défini, utilise le service par défaut de l’organisation.	Définissez la colonne appearance (apparence) d’une question à texte sur geocode et définissez le paramètre geocode sur l’ID d’élément du service de localisateur dans la colonne bind::esri:parameters.
Vertical, Horizontal et Horizontal (compact)	Single select (Sélection unique) et Multiple select (Sélection multiple)	Détermine si les choix correspondant à la question seront présentés verticalement, horizontalement ou horizontalement avec chaque choix étant donné uniquement sur l’espace disponible exigé par l’étiquette.	Définissez la colonne appearance (apparence) pour la question sur blanc, horizontal ou horizontal-compact.

Options de validation

Option	Questions applicables	Description	XLSForm équivalent
Il s’agit d’une question obligatoire	Toutes sauf Note (Note), Page (Page) et Group (Groupe)	Une réponse doit être donnée à cette question pour envoyer l’enquête.	Définissez la colonne required (requis) pour cette question sur true.
Contrainte	Singleline text (Texte uniligne), Multiline text (Texte multiligne), Number (Nombre), Date et Date and time (Date et heure), Email (E-mail), Website (Site Web), Barcode (Code-barres), Multiple select (Sélection multiple), Map (Carte), Address (Adresse), Image, File upload (Chargement de fichiers)	L’utilisateur doit fournir une réponse en fonction des restrictions spécifiées par une expression ou une combinaison d’expressions. Lorsque la condition spécifiée n’est pas remplie, le formulaire affiche un message d’information que vous pouvez personnaliser.	Utilisez les expressions dans la colonne constraint (contrainte).
Limite de taille de fichier unique	Image (Image) et File upload (Téléchargement de fichiers)	Définit une taille de fichier maximale, en mégaoctets, pour un fichier unique envoyé à une question. Cette fonctionnalité n’est pas prise en charge dans l’application de terrain Survey123.	Fournissez une valeur pour max-size dans la colonne bind::esri:parameters.

Voici des exemples de contraintes accompagnées de règles afin de restreindre les réponses :

• Pour les questions en entrée Date et heure, limitez les réponses à la plage spécifique définie pour la question.
• Pour les questions en entrée Texte, définissez un nombre de caractères minimal et maximal afin que l’utilisateur doive donner une réponse au moins aussi longue que le nombre minimal de caractères, sans dépasser le nombre maximal de caractères.
• Pour les questions Image et Chargement de fichiers, spécifiez un nombre de fichiers afin que l’utilisateur doive charger un nombre minimal, maximal ou exact d’images ou de fichiers par rapport au nombre indiqué. Dans XLSForm, il suffit de définir la colonne appearance (apparence) de la question sur multiline et d’utiliser une expression count-selected dans la colonne constraint (contrainte).

Autres options

• Cache answer (Mettre en cache la réponse) — Après que l’enquête a été soumise, cette réponse sera automatiquement renseignée la prochaine fois que l’utilisateur ouvrira l’enquête. Cela n’a aucun équivalent XLSForm, mais l’application de terrain Survey123 offre la possibilité de définir et d’appliquer les réponses favorites fonctionnant de la même manière.
• Read-only (Lecture seule) — L’utilisateur n’est pas en mesure de répondre à cette question. La question peut uniquement contenir des valeurs par défauts ou les résultats des calculs. Dans XLSForm, il suffit de définir la colonne readonly (lecture seule) de cette question sur yes.
• Hide from survey (Masquer de l’enquête) — L’utilisateur ne peut pas voir cette question, laquelle peut toujours enregistrer les réponses données en fonction des valeurs par défaut ou des calculs. Cette option n'est disponible que pour les questions qui prennent en charge les valeurs par défaut ou les calculs. Dans XLSForm, il suffit de définir la colonne appearance (apparence) de la question sur hidden.
• Do not submit the answer (Ne pas envoyer la réponse) — Cette question n’a aucun champ dans la couche d’entités, et la réponse à la question ne sera pas envoyée. Dans XLSForm, il suffit de définir la colonne bind::esri:fieldType de la question sur null.

Étiquettes dynamiques

Vous pouvez afficher le contenu d’une autre question dans les notes, les étiquettes, les astuces et l’écran de remerciement de votre enquête en indiquant le nom de cette question dans le texte à l'aide du format ${field_name}. Cela permet d’afficher le contenu de champs qui n’ont pas besoin d’être vus habituellement, comme les calculs effectués à partir de réponses précédentes, ou d’utiliser dans l'étiquette d’une question le nom d’une personne interrogée issu de la question qui précède.

Lors de la mise à jour d’une étiquette, cliquez sur le bouton de valeur d’insertion de la question pour afficher une liste de questions pouvant être référencées.

Vous ne pouvez pas effectuer de calculs dans une étiquette ou une astuce. Pour pouvoir afficher les résultats d’un calcul, assurez-vous que le calcul est inséré dans une question.

Attention :

Les étiquettes dynamiques ne sont pas prises en charge dans les listes de choix.

Calculs

Vous pouvez calculer la réponse à une question à l’aide d’autres questions de votre enquête ou de propriétés d’enquête. Pour créer ou modifier un calcul pour une question, cliquez sur Edit (Modifier) à côté de l’option Calculation (Calcul).

Les types de question suivants prennent en charge les calculs :

• Texte uniligne
• Texte multiligne
• Nombre
• Date
• Date et heure
• Carte

Par exemple, l’emplacement d’une question de type carte peut être utilisé pour renseigner une question de type texte uniligne. De même, l’emplacement d’une question de type carte peut être dérivé à partir des métadonnées EXIF d’une photo envoyée à une question de type image. Dans l’exemple ci-après, la question Carte nommée Location (Localisation) est renseignée avec la valeur du champ Location from EXIF (Localisation à partir de données EXIF) de la question Photo :

En définissant Source sur Layer (Couche), vous pouvez interroger une table ou une couche d’entités ArcGIS et utiliser le résultat de la requête comme réponse à la question. Vous pouvez effectuer une requête attributaire ou spatiale. Dans l’exemple ci-après, la question de type texte nommée Country (Pays) est renseignée avec la valeur du champ Country Name (Nom du pays) de la couche d’entités World Countries (Pays du monde). Dans l’enquête, les utilisateurs spécifient une localisation dans une question de type carte nommée Location (Localisation), et le pays dans lequel se trouve la localisation est renvoyé à partir de la couche d’entités.

Lorsque l’on utilise le calcul pour créer une chaîne, l’opérateur Joins (Jointures) doit précéder et suivre les questions référencées, sauf au début ou à la fin du calcul. Il est possible de saisir librement du texte en dehors de ces questions.

Attention :

Les expressions mathématiques contenant des valeurs vides ne sont pas évaluées et la question contenant l'expression reste vide. Envisagez d'affecter une valeur par défaut de 0 aux questions numériques qui contiennent une expression.

Propriétés concernant l’appareil et l’utilisateur

Le tableau suivant répertorie les propriétés concernant l’appareil et l’utilisateur qui peuvent être référencées par les calculs :

Propriété	Description
Nom d\\’utilisateur	Nom d’utilisateur du compte d’organisation de l’utilisateur actuellement connecté.
Nom complet de l’utilisateur	Nom et prénom de l’utilisateur actuellement connecté.
Prénom de l’utilisateur	Prénom de l’utilisateur actuellement connecté.
Nom de l’utilisateur	Nom de l’utilisateur actuellement connecté.
Adresse e-mail de l’utilisateur	Adresse e-mail du compte d’organisation de l’utilisateur actuellement connecté.
Langue	Langue utilisée dans l’enquête en cours.
Décalage UTC	Décalage, en heures, par rapport au temps universel coordonné (UTC) pour le fuseau horaire local.
Agent de l’utilisateur	Chaîne de l'agent de l’utilisateur pour l'appareil de l'utilisateur.

Règles de visibilité

La visibilité d’une question peut être définie sur toujours visible (coché), jamais visible (décoché) ou être définie par une règle.

Cliquez sur Set rule (Définir une règle) pour créer une règle de visibilité et sélectionnez une autre question dans l’enquête dont la réponse contrôlera la visibilité de la question sélectionnée. Si la règle de visibilité n’est pas satisfaite, l’auteur peut décider si les réponses sont envoyées ou non. Le fait de ne pas envoyer la réponse revient au même que d’utiliser la colonne relevant dans le formulaire XLSForm. Le fait d’envoyer la réponse revient au même que d’utiliser la colonne bind::esri:visible dans le forrmulaire XLSForm.

Lorsque la visibilité d’une question est contrôlée par une règle de visibilité, l’option Visible affiche un état indéterminé (partiellement cochée).

Vous pouvez copier une règle de visibilité dans une ou plusieurs des questions d’une enquête. Pour copier une règle de visibilité, sélectionnez la question à laquelle la règle est appliquée, puis cliquez sur Set rule (Définir la règle). Dans le volet Visibility rule (Règle de visibilité), cliquez sur le bouton Copy visibility rule (Copier la règle de visibilité) . Sélectionnez les questions cibles dans lesquelles vous souhaitez copier la règle. Les règles de visibilité existantes sont remplacées.

Remarque :

Dans le cas de questions de type Image, File upload (Téléchargement de fichiers), Audio et Signature, les réponses ne peuvent pas être envoyées si la question n’est pas visible.