Ir al contenido
Base de conocimiento

Importar un cuestionario

Ya tiene un cuestionario: un formulario en papel, un PDF de una oficina de estadística, un borrador en Markdown. La importación lo convierte en un borrador de cuestionario de su proyecto, escrito en QML y comprobado por el validador Z3, para que pueda editarlo, traducirlo y llevarlo a campo como cualquier otro. Askalot lee el archivo, enumera todas las preguntas que encuentra con el número que figura impreso en el original y genera el cuestionario a partir de esa lista.

Formato Límites
PDF, nativo digital o escaneado Hasta 100 MB y 300 páginas
Markdown (texto UTF-8) Hasta 2 MB

Los PDF protegidos con contraseña y los formularios XFA dinámicos se rechazan con un mensaje que indica qué hacer (guardar una copia sin protección; imprimir el formulario en blanco a PDF). Divida los documentos más largos e importe las partes por separado. Otros formatos, como XLSForm, LimeSurvey, SurveyJS y REDCap, están previstos.

  • Un proveedor de IA propio. La importación usa dos de sus ranuras de modelo, en Configuración del perfil → Modelos de IA: la ranura Razonamiento debe usar una clave de la API de Anthropic o AWS Bedrock, y la ranura LLM directo lee las páginas que necesitan una imagen de la página (escaneos, cuadrículas, texto dañado). Consulte Funciones de IA y opciones de modelo.
  • Un rol que diseñe cuestionarios. Necesita el rol de diseñador o de gestor en la organización, y poder editar el proyecto.
  • Un límite mensual de importaciones. En el servicio gratuito, cada importación que inicia cuenta para su límite mensual de importaciones, incluida la que falle más adelante. Consulte Límites de uso razonable.

Si falta algo, la importación se rechaza antes de que se almacene su archivo y antes de usar ninguna IA, y el mensaje indica qué debe cambiar.

En el editor, haga clic con el botón derecho en la carpeta questionnaires y elija Importar cuestionario desde PDF o Markdown… (también está en la paleta de comandos); después, elija el archivo. Solo este comando inicia una importación: un archivo que se suelta en la carpeta sin usarlo se rechaza, porque una importación usa su proveedor de IA y cuenta para su límite mensual.

Un cliente de IA conectado por MCP puede hacer lo mismo con tres llamadas; consulte Importar un cuestionario impreso.

La importación se ejecuta en segundo plano. Un formulario breve tarda unos minutos; un instrumento largo puede tardar una hora o más. Puede seguir trabajando o cerrar el editor. El archivo aparece en la carpeta questionnaires con lo que está haciendo la importación («Importando visitor-survey.pdf: leyendo las páginas», etc.), en todas las pestañas y para todos los clientes del proyecto. Cuando termina, se abre el nuevo cuestionario, o el editor le explica por qué se detuvo.

  • Las respuestas rellenadas se descartan. Si el archivo es un formulario cumplimentado, los valores de sus campos de formulario, las casillas marcadas y las respuestas manuscritas se eliminan antes de que nada más lea el texto. Solo se usa el cuestionario impreso, y el informe indica que se descartaron respuestas. Un archivo Markdown se considera en blanco salvo por sus casillas marcadas.
  • El contenido oculto se ignora. El texto que un lector no puede ver (texto blanco, texto fuera de la página, comentarios en Markdown) se descarta.
  • El archivo subido se elimina. Su archivo se elimina cuando termina la importación, tanto si tuvo éxito como si falló o fue rechazada. No se añade a los documentos del proyecto ni se indexa para la búsqueda.
  • Lo que leyó la importación de un PDF se conserva. El texto con el que trabajó la importación, ya sin las respuestas, se queda con el nuevo cuestionario como su fuente de importación (véase más abajo). Un archivo Markdown no se conserva así, porque una respuesta escrita a máquina no se puede distinguir del texto del cuestionario.

Un borrador de cuestionario en el proyecto, en el idioma del original, con:

  • Su inventario: la lista a partir de la cual se generó el cuestionario. Relaciona cada número de pregunta impreso en el original con el ítem que la formula, indica qué partes del original se omitieron y por qué, y contiene el informe de importación: las páginas leídas a partir de una imagen, si se descartaron respuestas, las objeciones que la fase de revisión dejó abiertas y los problemas que el validador sigue señalando. El inventario describe la primera versión y no cambia con sus ediciones posteriores. Un cliente de IA lo lee con get_questionnaire_inventory.
  • Su fuente de importación (solo PDF): las páginas tal como las leyó la importación, en Markdown, para que pueda contrastar una pregunta con lo que vio la importación. Los títulos en letra más grande se convierten en encabezados y las opciones de respuesta en elementos de lista; los encabezados y pies de página repetidos y los números de página impresos se eliminan y se contabilizan. Cada página se etiqueta con su número de página en el archivo, el número impreso en ella y si se leyó del texto o de una imagen de la página; los números de página del inventario son los del archivo. Al igual que el inventario, nunca cambia con ediciones posteriores, y se mueve, se elimina y se restaura junto con el cuestionario. Un cliente de IA la lee unas pocas páginas cada vez con get_questionnaire_import_source.
  • Comprobaciones inventadas marcadas. Algunas comprobaciones no figuran en el original como reglas estrictas: una validación flexible, o una instrucción para el entrevistador como «indague si son más de 80 horas». La importación las escribe igualmente como comprobaciones, para que los datos sigan siendo coherentes, pero marca cada una con invented: true y el editor la resalta. Confirme o cambie cada una y, después, quite la marca. Los encuestados nunca la ven. Consulte Sintaxis de QML.
  • Un veredicto de Z3. El cuestionario se valida como cualquier otro. Cuando quedan problemas, el editor indica cuántos son y los enumera en el panel Problemas; el cuestionario se guarda igualmente como borrador, y la publicación espera hasta que se corrijan.

Las instrucciones de salto impresas («Si responde No, pase a la P12») se convierten en condiciones sobre las preguntas que se saltan, también entre secciones. Un salto que no se puede seguir, por ejemplo uno que apunta hacia atrás o a una pregunta que el archivo no contiene, nunca se adivina: figura en el inventario como omitido, con el motivo, para que usted lo resuelva.