ご覧のページは、お客様の利便性のために一部機械翻訳されています。また、ドキュメントは頻繁に更新が加えられており、翻訳は未完成の部分が含まれることをご了承ください。最新情報は都度公開されておりますため、必ず英語版をご参照ください。翻訳に問題がある場合は、こちらまでご連絡ください。

ワークフロー指標の使用

サブスクリプション

警告

この機能はElasticsearchでのみ利用可能です。

ワークフローメトリクス は、特定のワークフローイベントを完了するのに要した時間についての洞察を提供します。これを使用するには、ワークフロープロセスのイベントに期限を設定します。これらの期限設定は、SLA（サービスレベル契約）と呼ばれます。ワークフローレポートは、一度定義されると、SLAへの準拠状況を測定します。これらは、ワークフロー参加者とワークフロー項目を送信するユーザーとの間の契約のようなものです。ワークフローレポート には、SLA が設定されているすべてのプロセスに関するデータが表示され、各ワークフローアイテムの SLA ステータス (期限内または期限超過) も表示されます。

重要

SLA を含むワークフローの編集: SLA が定義されているワークフローを編集 (ノードの削除、タスク名の編集など) すると、ワークフロー/SLA パイプラインに既に存在するアイテムの SLA が無効になる場合があります。
アクティブなプロセスの SLA の作成または編集: アイテムが既にワークフロープロセスにある状態で SLA の期間を編集したり、新しい SLA を定義したりすると、現在ワークフローにあるすべてのインスタンスの再計算が行われます。完了したワークフローインスタンスは再計算されません。

前提条件

ワークフローメトリクスを使用するには、Elasticsearch を使用して DXP データをインデックス化する必要があります。詳細については、 Elasticsearch のインストールの記事をお読みください。

SLAの追加

SLAを追加するには、

グローバルメニュー () を開き、 アプリケーション → ワークフローメトリクス に移動します。
プロセスのタイトルをクリックしてください。
当該プロセスにSLAが設定されていない場合は、その旨を示す警告メッセージが表示されます。警告メッセージから 新しい SLA を追加 リンクをクリックすると、新しい SLA フォームに直接アクセスできます。

