Expressions

Os recursos de expressions do ProcessMind permitem gerar textos dinâmicos e conteúdos flexíveis em seus dashboards. Usando expressions, é possível criar visualizações mais envolventes e informativas que se adaptam aos seus dados. Como o conteúdo pode mudar conforme a interação do usuário ou atualizações dos dados, as expressions são uma forma poderosa de manter seus dashboards sempre atualizados e relevantes. Neste guia, mostramos exemplos e notações para utilizar expressions de forma eficaz.

Conceitos Básicos

Para uso básico, utilize expressions para referenciar métricas e atributos diretamente no texto. Assim, o conteúdo do dashboard é dinâmico e se atualiza automaticamente sempre que houver alteração nos dados.

Exemplo 1: Nº de cases em exibição vs Total de cases

Quero mostrar o número de cases ativos versus o total de cases. A expression fica assim:

Nº de cases em exibição: ${metric} / Total de cases: ${total}

Onde ${metric} é o valor atual da métrica e ${total} é o número total de cases.

Exemplo 2: Nº de cases não incluídos

Quero exibir o número de cases subtraídos do total:

Nº de cases não incluídos: ${total - metric}

Onde ${metric} é o valor atual da métrica e ${total} é o número total de cases.

Exemplo 3: Porcentagem de cases usando função

Quero exibir o percentual de cases em exibição comparado ao total:

Porcentagem de cases em exibição: ${formatPercentage(metric)}

Onde ${metric} é a métrica atual referente aos cases.

Funções Disponíveis

O ProcessMind oferece várias funções que você pode utilizar dentro das expressions para cálculos, formatação e buscas dinâmicas. É possível combinar essas funções com as suas métricas e atributos para criar textos automáticos mais completos.

Função	Descrição	Exemplo
`round(value, decimals?)`	Arredonda um número, com casas decimais opcionais.	`${round(metric, 2)}` → `123.46`
`power(base, exponent)`	Eleva um número à potência (igual ao `pow`).	`${power(2, 3)}` → `8`
`pow(base, exponent)`	Igual ao `power`.	`${pow(metric, 2)}`
`sqrt(value)`	Retorna a raiz quadrada.	`${sqrt(metric)}`
`abs(value)`	Retorna o valor absoluto (remove sinal negativo).	`${abs(metric)}`
`ceil(value)`	Arredonda para cima.	`${ceil(3.2)}` → `4`
`floor(value)`	Arredonda para baixo.	`${floor(3.8)}` → `3`
`exp(value)`	Retorna o número de Euler e elevado ao valor.	`${exp(1)}` → `2.718...`
`log(value)`	Calcula o logaritmo natural (base e).	`${log(metric)}`
`mod(dividend, divisor)`	Resto da divisão.	`${mod(10, 3)}` → `1`
`formatDate(date, format?)`	Formata uma data em texto. Aceita padrões de formatação.	`${formatDate(created_at, "YYYY-MM-DD")}`
`formatDuration(ms)`	Converte ms em texto de duração legível.	`${formatDuration(metric)}` → `3d 4h 5m`
`formatPercentage(value)`	Formata número como porcentagem.	`${formatPercentage(metric)}` → `75%`
`getVariable(name)`	Recupera o valor de uma variável definida.	`${getVariable("Case Id")}`

Dica: As funções podem ser agrupadas ou usadas com operadores. Exemplo:

${formatPercentage(round(metric / total, 2))}

Isto calcula uma razão, arredonda para 2 casas, e mostra como porcentagem.

Considerações finais

Essa flexibilidade de combinar métricas, atributos, operadores e funções permite que você crie dashboards que vão além dos números — eles contam uma história. Usando expressions, é possível oferecer textos dinâmicos e insights calculados que se ajustam automaticamente ao explorar e filtrar os dados.

Seja mostrando percentuais, destacando KPIs ou formatando valores para fácil leitura, as expressions mantêm seu dashboard informativo, acionável e atrativo — tudo sem precisar programar.

Use essas ferramentas para direcionar o usuário a insights relevantes, identificar tendências e facilitar a compreensão das informações. Com criatividade, seu dashboard se torna uma narrativa interativa que apoia melhores decisões.