Expresiones
Expressions
Las expresiones en ProcessMind permiten crear contenido dinámico y textos enriquecidos en tus dashboards. Gracias a ellas, puedes generar visualizaciones interactivas y útiles que se adaptan a tus datos. Como el contenido puede variar según la interacción del usuario o actualizaciones del data, las expresiones son clave para mantener tus dashboards actualizados y relevantes. En esta guía verás ejemplos y notaciones recomendadas para usarlas de manera efectiva.
Conceptos básicos
Para empezar, puedes usar expresiones para referenciar métricas y atributos directamente en tu texto. Así generas contenido dinámico que se actualiza en tiempo real cuando cambian tus datos.
Ejemplo 1: Núm. de casos vs Total de casos
Quiero mostrar el número actual de casos activos comparado con el total. La expresión sería:
Nr of cases in view: ${metric} / Total Cases: ${total}
Donde ${metric} es el valor actual y ${total} es el total de casos.
Ejemplo 2: Núm. de casos no incluidos
Quiero mostrar el número de casos que no están incluidos, restando del total:
Nr of cases not included: ${total - metric}
Donde ${metric} es el valor actual del métrico y ${total} es el número total de casos.
Ejemplo 3: Porcentaje de casos con una función
Quiero mostrar el porcentaje de casos visibles respecto al total:
Percentage of cases in view: ${formatPercentage(metric)}
Donde ${metric} es el indicador configurado con casos.
Funciones disponibles
ProcessMind incorpora un conjunto de funciones que puedes usar dentro de expresiones para cálculos, formato o búsquedas dinámicas. Combina estas funciones con tus métricas y atributos para generar textos e insights aún más útiles.
| Function | Descripción | Ejemplo |
|---|---|---|
round(value, decimals?) | Redondea un número al entero más cercano o a un número específico de decimales. | ${round(metric, 2)} → 123.46 |
power(base, exponent) | Eleva un número a una potencia (igual que pow). | ${power(2, 3)} → 8 |
pow(base, exponent) | Alias de power. | ${pow(metric, 2)} |
sqrt(value) | Devuelve la raíz cuadrada de un número. | ${sqrt(metric)} |
abs(value) | Devuelve el valor absoluto (elimina el signo negativo). | ${abs(metric)} |
ceil(value) | Redondea el número hacia arriba al entero más próximo. | ${ceil(3.2)} → 4 |
floor(value) | Redondea el número hacia abajo. | ${floor(3.8)} → 3 |
exp(value) | Devuelve el número de Euler e elevado a ese valor. | ${exp(1)} → 2.718... |
log(value) | Devuelve el logaritmo natural (base e). | ${log(metric)} |
mod(dividend, divisor) | Devuelve el resto de una división. | ${mod(10, 3)} → 1 |
formatDate(date, format?) | Da formato legible a una fecha. Permite patrones opcionales. | ${formatDate(created_at, "YYYY-MM-DD")} |
formatDuration(ms) | Convierte una duración en milisegundos a texto legible. | ${formatDuration(metric)} → 3d 4h 5m |
formatPercentage(value) | Formatea un decimal como porcentaje. | ${formatPercentage(metric)} → 75% |
getVariable(name) | Recupera el valor de una variable definida por el usuario. | ${getVariable("Case Id")} |
Tip: Puedes anidar funciones o combinarlas con operaciones matemáticas.
Ejemplo:
${formatPercentage(round(metric / total, 2))}
Esto calcula un ratio, lo redondea a 2 decimales y lo muestra en formato porcentaje.
Comentarios finales
La flexibilidad de combinar métricas, atributos, operadores y funciones te permite crear dashboards que van mucho más allá de mostrar números: cuentan una historia. Usando expresiones, puedes construir textos dinámicos e insights automáticos que se adaptan cuando tus usuarios filtran o exploran los datos.
Ya sea mostrando porcentajes, destacando KPIs o dando formato para facilitar la lectura, las expresiones mantienen tus dashboards informativos, prácticos y atractivos visualmente—todo sin necesidad de programar.
Usa estas herramientas para guiar a tus usuarios hacia insights relevantes, detectar tendencias y facilitar la comprensión del data. Con un poco de creatividad, tus dashboards pueden convertirse en narrativas interactivas que impulsan mejores decisiones.