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

コンテンツの検索

すべてのインデックス付きコンテンツ(別名 Liferay DXPの アセット)を検索結果として返すことができます。 カスタムコンテンツにもインデックスを付けることができます そのため、ご使用のシステムには、デフォルトで含まれているもの以外の追加のアセットタイプがある場合があります。 次の画像は、Liferay DXPでインデックスが作成されるさまざまなタイプのコンテンツの例を示しています。

これらのアプリがデプロイされている場合、そのコンテンツはデフォルトで検索可能です。

検索バーの使用

デフォルトのLiferay DXP設定を使用すると、ユーザーは検索バーに検索語を入力して検索を行うことができます。 検索を実行すると、検索ページに移動し、さまざまな検索ウィジェットをデプロイします。

デフォルトの検索設定では、デフォルトのビューに検索バーが表示され、ユーザーに検索コンテキストの入力を求めます。

検索用語を入力する

Liferayの検索インフラストラクチャは、サポートされている検索エンジン( Elasticsearch および Solr )によって実装されている全文検索に対応しています。

全文検索では、検索クエリに入力されたすべての単語(例えば、 stock market)と、インデックスされた各文書に含まれるすべての単語を比較します。 Elasticsearchのような検索エンジンは、関連性スコアを計算して、最適な結果が最初に返されるようにしています(最近の強気の市場についてのBlog Entryなど)。 stockmarket のような単語を含むものが返されます。

全文検索に加えて、高度な検索構文がサポートされています。 基盤となる検索エンジンが正確な動作を決定するため、詳細は Elasticsearch または Solr ドキュメントを参照してください。

Elasticsearchのクエリ文字列構文を使用して、特定のフィールドのテキストを検索します。

検索バーの提案ユーザーのタイプに合わせて検索

7.4 U36+およびGA36+

最新のLiferay 7.4では、ユーザーが検索フレーズを入力すると、すぐに検索バーが検索候補を表示します:

検索バーのサジェスチョンは、ユーザーが検索バーに検索フレーズを入力すると、予備結果を返します。

動作の詳細については、 検索バーのサジェストを参照のこと。

引用元検索

検索バーのクエリを引用符で囲むと、検索エンジンはより厳密にマッチを生成するようになる。 正確な動作は、検索されるフィールドのタイプによって異なる。

引用全文検索:一致順序の確保

検索バーのクエリを引用符で囲むと、検索された語句がまったく同じ順序で現れる場合のみ、フィールドにマッチします。 検索エンジンは正確に引用されたフレーズにはマッチしない。なぜなら、分析はインデックスされたコンテンツと検索フレーズに対して行われるからである。

content フィールドにこのテキストを含むブログ・エントリーを考えてみよう:

積極的なコラボレーションを確実にするために、ウィンウィンの生存戦略を持ち込む。

デフォルトの英語アナライザーでは、検索フレーズ “strategy that ensures” 、このブログエントリーが返される。 検索キーワードとインデックスされたテキストについて、ステミング、ストップワードの除去、その他のトークン化を考慮した上で、同じ分析が行われる。 フレーズを引用することで、フレーズ内の別々のトークンが、互いの相対位置も含めて、インデックスされた文書フィールドのトークンと一致することが強制される。

対照的に、検索キーワード “strategies ensure” を入力しても、上記のブログエントリーの文書は返されない。分析によって生成されたトークンの相対位置が、検索キーワードとインデックスされたコンテンツとで異なるからである。

検索語を引用符で囲むと、トークンの順序が返されるコンテンツと一致するようになります。

引用キーワード検索完全一致フレーズ検索

非分析フィールド(キーワード・フィールドなど)を検索する場合、引用符で囲まれた検索フレーズとフィールド値が正確に一致しなければならない。

通常のLiferay検索では、分析されたフィールドと分析されていないフィールドの両方がインデックスドキュメントに存在します。 非分析フィールドは、そのコンテンツが引用された検索フレーズと完全に一致する場合にのみ結果を生成し、分析フィールドは、そのトークンが引用された検索フレーズのトークンと一致し、それらが同じ相対位置に表示される限り、結果を生成する。

プレフィックス検索

プレフィックス検索では、 楽器 という用語を検索すると、完全な単語を含むドキュメントだけでなく、 楽器 をプレフィックスとするバリエーションも返します。 例えば、 楽器楽器の器楽編成 の結果も返されます。

"lever&quotを検索すると、また"leverage"と "leveraging"を返します。

