Sélectionner des options à partir de fichiers externes dans le Formbuilder

Dernière mise à jour : 21 Mar 2026

Les questions Choix unique à partir d’un fichier et Choix multiple à partir d’un fichier vous permettent d’utiliser une liste de choix de réponse stockée dans un fichier externe plutôt que de la définir directement dans votre formulaire. Il en existe deux types :

• Choix unique à partir d’un fichier pour sélectionner un seul choix

• Choix multiple à partir d’un fichier pour sélectionner plusieurs choix

L’utilisation d’un fichier externe pour votre liste de choix facilite la gestion de longues listes dans l’interface de création de formulaires KoboToolbox (KoboToolbox Formbuilder). Les formats de fichiers disponibles sont CSV, XML et GeoJSON.

Cet article explique comment formater votre fichier externe, l’importer dans KoboToolbox et configurer des questions Choix à partir d’un fichier dans le Formbuilder.

Formater les listes de choix externes

Pour commencer, créez votre liste de choix dans un fichier externe séparé. La structure requise de ce fichier dépend du format choisi (CSV, XML ou GeoJSON). Utilisez un fichier distinct pour chaque liste de choix.

Pour en savoir plus sur le formatage des fichiers XML ou GeoJSON, consultez la documentation XLSForm et ODK. Les fichiers GeoJSON sont principalement utilisés pour sélectionner des options à partir d'une carte.

Si vous utilisez un fichier CSV pour vos choix de réponse, il doit contenir au minimum deux colonnes : name et label.

• La colonne name représente la valeur XML de votre choix de réponse.

• La colonne label représente le libellé du choix tel qu’il s’affiche dans votre formulaire.

Fichier CSV externe

name	label
option1	Option 1
option2	Option 2
option3	Option 3

Si votre fichier utilise des noms différents pour le nom et le libellé du choix, vous pouvez le préciser en téléchargeant votre formulaire en tant que XLSForm et en ajoutant une colonne parameters.

Note : Utilisez des noms de fichiers courts et simples pour vos fichiers externes, en évitant les espaces et les caractères spéciaux. Le nom du fichier sera utilisé pour associer les questions à leurs listes de choix. Si vous utilisez plusieurs fichiers externes, assurez-vous que chacun porte un nom unique, même s'ils utilisent des types de fichiers différents.

Importer le fichier externe dans KoboToolbox

Avant de créer une question Choix à partir d’un fichier dans le Formbuilder, vous devez importer le fichier externe contenant votre liste de choix :

1. Dans KoboToolbox, accédez à la page PARAMÈTRES du projet.

2. Dans l’onglet Média, importez le fichier externe. Vérifiez que le nom du fichier correspond exactement au nom de fichier indiqué dans le XLSForm.

Pour mettre à jour votre liste de choix, modifiez le fichier externe selon vos besoins, importez-le à nouveau dans KoboToolbox, puis redéployez votre formulaire.

Pour en savoir plus sur l'importation de fichiers multimédias, consultez l'article Importer des fichiers multimédias dans un projet.

Configurer la question dans le Formbuilder

Après avoir importé votre fichier CSV externe dans KoboToolbox, vous pouvez ajouter une question Choix unique à partir d’un fichier ou Choix multiple à partir d’un fichier dans le Formbuilder.

Pour ajouter une question de type choix à partir d’un fichier :

1. Cliquez sur le bouton .

2. Saisissez le libellé de votre question.

3. Cliquez sur + AJOUTER UNE QUESTION.

4. Choisissez Choix unique à partir d’un fichier ou Choix multiple à partir d’un fichier comme type de question.

Note : Les types de questions Choix unique à partir d'un fichier et Choix multiple à partir d'un fichier n'apparaissent comme options dans le Formbuilder que si un fichier de choix externe a été importé dans KoboToolbox.

Si un seul fichier externe a été importé dans votre projet, il sera automatiquement associé à la question. Si plusieurs fichiers ont été importés, ouvrez les Paramètres de la question et sélectionnez le fichier approprié dans le menu déroulant Fichier des choix.

Pour apprendre à configurer des questions de type choix à partir d'un fichier dans XLSForm et pour obtenir une aide supplémentaire à la résolution de problèmes, consultez l'article Sélectionner des options à partir d'un fichier externe avec XLSForm.