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

検索結果の動作

前回は、 検索結果を表示する方法を 学びました。 検索結果を強化できる追加の検索結果の概念と構成があります。

ファセットを使用した結果のフィルタリング

結果はファセットを使ってフィルタリングされます。 ユーザーが検索ワードを入力すると、検索結果のリストと検索ファセットが表示されます。検索ファセットとは、共通の特徴を持つ結果をグループ化するバケットのようなものです。

管理者はファセットを設定することができます。 詳しくは 検索ファセット をご覧ください。

検索結果の関連性

検索エンジンは、検索結果の順位付けに、検索エンジンが算出したスコアである「関連性」を用います。 検索結果のスコアには、使用する検索エンジンによって様々な要因があります。

結果ランキング は、返された検索結果の順序をコントロールするのに役立ちます。

権限と検索結果

アセットに 表示権限 がないユーザーは、検索結果にそのアセットが表示されません。 サイト管理者の役割を持つログインしたユーザーは、ゲストよりも多くの検索結果を見ることができます。

権限チェックには2つのラウンドがあります。 最初の権限チェックであるプレフィルタリングは、検索エンジンのインデックスで行われます。 データベースの権限情報をチェックするよりも高速ですが、検索インデックスに古い権限情報が含まれる場合があります。 サーチエンジンのインデックスが正しく最新の権限情報を持っていることを保証するために、Liferayは結果を表示する前に、ポストフィルタリングという最後の2回目の権限チェックを行います。

初期の権限チェック

検索結果の許可フィルタリングの最初のラウンドは、検索クエリにフィルタ句を追加します。 これにより、検索エンジンから返ってくる検索結果には、現在のユーザーが閲覧できる結果のみが含まれるよう、事前にフィルターがかけられます。

この最初の権限チェックは、[コントロールパネル]→ [設定] → [システム設定] → [検索] → [権限チェッカー]で設定できます。

権限チェッカーの設定で、権限の期間制限を設定します。

権限期間制限: このレベルの権限チェックが中止される前に、検索クエリに追加される権限検索句の数を制限します。 権限チェックは、以下で説明する最終的な権限フィルタリングのみに依存します。

権限の条件を制限する唯一の理由はパフォーマンスです。 多くのサイトおよび組織への管理アクセス権を持つユーザーは、クエリに追加された多くの権限条件を生成します。 クエリ内の用語が多すぎると、検索エンジンがタイムアウトする可能性があります。

最終的な権限の確認

結果をUIで発表する前に、最終的な許可の確認を行います。 例えば、ユーザーが liferay を検索すると、検索エンジンは関連するすべてのフォーラムの投稿を返します。 検索結果は、関連するフォーラムの投稿のリストを繰り返し表示する際に、最後に投稿の権限チェックを行い、ユーザーが投稿とそのカテゴリを表示できることを確認します。 一致するフォーラムの投稿が、ユーザーに閲覧権限のないカテゴリーに存在する場合は、検索結果のリストから除外されます。

この最終的な権限チェックは、[コントロールパネル] &rarr [ 設定] → [システム設定] → [検索]→ [デフォルトの検索結果の権限フィルター] で設定できます。 次の2つの設定が含まれます。

デフォルトの検索結果の権限フィルタ設定で、追加の権限を設定します。

パーミッションフィルター済み検索結果精度のカウンターしきい値: 結果がカウントされる前に権限・フィルタリングする検索結果の最大数を指定します。 しきい値を高くすると、カウントの精度は向上しますが、パフォーマンスは低下します。 現在表示されているページの結果は常にチェックされるため、検索結果の1ページの表示数よりも小さい値を指定すると、この動作が事実上無効になります。

検索クエリの結果ウィンドウの上限を設定します。 各権限チェックリクエストの最大バッチサイズを設定します。 これもページネーションの影響を受けています。 例えば、1ページに100件の検索結果があり、ユーザーが検索結果の200ページ目までジャンプしたい場合、1ページ目から200ページ目までのすべての検索結果をチェックして、ユーザーに権限があることを確認する必要があります。 権限チェックの結果は20,000です。 これを検索エンジンとの間で一度に行うと、パフォーマンスの問題が発生する可能性があります。 権限チェックリクエストごとの最大バッチサイズを設定します。

検索とステージング

ステージングでは、コンテンツはまずプレビューやテスト環境に置かれた後、一般公開(ライブサイト)されます。 検索インデックスに追加されたコンテンツは、検索APIがアイテムがライブであるかどうかを解読できるようにマークされます。 ライブ版サイトでは、ライブ版サイト用にマークされたコンテンツのみが検索可能となります。 本サイトのステージングバージョンでは、ライブまたはステージングされたすべてのコンテンツが検索可能です。

検索と公開

公開を有効にすると、コンテンツが特定の公開に関連付けられます。 公開に追加されたコンテンツは、検索APIがアイテムが生産中であるかどうかを解読できるようにマークされます。 本番のサイトでは、 公開された コンテンツのみが検索結果として返されます。 進行中の公開では、プロダクションコンテンツや特定の公開に対するコンテンツを返すことができます。

結果の要約

結果の要約には、アセットの開発者が、アセットを検索する人にとって最も有用であると考えたドキュメントの情報が含まれています。 各アセットでは、サマリーに含まれるフィールドが異なります。 テキストコンテンツのあるアセットでは、タイトルとコンテンツの一部を含む一般的なサマリー形式で、タイトルが最初に表示されます。 2行目には必ずアセットタイプが表示され、最後の行には検索ワードにマッチしたコンテンツのスニペットが表示されます。 ドキュメントとメディアドキュメントなど、コンテンツ項目のないアセットは、代わりに説明を表示します。

