Añadir criterios de validación en el editor de formularios de KoboToolbox (Formbuilder)

Read in English | Lire en français | اقرأ باللغة العربية Última actualización: 2 Oct 2025

La lógica de validación, también conocida como criterios de validación o restricciones, define las condiciones para una respuesta aceptable a una pregunta. Esta funcionalidad ayuda a garantizar datos de alta calidad al prevenir respuestas accidentales o inválidas.

Los criterios de validación se pueden aplicar a cualquier tipo de pregunta. Por ejemplo, puedes usarlos para asegurar que un/a participante tenga más de cierta edad, que una fecha esté dentro de un rango específico, o que una entrada de texto coincida con un patrón determinado.

Existen dos métodos para añadir criterios de validación en el editor de formularios: añadir una condición a través del constructor de criterios de validación, o ingresar manualmente la lógica de validación en código XLSForm.

Añadir una condición

El constructor de criterios de validación te permite añadir condiciones para preguntas de Texto, Número, Decimal y Fecha. No es compatible con preguntas de Seleccionar Uno o Seleccionar Varios. Para usar el constructor:

  1. Abre la Configuración en el menú lateral derecho de la pregunta.

  2. Selecciona Criterios de Validación, y haz clic en Añadir una condición.

  3. Elige el operador lógico apropiado para tu condición (por ejemplo, >, =, !=).

  4. En el campo valor de respuesta, selecciona o escribe el valor que se requiere para que la respuesta sea válida.

Nota: Para añadir criterios de validación a preguntas de Fecha, el valor de respuesta debe estar en formato AAAA-MM-DD. Por ejemplo, para establecer un criterio de validación para que una fecha sea anterior al 1 de enero de 2021, usa < 2021-01-01.

Para añadir múltiples condiciones (por ejemplo, un valor mínimo y un valor máximo), añade tu primera condición, luego haz clic en Añadir otra condición. Cuando uses múltiples condiciones, especifica si al menos una de estas condiciones debe cumplirse o todas ellas. Puedes eliminar condiciones haciendo clic en el ícono de papelera.

Si no se cumplen las condiciones de validación, la entrada no será aceptada durante la recolección de datos. Se mostrará un mensaje de error.

Ingresar manualmente la lógica de validación en código XLSForm

Para usuarios/as avanzados/as y para preguntas de Seleccionar Uno o Seleccionar Varios, los criterios de validación se pueden ingresar directamente en código XLSForm.

Para ingresar manualmente la lógica de validación en código XLSForm, sigue estos pasos:

  1. Abre la Configuración en el menú lateral derecho de la pregunta.

  2. Selecciona Criterios de Validación, y haz clic en Ingresar manualmente tu lógica de validación en código XLSForm.

  3. Ingresa los criterios en código XLSForm.

En la sintaxis XLSForm, se usa un punto . para referirse a la pregunta actual, y ${nombre_pregunta} se usa para referirse a otras preguntas. También necesitarás incluir el operador lógico relevante y el valor de respuesta.

Ejemplos de Criterios de Validación

Criterio

Descripción

. > 17

La respuesta debe ser mayor que 17

. >= 17 and . <= 130

La respuesta debe ser igual o estar entre 17 y 130

not(${en_universidad} = 'yes' and . < 16)

No se puede proporcionar una respuesta menor a 16 si la respuesta a en_universidad es «Sí»

not(selected(., 'none') and count-selected(.)>1)

No se puede seleccionar «Ninguno» y otras opciones en una pregunta de Seleccionar Varios

Para más información sobre código XLSForm y operadores, consulta la documentación de XLSForm.

Mensaje de error

El mensaje de error es un mensaje opcional que el/la entrevistador/a o encuestado/a verá cuando se ingrese una respuesta inválida. Se puede configurar tanto usando el enfoque del constructor de criterios de validación como el enfoque de código XLSForm, en la parte inferior del cuadro.

Si no se especifica ningún mensaje de error, el mensaje predeterminado es «Valor no permitido». Los mensajes de error personalizados típicamente especifican los criterios de validación para ayudar al/a la encuestado/a a corregir su respuesta (por ejemplo, «La edad debe ser mayor que 18»).