Expression Editor

Expression Editorは、式を作成するためのProcessMind組み込みツールです。データセットの属性、データセットフィルター、指標の定義など、式を使用する場所から開くことができます。どの場所でも、保存する前に作成、検証、プレビューを行えます。

開ける場所

開いた場所	編集対象
Dataset → 属性 → マッピング／Expressionセル	計算属性
Dataset → 一般 → グローバルデータセットフィルター → フィルター式を追加…	マイニング前に適用する行フィルター
Chart settings → 指標Expression → 指標Expressionを使用…	行ごとに評価される指標Expression
Chart settings → セカンダリメトリクス → Expression…	セカンダリ指標Expression
Chart settings → テキスト／Htmlチップ	グラフテキスト：リテラルテキストと`${ ... }`Expression
Chart settings → 基準設定 → ƒ → 開始／停止Expression	プロセス設定の定数から解決される基準境界

ダイアログのタイトルには編集対象が反映されます。たとえば、Edit Expression: {attribute name}や行フィルター式のように表示されます。

式の作成

入力中は構文が強調表示されます。関数、属性、定数、ケースのプロパティ、行参照はそれぞれ異なる色で表示され、解析エラーには赤い下線が付きます。
Ctrl/Cmd+Spaceを押すと入力候補が開きます（自動では開きません）。Enterまたはタブで選択した項目を適用し、Escで一覧を閉じます。
任意のトークンにカーソルを合わせると、ドキュメントが表示されます。関数にはシグネチャ、説明、例が表示され、属性には型が表示されます。
関数呼び出しの中では、シグネチャヘルプに入力中のパラメーターが表示されます。
元に戻すとやり直しのボタンはヘッダーにあり、ショートカットとしてCtrl/Cmd+Z、Shift+Ctrl/Cmd+Z、Ctrl/Cmd+Yを使えます。

リファレンスパネル

式を作成する要素を選択パネルには、使用できるすべての要素がセクション別に表示されます。

属性：データセットの属性です。クリックすると挿入されます。
定数：プロセス設定で定義されたプロセス全体の定数です。
Functions：カテゴリ別に整理され、シグネチャ、説明、例を示すツールチップが表示されます。クリックすると、かっこ付きで関数名が挿入されます。
ケースのプロパティと行参照：行参照をクリックするとprevious.が挿入され、前の行との比較を作成できます。

検索ボックスでは、名前、シグネチャ、説明、例を検索できます。意図も認識するため、「days between」や「sum with condition」と入力すると、該当する関数が表示されます。ヘッダーのヘルプアイコンをクリックすると、式言語のドキュメントが開きます。

プレビュー

属性と指標では、入力中に更新される出現回数の多い値のライブプレビューが表示されます。出現回数の多い結果と件数に加え、nullおよびotherのバケットも表示されます（最大20個）。プレビューの実行中は式のプレビューを実行しています…と表示され、エラーがある場合は式を修正してプレビューを表示と表示されます。行フィルターはプレビューに対応していないため、その旨がエディターに表示されます。

グラフテキストテンプレート

グラフテキスト（テキストグラフ、KPI、ゲージ、HTMLフレーム）はテンプレートです。リテラルテキストは記述どおりに保持され、各${ ... }セグメントが評価されます。エディターは各セグメントを検証し、入力中に強調表示します。テキスト、Html、指標Expression、基準Expressionは、保存でエディターを閉じた場合にのみ適用されます。キャンセルすると下書きは破棄されます。通常のグラフテキストとHTMLは行ごとに評価できないため、値のプレビューの代わりにグラフテキストのプレビューは利用できませんと表示されます。

基準ExpressionはProcess Settingsの定数（例：slaTargetDays * 86400000）に対して解決されるため、エディターには定数と関数が表示されますが、データセット属性は表示されません。

検証と保存

編集中は継続的に検証が行われます。ダイアログ下部のステータス行には、緑色のExpressionは有効ですチェック、または**Error at position 12: Expected ‘)’ but got …**のような赤色のエラーが表示されます。よくあるエラーには、未知の関数や変数、引数の数の誤り、閉じられていない文字列、型の不一致があります。

式が無効な場合や行フィルターの制限に該当する場合、保存は無効になります。フィールドを空にして保存すると、式が削除されます。キーボードから保存するにはCtrl/Cmd+Enterを押し、保存せずに閉じるにはキャンセルをクリックします。

行フィルター：使用できる要素と使用できない要素

行フィルターは、データの読み込み時にすべての生のイベント行に対して、マイニング前に実行されます。式がtrueになる行だけが保持され、false、空の値、nullの結果は削除されます。この制約により、使用できる要素が限られます。

**使用可能：**行自身の値。データセットの属性と組み込み列エイリアス（caseid、time、activity、cost、user、start_time、co2）が対象です。
**使用不可：**ケースレベルまたは行をまたぐコンテキストが必要な要素。ケースプロパティ、ケース集計とウィンドウ関数、行参照（previous.）、first()などのアクティビティ検索、followedBy式が該当します。

使用できない要素を指定すると、次のメッセージが表示され、保存が無効になります：「Row filters can only use raw row data. Remove case properties, case aggregates, row references, activity lookups, or followed-by expressions.」

Expression Editor