テンプレート処理中にエラーが発生しました。 
Java method "com.liferay.portal.json.JSONFactoryImpl.createJSONObject(String)" threw an exception when invoked on com.liferay.portal.json.JSONFactoryImpl object "com.liferay.portal.json.JSONFactoryImpl@2ad66ae2"; see cause exception in the Java stack trace.

----
FTL stack trace ("~" means nesting-related):
	- Failed at: navigationJSONObject = jsonFactoryUti...  [in template "17855804202317#32484267#LEARN-ARTICLE-NAV" at line 4, column 9]
----
1<#assign 
2	groupFriendlyURL = themeDisplay.getScopeGroup().getFriendlyURL() 
3	groupPathFriendlyURLPublic = themeDisplay.getPathFriendlyURLPublic() + groupFriendlyURL 
4	navigationJSONObject = jsonFactoryUtil.createJSONObject(navigation.getData()) 
5	navigationMenuItems = 
6		{ 
7			"Analytics Cloud": { 
8				"image": "/documents/d${groupFriendlyURL}/analytics_c-svg", 
9				"title": "Analytics Cloud", 
10				"url": "analytics-cloud" 
11			}, 
12			"Commerce": { 
13				"image": "/documents/d${groupFriendlyURL}/commerce_product-svg", 
14				"title": "Commerce", 
15				"url": "commerce" 
16			}, 
17			"DXP": { 
18				"image": "/documents/d${groupFriendlyURL}/dxp_p-svg", 
19				"title": "DXP / Portal", 
20				"url": "dxp" 
21			}, 
22			"Liferay Cloud": { 
23				"image": "/documents/d${groupFriendlyURL}/dxp_c-svg", 
24				"title": "Liferay Cloud", 
25				"url": "liferay-cloud" 
26			}, 
27			"Reference": { 
28				"image": "/documents/d${groupFriendlyURL}/reference-svg", 
29				"title": "Reference", 
30				"url": "reference" 
31			} 
32		} 
33 
34	breadcrumbJSONArray = navigationJSONObject.getJSONArray("breadcrumb") 
35	childrenJSONArray = navigationJSONObject.getJSONArray("children") 
36	parentJSONObject = navigationJSONObject.getJSONObject("parent") 
37	productJSONObject = breadcrumbJSONArray.getJSONObject(breadcrumbJSONArray.length()-1)!navigationJSONObject.getJSONObject("self") 
38	siblingsJSONArray = navigationJSONObject.getJSONArray("siblings") 
39/> 
40 
41<div class="learn-article-nav"> 
42	<#if productJSONObject?has_content && productJSONObject.getString("title")?has_content && navigationMenuItems[productJSONObject.getString("title")]?has_content && navigationMenuItems[productJSONObject.getString("title")].title?has_content> 
43		<div 
44			class="dropdown learn-article-nav-root learn-dropdown" 
45		> 
46			<div class="learn-article-nav-item"> 
47				<div class="d-flex"> 
48					<div class="learn-article-nav-image"> 
49						<img 
50							class="lexicon-icon lexicon-icon-caret-bottom product-icon" 
51							role="presentation" 
52							src='${navigationMenuItems[productJSONObject.getString("title")].image}' 
53							viewBox="0 0 512 512" 
54						/> 
55					</div> 
56 
57					<span class="learn-article-nav-text">${navigationMenuItems[productJSONObject.getString("title")].title}</span> 
58				</div> 
59 
60				<div id="dropdown-icon"> 
61					<svg 
62						class="lexicon-icon lexicon-icon-caret-bottom" 
63						role="presentation" 
64						viewBox="0 0 512 512" 
65					> 
66						<use xlink:href="/o/admin-theme/images/clay/icons.svg#caret-bottom"></use> 
67					</svg> 
68				</div> 
69			</div> 
70 
71			<ul class="dropdown-menu learn-dropdown-menu"> 
72				<#list navigationMenuItems as key, value> 
73					<li> 
74						<a 
75							class="dropdown-item learn-article-nav-item" 
76							href="/w/${navigationMenuItems[key].url}/index" 
77							tabindex="4" 
78						> 
79							<span class="d-flex"> 
80								<span class="learn-article-nav-image"> 
81									<img 
82										class="lexicon-icon lexicon-icon-caret-bottom product-icon mt-0 mr-2" 
83										role="presentation" 
84										src="${value.image}"height: 25px; margin-left: 5px; max-width: none; width: 25px; 
85										viewBox="0 0 512 512" 
86									/> 
87								</span> 
88								<span class="learn-article-nav-text">${value.title}</span> 
89							</span> 
90 
91							<#if navigationMenuItems[productJSONObject.getString("title")].url == value.url> 
92								<span> 
93									<@clay["icon"] symbol="check" /> 
94								</span> 
95							</#if> 
96						</a> 
97					</li> 
98				</#list> 
99			</ul> 
100		</div> 
101	</#if> 
102 
103	<div class="learn-article-nav-content"> 
104		<#if parentJSONObject?has_content && parentJSONObject.getString("url")?has_content> 
105			<div class="learn-article-nav-item learn-article-nav-parent liferay-nav-item p-2"> 
106				<div class="mr-2"> 
107					<a 
108						href='${parentJSONObject.getString("url")}' 
109					> 
110						<svg 
111							class="lexicon-icon lexicon-icon-angle-left" 
112							role="presentation" 
113							viewBox="0 0 512 512" 
114						> 
115							<use xlink:href="/o/admin-theme/images/clay/icons.svg#angle-left"></use> 
116						</svg> 
117					</a> 
118				</div> 
119 
120				<span>${parentJSONObject.getString("title")}</span> 
121			</div> 
122		</#if> 
123 
124		<#if childrenJSONArray.length() gt 0> 
125			<ul class="m-0 p-2"> 
126				<#list 0..childrenJSONArray.length()-1 as i> 
127					<li class="learn-article-nav-item"> 
128						<a 
129							class='liferay-nav-item ${(navigationJSONObject.getJSONObject("self").url == childrenJSONArray.getJSONObject(i).url)?then("selected", "")}' 
130							href="${childrenJSONArray.getJSONObject(i).url}" 
131						> 
132							<span>${childrenJSONArray.getJSONObject(i).getString("title")}</span> 
133						</a> 
134					</li> 
135				</#list> 
136			</ul> 
137		<#elseif siblingsJSONArray.length() gt 0> 
138			<ul class="m-0 p-2"> 
139				<#list 0..siblingsJSONArray.length()-1 as i> 
140					<li class="learn-article-nav-item"> 
141						<a 
142							class='liferay-nav-item ${(navigationJSONObject.getJSONObject("self").url == siblingsJSONArray.getJSONObject(i).url)?then("selected", "")}' 
143							href="${siblingsJSONArray.getJSONObject(i).url}" 
144						> 
145							<span>${siblingsJSONArray.getJSONObject(i).getString("title")}</span> 
146						</a> 
147					</li> 
148				</#list> 
149			</ul> 
150		</#if> 
151	</div> 
152</div> 
フィードバックを送信

