UIP PM の適合性、UIP PM の逸脱、UIP PM クエリ

Process Mining アプリを分析するための構文とオプション (適合率、許容される逸脱、アドホック データ クエリ) と、「uip pm 適合性」、「uip pm の逸脱」、「uip pm クエリ」を使用。

uip pmツールの一部です。conformance と deviations は query上の利便性レイヤーであり、アプリの内部適合性フィールド ID を解決し、平易な言葉で回答します。query は、この 2 つがカバーしていないもののための汎用脱出ハッチです。

注:

conformance と deviations は、モデルベースのアプリ (apps createの--miner inductive または bpmn、または conformance upload-modelを介してアップロードされた BPMN 参照モデルでのみ機能します。directly-follows アプリには参照モデルも適合性データもありません。このグループ内のすべての動詞は、マイナーの名前を示す明示的なエラーで失敗します。

概要

uip pm conformance rate <app-id> [--process-id <id>] [--stage dev|published]
uip pm conformance activities <app-id> [--process-id <id>] [--stage dev|published]
uip pm conformance transitions <app-id> [--process-id <id>] [--stage dev|published]
uip pm conformance deviations <app-id> [--process-id <id>] [--stage dev|published]
uip pm conformance upload-model <app-id> <bpmn-file> [--process-id <id>]

uip pm deviations list <app-id> [--process-id Process] [--stage dev|published]
uip pm deviations accept <app-id> --type <type> --activities <activities...> [--process-id Process]
uip pm deviations delete <app-id> --type <type> --activities <activities...> [--process-id Process]
uip pm deviations delete-all <app-id> -y [--process-id Process]

uip pm query run <app-id> [--body <file> | --body-json <json> | --group-by <cols> --metric <col:fn[:alias]>...] [--process-graph] [--conformance] [--limit <n>] [--stage dev|published]
uip pm query details <app-id> [--body <file> | --body-json <json>] [--limit <n>] [--stage dev|published]
uip pm query rca <app-id> [--body <file> | --body-json <json>] [--limit <n>] [--stage dev|published]
uip pm query insights <app-id> [--body <file> | --body-json <json>] [--limit <n>] [--stage dev|published]
uip pm query info <app-id> [--stage dev|published]
uip pm query layout <app-id> [--type graph|process-model] [--stage dev|published]
uip pm query percentile <app-id> --field <id> --values <list> [--filters <file> | --filters-json <json>] [--stage dev|published]

UIP PM の適合率

参照モデルに従ったケースの割合

オプション

長押し	値 (Value)	説明
--process-id <id>	string	レポートするプロセスマルチプロセス アプリでのみ必要です。
--stage <stage>	dev | published	既定 devです。

例

uip pm conformance rate 9c46289e

データシェイプ(--output json)

{ "Code": "PmConformanceRate", "Data": { "ProcessId": "Process", "Miner": "inductive", "ConformanceRate": 0.666667, "ConformingCases": 2, "TotalCases": 3 } }

[UIP PM 適合性] アクティビティ

各アクティビティとその背後にあるケースの適合性ステータス

uip pm conformance activities 9c46289e

{ "Code": "PmConformanceActivities", "Data": [{ "Activity": "Approve", "Status": "Conforming", "Cases": 2 }, { "Activity": "Escalate", "Status": "LogOnly", "Cases": 1 }] }

Status は、 、 LogOnly、 ConformingAcceptedのいずれかModelOnly。

UIP PM の適合性の移行

アクティビティ間の各遷移の適合性ステータス。

uip pm conformance transitions 9c46289e

{ "Code": "PmConformanceTransitions", "Data": [{ "FromNodeId": "Start", "ToNodeId": "Approve", "Status": "Conforming", "Cases": 2 }] }

UIP PM の適合性の逸脱

データが実際に示す逸脱 ( uip pm deviationsと混同しないでください。 は許容 される 逸脱を管理します。

uip pm conformance deviations 9c46289e

{ "Code": "PmConformanceDeviations", "Data": [{ "Deviation": "Activity Approve is skipped", "Type": "Skip", "Cases": 1, "AverageThroughputTime": 2700 }] }

UIP PM 適合性 upload-model

アプリの参照モデルとして BPMN ファイルをアップロードします。開発ステージのみ。次回の取り込み時に有効になります。アップロードしただけでは何も再測定されません。

引数

名前	Required	目的
<app-id>	○	プロセス アプリ ID です。
<bpmn-file>	○	ローカル .bpmn ファイル、最大 6 MB。

オプション

長押し	値 (Value)	説明
--process-id <id>	string	モデルが属するプロセス。マルチプロセス アプリでのみ必要です。

例

uip pm conformance upload-model 9c46289e ./order-to-cash.bpmn

データシェイプ(--output json)

{ "Code": "PmConformanceUploadModel", "Data": { "AppId": "9c46289e", "File": "./order-to-cash.bpmn", "Status": "Uploaded", "Messages": [] } }

ファイルが 6 MB を超える場合、またはサーバーが BPMN を検証して拒否した場合 (応答のHasError ) は失敗します。拒否の理由は失敗メッセージに表示されます。成功としてサイレントに報告されることはありません。

UIP PM の逸脱

アプリをチェックする許容偏差リストを管理する — 逸脱を受け入れると、適合性はカウントを停止します。変換が再実行されるまで、何も有効になりません。 list では、そのギャップを逸脱ごとのステータスとして報告します。

--process-id は、既定ですべての動詞で "Process" に設定されます (マルチプロセス アプリでのみ重要)。

UIP の PM の逸脱リスト

オプション	値 (Value)	説明
--process-id <id>	string	既定 Processです。
--stage <stage>	dev | published	既定 devです。

{ "Code": "PmDeviationsList", "Data": [{ "Type": "activity_missing", "Activities": ["Approve order"], "ParentProcess": [], "Status": "NotApplied" }] }

Status は Applied (最後に成功した取り込みで取得)、 NotApplied (その取り込み以降で承認)、または AppliedButDeleted (その後削除) です。後者の 2 つはどちらも「追いつくために変換を再実行する」ことを意味します。

UIP PM の逸脱の受け入れ

長押し	値 (Value)	Required	説明
--type <deviation-type>	string	○	conformance deviationsによって報告される逸脱の種類。
--activities <activities...>	文字列、スペース区切り	○	逸脱がカバーされるアクティビティ名
--process-id <id>	string	×	既定 Processです。

uip pm deviations accept 9c46289e --type activity_missing --activities "Approve order"

{ "Code": "PmDeviationsAccept", "Data": { "AppId": "9c46289e", "Type": "activity_missing", "Activities": ["Approve order"], "Status": "Accepted" } }

種類/アクティビティ/プロセスの正確な組み合わせが既に受け入れられている場合は、失敗します。トップレベルの逸脱にのみ到達します。サブプロセス (空ではない parentProcess) に入れ子になった逸脱は、このコマンドから一致させることはできません。 --activities は parentProcessを送信しないためです。

UIP PM の逸脱 削除

acceptと同じオプションです。逸脱を受け入れるのをやめてください。つまり、種類、アクティビティ、親プロセスが許容された逸脱と完全に一致する必要があります。

{ "Code": "PmDeviationsDelete", "Data": { "AppId": "9c46289e", "Type": "activity_missing", "Activities": ["Approve order"], "Status": "Deleted" } }

UIP PM の逸脱 delete-all

アプリ上であらゆる逸脱を受け入れるのはやめましょう。

長押し	値 (Value)	説明
-y, --yes	フラグ	この元に戻せない操作を確認します。必須。
--process-id <id>	string	既定 Processです。

{ "Code": "PmDeviationsDeleteAll", "Data": { "AppId": "9c46289e", "Status": "Deleted" } }

UIP PM クエリ

マイニングされたアプリに対する汎用データ クエリ。すべての身体を取る動詞 (run/details/rca/insights) は --body <json-file> / --body-json <json> (相互に排他的)、 --stage、および ( insights...実際には 4 つすべて) --limit (サーバーは 1..1000 にクランプします)。

UIP PM クエリの実行

集計 (グループ化 + メトリック) クエリ。生の本文の上に sugar 構文がサポートされています。

長押し	値 (Value)	説明
--group-by <cols>	コンマ区切り	グループ化の条件にするフィールド列 (名前または ID、 query infoから)。砂糖; --body/--body-jsonと相互に排他的です。
--metric <col:fn[:alias]>	繰り返し可能	フィールドを集計します。fn のいずれか any、 average、 count、 distinct_count、 forall、 forany、 max、 median、 min、 percentage、 sum (大文字と小文字を区別せず、 -/_ を入れ替え可能) のいずれかです。既定のエイリアスは <fn>_<column>です。
--process-graph	フラグ	プレーン データ モデルではなくプロセス グラフ (アクティビティ/遷移) で回答する。砂糖のみ — 生の体はそれ自体を運びます isProcessGraph 。
--conformance	フラグ	ログの処理ではなく、モデルのみの側 (ケースがスキップされたと参照モデルが予期していたステップ) に回答してください。砂糖のみ。

他の集計関数 (COUNT_ROWS、 EXISTS、 APPROX_DISTINCT_COUNT、 PERCENTILE、 CASE_AVERAGE) は --metric では利用できません。 --body/--body-json で作成します (特にパーセンタイルには query percentile を使用します)。

例

uip pm query run 9c46289e --group-by Open_year --metric Event_count:average

uip pm query run 9c46289e --body-json '{"groupBy":["F__Cases__Priority__..."],"aggregates":[{"id":"n","argument":"Case_ID","aggregation":"COUNT"}]}'

uip pm query run 9c46289e --metric Case_conforming:percentage

# Skipped steps: activities the reference model expected that a case didn't take
uip pm query run 9c46289e --group-by Node_id,Node_label --metric Case_ID:distinct_count --process-graph --conformance

データシェイプ(--output json)

{ "Code": "PmQueryRun", "Data": [{ "Open_year": 2014, "average_Event_count": 9.16 }] }

sugar 構文を使用すると、エンジンの列方向の応答は、人間の列名/エイリアスによってキーを持つ行オブジェクトに再形成されます。生の --body/--body-json 呼び出しは、エンジンの応答をそのまま返します。

UIP PM クエリの詳細

生の表の行。

{ "Code": "PmQueryDetails", "Data": {} }

UIP PM クエリ RCA

根本原因分析。本文には空ではない selectedSetが必要です。

uip pm query rca 9c46289e --body-json '{"argument":"Case_ID","exploreAttributes":["Case_type"],"selectedSet":[[{"kind":"values","dimension":"Case_status","type":"string","values":["Open"],"invert":false,"displayType":"list"}]]}'

{ "Code": "PmQueryRca", "Data": { "Data": {}, "Warnings": null } }

UIP PM クエリに関するインサイト

「プロセスのインサイト」体には processId と1〜10 metricsが必要です。

{ "Code": "PmQueryInsights", "Data": {} }

UIP PM クエリ情報

クエリ本文で利用可能なフィールド、メトリック、プロセスを見つけます。

uip pm query info 9c46289e

{ "Code": "PmQueryInfo", "Data": { "fields": [], "processes": [] } }

UIP PM クエリのレイアウト

プロセス アプリの永続化されたグローバル グラフのレイアウトを取得します。

長押し	値 (Value)	既定 (Default)	説明
--type <type>	graph | process-model	graph	読み取るレイアウト。

{ "Code": "PmQueryLayout", "Data": {} }

UIP PM クエリのパーセンタイル

数値フィールドのパーセンタイルを計算します。

長押し	値 (Value)	Required	説明
--field <field-id>	string	○	フィールド ID (query info)。
--values <list>	コンマ区切り、0..1	○	パーセンタイル ポイント (例:0.5,0.9,0.95です。
--filters <json-file> / --filters-json <json>	JSON	×	フィルター仕様 (AND-ed フィルター グループの配列)。相互に排他的です。

uip pm query percentile 9c46289e --field PF__throughput_time --values 0.5,0.9,0.95

{ "Code": "PmQueryPercentile", "Data": { "values": [3600, 86400, 172800] } }

関連

• uip pm — 概要と apps CRUD
• apps model — これらのクエリで参照するフィールド/メトリックの定義です。
• ingestions & transformations — クエリは、対象のステージで完了した取り込みが必要です。

参照

• グローバル オプション
• 終了コード