note

プレフィックス検索は、多くのフィールドですぐに利用できますが、ボンネットの中はもっと複雑です。 フィールドで使用されている分析器や実行された変換など、フィールドマッピングの詳細が最終的な動作を決定します。

ユーザーに確実に結果を表示するもう1つの方法は、 検索候補を使用することです。

検索バーの構成

検索バーの動作は、ウィジェット設定画面で設定できます。 設定オプションは、ディスプレイ設定、サジェスチョン設定、または詳細設定に分類されます。

構成画面で検索バーの動作を構成します。

note

あるページの上部にグローバルに埋め込まれた検索バーウィジェットを設定すると、サイト内のすべてのページでページトップの検索バーウィジェットが設定されます。 また、目的地検索ページ検索バー・ウィジェットの設定が異なる場合は、それをオーバーライドします。 ただし、他のページに手動で設置した検索バーウィジェットを上書きすることはできません。

表示設定

表示テンプレート: 検索バーを表示する ウィジェットテンプレート を選択します。 すぐに使える代替テンプレートが1つあります:左寄せアイコンレイアウト。 検索バーの提案を使用する場合は、デフォルトの表示テンプレートを使用する必要があります。

キーワードパラメータ名: 検索で入力したキーワードのパラメータ名を編集します。 たとえば、キーワード データ 検索するときのデフォルトのURLは次のようになります。

http://localhost:8080/web/guest/search?q=data

キーワードパラメータ名を キーワード に変更すると、次のようになります。

http://localhost:8080/web/guest/search?keyword=data

スコープ: このサイト(デフォルト)、すべて、およびユーザーに選択させるの3つのオプションから選択します。 このサイト は、検索が実行されるサイトに関連付けられているアセットのみが検索されることを意味します。 すべて を選択して、検索範囲をすべてのサイトに展開します。 ユーザーが検索するスコープを選択できるようにするには、[ユーザーに選択させる]を選択します。

ユーザーに検索を実行する範囲を選択させます。

スコープパラメータ名: 検索が行われているスコープのURLパラメータ名を設定します。 このパラメーターは、スコープ ユーザーに を選択させるが選択されている場合にのみURLに表示されます。 デフォルト値は scope で、単語 data を検索すると、デフォルトURLは次のようになります。

http://localhost:8080/web/guest/search?q=data&scope=this-site

scopetarget に変更すると、次のようなURLになります。

http://localhost:8080/web/guest/search?q=data&target=this-site

対象ページ:検索ページにフレンドリURLを提供します。 構成されていない場合、または存在しないページを指している場合、ユーザーに表示するには検索バーを構成する必要があるというメッセージが管理者に表示されます。

検索提案の設定

検索バーの提案 が利用可能で有効な場合、検索バー・ウィジェット構成に追加構成が表示されます。 これらの設定オプションについて理解するには、 検索バーのサジェスチョンを設定する を参照してください。

詳細設定

詳細検索シンタックスを利用する: Elasticsearchを使用している場合、これを有効にすると、ユーザーは 検索文字列構文 を検索バーに入力できます。 Solrを使用している場合は、 適切な構文 に関するドキュメントを参照してください。

ステージサイトからの結果を表示: ステージング環境 からのコンテンツは この設定に関わらず、本番環境サイトでは 検索できない ようになりました。 この設定は、ローカルステージングを有効にしたサイトで「すべて」のスコープが構成されている場合に、他のローカルステージングサイトからのコンテンツの検索を可能にします。

Liferay Objectの検索

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

important

オブジェクトのスコープにより、検索方法が決定されます。

  • オブジェクトのスコープが Company の場合、検索バーがすべてを検索するように設定されているときのみ、オブジェクトのエントリが検索されます。
  • オブジェクトのスコープがSiteの場合、検索バーが このサイト内で検索するように設定されていれば、オブジェクトのエントリを検索することができます。

タイプファセットと検索結果ウィジェットは、以下の方法で Liferay Objectsの検索をサポートします。

  • タイプファセットには自動的に公開オブジェクトが含まれます。

    公開オブジェクトがタイプファセットウィジェットに追加されます。

  • 検索結果ウィジェットには、オブジェクトエントリのタイトルと概要が自動的に表示されます。

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

Liferay 7.4 U64+/GA64+ では、検索結果のオブジェクトエントリをクリックすると、そのエントリの 表示ページ があれば、そこにリダイレクトされます。

関連トピック