Expression（式）の使い方

Expressions

ProcessMindのExpression機能を使えば、ダッシュボード上でリッチテキストや動的コンテンツを自動生成できます。Expressionを活用することで、ダッシュボードがデータに合わせて自動的にアップデートされ、よりインタラクティブになります。このガイドでは、実用的なサンプルやNotationを通じ、Expressionを効果的に使う方法を紹介します。

基本操作

Expressionを使うと、メトリクスや属性を直接テキスト内に参照できます。データ変更時にも、自動で内容が最新化される動的なコンテンツが作成可能です。

例1: ケース数と総件数の表示

アクティブなケース数と全体件数を表示する場合:

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

${metric}は現在の件数、${total}は全ケース総数を示します。

例2: 未含ケース数の表示

（全体－現在）で未含のケース数を示す例:

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

同様に、${metric}は現在の件数、${total}が総件数です。

例3: 関数を使った割合表示

ビュー内のケース割合をパーセントで表示するには：

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

${metric}はケースで設定されたメトリクスです。

---

利用可能な関数

ProcessMind では、計算・フォーマット・動的参照など、さまざまな関数を式でサポートしています。これらの関数はメトリクスや属性と組み合わせて、柔軟かつ強力な出力を得ることができます。

Function	説明	例
round(value, decimals?)	数値を整数、または指定した小数点以下に四捨五入します。	${round(metric, 2)} → 123.46
power(base, exponent)	指数乗計算をします（pow と同じ）。	${power(2, 3)} → 8
pow(base, exponent)	power のエイリアスです。	${pow(metric, 2)}
sqrt(value)	数値の平方根を返します。	${sqrt(metric)}
abs(value)	絶対値を返します（負の符号を除去）。	${abs(metric)}
ceil(value)	数値を切り上げて最も近い整数にします。	${ceil(3.2)} → 4
floor(value)	数値を切り下げて最も近い整数にします。	${floor(3.8)} → 3
exp(value)	ネイピア数 e の累乗を返します。	${exp(1)} → 2.718...
log(value)	自然対数（底 e）を返します。	${log(metric)}
mod(dividend, divisor)	割り算の余りを返します。	${mod(10, 3)} → 1
formatDate(date, format?)	日付を見やすい形式で表示します。オプションで書式も指定できます。	${formatDate(created_at, "YYYY-MM-DD")}
formatDuration(ms)	ミリ秒単位の期間を、見やすい形式に変換します。	${formatDuration(metric)} → 3d 4h 5m
formatPercentage(value)	少数をパーセント形式で表示します。	${formatPercentage(metric)} → 75%
getVariable(name)	ユーザー定義の変数値を取得します。	${getVariable("Case Id")}

ヒント： 関数を入れ子にしたり、算術演算と組み合わせたりできます。例：

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

これは比率を計算し、小数点以下2桁で丸めて、パーセント形式で出力します。

---

Expressionを最大限活用するには

メトリクス・属性・演算子・関数を組み合わせることで、ダッシュボードは単なる数値の表示以上の情報を提供し、ストーリー性を持たせられます。Expressionで作成したダイナミックテキストや計算指標は、ユーザーがフィルタやデータを探索するたび自動で最新化。

KPIやパーセント表示の強調、値の見やすいフォーマットもExpressionなら簡単です。カスタムコード不要で、ダッシュボードを常に分かりやすく、実践的かつ視覚的に魅力的に保てます。

これらのツールでユーザーに有益な洞察を届け、トレンドや傾向の把握、データ理解促進に役立ててください。少し工夫すれば、ダッシュボードは意思決定を後押しするインタラクティブなナラティブになります。