テンプレート処理中にエラーが発生しました。
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@51577ebb"; 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> 

カテゴリーファセット

カテゴリーファセットは、検索クエリのキーワードに一致するカテゴリーに分類されたアセットの検索結果を絞り込みます。 一致する各結果のカテゴリーは、ファセット用語として集約されます。

Example of category facet results.

カテゴリーファセットの設定

カテゴリー・ファセットを設定するには、ファセットの Options メニュー( Options )を開き、 Configuration をクリックします。

Click the Configuration option.

[表示設定]が最初に表示されます。

表示テンプレート: Default , Cloud Layout , Compact Layout , Label Layout , Vocabulary Layout(7.4 Update/GA 48+ で使用可能)から選択。 デフォルトのレイアウトでは、各用語の横にチェックボックスが表示されますが、コンパクトレイアウトでは表示されません。 ラベルレイアウトでは、用語ごとにクリック可能な小さなラベルが表示されます。 ボキャブラリレイアウト では、ボキャブラリごとに整理されたファセット用語(カテゴリー)が表示されます。

[詳細設定]セクションには、追加のオプションが含まれています。

カテゴリ・パラメータ名: ファセットのURLのパラメータ名を変更します。 デフォルトは category である。

important

ファセット ウィジェット間で AND スタイルの選択を実現するには、ウィジェットごとに異なるカテゴリ パラメータ名を設定する必要があります。 デフォルトでは、すべてのカテゴリ ファセット ウィジェットのこのフィールドは category に設定されています。 以下の例 は使用例を示しています。

最大用語数: ファセットに一致する用語の数に関係なく、表示するファセット用語の最大数を設定します。

頻度のしきい値: ファセット用語リストに用語を表示するために必要な最小頻度を設定する。 たとえば、ファセットの頻度の閾値が3に設定されている場合、一致する結果が2つの用語は用語結果リストに表示されません。

頻度を表示する: 項目の頻度を表示するかどうかを選択する。

Order Terms By: Liferay 7.4 U56+/GA56+では、ファセット用語のソート戦略を選択できます:用語頻度降順(デフォルト)、用語頻度昇順、用語値昇順、用語値降順。 デフォルトのソートでは、ファセット用語のマッチ数が多いものから少ないものへと並べ替えられます。 用語の値オプションでは、ファセット用語をアルファベット順に並べます。

ボキャブラリごとのファセット用語の表示とフィルタリング

7.4 U48+とGA48+について

デフォルトでは、カテゴリーファセットウィジェットは、サイト内のすべてのボキャブラリから一致する結果のカテゴリを収集し、フラットリストで表示します。 アップデート48における機能拡張により、新たな表示やフィルタリングの動作が可能になりました。

ファセット用語(カテゴリー)をボキャブラリ別に表示する

カテゴリーファセットの設定画面でボキャブラリレイアウトを選択することで、カテゴリーをそのボキャブラリ下に表示できます。

Categories are displayed under their vocabulary.

ファセット用語(カテゴリー)をボキャブラリ別に絞り込む