note

ユーザーは異なります。 ユーザーの結果のサマリーには、ユーザーのフルネームとアセットタイプ(ユーザー)のみが表示されます。

ユーザーの場合は、ユーザーのフルネームのみが表示されます。

他のアセットを含むアセット(Webコンテンツおよびドキュメント & Mediaフォルダ)や、コンテンツが表示に適していないアセット(動的データリストレコードおよびカレンダーイベント)については、タイトル、アセットタイプ、および説明を結果のサマリーに表示する方が合理的です。

説明文を要約して表示するドキュメントフォルダ。

どのフィールドをサマリーに対応させるかはアセット開発者が決定しますが、検索時にはサマリーフィールドのどの部分を表示するかを正確に決定するロジックが実行されます。 例えば、 コンテンツ フィールドには多くのテキストが含まれていますが、サマリーではそのすべてが表示されません。 その代わりに、フィールドのテキストの関連する部分が表示されます。 検索されたキーワードがサマリーフィールドに存在する場合、フィールドのその部分がサマリーで使用されます。 さらに、マッチしたキーワードはサマリーでハイライトされます。

結果のサマリーにどのフィールドを含めるかを決定するために、「検索結果」ウィジェットは3つの点を考慮します。

  1. 概要に含めるアセット固有のフィールドは、 ModelSummaryContributor Javaクラス(Liferay独自のクラスおよびサードパーティの開発者によってデプロイされたクラス)で定義されます。 このロジックの古い実装は、 Indexer.getSummaryで提供されていました。

  2. 検索結果サマリーで表示可能なフィールドは、検索結果表示ロジックによって定義されます ( SearchResultsSummaryDisplayBuilder および SearchResultsSummaryDisplayContext )。

  3. 検索結果 ウィジェット(リスト デフォルト)で使用される ウィジェットテンプレート は、利用可能なフィールドのどれが要約に含まれるかを含め、検索結果表示に関連するすべてのことに関して最終決定権を持つ。

ハイライト

概要に表示される検索用語はデフォルトでハイライト表示されています。 望ましくない場合は、 ウィジェット設定画面 で無効にしてください。

検索キーワードは、検索結果の一覧でハイライト表示されます。

ハイライトは、なぜその結果が返されたのかを示唆する視覚的な手がかりとして役立ちますが、注意が必要です。 ヒットした商品のスコアが高く、結果的に検索結果の上位に表示されても、サマリーにハイライトが表示されないことがあります。 これは、すべてのインデックス付きフィールドが要約に表示されるわけではないためです。 Arthur C. Clarkeという名前のユーザーについて考えてみましょう。 彼は、 acc@authors.org の電子メールアドレスを持っており、検索可能です。 ユーザーの結果サマリーには、ユーザーのフルネームしか含まれていないため、クラークさんをメールアドレスで検索すると、ユーザーが表示されますが、用語はハイライトされません。

検索結果の中には、必ずしもハイライトされた用語がないものもあります。

検索結果のページを返す

Liferay 7.2以降では、公開コンテンツページの ページコンテンツ が、検索結果ウィジェットで返されます。 例えば、公開されているページのパラグラフフラグメントで見つかったテキストを検索することができます。

対照的に、最新のLiferay 7.2および7.3、そしてLiferay 7.4のすべてのリリースでは、プライベートコンテンツページおよびステージングされたページのコンテンツは、ユーザーの閲覧許可の有無にかかわらず、インデックスされず、したがって検索結果のリストにも返されません。

非公開ページのコンテンツは検索できません。

非公開ページやステージングされたページではコンテンツフィールドはインデックスされず検索もできませんが、他のフィールドは利用可能です。 例えば、公開されているコンテンツページと非公開のコンテンツページの両方のタイトルフィールドが7.2ではインデックスされているため、非公開のコンテンツページのタイトルに一致するキーワードを検索しても、「検索結果」ウィジェットにヒットします。

公開・非公開ページのタイトルを検索することができます。

note

Liferay 7.4 U22+とGA22+では、新規インストール時にプライベートページが無効になります。 ただし、必要に応じて有効にすることもできる。 詳しくは プライベートページの有効化 を参照してください。

コンテンツページのインデックスに登録されているフィールドを確認するには、[検索結果]ウィジェットの [ドキュメントフォームに結果を表示] の設定を有効にします。 詳しくは、 検索エンジンのドキュメントを検査する をご覧ください。

コンテンツページのドキュメントビューを検査して、どのフィールドがインデックスされているかを確認します。

Liferay 7.4 GA25+/U25+では、ウィジェットページを検索することもできます(タイトルのみ)。

検索結果でオブジェクトを返す

Liferay 7.4には、 Liferay Objectsが含まれており、GUI主導のアプリケーション構築フレームワークです。 各オブジェクトの定義のフィールドは検索可能と宣言できます。オブジェクトエントリ(アプリケーションのユーザが送信したレコード)は、 クエリを実行でき 、検索結果ウィジェットに返すことが可能です。

オブジェクトエントリには、タイトルとコンテンツの概要が表示されます。

Liferay 7.4 U64+/GA64+ では、検索結果のオブジェクトエントリーをクリックすると、そのエントリーの 表示ページ にリダイレクトされ、結果の詳細が表示されます。 オブジェクトの表示ページテンプレートが存在しない場合、デフォルトのレイアウトが使用されます。 エントリーの詳細表示で戻る矢印をクリックすると、検索ページに戻ります。

デフォルトの表示ページテンプレートがまだ存在しない場合は作成される。