Diccionario de datos para M&E: cómo definir cada variable

Prompts para este tema
En esta página

Qué es un diccionario de datos

Un diccionario de datos describe las variables de un conjunto de datos: nombres, significados, tipos de almacenamiento, unidades, valores permitidos y reglas. Otra persona debe poder interpretar una columna sin consultar a su creador. El nombre estado no basta: puede referirse a la entrevista, la elegibilidad de una persona o el uso de un servicio.

En M&E, el diccionario acompaña los datos y los acuerdos de gestión de datos. No reemplaza la base, el cuestionario ni el plan de análisis. La ficha de referencia de un indicador define la medida; el diccionario explica los campos concretos con los que se calcula. Conviene vincular ambos registros y evitar definiciones distintas de una misma medida.

Qué registrar para cada variable

Una fila por variable y columnas separadas para sus propiedades facilitan la revisión. Identifique primero el conjunto de datos o la tabla, sobre todo si varios archivos usan nombres como fecha o id.

PropiedadQué registrarPregunta de revisión
Nombre y etiquetaNombre exacto del campo y una etiqueta legible¿Coincide con la columna exportada?
DefiniciónQué se observa, de quién y durante qué período¿Dos analistas lo interpretarían igual?
Tipo y formatoEntero, decimal, texto, fecha o categoría; formato de fecha¿La importación puede cambiar el valor?
Valores permitidosCódigos, etiquetas, rangos y unidades¿Se distingue un valor poco habitual de un error?
Valores faltantesMotivo, código y tratamiento en el análisis¿Se diferencia rechazo de no aplicabilidad?
OrigenPregunta, campo administrativo o cálculo¿Puede rastrearse la procedencia?
CálculoFórmula, insumos, elegibilidad y exclusiones¿Otra persona puede reproducirlo?
Responsable y versiónRol responsable, fecha de revisión y entrega de datos¿Describe esta versión del archivo?

La etiqueta resume; no sustituye la definición. “Asistió” todavía necesita una actividad, un período y una regla de asistencia. En las fechas, distinga cuándo ocurrió el hecho, cuándo se recopiló el dato y cuándo se ingresó al sistema.

Ejemplo de un diccionario

Estos campos pertenecen a un seguimiento hipotético de capacitación. Los nombres, códigos y decisiones de cálculo sirven para mostrar la documentación; no son normas universales.

VariableDefinición y tipoValores o regla
record_keyClave de texto para el registro de seguimiento de una personaClave generada por el estudio; conservar ceros iniciales; sin nombres
eligibleEntero: cumple la regla de elegibilidad para el seguimiento1 = sí; 0 = no; regla documentada por separado
sessions_attendedEntero: sesiones a las que asistió en el ciclo indicadoDe 0 a 6; un vacío requiere motivo documentado
attendance_missing_reasonTexto: motivo de ausencia del conteo de sesionesrefused, unknown, not_applicable o not_recorded, con etiquetas en español
completed_cycleCategoría calculada para personas elegibles con asistencia observada1 si asistió al menos a 4 sesiones; en otro caso, 0; sin valor si la elegibilidad o asistencia no está resuelta

El umbral de cuatro sesiones es una elección inventada para este ejemplo. En el trabajo real, el diccionario debe remitir a la definición aprobada del programa. Una persona no elegible no se convierte automáticamente en alguien que no completó el ciclo. Antes de informar un porcentaje, documente quién entra en el denominador.

El diccionario describe el formato y la función de la clave. No debe mostrar una clave real junto con un nombre, teléfono o cita que permita identificar a alguien. Use ejemplos artificiales y limite el acceso al archivo separado que vincule las claves con identidades.

Cómo prepararlo y revisarlo

  1. Partir del instrumento y de la exportación prevista. Incluir identificadores, marcas de tiempo, grupos repetidos y variables calculadas.
  2. Redactar las definiciones antes de recopilar datos. Resolver conceptos ambiguos con los responsables del programa y del análisis mientras aún sea posible ajustar el instrumento.
  3. Separar códigos válidos y motivos de ausencia. Elegir una representación que conserven las herramientas de recopilación y análisis.
  4. Documentar los cálculos con nombres de los campos de origen, reglas de elegibilidad, unidades y exclusiones. Mantener una versión ejecutable del cálculo cuando sea posible.
  5. Comparar el diccionario con una exportación real. Buscar columnas sin documentar, campos renombrados y categorías no previstas.
  6. Pedir a otra persona que calcule una medida usando solo los datos y el diccionario. Registrar las aclaraciones que necesitó.
  7. Entregar ambos con versiones coincidentes. Documentar cambios posteriores, sin sustituir en silencio el significado de un campo anterior.

Estas revisiones complementan el aseguramiento de la calidad de los datos. Un diccionario completo no demuestra que las observaciones sean correctas: un valor puede cumplir el rango declarado y pertenecer a otra persona o período.

Los datos faltantes requieren una regla

Cero puede ser un valor observado. No debe significar a la vez “no se preguntó”, “rechazó responder” y “se desconoce”. Un campo de motivo separado, las categorías de ausencia del programa de análisis o los códigos reservados permiten conservar esas diferencias. Documente la opción elegida y pruebe qué sucede al exportar.

Si se usan números reservados, exclúyalos de las operaciones y compruebe que no coincidan con valores válidos. Un código apropiado para una pregunta de sí o no puede ser un ingreso perfectamente posible. Si la exportación convierte categorías especiales en vacíos, conserve el motivo en otro campo o mediante un paso documentado.

No reemplace silenciosamente los faltantes por cero. Si se imputan valores, conserve su procedencia, identifique los registros o campos afectados y describa el método. El denominador del informe debe corresponder a la regla de análisis declarada.

Mantener juntas las versiones legible y procesable

Una hoja de cálculo facilita la revisión humana; un CSV estructurado, un esquema de base de datos u otra especificación procesable puede apoyar controles automáticos. Ningún formato sustituye las definiciones legibles. Evite mantener dos diccionarios independientes: cuando sea posible, genere una vista desde la otra y compare los nombres de campo en cada entrega.

Conserve los nombres cuando el significado permanezca estable. Si cambia, documente si hace falta otra variable y si los períodos siguen siendo comparables. Preserve el diccionario anterior junto con la versión de datos que describe.

Preguntas frecuentes

¿Un diccionario de datos es lo mismo que un libro de códigos?

En datos cuantitativos, los términos pueden coincidir: el libro de códigos suele incluir definiciones, respuestas codificadas y preguntas. Un libro de códigos cualitativo tiene otra función: define los códigos analíticos aplicados a pasajes de entrevistas o documentos. Aclare cuál de los dos sentidos se usa.

¿Todos los proyectos deben usar los mismos códigos de ausencia?

No existe un conjunto universal que funcione en todas las herramientas y variables. Use una convención coherente cuando sea compatible, preserve los distintos motivos de ausencia y documente las excepciones. La persona que analiza y el programa deben poder distinguir un dato faltante de un valor válido.

Actualizado el 25 de octubre de 20263 fuentes verificadas

M&E Studio también hace este trabajo para clientes.

El equipo que escribe y revisa esta biblioteca asume el diseño de sistemas de M&E, revisiones de calidad de evaluaciones, asesoría en IA y automatización de flujos de trabajo.

Ver servicios
También conocido como

diccionario de variables, documentación de variables, libro de códigos de datos

Explorar la biblioteca de M&E

176 entradas en 9 categorías