ファセットに表示するボキャブラリとカテゴリーを選択します。 これを有効にするには、System Settings → Search → Category Facet Field の設定を、デフォルトのフィールド assetCategoryIds から assetVocabularyCategoryIds フィールドに切り替えます。 この設定は、カテゴリーファセットで集計を作成するために使用されるフィールドを指定します。 assetVocabularyCategoryIds`を設定すると、Category Facetウィジェットの設定画面内の語彙設定が有効になります。

important

Liferay 7.4 Update/GA 48より前のバージョンやアップデートからアップグレードする場合で、システム内にすでにカテゴリー化されたアセットがある場合は、すべての検索インデックスのインデックスを再作成して、検索ドキュメントに必要なassetVocabularyCategoryIdsフィールドを含めてください。

Select the vocabulary.

この動作により、強力な検索ファセット体験を提供することができます。 以下の使用例 をご参照ください。

例:ボキャブラリーを使用してカテゴリーファセットで階層型フィルタリングエクスペリエンスを作成する

自動車部品を購入するためのコマースポータルを考えてみます。 各パーツは、異なるボキャブラリーで分類されたコマース製品です。

  • ボキャブラリ:Vehicle System

    カテゴリー:

    • Brake System
    • Engine
    • Exhaust System
    • Suspension
    • Transmission
    • Turbocharger
  • ボキャブラリー:Quality

    カテゴリー:

    • Premium
    • 標準

ユーザーは、「エンジン」と「排気システム」を選択した場合に、いずれかのカテゴリーに一致する製品が表示されることを期待します。 さらに、「Quality」のボキャブラリから「Premium」を選択した場合、エンジンや排気システムのプレミアムな自動車部品だけに絞られることを期待します。 7.4 アップデート/GA 48バージョンでは、すぐにそれを実現することができます。

上記のユースケースを設定するには、

  1. グローバルメニュー → [コントロールパネル]→ [サイト]で新規サイトを作成します。 プロンプトが表示されたら、Miniumサイトテンプレートを選択します。

  2. サイト名をFooとし、 Add をクリックしてください。

  3. グローバル サイトのメニュー → [カテゴリー設定]→ [カテゴリー]に移動します。 「Quality」というボキャブラリ名を追加し、「Premium」と「Standard」という2つのカテゴリーを作成します。

    important

    Fooサイトのサイトカテゴリーではなく、グローバルサイトのグローバルカテゴリーを作成する必要があります。

    note

    サイトの初期化時にサイトテンプレートによって作成された既存のボキャブラリがあります(サイト名にちなみFooとされています)。構築する例に合わせ、Vehicle Systems という名前を付けて、カテゴリーをより明確にした方が良いでしょう (例: Brake System)。 ただし、Fooボキャブラリのカテゴリーは既存のコマース製品から参照されるため、編集することはできません。

    Create a Quality vocabulary in the global site.

  4. グローバルメニュー → コマース → [Products](製品管理セクション下)で、既存のコマース製品の一部を分類します。

    「Premium」カテゴリーを以下に追加します。

    • Premium Brake Fluid
    • Premium Brake Pad

    以下のように、いくつかの追加製品に「Standard」カテゴリを追加します。

    • ABS Sensor
    • Brake Fluid
    • Wear Sensors
    • Brake Pads
    • Brake Rotors

    Categorize some existing products as Premium or Standard.

  5. Fooサイトのホームページに移動します。 Miniumサイトのホームページは、デフォルトで製品カタログとなっており、基本的には[空の検索を許可する]を有効にした検索ページとなっています。

    カテゴリーファセットウィジェットでは、両方のボキャブラリのカテゴリーが1つのフラットリストに表示されます。 複数のファセット用語(例:「Suspension」と「Standard」など)を選択すると、ページ上に結果が展開されます。これは、ファセット用語間のOR演算子の動作を示しています。

    The categories of all available vocabularies are aggregated.

    このページのウィジェットの中には、コマースに特化したウィジェット(仕様ファセットなど)もありますが、カテゴリーファセットは標準の検索ウィジェットになります。

  6. assetVocabularyCategoryIdsフィールドを使用して集約を作成するように、Category Facetウィジェットを変更します。 [システム設定]→ [検索]に移動します。 Category Facet Field項目で、Category Facet FieldセレクタでassetVocabularyCategoryIdsを選択し、設定を更新する。

  7. Fooサイトのホームページに、Fooボキャブラリのカテゴリーのみを表示するように設定されたカテゴリーファセットウィジェットを追加します。

    • ページ上部の プラスアイコン をクリックします(! Plus )。
    • カテゴリファセット*ウィジェットを既存のウィジェットの真上または真下にドラッグします。
    • ウィジェット設定*画面を開く(アプリオプション)。
    • 表示テンプレートのセレクタを開き、 語彙レイアウト を選択します。
    • Categoryパラメータ名を foocategories に変更する。
    • ボキャブラリーの選択」ラジオボタンをクリックします。 Global を展開し、 Foo_を選択する。
    • 保存」をクリックする。
  8. 同様の手順で、オリジナルのカテゴリーファセットウィジェットを設定し、「Quality」ボキャブラリのカテゴリーのみを表示し、ボキャブラリレイアウトテンプレートを使用します。 新しいカテゴリーファセットウィジェットのカテゴリーパラメータ名はすでに変更されているので、既存ウィジェットのデフォルト値のままにしておくことができます。

  9. ページを更新します。 Fooボキャブラリを表示するカテゴリーファセットウィジェットで「Brake System」と「Suspension」のカテゴリーを選択すると、表示される製品が「Brake System OR Suspension」のカテゴリーと一致するようになります。

    「Quality」カテゴリーを表示するカテゴリーファセットで「Standard」を選択すると、「Brake System OR Suspension AND Standard」に分類される製品のみに結果が絞り込まれます。

Configure hierarchic filtering in the Category Facet.