Expressions in Dashboards

Expressions

ProcessMind expressions let you generate rich text and dynamic content in your dashboards, so the content adapts to your data. This page covers dashboard-specific examples and notation. For the full expression language reference (functions, operators, and syntax), see the Expression Language section.

Basics

You can use expressions to reference metrics and attributes directly in your text. This creates dynamic content that updates automatically as your data changes.

Expressions on Data

Expressions can also be defined on dataset attributes to calculate or derive values before they are used in dashboards and analysis. Use these expressions when the value you need is not present as a column in the source data, or when you want to standardize a calculation for reuse.

Once an expression is available on the data, it can be selected wherever ProcessMind exposes that attribute, including charts and text charts.

Example 1: Number of Cases vs Total Cases

To display the number of active cases versus the total, use:

Number of cases in view: ${metric} / Total Cases: ${total}

Here, ${metric} is the current metric value and ${total} is the total number of cases.

Example 2: Cases Not Included

To show the number of cases not included (total minus current):

Number of cases not included: ${total - metric}

Again, ${metric} is the current metric value and ${total} is the total number of cases.

Example 3: Percentage of Cases Using a Function

To display the percentage of cases in view compared to the total:

Percentage of cases in view: ${formatPercentage(metric)}

Here, ${metric} is the metric set to cases.

Available Functions

ProcessMind supports a variety of functions in expressions for calculations, formatting, and dynamic lookups. For a complete reference of all available functions, operators, and syntax, see the Expression Language Reference.

Common functions used in dashboard expressions include:

• round(value, decimals?) - Round numbers to specified decimal places
• formatPercentage(value) - Format decimals as percentages
• formatDuration(ms) - Convert milliseconds to human-readable durations
• formatDate(date, format?) - Format dates with custom patterns

Tip: You can nest functions or combine them with arithmetic. For example:

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

This calculates a ratio, rounds it to two decimals, and formats it as a percentage.

Related topics

• Expression Language Reference: all functions, operators, and syntax.
• Using Markdown Notation: rich text in charts.
• Metrics: the metrics you can use in expressions.