Choix multiples

XLSForm prend en charge les questions de type select_one (ne sélectionner qu’une seule réponse), select_multiple (sélectioner plusieurs réponses) et rank (classer une liste de choix). 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 :

Notez que la réponse yes_no (oui_non) dans la feuille de calcul de l’enquête doit correspondre à yes_no (oui_non) dans la colonne de nom de liste de 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.

Lorsque vous modifiez les choix des questions de type select_one et republiez l’enquête, Survey123 Connect affiche un récapitulatif des changements et vous pouvez décider d’appliquer ou non ces changements aux domaines dans la couche d’entités. Pour plus d’informations, voir Mettre à jour une enquête.

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.

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}')

Préciser d’autres choix

Pour les questions à choix multiples, les enquêtes peuvent comprendre l’option de choix différente lorsque le choix voulu n’est pas répertorié. 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 cette méthode, Survey123 Connect crée 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 Connect crée automatiquement un champ supplémentaire dans la couche d’entités en utilisant le nom de la question à choix multiples 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 multiples suivi de _other (_autre), par exemple favorite_toppings_other (garniture_préférée_autre).

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 Connect et l’application de terrain Survey123, et n’apparaîtront pas dans l’application Web Survey123

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

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 Survey123.

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

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