Cálculos y fórmulas
Detrás de cada número del tablero hay un cálculo: un conteo, una suma, un promedio, un porcentaje. La elección del cálculo cambia el resultado y, a veces, la decisión. El promedio de conformidad de una unidad no es lo mismo que la mediana; la cantidad de recolecciones no es lo mismo que la cantidad de no conformidades; y una tasa de aprobación debe dividir las aprobadas por el total correcto.
Las funciones cubren los cálculos más comunes con un clic. Las fórmulas combinan funciones para crear indicadores propios: tasas, porcentajes del total, variación respecto del mes anterior, saldo de stock, puntaje ponderado.
Funciones de cálculo
Al abrir una métrica en el editor de gráficos, la pestaña Quick function lista las funciones disponibles:
| Función | En pantalla | Calcula | Cuándo usar |
|---|---|---|---|
| Conteo | Count (Count of records) | Cantidad de registros | Cuántas recolecciones, auditorías, entrevistas. |
| Conteo de valores únicos | Unique count | Cuántos valores distintos tiene un campo | Cuántas unidades auditadas, cuántos auditores activos. |
| Suma | Sum | Suma de los valores | Total de ocurrencias, de ítems, de horas, de cantidades. |
| Promedio | Average | Suma dividida por la cantidad | Resultado promedio de auditorías, temperatura promedio, nota promedio. |
| Mediana | Median | El valor del medio, con la mitad de los valores por encima y la mitad por debajo | Tiempos y valores con extremos que distorsionan el promedio. |
| Mínimo y máximo | Minimum / Maximum | El menor y el mayor valor | Peor y mejor resultado, menor y mayor temperatura. |
| Percentil | Percentile | El valor por debajo del cual está un porcentaje de los registros | "El 90% de las atenciones tarda hasta X minutos." |
| Posición percentil | Percentile rank | El porcentaje de registros por debajo de un valor | "¿Qué parte de las cámaras quedó por debajo de 4 °C?" |
| Último valor | Last value | El valor de la recolección más reciente | Lecturas actuales: nivel de tanque, horómetro, stock. |
| Desviación estándar | Standard deviation | Cuánto varían los valores alrededor del promedio | Estabilidad de un proceso (pesos, temperaturas). |
| Suma acumulada | Cumulative sum | La suma de los períodos anteriores más el actual | Total acumulado de recolecciones a lo largo del año. |
| Diferencia | Differences | La diferencia respecto del período anterior | Cuánto subió o bajó el indicador de un mes a otro. |
| Media móvil | Moving average | El promedio de los últimos N períodos | Suavizar oscilaciones diarias para ver la tendencia. |
La suma acumulada, la diferencia y la media móvil se calculan sobre la agrupación por fecha del eje horizontal. Úselas en gráficos con Date histogram.
Promedio o mediana
El editor suele elegir Median al colocar un campo numérico en el gráfico. Para indicadores de resultado (notas, porcentajes de conformidad), lo habitual es el promedio. Vea la diferencia con cinco auditorías de una unidad:
| Resultados | Promedio | Mediana |
|---|---|---|
| 90, 88, 85, 84, 30 | 75,4 | 85 |
El promedio baja por la auditoría de 30; la mediana la ignora. Si el indicador oficial es el promedio, use Average en todos los gráficos, para que los números del tablero coincidan con los informes.
Conteo de registros y conteo de ocurrencias
Count of records cuenta recolecciones (registros), no respuestas "Sí" ni ocurrencias.
- Para contar las recolecciones con una respuesta específica, use Count of records con un filtro (por ejemplo,
estado : "Rechazado"). - Para contar ocurrencias registradas como número (por ejemplo, opciones con valor 1 para "Sí"), use Sum del campo.
- En un índice transpuesto, cada recolección se convierte en varios registros: use Sum del campo de valor.
- En una pregunta de selección múltiple, una recolección se cuenta en cada opción marcada.
Fórmulas
Una fórmula combina funciones, números y operaciones. Para usarla:
- Abra la métrica en el editor de gráficos.
- Haga clic en la pestaña Formula.
- Escriba la fórmula. El editor sugiere funciones y campos mientras escribe, y muestra la documentación de cada función en el botón de ayuda.
- En Value format, elija el formato del resultado (por ejemplo, Percent para una tasa).
Elementos de una fórmula
| Elemento | Ejemplo | Observación |
|---|---|---|
| Función sobre un campo | average(temperatura) | Las mismas funciones de la tabla de arriba, con los nombres en inglés: count, unique_count, sum, average, median, min, max, percentile, last_value, standard_deviation. |
| Campo con guion | average('perc-total') | Los nombres con guion o caracteres especiales van entre comillas simples. |
| Conteo de registros | count() | Sin campo. |
| Filtro en una función | count(kql='estado : "Rechazado"') | El parámetro kql recibe una expresión de la barra de búsqueda, entre comillas simples. |
| Desplazamiento en el tiempo | average('perc-total', shift='1M') | El mismo cálculo en el mes anterior. Otros valores: 1d, 1w, 3M, 1y. |
| Operaciones | + - * / y paréntesis | Siguen el orden habitual de la matemática. |
| Funciones matemáticas | round(x, 1), abs(x), clamp(x, 0, 100), pow(x, 2), sqrt(x) | Redondear, valor absoluto, limitar a un rango, potencia, raíz. |
| Totales del conjunto | overall_sum(count()), overall_average(...) | El total o el promedio de todos los grupos del gráfico, para calcular participaciones. |
El filtro kql='...' va entre comillas simples, y los valores dentro de él, entre comillas dobles: count(kql='aprobacion : "Necesita ajustes"'). Si el valor tiene un apóstrofo, escriba \' en su lugar.
Fórmulas listas
| Indicador | Fórmula | Formato |
|---|---|---|
| Tasa de rechazo | count(kql='estado : "Rechazado"') / count() | Percent |
| Tasa de aprobación entre las evaluadas (ignora las no evaluadas) | count(kql='estado : "Aprobado"') / count(kql='estado : *') | Percent |
| Positividad (positivos entre los testeados) | count(kql='resultado : "Positivo"') / count(kql='testeado : "Sí"') | Percent |
| Derivación de los positivos | count(kql='derivado : "Sí" and resultado : "Positivo"') / count(kql='resultado : "Positivo"') | Percent |
| Participación de cada grupo en el total | count() / overall_sum(count()) | Percent |
| Fuera del rango de temperatura | count(kql='temperatura > 4 or temperatura < 0') / count() | Percent |
| Primera vez (por ejemplo, entrevistados que nunca participaron) | count(kql='ya-participo : "No"') / count() | Percent |
| Saldo a partir de una lectura de espacio vacío (capacidad menos el vacío medido) | 500 - last_value('espacio-vacio', kql='espacio-vacio : *') | Number |
| Ocupación porcentual de un tanque | (500 - last_value('espacio-vacio', kql='espacio-vacio : *')) / 500 | Percent |
| Porcentaje sobre el máximo de puntos | sum(puntos) / sum('puntos-posibles') | Percent |
| Promedio ponderado de dos notas (peso 2 y peso 1) | (average('nota-practica') * 2 + average('nota-teorica')) / 3 | Number |
| No conformidades por auditoría | sum('cant-nc') / count() | Number |
last_value trae el valor de la recolección más reciente. Si esa recolección no tiene el campo completo, el resultado queda vacío. El filtro kql='campo : *' hace que la función considere solo las recolecciones con el campo completo.
Una tasa calculada por división (por ejemplo, 0.25) debe usar el formato Percent, que muestra 25%. Un campo que ya viene multiplicado por 100 desde el formulario (por ejemplo, 85) debe usar el formato Number con sufijo %. Mezclar los dos genera valores como 0,85% o 8.500%.
Variación respecto del período anterior
| Indicador | Fórmula | Formato |
|---|---|---|
| Variación porcentual respecto del mes anterior | average('perc-total') / average('perc-total', shift='1M') - 1 | Percent |
| Diferencia en puntos respecto del mes anterior | average('perc-total') - average('perc-total', shift='1M') | Number |
| Recolecciones respecto del mismo período del año anterior | count() / count(shift='1y') - 1 | Percent |
En una tarjeta, coloque el valor actual como métrica principal y la variación como métrica secundaria, con color por valor (verde para positivo, rojo para negativo).
Si el período anterior no tiene recolecciones, la división no tiene resultado y el gráfico muestra un valor vacío. Es lo esperado. Para evitar el vacío, elija un período en que los dos intervalos tengan recolecciones.
Valor fijo
La pestaña Static value define un número fijo en una dimensión. Se usa principalmente para:
- Metas en líneas de referencia.
- Mínimo, máximo y meta de medidores.
- Máximo de una tarjeta con barra de progreso.
Opciones avanzadas de una métrica
En Advanced, dentro de cada métrica:
| Opción | Qué hace |
|---|---|
| Filter by | Aplica un filtro solo a esa métrica. Vea Filtro en una métrica. |
| Time shift | Calcula la métrica desplazada en el tiempo. Vea Comparar con el período anterior. |
| Reduced time range | Usa solo el tramo final del período (por ejemplo, la última hora), útil para lecturas "actuales" en tableros de seguimiento. |
Cuándo calcular en el formulario
Algunas reglas funcionan mejor en el propio formulario, como campo calculado, que en una fórmula del tablero:
- Reglas con varias condiciones sobre la misma recolección ("positivo si A o al menos dos entre B, C y D").
- Clasificaciones que deben aparecer en la respuesta y en los informes del formulario (por ejemplo, "Aprobado" o "Rechazado").
- Puntajes por etiqueta, como
sumByTagyavgByTag.
El resultado llega listo al índice, y el tablero solo tiene que contar, sumar o promediar. Vea Campos calculados y etiquetas.