Crear un XLSForm

Última actualización: 23 abr 2026

Al crear formularios de encuesta con KoboToolbox, puedes crear tu formulario con el editor de formularios de KoboToolbox (Formbuilder) o usando XLSForm. XLSForm es muy efectivo para crear formularios básicos y avanzados en un formato fácil de usar.

Para obtener más información sobre XLSForm, consulta Introducción a XLSForm. Para una introducción completa al desarrollo de formularios usando XLSForm, recomendamos el curso XLSForm Fundamentals en línea de aprendizaje autónomo de KoboToolbox Academy.

Este artículo explica cómo configurar un XLSForm usando Microsoft Excel u otros programas de hojas de cálculo, incluyendo:

  • Configurar la estructura básica de tu XLSForm

  • Agregar preguntas y opciones de respuesta

  • Agregar configuración del formulario y columnas opcionales

  • Cargar y previsualizar tu XLSForm en KoboToolbox

Nota: Algunas funcionalidades de XLSForm no están disponibles actualmente en el Formbuilder, pero los formularios de KoboToolbox se pueden descargar, modificar en XLSForm y cargar de nuevo a KoboToolbox.

Configurar un XLSForm

Para configurar la estructura básica de un XLSForm:

  1. Abre una nueva hoja de cálculo en tu programa de hojas de cálculo preferido.

  2. Crea tres hojas de trabajo: survey, choices y settings.

    • Los nombres de las hojas de trabajo deben estar en minúsculas.

  3. En la hoja survey, crea tres columnas con los encabezados: type, name y label.

  4. En la hoja choices, crea tres columnas con los encabezados: list_name, name y label.

  5. La hoja settings es opcional. Se puede usar para incluir especificaciones y personalizaciones adicionales del formulario.

    • Por ejemplo: form_title, style y default_language.

Para comenzar con XLSForm, descarga un XLSForm de ejemplo aquí.

Columnas obligatorias en XLSForm

Las siguientes columnas son obligatorias en XLSForm:

hoja survey

Nombre de columna

Descripción

type

Define el tipo de pregunta (ej., text, integer, select_one)

name

Define un nombre corto y único para referirse a cada pregunta

label

Define el texto de la pregunta tal como se mostrará en el formulario

hoja choices

Nombre de columna

Descripción

list_name

Define el identificador único para una lista de opciones de respuesta

name

Define un nombre corto y único para referirse a cada opción de respuesta

label

Define el texto de la opción tal como se mostrará en el formulario

Agregar preguntas

En XLSForm, las preguntas se agregan en la hoja survey. Para agregar preguntas en XLSForm:

  1. En la columna type de la hoja survey, ingresa el tipo de pregunta de la pregunta que deseas agregar.

  2. En la columna name, ingresa un nombre usado para identificar la pregunta.

    • Cada pregunta debe tener un nombre único y no puede contener espacios ni símbolos (excepto guiones bajos).

  3. En la columna label, ingresa el texto de la pregunta tal como debe mostrarse en el formulario durante la recolección de datos.

hoja survey

type

name

label

text

yourname

¿Cuál es tu nombre?

survey

  1. Si estás agregando preguntas de tipo selección (select_one, select_multiple o rank): en la columna type, después del tipo de pregunta, agrega un espacio e ingresa el nombre de la lista de opciones.

    • El nombre de la lista de opciones se define más adelante en la hoja choices como list_name.

hoja survey

type

name

label

select_one sex

baby_sex

¿Cuál es el sexo de tu bebé?

survey

Para obtener más información sobre los tipos de pregunta en XLSForm, consulta Tipos de preguntas en XLSForm.

Agregar opciones de respuesta

Para preguntas de tipo selección, las opciones de respuesta se agregan en la hoja choices. Para agregar opciones de respuesta en XLSForm:

  1. En la columna list_name de la hoja choices, ingresa el nombre de la lista de opciones de respuesta.

    • El list_name es un identificador único para una lista de opciones de respuesta. Debe coincidir con el nombre de lista ingresado en la columna type de la hoja survey.

  2. En la columna name, agrega un nombre corto para cada opción de respuesta.

    • Cada opción dentro de una lista debe tener un name único, que no puede contener espacios ni símbolos (excepto guiones bajos).

  3. En la columna label, ingresa el texto de la opción tal como debe mostrarse en el formulario durante la recolección de datos.

hoja choices

list_name

name

label

sex

male

Masculino

sex

female

Femenino

choices

Para obtener más información sobre la administración de opciones de respuesta en XLSForm, consulta Administrar opciones de respuesta en XLSForm.

Agregar configuraciones

Hay muchas configuraciones opcionales que se pueden agregar a la hoja settings en XLSForm.

Las configuraciones comunes del formulario incluyen:

Configuración

Descripción

form_title

Título que se muestra en la parte superior del formulario

default_language

Idioma predeterminado del formulario

style

Temas para formularios web

version

ID de versión del formulario

Por ejemplo, para agregar un título de formulario:

  1. Agrega una columna en la hoja settings llamada form_title.

  2. Ingresa el título del formulario en la columna form_title.

Nota: Todas las configuraciones del formulario son opcionales. Si no defines un título de formulario en tu XLSForm, el nombre del archivo de Excel se usará como el nombre del proyecto en KoboToolbox de forma predeterminada. Esto se puede editar en KoboToolbox.

hoja settings

form_title

Comenzar con
XLSForm

settings

Para obtener más información sobre la hoja de configuraciones en XLSForm, consulta Configuración de formularios en XLSForm.

Agregar columnas opcionales a la hoja survey

Para personalizar aún más tu XLSForm, puedes agregar columnas opcionales para configurar la lógica del formulario, opciones de preguntas y configuraciones avanzadas. Las columnas opcionales comunes incluyen:

Nombre de columna

Descripción

hint

Sugerencia de pregunta

guidance_hint

Sugerencia adicional

required

Hace que una pregunta sea obligatoria

relevant

Condiciones de lógica de omisión para la pregunta

constraint

Criterios de validación para la pregunta

constraint_message

Mensaje de error cuando no se cumplen los criterios de validación

appearance

Opciones para cómo se muestran las preguntas

choice_filter

Criterios para selección en cascada

parameters

Configuraciones para tipos de pregunta específicos

calculation

Expresión matemática para pregunta calculate

default

Respuesta predeterminada para una pregunta

Para obtener más información sobre las columnas opcionales en XLSForm, consulta Opciones de preguntas en XLSForm, Apariencia de preguntas en XLSForm y Introducción a la lógica de formularios en XLSForm.

Cargar y previsualizar tu XLSForm en KoboToolbox

Una vez que hayas terminado de desarrollar tu XLSForm, puedes cargarlo y previsualizarlo en KoboToolbox:

  1. Ve a la página de inicio de Proyecto en KoboToolbox y haz clic en NUEVO.

  2. Selecciona Cargar un XLSForm y carga tu archivo XLSForm.

  3. Ingresa los detalles del proyecto y haz clic en CREAR PROYECTO.

  4. Haz clic en el botón Previsualizar.

Si tu XLSForm contiene un error, aparecerá un mensaje de error, generalmente indicando la fila, pregunta o expresión exacta donde se encuentra el problema. Después de corregir el error en tu XLSForm, deberás cargar el archivo nuevamente.

Para aprender cómo descargar un XLSForm de KoboToolbox, importar tu XLSForm a través de URL y usar KoboToolbox para validar y probar tu XLSForm, consulta Usar XLSForm con KoboToolbox.