Creación de la cuenta personal en KoboToolbox

Para garantizar que los datos se alojen en servidores seguros y sin restricciones comerciales, utilizaremos el servidor global gratuito.

  1. Ingresa a kobotoolbox.org.
  2. Haz clic en “Sign Up” y selecciona la opción “Global (For Researchers, Aid Workers & Everyone Else)”.
  3. Completa el formulario de registro:
    • Nombre de usuario: Crea un usuario profesional y fácil de recordar (ej. nombre_apellido_2026). Guarda este usuario, será clave para el paso colaborativo.
    • Sector: Salud Pública / Academia.
  4. Revisa tu correo electrónico institucional o personal y haz clic en el enlace de activación.

Introducción al Trabajo de Campo

Este tutorial paso a paso guiará la construcción técnica del instrumento Encuesta Salud Familiar directamente en la plataforma KoboToolbox. Como parte de la formación en métodos de investigación, bioestadística y epidemiología, el objetivo de este ejercicio de aprendizaje activo es que dominen el constructor de formularios (Form Builder) para digitalizar, optimizar y validar sus instrumentos de recolección de datos antes de ir al terreno.


Paso 1: Creación del Proyecto y Entorno de Trabajo

  1. Ingresen a su cuenta de KoboToolbox (se recomienda utilizar la versión para investigadores o humanitaria).
  2. Hagan clic en el botón azul “Nuevo” (New) y seleccionen “Construir desde cero” (Build from scratch).
  3. Asignen un título al proyecto (ej. “Encuesta de Salud Familiar - Grupo 1”), una breve descripción de los objetivos del estudio y seleccionen el sector relacionado a la Salud Pública.
  4. Hagan clic en “Crear proyecto”.

Trabajo en red: Conectivismo en la construcción del instrumento

El aprendizaje no ocurre en aislamiento. En cada grupo de 8 personas, un solo estudiante (el coordinador) creará el proyecto base y otorgará permisos al resto de sus 7 compañeros para construir y validar el cuestionario de forma simultánea.

Pasos para el coordinador:

  1. Haz clic en “Nuevo” y selecciona “Construir desde cero”. Ponle un título al proyecto (Ej. Diagnóstico de Salud Familiar - Grupo A).
  2. Ve a la pestaña superior llamada Configuración (Settings) y haz clic en Compartir (Sharing).
  3. Haz clic en el botón “Añadir usuario”.
  4. En el campo de texto, escribe exactamente el nombre de usuario de KoboToolbox de tu primer compañero.
  5. Asignación de Permisos: Activa las siguientes casillas para que tus compañeros puedan co-crear el instrumento:
    • Ver formulario
    • Editar formulario
    • Añadir envíos (Para la recolección de datos en campo)
  6. Repite este proceso hasta agregar a los 7 integrantes. Ahora, todos pueden entrar a sus propias cuentas y verán el proyecto compartido listo para editarse.

Paso 2: Inserción de Preguntas y Tipos de Variables

Para garantizar la calidad de la base de datos que posteriormente analizaremos en R, es crucial definir si una variable acepta una o múltiples respuestas.

  1. En el lienzo en blanco, hagan clic en el botón “+” (Añadir pregunta).
  2. Escriban el texto de la pregunta. Por ejemplo: “¿Cuáles bienes posee la familia?”
  3. Hagan clic en “Añadir pregunta” y seleccionen el tipo “Selección Múltiple” (Select Many), ya que el instrumento puede requerir que el encuestado “Puede marcar varias respuestas”.
  4. Añadan las opciones de respuesta correspondientes (Cultivo agrícola propio, Aves de corral, etc.).
  5. Ejercicio colaborativo: Discutan en su grupo de trabajo y repitan este proceso para las preguntas donde deba marcarse una sola opción, como “¿Cuál es el principal combustible o energía que utilizan para cocinar?”, asegurándose de elegir el tipo “Selección Única” (Select One).

Paso 3: Configuración de la Lógica de Salto (Skip Logic)

Esta función evita sesgos de recolección y ahorra tiempo en el abordaje comunitario, ocultando preguntas que no aplican según las respuestas previas.

  1. Creen la pregunta filtro. Por ejemplo: “Situación de la vivienda” (Ocupada / Desocupada).
  2. Creen la pregunta dependiente: “Si la vivienda está ocupada:” (Con personas presentes / Con personas ausentes, etc.).
  3. Pasen el cursor sobre la pregunta dependiente y hagan clic en el ícono de Engranaje (Configuración) en el lado derecho.
  4. En el menú izquierdo, seleccionen “Lógica de salto” (Skip Logic).
  5. Hagan clic en “Añadir una condición”.
  6. Configuren la regla: Seleccionen la pregunta “Situación de la vivienda”, el operador “=”, y elijan la respuesta “Ocupada”. Esta segunda pregunta solo aparecerá en la pantalla del dispositivo si la primera se responde afirmativamente.

