Aller au contenu
Base de connaissances

Importer un questionnaire

Vous disposez déjà d’un questionnaire : un formulaire papier, un PDF d’un institut de statistique, un brouillon en Markdown. L’import le transforme en brouillon de questionnaire de votre projet, écrit en QML et vérifié par le validateur Z3, que vous pouvez ensuite modifier, traduire et mettre sur le terrain comme n’importe quel autre. Askalot lit le fichier, recense chaque question qu’il y trouve avec le numéro imprimé dans la source, et génère le questionnaire à partir de cette liste.

Format Limites
PDF, nativement numérique ou numérisé Jusqu’à 100 Mo et 300 pages
Markdown (texte UTF-8) Jusqu’à 2 Mo

Un PDF protégé par mot de passe et un formulaire XFA dynamique sont refusés, avec un message qui indique la marche à suivre (enregistrer une copie non protégée ; imprimer le formulaire vierge en PDF). Découpez un document plus long et importez-en les parties. D’autres formats, comme XLSForm, LimeSurvey, SurveyJS et REDCap, sont prévus.

  • Votre propre fournisseur d’IA. L’import utilise deux de vos emplacements de modèles dans Paramètres du profil → Modèles IA : l’emplacement Raisonnement doit utiliser une clé d’API Anthropic ou AWS Bedrock, et l’emplacement LLM direct lit les pages qui exigent une image de la page (numérisations, grilles, texte abîmé). Voir Fonctions d’IA et choix des modèles.
  • Un rôle qui permet de concevoir des questionnaires. Il vous faut le rôle Concepteur ou Gestionnaire dans l’organisation, et vous devez pouvoir modifier le projet.
  • Une limite mensuelle d’imports. Sur le service gratuit, chaque import que vous lancez compte dans votre limite mensuelle d’imports, y compris un import qui échoue ensuite. Voir Limites d’usage raisonnable.

S’il manque quoi que ce soit, l’import est refusé avant que votre fichier ne soit stocké et avant tout recours à l’IA, et le message indique ce qu’il faut changer.

Dans l’éditeur, faites un clic droit sur le dossier questionnaires et choisissez Importer un questionnaire depuis un PDF ou un fichier Markdown… (la commande figure aussi dans la palette de commandes), puis sélectionnez le fichier. Seule cette commande lance un import : un fichier déposé sur le dossier sans passer par elle est refusé, car un import utilise votre fournisseur d’IA et compte dans votre limite mensuelle.

Un client IA connecté via MCP peut faire de même en trois appels ; voir Importer un questionnaire imprimé.

L’import s’exécute en arrière-plan. Un questionnaire court prend quelques minutes ; un instrument long peut demander une heure ou plus. Vous pouvez continuer à travailler ou fermer l’éditeur. Le fichier apparaît dans le dossier questionnaires avec l’étape en cours (« Import de visitor-survey.pdf — lecture des pages », etc.), dans chaque onglet et pour chaque client du projet. À la fin, le nouveau questionnaire s’ouvre, ou l’éditeur vous indique pourquoi l’import s’est arrêté.

  • Les réponses saisies sont écartées. Si le fichier est un formulaire rempli, les valeurs de ses champs, les cases cochées et les réponses manuscrites sont supprimées avant que quoi que ce soit ne lise le texte. Seul le questionnaire imprimé est utilisé, et le rapport mentionne que des réponses ont été écartées. Un fichier Markdown est réputé vierge, à l’exception de ses cases cochées.
  • Le contenu masqué est ignoré. Le texte qu’un lecteur ne peut pas voir (texte blanc, texte hors de la page, commentaires en Markdown) est supprimé.
  • Le fichier téléversé est supprimé. Votre fichier est effacé à la fin de l’import, que celui-ci ait réussi, échoué ou été refusé. Il n’est pas ajouté aux documents du projet et n’est pas indexé pour la recherche.
  • Ce que l’import a lu dans un PDF est conservé. Le texte sur lequel l’import a travaillé, réponses déjà retirées, reste rattaché au nouveau questionnaire en tant que source d’import (voir plus bas). Un fichier Markdown n’est pas conservé de cette façon, car une réponse saisie au clavier ne peut pas être distinguée du texte du questionnaire.

Un brouillon de questionnaire dans le projet, dans la langue de la source, avec :

  • Son inventaire : la liste à partir de laquelle le questionnaire a été généré. Il associe chaque numéro de question imprimé dans la source à l’item qui pose cette question, indique quelles parties de la source ont été laissées de côté et pourquoi, et contient le rapport d’import : les pages lues à partir d’une image, si des réponses ont été écartées, les objections que l’étape de relecture a laissées ouvertes et les problèmes que le validateur signale encore. L’inventaire décrit la première version ; vos modifications ultérieures n’y changent rien. Un client IA le lit avec get_questionnaire_inventory.
  • Sa source d’import (PDF uniquement) : les pages telles que l’import les a lues, en Markdown, pour que vous puissiez comparer une question à ce que l’import a vu. Les titres en plus gros caractères deviennent des intertitres et les options de réponse des éléments de liste ; les en-têtes et pieds de page répétés et les numéros de page imprimés sont retirés et comptabilisés. Chaque page indique son numéro dans le fichier, le numéro qui y est imprimé et si elle a été lue depuis le texte ou depuis une image de la page ; les numéros de page de l’inventaire sont ceux du fichier. Comme l’inventaire, elle n’est jamais touchée par les modifications ultérieures, et elle est déplacée, supprimée et restaurée avec le questionnaire. Un client IA la lit quelques pages à la fois avec get_questionnaire_import_source.
  • Des contrôles inventés signalés. Certains contrôles ne sont pas énoncés comme des règles strictes dans la source : une vérification souple, ou une consigne à l’enquêteur telle que « relancer si plus de 80 heures ». L’import les écrit tout de même sous forme de contrôles, pour que les données restent cohérentes, mais marque chacun avec invented: true, et l’éditeur le met en évidence. Confirmez ou modifiez chacun d’eux, puis retirez la marque. Les répondants ne la voient jamais. Voir Syntaxe QML.
  • Un verdict Z3. Le questionnaire est validé comme n’importe quel autre. Lorsque des problèmes subsistent, l’éditeur en indique le nombre et les liste dans le panneau Problèmes ; le questionnaire est tout de même enregistré comme brouillon, et la publication attend qu’ils soient corrigés.

Les filtres imprimés (« Si Non, passez à Q12 ») deviennent des conditions sur les questions qu’ils font sauter, y compris d’une section à l’autre. Un saut qui ne peut pas être suivi, par exemple parce qu’il renvoie en arrière ou vers une question absente du fichier, n’est jamais deviné : il figure dans l’inventaire comme laissé de côté, avec la raison, pour que vous tranchiez.