ワークフローメトリクスの使用

サブスクリプション

warning

この機能はElasticsearchでのみ機能します.

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

important

  • SLAが設定されたワークフローの編集： SLAが定義されたワークフローを編集すると(ノードの削除、タスク名の編集など）、ワークフロー/SLAパイプラインに既にある項目のSLAが無効になる場合があります。

  • *アクティブなプロセスに対するSLAの作成または編集：*項目が既にワークフロープロセスにある場合にSLAの期間を編集したり、新しいSLAを定義すると、現在ワークフローにあるすべてのインスタンスが再計算されます。 完了したワークフローインスタンスは再計算されません。

前提条件

ワークフローメトリクス を使用するには、Elasticsearchを使用してDXPデータにインデックスを付ける必要があります。 詳細は、Elasticsearchのインストールを参照してください。

SLAの追加

SLAを追加するには

  1. グローバルメニューでは、 ［アプリケーション］ → ［ワークフロー］ → ［メトリクス］ に移動します。

  2. プロセスのタイトルをクリックします。

  3. プロセスに対するSLAがない場合は、そのことを示す警告メッセージが表示されます。 警告メッセージの ［Add a new SLA］ リンクをクリックして、新しいSLAフォームに直接アクセスします。

    または、オプション(Options）メニューをクリックし、 ［SLA Settings］ を選択します。

    メトリクスアプリケーションからワークフロー定義にSLAを追加します。

  4. SLA画面で、 追加 ボタン(Add）をクリックします。

  5. 新しいSLAフォームで、SLAに名前と説明を付けます。

  6. 次の3つを指定して、SLAの期間を定義します。

    • Start ：Enters Task: Review
    • Pause : On Task: Update
    • Stop : Process Ends: Approved

  7. SLAの期間(つまり、期限）を定義します。 2つの時間ボックスの少なくとも1つに入力します。

    • Days: 1
    • Hours: 00:00

    SLAの例

  8. ［Save］ をクリックします。

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

有効な開始および停止イベント

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

項目がここで定義されたイベントに到達すると、SLAタイマーがカウントを開始します。 次のオプションから選択します。

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

項目が定義されたSLA期間(期限）の前に停止イベントに到達した場合、その項目はSLAに従って 期限内 となります。 指定した時間内に停止イベントに到達できなかった場合、 期限切れ となります。 SLAの停止イベントとして機能するタスクを定義する場合は、次のオプションから選択します。

停止イベント説明
タスクへのエントリSLAクロックは、ワークフローがタスク(アップデート タスクなど）に移行すると停止します。
タスクの終了SLAクロックは、ワークフローがタスク(レビュー タスクなど）から移行すると停止します。
終了ノード承認された ノードに入るとSLAタイマーが停止します。

［一時停止］フィールドは、時間のカウントを停止する必要があるワークフローのイベントを定義します。 Single Approverワークフローの場合、項目が更新タスクにあるときにSLAタイマーを一時停止することを選択できます。 SLAは、開始ノードと終了ノードの間にある任意のタスクで一時停止でき、SLAを一時停止する必要があるときにノードを設定することによって定義します。 ワークフロー項目が指定されたノードにある間、SLAタイマーは一時停止されます 。

期間

単位時間説明
日間日数は整数で入力します。 36時間などの場合は、 ［Hours］ フィールドと組み合わせて使用します。この場合は、 1日と12時間と表現します。
時間時間数と分数を入力します。 ［Hours］ ボックスの値は 23:59 を超えてはいけません。 期間が1日を超える場合は、 ［Days］ フィールドと組み合わせて使用します。

SLAジョブ間隔の設定

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

  1. グローバルメニュー(Applications Menu）から、［システム設定］アプリケーションに移動し、［ワークフロー統計情報］エントリーを開きます。

  2. ［SLAジョブの確認間隔］の設定値を変更し、 ［保存］ をクリックします。

または、

  1. 以下の設定ファイルを作成します

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

  2. 以下のような内容を指定します。

    checkSLAJobInterval="1"

  3. ［Liferay Home］/osgi/configsに配置します。

ワークフロー統計情報データが検索エンジンから読み取られ、メトリクスが計算されます。 間隔の値を設定するときは、次の競合するパフォーマンスの懸念を考慮してください。

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

ワークフロー統計情報のインデックスの再構築

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

  1. メトリクスアプリケーションから、オプションメニュー(Options）を開き、 ［Settings］ をクリックします。

  2. 次に、［ワークフローのインデックス操作］画面で、［ワークフローのインデックス］エントリの ［すべてインデックスを再構築］ をクリックします。

    このオプションは、ワークフロー統計情報アプリケーションのすべてのインデックスに作用します。 より詳細なオプションも利用できます。 複数の仮想インスタンスがある場合は、各仮想インスタンスのワークフローメトリクスのインデックスを個別に作成する必要があります。

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

検索エンジンを最初に設定する際およびアップグレードするたびに、ワークフロー統計情報のインデックス再構築が必要です。 経験則として、Liferay DXPのメインの検索インデックスが再構築されるたびに、ワークフロー統計情報のインデックス再構築が必要です。

ワークフロープロセスの全体的なメトリクスから、ワークフロー内の単一項目の詳細まで、新しいワークフロー統計情報機能を使用して、Liferay DXPでの 作業にかかる時間 を把握できます。

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

メトリックスUI内で、ワークフロータスクを一括管理することができます。 例えば、各タスクに個別に入ることなく、1人のユーザーに複数のタスクを割り当てることができます。 この機能を利用するには、ワークフロー・プロセス内で管理する必要のあるアイテムがあることを確認してください。 例えば、 active ブログのSingle Approverワークフロープロセスを実行し、いくつかのブログをワークフローに送信します。

  1. Metrics アプリケーションで、ワークフロープロセス(例：Single Approver）をクリックし、ダッシュボードビューを開きます。

  2. Total Pending ボックスにカーソルを合わせ、 See Items をクリックすると、Pending ステータスを持つ保留中のワークフロー項目のテーブルが表示されます。

  3. ワークフローで再割り当てしたい項目を選択し、再割り当てボタン(Reassign)をクリックします。

    複数のワークフロータスクを一度に再割り当て。

  4. 再割り当てするタスクの選択］モーダルで、タスクを再度選択し、 ［次へ］ をクリックします。

  5. すべてのタスクを同じ担当者に割り当てるには、 「Use the same assignee for all tasks」ボックスをチェックします。 にチェックを入れてから、担当者を検索します。

    各タスクの担当者を手動で選択する場合は、各項目の「新規担当者」ボックスを使用して担当者を選択します。

    各ワークフロータスクの担当者を選択するか、すべてのタスクに同じ担当者を使用します。

  6. 再割り当て］をクリックします。

同様の手順で、選択したワークフロー項目の期日を更新(Calendar）したり、ワークフロー内の別のステップに移行(Transition）したりすることもできます。

複数のワークフロー項目を一度に新しいステップに遷移させることができます。

関連トピック

Capability:
Platform
Resource Type:
Official Documentation
Feature:
Workflow
Deployment Approach:
Liferay PaaS
Liferay SaaS
Liferay Self-Hosted