Paso 4: Creación de Grupos de Repetición (Roster de Hogar)

Para encuestar a múltiples individuos en una misma vivienda sin crear un formulario interminable, utilizamos grupos iterativos para la sección “Datos de personas de la familia”.

  1. Añadan secuencialmente todas las preguntas correspondientes a un individuo (Nombre, Sexo, Fecha de nacimiento, Parentezco, Nivel educativo, etc.).
  2. Mantengan presionada la tecla Ctrl (o Cmd en Mac) y hagan clic en cada una de estas preguntas sociodemográficas para seleccionarlas simultáneamente.
  3. En la barra superior, hagan clic en el ícono de “Crear grupo con las preguntas seleccionadas”.
  4. Pasen el cursor sobre el encabezado del grupo recién creado y abran la Configuración (Engranaje).
  5. Marquen la casilla “Repetir este grupo si es necesario” (Repeat this group if necessary). Al recolectar los datos, la aplicación preguntará “¿Desea añadir otra persona?” permitiendo ciclar el proceso para cada habitante.

Paso 5: Criterios de Validación (Constraints)

Para asegurar el rigor clínico de los datos biológicos y antropométricos, es vital restringir los valores atípicos (outliers) desde el momento de la digitación en campo.

  1. Creen una pregunta de tipo “Número” (Number) o “Decimal”. Por ejemplo: “Valor de frecuencia cardíaca”.
  2. Hagan clic en la Configuración de esta pregunta y vayan a la pestaña “Criterios de validación” (Validation Criteria).
  3. Hagan clic en “Añadir una condición”.
  4. Configuren el rango lógico. Por ejemplo: “Esta respuesta tiene que ser mayor o igual a” (>=) 30, y hagan clic en “Añadir otra condición” seleccionando “y tiene que ser menor o igual a” (<=) 250.
  5. En el campo “Mensaje de error”, escriban: “Valor fuera de los parámetros fisiológicos normales. Verifique la medición y la digitación.”
  6. Ejercicio colaborativo: Apliquen criterios de validación similares a variables como “Presión arterial sistólica” o “Peso en libras”.

Paso 6: Guardado, Previsualización y Despliegue

  1. Hagan clic frecuentemente en el botón “Guardar” (Save) en la esquina superior derecha para no perder su progreso.
  2. Usen el botón del “Ojo” (Preview form) para probar el formulario. En esta fase, cada equipo debe verificar rigurosamente que la lógica de salto, los grupos de repetición y las validaciones de signos vitales funcionen correctamente, simulando diferentes escenarios de llenado.
  3. Una vez superada la revisión metodológica, cierren el constructor y hagan clic en el botón azul “Implementar” o “Desplegar” (Deploy).

El instrumento optimizado está ahora activo en el servidor, listo para ser descargado en KoboCollect para iniciar la recolección de información con los sujetos de investigación.


Lógica y Estructura: Ejemplos de Configuración en el Constructor

Para evitar datos vacíos o inconsistentes, utilizaremos dos herramientas críticas: la Respuesta Obligatoria y la Lógica de Salto.

Ejemplo A: Variable Demográfica Crítica (Obligatoria)

  • Pregunta: Sexo de la persona (Selección Única: Hombre / Mujer).
  • Configuración: Al ser una variable fundamental para estratificar indicadores epidemiológicos, no puede quedar vacía.
    1. Haz clic en el ícono de Engranaje de la pregunta.
    2. En Opciones de la pregunta, marca la casilla “Respuesta obligatoria” (Mandatory). Si el encuestador olvida marcarla, KoboCollect no le dejará guardar el formulario.

Ejemplo B: Salud Reproductiva (Lógica de Salto Condicionada)

  • Pregunta: ¿Está embarazada actualmente? (Selección Única: Sí / No).
  • Configuración: Esta pregunta representaría un error metodológico si se le presenta a un hombre o a una infante.
    1. Haz clic en el Engranaje de la pregunta de embarazo y ve a Lógica de Salto.
    2. Haz clic en “Añadir una condición” y establece la primera regla: Sexo de la persona = Mujer.
    3. Haz clic de nuevo en “Añadir una condición” y establece la segunda regla: Edad en años >= 10 (o el rango etario definido metodológicamente en su protocolo).
    4. Asegúrate de que la opción superior diga: “La pregunta se mostrará si se cumplen TODAS estas condiciones”.

Buenas Prácticas de Etiquetado: Preparando el terreno para R y RStudio

El mayor desafío en Bioestadística no es correr el modelo, sino limpiar la base de datos. KoboToolbox permite separar el “texto que lee el encuestador” del “código que exportará el programa”. Si configuramos esto bien desde el inicio, la base de datos entrará impecable a nuestro entorno de análisis.