または、オプション（）をクリックして、 SLA設定を選択します。
SLA画面で、追加 ( をクリックします。
新しいSLAフォームで、SLAの名前と説明を入力してください。
SLAの期間を定義し、以下の3点を指定してください。
- 開始: タスクに入ります: レビュー
- 一時停止: タスク: 更新
- 停止: 処理終了: 承認済み
SLAの期間（つまり、期限）を定義します。 2つの時間入力欄のうち、少なくとも1つに記入してください。
- 日数: 1
- 時間: 00:00
をクリックして保存します。

SLA画面からSLAを管理します。

有効な開始イベントと停止イベント

ワークフローのタスクはどれでも、SLAの開始パラメータまたは終了パラメータとして使用できます。

アイテムがここで定義されたイベントに到達すると、SLAタイマーのカウントが開始されます。以下の選択肢からお選びください。

イベント開始	説明
開始ノード	SLAタイマーは、が作成したノードに入ったときに開始されます。
タスクへの参加	SLAのカウントダウンは、ワークフローがタスクに移行した時点から始まります。
タスクを終了する	SLAのカウントダウンは、ワークフローがタスクから移行した時点から始まります。例えば、SLA タイマーはレビュータスクを終了したときに開始されます。

アイテムが定義された SLA 期間 (期限) より前に Stop イベントに到達した場合、SLA に従って オンタイム となります。指定された期間内に停止イベントに到達できなかった場合、それは 期限切れ となります。 SLAの停止イベントとして機能するタスクを定義する際には、以下のオプションから選択してください。

イベントを停止	説明
タスクへの参加	SLA クロックは、ワークフローがタスクに移行したときに停止します (たとえば、 Update タスク)。
タスクを終了する	SLA クロックは、ワークフローがタスクから移行したときに停止します (たとえば、レビュータスク)。
エンドノード	SLAタイマーは、承認済みノードに入ると停止します。

「一時停止」フィールドは、ワークフロー内で時間のカウントを停止するイベントを定義します。単一承認者ワークフローの場合、アイテムが更新タスクにあるときにSLAタイマーを一時停止するように選択できます。 SLAは、開始ノードと終了ノードの間にある任意のタスクで一時停止することができ、SLAを一時停止するノードを設定することで定義されます。ワークフロー項目が指定されたノードにある間、SLA タイマーは一時停止されます。

期間

時間の単位	説明
日	日数として整数を入力してください。 36 時間などの端数日がある場合は、時間フィールドと組み合わせて使用し、1 日 12 時間と表現します。
営業時間	時間数と分数を入力します。時間ボックスの値は 23:59を超えてはなりません。期間が 1 日を超える場合は、日数フィールドと組み合わせて使用してください。

SLAジョブ間隔の設定

メトリクスの再計算間の時間間隔は、 SLA ジョブ間隔 と呼ばれます。デフォルト値は1分です。それを変更するには、

アプリケーションメニュー（）から、システム設定アプリケーションに移動し、ワークフローメトリクスのエントリを開きます。
「Check SLA Job Interval」の設定値を変更し、「保存」をクリックします。

あるいは、

設定ファイルを作成します。

com.liferay.portal.workflow.metrics.internal.configuration.WorkflowMetricsConfiguration.config

次のような内容を与えてください。
```
checkSLAJobInterval="1"
```
[Liferay Home]/osgi/configsに配置します。

ワークフローメトリクスデータは、検索エンジンから読み込まれ、メトリクスの計算に使用されます。間隔値を設定する際には、以下の相反するパフォーマンス上の懸念事項を考慮してください。

指標の再計算間隔が長いほど、再計算のたびに読み込まれる検索ドキュメントの数が増える。
指標の再計算イベントの間隔が短いほど、検索エンジンへの読み取りリクエストの頻度が高くなる。

ワークフローメトリクスの再インデックス

Liferay DXP の Reindex アクションは、マッピングファイルに基づいて検索インデックスを完全に削除してから再作成します。メトリクスもデータベースに保存されているため、インデックスの再構築時にデータが失われる危険性はありません。 Liferay 7.3 でワークフローメトリクスを再インデックスするには、

Metrics アプリケーションから、オプションメニュー (を開き、設定をクリックします。
ワークフローインデックスアクション画面で、ワークフローインデックスのエントリに対して すべて再インデックス をクリックします。

このオプションは、ワークフローメトリクスアプリケーション内のすべてのインデックスに対して作用します。より詳細なオプションも利用可能です。複数の仮想インスタンスがある場合は、それぞれのワークフローメトリクスを個別に再インデックスする必要があります。

Liferay 7.2 では、ワークフローメトリクスは検索管理パネル (コントロールパネル → 設定 → 検索) から再インデックスされます。

検索エンジンが最初に構成されたとき、およびアップグレードされるたびに、ワークフローメトリクスの再インデックスが必要です。経験則として、Liferay DXPのメイン検索インデックスが再インデックスされるたびに、ワークフローメトリクスも再インデックスされるべきです。

ワークフロープロセスの全体的な指標からワークフロー内の単一のアイテムの詳細まで、新しいワークフローメトリクス機能を使用すると、Liferay DXP で 作業を完了するのにかかる時間 についての洞察が得られます。

ワークフロータスクの一括管理

メトリクスUI内では、ワークフロータスクを一括管理できます。例えば、個々のタスクを一つずつ確認することなく、一人のユーザーに複数のタスクを割り当てることができます。この機能を検証するには、ワークフロープロセス内で管理する必要のある項目がいくつかあることを確認してください。例えば、ブログ用のシングル承認ワークフロープロセスを有効化し、ワークフローにいくつかのブログを送信します。

メトリクスアプリケーションから、ワークフロープロセス（例：単一承認者）をクリックして、ダッシュボードビューを開きます。
合計保留中 ボックスにカーソルを合わせ、 アイテムを見る をクリックすると、保留中のステータスを持つ保留中のワークフローアイテムのテーブルが開きます。
ワークフローで再割り当てしたい項目を選択し、再割り当てボタン（）をクリックします。
「再割り当てするタスクを選択」モーダルで、タスクを再度選択し、次へをクリックします。
すべてのタスクを同じ担当者に割り当てるには、チェックボックス すべてのタスクに同じ担当者を使用する をオンにします。次に、譲受人を検索します。

各タスクの担当者を手動で選択するには、各項目の「新しい担当者」ボックスを使用して担当者を選択してください。
「再割り当て」をクリックしてください。