Saltar al contenido principal

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.

  1. En el menú principal de Hashdata, haga clic en el ícono de Integraciones.
  2. 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.
  3. Haga clic en Configuraciones.
  4. 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.
  5. 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.
  6. Revise el Nombre del índice en Hashdata Advanced Reports. Vea Nombre del índice.
  7. Guarde.

A partir de ese momento, cada respuesta enviada se copia automáticamente al índice del formulario.

Los borradores también pueden integrarse

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.

Detalles de la pantalla de integración

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.

ReglaRecomendadoEvitar
Letras minúsculasunidad, turnoUnidad, TURNO
Sin acentos ni eñeevaluacion, regionevaluación, región
Guion en lugar de espacioresponsable-arearesponsable area
Prefijos que agrupan campos del mismo tipoperc-limpieza, perc-orden, pts-limpiezalimpieza-pct, puntos2
Cantidad fija de dígitos en listas de ítemsitem-01 … item-25item1 … item25
Mismo nombre para la misma pregunta en formularios distintosunidad en todosunidad en uno, negocio en otro
Nombre que describe el contenidotemperatura-camarap17, campo-nuevo
Las mayúsculas y minúsculas cuentan

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.

Renombre antes de empezar a recolectar

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 preguntaCómo suele llegarUso típico en el tablero
Número y campo calculadoNúmeroSuma, promedio, mediana, mínimo, máximo, último valor, rangos (intervalos).
Selección únicaTexto, con la opción elegidaAgrupar (por ejemplo, por unidad), contar, filtrar, separar barras por categoría.
Selección con valor asignadoPuede llegar como el número asignado a la opción. Revíselo en DiscoverSumar ocurrencias (por ejemplo, opción "Sí" = 1) o calcular promedios de puntaje.
Selección múltipleLista con todas las opciones marcadasContar cuántas veces se marcó cada opción. Vea Selección múltiple.
Texto libreTextoBúsqueda por palabra, nube de palabras, columna de observaciones en tablas.
Fecha y horaFechaFiltrar por período o usar como campo de tiempo de una fuente de datos.
Revise el tipo antes de armar el tablero

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.

NecesidadEn el formulario (campo calculado)En el tablero
Porcentaje de conformidad de una auditoríaavgByTag('r')*100, o la suma por etiqueta dividida por el máximo posiblePromedio del campo, por mes o por unidad.
Puntaje de cada secciónSuma 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 pesoCampo calculado con el rango (opcional)Agrupación directa por el rango, o Intervals sobre el número.
Etiquetas y nombres son independientes

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.

Escala del porcentaje: 0–100 o 0–1

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:

  1. Use nombres de preguntas idénticos en todos los formularios. Si un formulario usa unidad y otro usa negocio, el tablero trata ambos como campos distintos, y el gráfico no une los datos.
  2. Use los mismos tipos de pregunta. Un campo que es número en un formulario y texto en otro no puede sumarse en conjunto.
  3. Use las mismas opciones de respuesta, con la misma escritura.
  4. 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.
  5. 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óntipo-defecto (etiqueta)valor-defecto (valor)
Recolección 1Mancha2
Recolección 1Fisura0
Recolección 1Cuerpo extraño1
Recolección 2Mancha0
Recolección 2Fisura3
Recolección 2Cuerpo extraño0

Para el gráfico de defectos por tipo:

  • Eje horizontal: el campo de etiqueta, con Top values.
  • Eje vertical: Sum del campo de valor.
En el índice transpuesto, el conteo de registros no es el conteo de recolecciones

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.


Validar antes de armar el tablero​

  1. Integración activa, con las preguntas necesarias habilitadas para exportación.
  2. Nombres de las preguntas revisados, en el orden del formulario, según el estándar definido.
  3. Campos calculados apuntando a los nombres y etiquetas correctos.
  4. Recolección de prueba completa, enviada y sincronizada.
  5. Discover: la recolección de prueba aparece en el índice, con todos los campos completos y con el tipo correcto. Vea Explorar los datos.
  6. Opciones de respuesta anotadas con la escritura exacta, para los filtros.