A. Nombre de la Columna de Datos (Data Column Name)

Esta es la variable que aparecerá como el encabezado de tu columna en el archivo Excel/CSV y que usarás en tus scripts de R.

  • Regla de oro: Usa el formato snake_case (todo en minúsculas, separando palabras con guiones bajos).
  • Prohibiciones absolutas: NO usar espacios, NO usar mayúsculas, NO usar tildes, NO usar la letra “ñ” ni caracteres especiales (?, !, $, %).
  • Ejemplo Incorrecto: ¿Tienen vehículo para uso del hogar?
  • Ejemplo Correcto (Configuración en Kobo): Ve al engranaje de la pregunta y en “Nombre de la columna de datos” escribe: tiene_vehiculo.

B. Valores XML de las Opciones de Respuesta (XML Values)

Cuando creas opciones de selección múltiple o única, KoboToolbox por defecto asigna el texto completo a la celda. Esto complica la recodificación de factores en R.

  • La Práctica Correcta: Asignar códigos numéricos simples o de texto corto a las opciones.
  • Ejemplo en “Situación de la vivienda”:
    • Texto visible: “Con personas presentes, pero rechazo”
    • Valor XML (Código para R): 3
  • Cómo hacerlo: Debajo de las opciones de respuesta que has creado, haz clic en el ícono de engranaje de la opción para ver el valor XML y reemplaza el texto largo por tu código numérico (ej. 1 para Sí, 0 para No).

Demostración del impacto en R

Al exportar los datos aplicando estas buenas prácticas de diseño estructural y etiquetado XML, el procesamiento inicial en RStudio se vuelve directo, evitando el uso excesivo de funciones de limpieza de cadenas de texto (como stringr):

# Lectura de la base de datos exportada desde KoboToolbox
# Los nombres de las variables ya están optimizados en snake_case
datos_familia <- read.csv("diagnostico_salud_grupo_a.csv")

# Recodificación directa de la variable utilizando los valores XML numéricos predefinidos
datos_familia$tiene_vehiculo <- factor(datos_familia$tiene_vehiculo,
                                       levels = c(0, 1),
                                       labels = c("No", "Sí"))

# Tabulación rápida
table(datos_familia$tiene_vehiculo)

Instrucciones de Entrega: Enlace del Instrumento en KoboToolbox

Para finalizar la fase de diseño de su instrumento de recolección de datos, el grupo deberá enviar el enlace de su formulario funcional. Sigan cuidadosamente estos pasos para garantizar que el trabajo sea evaluado correctamente:

Paso 1: Implementar y obtener el enlace en KoboToolbox

Solo el estudiante coordinador (quien creó el proyecto base) debe realizar este paso:

  1. Dentro de su cuenta de KoboToolbox, ingresen al proyecto de su grupo.
  2. En la pestaña superior de Resumen (Summary), busquen el botón azul que dice “Implementar” (Deploy) y háganle clic. Esto activará el formulario.
  3. Una vez implementado, en la sección de “Recopilar datos” (Collect data), asegúrense de que esté seleccionada la opción “En línea-Fuera de línea (envío múltiple)”.
  4. Hagan clic en el botón “Copiar” para copiar el enlace URL público de su formulario.

Paso 2: Creación del documento PDF

Abran un documento de procesador de texto (Word, Google Docs, etc.) y estructuren la entrega de la siguiente manera:

  1. Portada del Grupo:
    • Nombre de la asignatura.
    • Título del proyecto (Ej. Diagnóstico de Salud Familiar - Grupo A).
    • Integrantes del equipo: Deben enlistar a los 8 miembros utilizando obligatoriamente el siguiente formato institucional para cada uno: NOMBRE APELLIDO (carnet@ujmd.edu.sv).
  2. Cuerpo del documento:
    • Peguen el enlace URL de KoboToolbox que copiaron en el Paso 1.
    • Opcional pero recomendado: Realicen una prueba haciendo clic en el enlace desde una ventana de incógnito en su navegador para asegurarse de que el formulario abre correctamente y no solicita contraseñas.
  3. Exportación:
    • Guarden el documento estrictamente en formato PDF. No se aceptarán documentos en Word (.doc/.docx).
    • Nombren el archivo de la siguiente manera: GrupoX_Instrumento_Kobo.pdf (Sustituyan la “X” por la letra o número de su grupo).

Paso 3: Subida a la plataforma

  • Únicamente un miembro del grupo (el coordinador) deberá subir el archivo PDF al buzón de entrega de esta tarea antes de la fecha y hora límite establecida.
  • Asegúrense de hacer clic en el botón de envío final para que el estado cambie a Enviado para calificar.