Preparar los datos
Un buen tablero empieza en el formulario. Los nombres de las preguntas, el tipo de cada respuesta y los campos calculados definen lo que el tablero puede mostrar y con qué precisión. Un formulario bien preparado genera indicadores correctos desde la primera recolección, permite unir varios formularios en un mismo tablero y evita retrabajo cuando el tablero crece. Un formulario armado a las apuradas suele generar gráficos con nombres confusos, números sumados como texto y campos que cambian de nombre a mitad de camino.
Esta página reúne todo lo que debe hacerse antes de crear el primer gráfico: activar la integración, nombrar las preguntas, revisar el tipo de cada respuesta y dejar en el formulario los cálculos que el tablero va a usar.
Activar la integración del formulario
Solo los formularios habilitados para la integración aparecen en los Análisis Avanzados.
- En el menú principal de Hashdata, haga clic en el ícono de Integraciones.
- Seleccione el formulario y habilite la integración Hashdata Advanced Reports. El mismo formulario puede tener también la integración vía API REST.
- Haga clic en Configuraciones.
- Para cada pregunta, defina el nombre de la pregunta. El botón Completar automáticamente sugiere nombres a partir de los enunciados. Revise las sugerencias con el estándar de la sección Nombre de la pregunta.
- Revise que cada pregunta que el tablero va a usar esté habilitada para la exportación al BI. Una pregunta que no se exporta no aparece en los análisis.
- Revise el Nombre del índice en Hashdata Advanced Reports. Vea Nombre del índice.
- Guarde.
A partir de ese momento, cada respuesta enviada se copia automáticamente al índice del formulario.
Un formulario en borrador puede integrarse, pero su estructura puede cambiar en cualquier momento. Preguntas renombradas, eliminadas o con el tipo modificado cambian los campos que llegan al tablero. Para tableros en producción, prefiera integrar formularios publicados.
La pantalla de integración también la usa la API REST. Vea la página Integraciones para los detalles de esta configuración.
Nombre del índice
El índice es la base de recolecciones del formulario en los Análisis Avanzados. Su nombre tiene dos partes:
- Prefijo numérico — lo genera el sistema. No lo modifique.
- Descripción — solo letras, números, guion bajo (
_) y guion (-).
Ejemplo: 21261-formulario-datos-personales.
Elija una descripción corta que identifique el formulario sin ambigüedad. Cuando varios formularios vayan a componer el mismo tablero, use descripciones con una parte en común (por ejemplo, buenas-practicas-unidad-a y buenas-practicas-unidad-b). Así podrá unirlos en una fuente de datos con comodín.
Nombre de la pregunta
El nombre de la pregunta es el nombre corto que identifica la pregunta en el sistema. Es el mismo Nombre del campo de Atributos del elemento, en el editor del formulario. En los Análisis Avanzados, es el nombre del campo: aparece en la lista de campos, en los filtros, en las fórmulas y en los títulos automáticos de los gráficos.
| Regla | Recomendado | Evitar |
|---|---|---|
| Letras minúsculas | unidad, turno | Unidad, TURNO |
| Sin acentos ni eñe | evaluacion, region | evaluación, región |
| Guion en lugar de espacio | responsable-area | responsable area |
| Prefijos que agrupan campos del mismo tipo | perc-limpieza, perc-orden, pts-limpieza | limpieza-pct, puntos2 |
| Cantidad fija de dígitos en listas de ítems | item-01 … item-25 | item1 … item25 |
| Mismo nombre para la misma pregunta en formularios distintos | unidad en todos | unidad en uno, negocio en otro |
| Nombre que describe el contenido | temperatura-camara | p17, campo-nuevo |
Grupo y grupo son campos distintos en los análisis. Si un nombre se creó con inicial mayúscula, debe escribirse exactamente así en los filtros y en las fórmulas. Estandarizar todo en minúsculas evita este tipo de confusión.
Las recolecciones ya enviadas guardan los nombres que las preguntas tenían en el momento del envío. Si una pregunta se renombra después, las recolecciones antiguas mantienen el nombre antiguo, y la misma pregunta pasa a aparecer como dos campos en el tablero. Defina los nombres antes de poner el formulario en uso. Si necesita renombrar un formulario que ya tiene recolecciones, hable con el soporte de Hashdata sobre el reprocesamiento del historial.
Revise que los nombres coincidan con las preguntas
En formularios largos, con secciones repetidas (por ejemplo, una sección por pilar en una auditoría 5S), es común que un nombre quede desplazado: el resultado de la sección "Limpieza" termina con el nombre perc-orden, y todos los siguientes se desplazan con él. El tablero muestra números, pero con el nombre equivocado.
Antes de integrar, recorra el formulario en orden y revise, pregunta por pregunta, que el nombre describa esa pregunta. Para formularios con muchas secciones, arme una tabla simple con tres columnas: sección, pregunta y nombre.
Cómo llega cada tipo de pregunta a los análisis
El tipo de pregunta define lo que se puede calcular con ella. Un número permite sumar y promediar; un texto permite agrupar, contar y filtrar.
| Tipo de pregunta | Cómo suele llegar | Uso típico en el tablero |
|---|---|---|
| Número y campo calculado | Número | Suma, promedio, mediana, mínimo, máximo, último valor, rangos (intervalos). |
| Selección única | Texto, con la opción elegida | Agrupar (por ejemplo, por unidad), contar, filtrar, separar barras por categoría. |
| Selección con valor asignado | Puede llegar como el número asignado a la opción. Revíselo en Discover | Sumar ocurrencias (por ejemplo, opción "Sí" = 1) o calcular promedios de puntaje. |
| Selección múltiple | Lista con todas las opciones marcadas | Contar cuántas veces se marcó cada opción. Vea Selección múltiple. |
| Texto libre | Texto | Búsqueda por palabra, nube de palabras, columna de observaciones en tablas. |
| Fecha y hora | Fecha | Filtrar por período o usar como campo de tiempo de una fuente de datos. |
En Discover, la lista de campos muestra un ícono junto a cada nombre: # para número, t o k para texto, un calendario para fecha. Un campo de nota, puntaje o porcentaje que aparece como texto no permite calcular promedio ni suma. En ese caso, revise el tipo de la pregunta en el formulario. Vea Explorar los datos.
Selección múltiple
En una pregunta de selección múltiple, una misma recolección puede tener varias opciones marcadas. Al agrupar por ese campo, cada recolección se cuenta una vez por cada opción marcada. Por eso:
- La suma de las barras puede ser mayor que el total de recolecciones.
- Los porcentajes por opción pueden sumar más del 100%.
Esto es correcto: el gráfico muestra cuántas recolecciones marcaron cada opción. Déjelo claro en el título, por ejemplo: "Factores de riesgo informados (pregunta de selección múltiple)".
Opciones con escritura exacta
Los filtros y las fórmulas comparan el texto exacto de la opción. "Positivo" y "positivo" son valores distintos, igual que "No" y "NO". Antes de escribir filtros, revise en Discover cómo se guardó cada opción.
Campos calculados y etiquetas
Las reglas con varias condiciones son más simples y confiables cuando se calculan en el formulario, con un campo calculado. El resultado llega listo al índice, y el gráfico solo tiene que sumar, contar o promediar.
| Necesidad | En el formulario (campo calculado) | En el tablero |
|---|---|---|
| Porcentaje de conformidad de una auditoría | avgByTag('r')*100, o la suma por etiqueta dividida por el máximo posible | Promedio del campo, por mes o por unidad. |
| Puntaje de cada sección | Suma por etiqueta de cada sección (por ejemplo, sumByTag('limpieza')) | Una serie por sección, en el mismo gráfico. |
| Clasificación con varias condiciones (por ejemplo, "positivo" cuando una prueba es positiva o hay al menos dos síntomas) | Campo calculado que devuelve "Sí" o "No" | Conteo o porcentaje de los "Sí". |
| Rango de edad, de temperatura, de peso | Campo calculado con el rango (opcional) | Agrupación directa por el rango, o Intervals sobre el número. |
Las fórmulas que usan etiquetas (como sumByTag('r') y avgByTag('r')) no dependen de los nombres de las preguntas. Por eso, estandarizar los nombres no rompe esos cálculos. Las fórmulas que citan el nombre de una pregunta deben revisarse cuando el nombre cambia.
Un campo calculado como avgByTag('r')*100 guarda, por ejemplo, 85 para 85%. En el gráfico, muestre ese valor con el formato Number y el sufijo %. El formato Percent multiplica el valor por 100 y mostraría 8.500%. Vea Formato de los números.
Unir varios formularios en un tablero
Cuando cada unidad, dirección o región tiene su propio formulario, cada uno genera un índice separado. Para mostrarlos todos en un mismo gráfico, los índices se reúnen en una única fuente de datos. Para que funcione:
- Use nombres de preguntas idénticos en todos los formularios. Si un formulario usa
unidady otro usanegocio, el tablero trata ambos como campos distintos, y el gráfico no une los datos. - Use los mismos tipos de pregunta. Un campo que es número en un formulario y texto en otro no puede sumarse en conjunto.
- Use las mismas opciones de respuesta, con la misma escritura.
- Identifique el origen. Incluya en cada formulario una pregunta con valor fijo (por ejemplo,
direccion, con el valor "Dirección A"). Así, el tablero muestra nombres legibles. Sin esa pregunta, el origen puede identificarse por el campo_index, que trae el nombre técnico del índice. Vea El campo_index. - Dé a los índices descripciones con una parte en común, para usar un comodín en la fuente de datos.
Índice transpuesto
Algunos formularios registran la misma medida en varias preguntas, una por posición, ítem o tipo. Por ejemplo, un control de defectos con una pregunta por cada tipo: defecto-01, defecto-02 … defecto-24. Para analizar "cuántos defectos de cada tipo", lo más práctico es convertir esas columnas en filas. Eso es lo que hace el índice transpuesto, configurado en la integración.
En el índice transpuesto, cada pregunta mapeada se convierte en un registro con dos campos:
- un campo de etiqueta, con el nombre del ítem (por ejemplo,
tipo-defecto); - un campo de valor, con la respuesta de ese ítem (por ejemplo,
valor-defecto).
| Recolección | tipo-defecto (etiqueta) | valor-defecto (valor) |
|---|---|---|
| Recolección 1 | Mancha | 2 |
| Recolección 1 | Fisura | 0 |
| Recolección 1 | Cuerpo extraño | 1 |
| Recolección 2 | Mancha | 0 |
| Recolección 2 | Fisura | 3 |
| Recolección 2 | Cuerpo extraño | 0 |
Para el gráfico de defectos por tipo:
- Eje horizontal: el campo de etiqueta, con Top values.
- Eje vertical: Sum del campo de valor.
Cada recolección se convierte en un registro por ítem mapeado. En una transposición de 24 ítems, una recolección genera 24 registros. Por eso, Count of records con la etiqueta en el eje muestra el mismo número para todos los tipos: cuenta las filas, no las ocurrencias. Use siempre Sum del campo de valor. Para contar recolecciones, use el índice original del formulario.