Survey123 prend en charge les questions de type select_one (ne sélectionner qu’une seule réponse), select_multiple (sélectionner plusieurs réponses) et rank (classer une liste de choix).
Remarque :
Les questions de type rank (classement) sont actuellement prises en charge uniquement dans l’application de terrain et l’application Web.
La création d’une question à choix multiples nécessite d’ajouter une feuille de calcul choices (choix) à votre classeur Excel. Voici un exemple de question select_one :
Le nom de liste dans la feuille de calcul de l’enquête, yes_no, doit correspondre au nom de liste dans la feuille de calcul de choix. Cela permet de s’assurer que le formulaire affiche la liste correcte des choix de réponses pour une question donnée.
Par défaut, lorsqu’une enquête est publiée, les choix des questions de type select_one (sélection unique) sont ajoutées dans la couche d’entités de l’enquête en tant que domaines de valeurs précodées. Vous pouvez désactiver la création de domaines au cours du processus de publication. Pour plus d’informations, reportez-vous à la rubrique Options de publication.
Attention :
Voici les limitations lorsque vous utilisez une liste de choix avec des noms de choix dupliqués :
- Les noms de choix dupliqués ne sont pas pris en charge pour les questions à choix multiples.
- Les noms de choix dupliqués ne sont pas pris en charge pour les enquêtes multilingues.
- La fonction jr:choice-name() renvoie l’étiquette du premier choix dupliqué dans la liste.
- Lorsqu’elles sont ouvertes à partir des dossiers Inbox (Boîte de réception), Drafts (Brouillons), Outbox (Boîte d’envoi), Sent (Éléments envoyés) ou Overview (Vue d’ensemble), les questions à choix unique rétablissent le premier choix dupliqué dans la liste.
Pour en savoir plus sur la modification des listes de choix dans les enquêtes existantes, reportez-vous à la rubrique Mettre à jour une enquête.
Vous pouvez également ajouter des questions à choix multiples qui permettent de sélectionner plusieurs réponses, par exemple :
Par défaut, ces choix apparaissent dans l’ordre indiqué dans la feuille de calcul de choix. Vous pouvez présenter l’ordre d’apparition des choix de manière aléatoire en saisissant randomize=true dans la colonne des paramètres.
Attention :
Toutes les valeurs recueillies dans une question select_multiple (choix multiples) ou rank (classement) sont enregistrées sous forme de liste séparée par des virgules, de façon à éviter l’utilisation de virgules dans la colonne de nom de votre liste de choix. Notez également que les questions select_multiple (choix multiples) et rank (classement) n’envoient que le nom du choix à la couche d’entités, tandis que les questions select_one (choix unique) transmettent le nom et l’étiquette.
La valeur d’une question de type rank (classement) n’est pas renseignée tant que l’utilisateur n’a pas modifié l’ordre des choix. Si une valeur par défaut a été définie, l’ordre par défaut est appliqué sauf si l’utilisateur modifie l’ordre des choix.
Il est possible de renvoyer une réponse individuelle à une question de type select_multiple (choix multiples) à l’aide de la fonction selected-at. La fonction suivante renvoie la valeur de nom de la première réponse donnée à une question select_multiple (choix multiples) :
selected-at(${species}, 0)
La fonction jr:choice-name permet d’envoyer l’étiquette d’une réponse. Pour obtenir la valeur d’étiquette de la deuxième réponse donnée à la même question select_multiple (choix multiples), utilisez ce qui suit :
jr:choice-name(selected-at(${species}, 1), '${species}')
Apparence
Lorsque la colonne appearance (apparence) est définie sur minimal, une question de type sélection est présentée sous la forme d’un menu déroulant.
Lorsque la colonne appearance (apparence) est définie sur horizontal, les choix d’une question de type sélection sont présentés horizontalement dans des colonnes de largeur égale.
L’apparence de type compact est similaire à l’apparence de type horizontal, mais elle utilise une méthode différente pour déterminer les largeurs de colonne obtenues si les choix prennent moins de place.
Remarque :
Dans Survey123 Connect, vous pouvez spécifier un nombre maximal de colonnes pour l’apparence de type compact en indiquant un nombre séparé par un tiret. Par exemple, compact-3 limite la question à un maximum de trois colonnes pour les questions à choix multiple dans les enquêtes utilisées avec l’application de terrain ou l’application Web.
Les apparences de type compact et horizontal-compact sont identiques. Dans l’application Web Survey123, au lieu d’utiliser des colonnes, ces apparences s’adaptent aux étiquettes de choix d’une question de type sélection avec une présentation côte à côte dans les lignes, sans espacement supplémentaire.
Pour une question à sélection unique, le fait de définir la colonne appearance (apparence) sur likert présente les choix sous forme d’échelle de Likert. Une échelle de Likert est une échelle de notation qui permet aux sondés de préciser leur niveau d’accord sur une échelle d’accord-désaccord symétrique par rapport à une affirmation.
Lorsque la colonne appearance (apparence) est définie sur autocomplete, une question de type sélection est présentée sous la forme d’une zone de texte et d’un menu déroulant. La saisie de texte dans le champ restreint l’affichage du menu déroulant aux seules réponses qui contiennent du texte. Cette option est utile en cas de listes de choix très longues.
Remarque :
L’apparence autocomplete (renseignement automatique) pour les questions à sélection multiple est uniquement prise en charge dans Survey123 Mobile. Elle n’est pas prise en charge dans l’application de terrain ou l’application Web.
Lorsque la colonne appearance (apparence) est définie sur search (recherche), vous pouvez renseigner la liste de choix d’une question de type sélection avec les valeurs d’une table CSV figurant dans le dossier media de l’enquête ou d’une table ou couche d’entités existante. Pour plus d’informations, reportez-vous à la section Créer une liste de choix dynamiques à l’aide de l’apparence de recherche.
Lorsque la colonne appearance (apparence) est définie sur image-map, une question de type sélection peut se présenter dans l’application de terrain sous forme d’image dont les régions sélectionnables font office de choix, via un fichier SVG. Pour plus d’informations, reportez-vous à la rubrique Utiliser des fichiers SVG.
Créer une liste de choix dynamiques à l’aide de l’apparence de recherche
Remarque :
Cette section décrit les fonctions qui sont uniquement disponibles dans Survey123 Connect et l’application de terrain Survey123. Ces fonctions ne sont pas disponibles dans Survey123 Studio ou Survey123 Mobile.
Les questions à sélection unique ou à sélection multiple prennent en charge l’apparence search (recherche) qui permet de renseigner la liste de choix avec les valeurs d’une table CSV figurant dans le dossier media de l’enquête ou encore d’une table ou couche d’entités existante. Lors de l’utilisation de l’apparence search, vous devez toujours inclure une entrée dans la feuille de calcul de choix, mais au lieu d’énumérer chaque choix, vous référencerez le nom du champ de la table ou de la couche d’entités existante.
Dans l’exemple suivant, une liste de choix nommée us_states est définie dans la feuille de calcul de choix et utilisera le champ STATE_NAME comme nom du choix et comme libellé.
Dans l’exemple suivant, cette liste de choix est ensuite référencée sur la feuille de calcul d’enquête de la même manière que les autres listes de choix, mais elle inclut l’expression d’apparence search qui désigne la couche d’entités existante à partir de laquelle les choix sont extraits.
L’expression d’apparence search doit se présenter de la manière suivante, les variables étant séparées par des virgules :
search(tableName, searchType, searchColumn, searchText, filterColumn, filterText)Le paramètre tableName accepte soit le nom du fichier .csv dans le dossier media de l’enquête (par exemple, airports), soit l’URL d’une couche d’entités ou d’une couche de service de carte, précédée par un nom dans Survey123 permettant de désigner la table en interne. Ce nom de table ne doit pas forcément correspondre au nom de la couche hébergée, mais comme il s’agit de la façon dont Survey123 fait référence en interne à votre recherche, il doit être différent de tous les autres noms de table et fichiers .csv utilisés dans l’enquête. Vous pouvez également ajouter des paramètres de demandes de requête au point de terminaison REST de votre couche d’entités ou de vos couches de services de carte pour configurer le comportement de la recherche. Dans l’exemple suivant, une URL de couche d’entités est ajoutée au paramètre resultRecordCount pour alimenter la liste de choix avec les 10 premiers résultats de la requête, la recherche étant stockée en interne sous le nom de airports :
"airports?url=https://services1.arcgis.com/e7dVfn25KpfE6dDd/arcgis/rest/services/Airports2/FeatureServer/0&resultRecordCount=10"Il est également possible de filtrer la liste de choix à l’aide d’une expression WHERE. Lors de l’utilisation de l’exemple suivant en tant que tableName, la liste de choix sera filtrée pour n’afficher que les États dont le nom n’est ni Alabama, ni Alaska :"state?url=https://services.arcgis.com/P3ePLMYs2RVChkJx/arcgis/rest/services/USA_States_Generalized_Boundaries/FeatureServer/0&where=STATE_NAME
NOT IN('Alabama', 'Alaska')"
Remarque :
Les paramètres de recherche qui comportent des caractères spéciaux doivent être encodés si l’enquête est destinée à un usage dans l’application Web Survey123. L’encodage remplace les caractères spéciaux (tel qu’un caractère générique dans l’expression) par le signe de pourcentage (%) suivi de leur équivalent hexadécimal.
Les paramètres supplémentaires suivants sont facultatifs, mais permettent d’affiner les résultats de la recherche :
| Paramètre | Description |
|---|---|
searchType | Contrôle le type de recherche réalisée et accepte différentes valeurs selon que la table compulsée est un table spatiale figurant dans une couche d’entités ou une table non spatiale dans une table d’entités ou une table CSV. Dans le cas de tables spatiales, les types de recherche acceptés sont intersects, contains, crosses, envelope_intersects, index_intercepts, overlaps, touches et within. Pour en savoir plus, reportez-vous à Relations spatiales. Dans le cas d’une table non spatiale, les types de recherche pris en charge sont contains, startswith, endswith et matches. |
searchColumn | Détermine la colonne dans laquelle le texte défini pour le paramètre searchText sera recherché. Ces colonnes proviennent de la table elle-même. De plus, une table spatiale figurant dans une couche d’entités peut faire une recherche sur les colonnes @geopoint, @geotrace et @geoshape. |
searchText | Contient le texte à rechercher et renvoyé dans le paramètre searchColumn. |
Par ailleurs, les paramètres de filtre suivants peuvent être ajoutés à l’expression de recherche pour affiner davantage les valeurs de la liste de choix :
| Paramètre | Description |
|---|---|
filterColumn | Définit une colonne dans laquelle des correspondances par rapport au texte fourni dans le paramètre filterText sont recherchées. La requête de recherche ne renvoie que les résultats contenant ce texte. Les paramètres filterColumn et filterText doivent être utilisés ensemble. |
filterText | Texte recherché dans la colonne indiquée par le paramètre filterColumn. Les paramètres filterColumn et filterText doivent être utilisés ensemble. |
L’expression de recherche d’exemple suivante comporte certains des paramètres facultatifs dans l’apparence search. Elle alimente une liste de choix avec le contenu d’un fichier .csv qui utilise une question précédente comme texte de recherche.
search('csvName', 'matches', 'breed', ${DogQuestion})
Remarque :
Les questions à l’apparence search (recherche) sont présentées dans l’application Web Survey123 de la même manière que les questions de type sélection à l’apparence autocomplete.
Préciser d’autres choix
Pour les questions à choix multiple, les enquêtes peuvent inclure la possibilité de choisir other (autre) lorsque le choix voulu n’est pas proposé. Le participant peut alors être invité à préciser l’autre option. Vous pouvez le faire dans XLSForm par la méthode manuelle ou par la méthode intégrée. La méthode intégrée est plus rapide et plus simple à configurer que la méthode manuelle, mais présente des limitations.
Méthode manuelle
La méthode manuelle est recommandée car elle permet de spécifier le nom et l’étiquette de l’autre choix et le nom et l’étiquette de la question à texte collectant l’autre réponse. Vous pouvez fournir la traduction de ces noms et de ces étiquettes. Vous pouvez également appliquer des contraintes et des apparences à la question à texte et la rendre obligatoire.
Commencez par ajouter un choix other (autre) à la liste de choix pour la question sur la feuille de calcul de choix. Spécifiez un nom et une étiquette pour ce choix comme vous le feriez pour n’importe quel autre choix dans la liste. Dans l’exemple suivant, la liste de choix color (couleur) comporte un choix nommé other (autre).
Sur la feuille de calcul de l’enquête, ajoutez une question à texte pour collecter l’autre réponse. Ajoutez une expression pertinente de sorte que la question à texte ne soit pertinente que si le choix other (autre) est sélectionné. Dans l’exemple suivant, la question other_color (autre couleur) est pertinente lorsque la réponse à la question select_one est other (autre).
Dans le cas des enquêtes multilingues, il est possible de traduire les questions et les choix. Dans l’exemple suivant, les traductions en français et en grec sont fournies sur la feuille de calcul de l’enquête pour la question select_one et la question à texte.
Des traductions sont également fournies sur la feuille de calcul de choix, y compris pour le choix other (autre).
Méthode intégrée
Avec la méthode intégrée, Survey123 Studio et Survey123 Connect créent automatiquement le choix other (autre) et la question pour collecter l’autre réponse. Pour utiliser cette méthode, saisissez or_other (ou_autre) après le nom de la liste de choix dans la colonne type, dans la feuille de calcul de l’enquête. Un choix Other (Autre) est affiché dans la liste de choix de la question. Lorsque le choix Other (Autre) est sélectionné, une question Specify other (Préciser d’autres choix) s’affiche pour permettre aux utilisateurs de fournir leur propre réponse. Pour stocker cette réponse, Survey123 Studio et Survey123 Connect créent automatiquement un champ supplémentaire dans la couche d’entités en utilisant le nom de la question à choix multiple suivi de _other (par exemple, favorite_toppings_other). Consultez l’exemple ci-dessous :
Attention :
L’étiquette de la question Specify Other (Préciser d’autres choix) ne s’affiche pas dans d’autres langues que l’anglais.
Si l’enquête est créée à partir d’une couche d’entités existante, le champ pour la question Specify other (Préciser d’autres choix) n’est pas créé automatiquement et l’enquête n’est pas publiée. Vous devez créer le champ manuellement pour la question Specify other (Préciser d’autres choix) dans la couche d’entités, avec le nom de la question à choix multiple suivi de _other, par exemple favorite_toppings_other.
Listes de choix externes
Vous pouvez stocker des listes de choix correspondant aux questions à choix unique et à choix multiples dans un fichier .csv CSV externe. Il s’agit d’une possibilité idéale pour les listes de choix volumineuses et une enquête comportant plusieurs listes de choix, ainsi que pour les listes de choix gérées hors de Survey123. Les listes de choix externes ne doivent pas être confondues avec les sélections externes, dans lesquelles les choix doivent être répertoriés dans une feuille de calcul supplémentaire.
Le fichier .csv doit contenir des colonnes de nom et d’étiquette.
Remarque :
S’il manque un en-tête de colonne dans le fichier .csv ou si une virgule se trouve à la fin des lignes du fichier, il est impossible d’importer le fichier dans l’enquête.
Pour obtenir de meilleurs résultats, encodez le fichier .csv selon l’encodage de caractères UTF-8. Si vous utilisez Microsoft Excel pour créer le fichier .csv, enregistrez-le au format CSV UTF-8.
Les colonnes d’étiquettes traduites peuvent être incluses dans le fichier .csv, mais les choix traduits ne s’afficheront que dans Survey123 Studio, Survey123 Connect, Survey123 Mobile et l’application de terrain, et n’apparaîtront pas dans l’application Web.
Pour inclure une question avec une liste de choix externes, entrez le type de question (select_one_from_file ou select_multiple_from_file) suivi du nom du fichier .csv, par exemple, select_one_from_file CoverType.csv. Les noms de fichier sont sensibles à la casse et n’acceptent pas les espaces.
Vous pouvez inclure un fichier .csv de deux manières : en stockant le fichier dans le dossier media de l’enquête ou en créant un lien vers un fichier .csv hébergé dans ArcGIS.
Conseil :
Exécutez l’outil Convertir les listes de choix au format CSV pour automatiser la migration des listes de choix à partir de la feuille de calcul des choix vers des fichiers .csv.
Lier un fichier .csv
Remarque :
Cette section décrit les fonctions qui sont uniquement disponibles dans Survey123 Connect et l’application de terrain Survey123. Ces fonctions ne sont pas disponibles dans Survey123 Studio ou Survey123 Mobile.
Pour lier un fichier .csv d’un contenu ArcGIS à une enquête, procédez comme suit :
- Assurez-vous que le fichier .csv est hébergé dans ArcGIS Online ou dans ArcGIS Enterprise et qu’il possède les mêmes autorisations de partage que l’enquête.
- Vérifiez que l’enquête est publiée sur ArcGIS avant d’essayer de lier le contenu.
- Dans ,Survey123 Connect ouvrez l’enquête et cliquez sur l’onglet Linked Content (Contenus liés). Cliquez sur le bouton Link content (Contenus liés), sélectionnez CSV, accédez au fichier .csv à lier et sélectionnez-le.
Pour faire en sorte que l’aperçu du formulaire affiche les choix du fichier .csv lié, dans Survey123 Connect, accédez à l’onglet Link content (Contenus liés) et cliquez sur le bouton de téléchargement 
. Une copie du fichier .csv est alors placée dans le dossier media de l’enquête. Les fichiers liés sont automatiquement téléchargés avec l’enquête dans l’application de terrain.
Si vous placez manuellement le fichier .csv dans le dossier media de l’enquête et que vous chargez ultérieurement un fichier .csv du même nom dans ArcGIS puis que vous le liez à l’enquête, le fichier .csv de l’enquête est mis à jour avec le contenu lié (s’il est plus récent).
Convertir les listes de choix au format CSV
Remarque :
Cette section décrit les fonctions qui sont uniquement disponibles dans Survey123 Connect et l’application de terrain Survey123. Ces fonctions ne sont pas disponibles dans Survey123 Studio ou Survey123 Mobile.
Exécutez l’outil Convertir les listes de choix au format CSV dans Survey123 Connect pour automatiquement migrer les listes de choix spécifiées à partir de la feuille de calcul des choix vers les nouveaux fichiers .csv dans le dossier media. L’outil modifie également les questions correspondantes dans la feuille de calcul de l’enquête pour faire en sorte que les questions de type select_one_from_file (sélection unique à partir d’un fichier) et select_multiple_from_file (sélection multiple à partir d’un fichier) soient utilisées.
Pour exécuter l’outil, procédez comme suit :
- Configurez un environnement Python dans Survey123 Connect pour pouvoir exécuter l’outil. Pour plus d’informations, reportez-vous à la rubrique Configurer Python.
- Ouvrez le formulaire XLSForm de l’enquête. Dans la feuille de calcul choices (choix), ajoutez une colonne nommée esri_tool_convert_csv (esri_outil_convertir_csv). Ajoutez une valeur yes à au moins une ligne pour chacune des listes de choix que vous souhaitez convertir en listes de choix externes. Enregistrez et fermez le fichier.
- Dans Survey123 Connect, ouvrez l’enquête, cliquez sur Tools (Outils) et sélectionnez Convertir les listes de choix au format CSV.
Une fois la conversion terminée, un fichier .csv est enregistré dans le dossier media pour chaque liste de choix migrée. Le nom de fichier correspond à la valeur initiale du nom de la liste de choix (colonne list_name (nom_liste)). La feuille de calcul des choix est mise à jour pour inclure uniquement les listes restantes n’ayant pas été migrées. Elle comprend toujours les en-têtes de colonne personnalisés de la feuille d’origine. Dans la feuille de calcul de l’enquête, les questions select_one (sélection unique) et select_multiple (sélection multiple)concernées sont modifiées en questions select_one_from_file (sélection unique à partir d’un fichier) et select_multiple_from_file (sélection multiple à partir d’un fichier) pour référencer les nouvelles listes de choix externes. La feuille de calcul des choix d’origine est enregistrée dans une feuille de calcul choices_backup pour que vous puissiez vérifier les résultats ou rétablir les valeur initiales. Vous pouvez conserver ou supprimer la feuille de calcul de sauvegarde.
L’outil ne convertit pas les listes de choix utilisées dans les questions Classement, les groupes table-list (table-liste) ou les questions possédant l’apparence search (recherche). Aucune question utilisant ces listes de choix n’est modifiée dans l’enquête.
Si l’outil détecte des questions non prises en charge, un fichier .xlsx est créé dans le dossier debug avec les noms des listes de choix concernées. Ce fichier se trouve également dans le dossier suivant :
C:\Users\<username>\ArcGIS\My Survey Designs\<surveyName>\debug\convertchoicelists
Vous avez un commentaire à formuler concernant cette rubrique ?