Importar una colección con XLSForm

Última actualización: 20 Mar 2026

Una colección es un grupo de preguntas, bloques de preguntas y plantillas relacionadas, organizadas en tu biblioteca de KoboToolbox. Las colecciones te ayudan a gestionar contenido reutilizable por proyecto, tema, país u organización.

Puedes importar varias preguntas o bloques de preguntas a la vez como una colección usando un XLSForm. Este enfoque es útil cuando preparas conjuntos de preguntas estandarizadas fuera del Formbuilder de KoboToolbox o cuando migras contenido XLSForm existente a tu biblioteca.

Este artículo explica cómo estructurar y cargar un XLSForm para que se importe como una colección.

Configurar tu XLSForm

Para que tu XLSForm se importe correctamente en la biblioteca de preguntas de KoboToolbox, debe seguir una estructura específica. Una vez que tengas un XLSForm funcional, puedes adaptarlo para que funcione como una colección modificando su estructura:

  1. Renombra la hoja principal: Reemplaza la hoja survey estándar por una hoja llamada library.

  2. Incluye preguntas individuales o grupos de preguntas: Puedes incluir preguntas independientes o grupos de preguntas completos en la hoja library.

  3. Define bloques de preguntas usando una columna block: Añade una columna llamada block para agrupar preguntas relacionadas en un bloque de preguntas.

    • Ingresa el mismo título de bloque en cada fila que pertenezca a ese bloque.

    • Cualquier fila sin valor en la columna block se importará como una pregunta individual.

  4. Añade etiquetas (opcional): Para asignar etiquetas a una pregunta o bloque, añade una columna con el formato tag:[nombre de la etiqueta] (por ejemplo, tag:wash).

    • Ingresa 1 en cada fila que deba recibir la etiqueta.

    • Dentro de los bloques, es suficiente marcar solo una fila del bloque, aunque marcar varias filas no causará problemas.

Para ver un ejemplo de la estructura requerida, consulta este XLSForm de ejemplo.

Cargar tu XLSForm

Una vez que tu XLSForm esté estructurado correctamente como una colección, puedes cargarlo en tu biblioteca de KoboToolbox.

Para cargar tu XLSForm:

  1. Inicia sesión en tu cuenta de KoboToolbox.

  2. Haz clic en Library en el menú de la izquierda para abrir la biblioteca.

  3. Haz clic en NEW en la esquina superior izquierda.

  4. Selecciona Upload e importa tu XLSForm. Haz clic en Upload.

El archivo se importará como una colección en tu biblioteca de preguntas.

Para obtener más información sobre la biblioteca de KoboToolbox, consulta Usar la biblioteca de preguntas de KoboToolbox.

Consideraciones adicionales

Grupos dentro de bloques

Puedes incluir filas begin_group y end_group dentro de un bloque. Asegúrate de que la fila begin_group tenga un valor name único, como se requiere en la estructura estándar de XLSForm. Las filas de apertura y cierre del grupo deben estar incluidas dentro del mismo bloque.

Usar el nombre del bloque como etiqueta del grupo puede ayudar a mantener la claridad después de la importación.

Para obtener más información sobre los grupos de preguntas en XLSForm, consulta Grupos de preguntas en XLSForm.

Lógica de omisión y reglas de validación

Puedes incluir lógica de relevancia, restricciones y otra lógica de formulario en tu XLSForm. Estas configuraciones se conservarán durante la importación, lo cual es útil cuando reutilizas bloques de preguntas complejos sin tener que reconstruir la lógica avanzada.

Para obtener más información sobre la lógica de formularios en XLSForm, consulta Introducción a la lógica de formularios en XLSForm.

Múltiples idiomas

Puedes incluir traducciones usando la sintaxis estándar de XLSForm, como label::English (en) o label::Español (es). Las etiquetas traducidas y las etiquetas de opciones de respuesta se importarán junto con el bloque.

Para obtener más información sobre cómo añadir traducciones en XLSForm, consulta Añadir traducciones en XLSForm.