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

検索結果の並べ替え

検索結果 ウィジェットに表示される検索結果は、デフォルトでは 関連性スコア ( 検索エンジン によって計算される) の順に並びます。 Sortウィジェットを使用すると、ユーザーは返された結果の順序を制御することができます。

検索ページ にウィジェットを追加して、結果の並べ替えを開始します。

箱の外では、関連性の並べ替えの代わりに、これらの方法で結果を並べ替えることができます:

  • アルファベット順
  • 更新日順 (デフォルトでは新しいものから、または古いものから)
  • 作成日順 (デフォルトでは新しいものから、または古いものから選択)
  • 一致する各アセットを作成したユーザーによるアルファベット順

並べ替えウィジェットの設定済み並べ替えストラテジーの中から1つを選ぶか、独自の並べ替えストラテジーを設定します。

また、ウィジェットから不要な並べ替えオプションを削除することもできます。

ソートウィジェットをページに追加する

ソートウィジェットを使い始めるには

  1. ページの[追加]メニュー(Add)を開き、[ウィジェット]セクションを展開します。

  2. [検索]カテゴリから、並べ替えウィジェットをページにドラッグします。

ソートウィジェットの設定

note

Liferay 7.4 DXP Update 29+/CE GA 29+でソートウィジェットの設定画面が更新されました。 一定期間、_Switch to Classic View_というリンクをクリックすることで、古い設定画面を使用することができます。

古典的なソート設定と、より直感的な新しい設定画面を切り替えます。

古典的な設定ビューを使用するオプションは、将来の更新/GAで削除されます。

Sortウィジェットの設定画面では、以下のことができます。

  • デフォルトの関連性の並べ替えオプションを無効にします。
  • 既存の並べ替えオプションを編集する
  • オプションの削除
  • 新しいオプションを追加する

ユーザーは、並べ替えウィジェットで検索結果を並べ替えることができます。

note

関連性はオン・オフできるが、完全に取り除くことはできない。 関連性を有効にすると、デフォルトの検索エンジンの動作が使用されます:結果は関連性の降順でソートされます(スコアが高い順)。

ウィジェット構成画面にアクセスするには、ウィジェットの[オプション]メニュー(Options)を開き、[構成]をクリックします。

各ソートオプションには3つの設定があります: インデックス付きフィールド表示ラベル順序

インデックス付きフィールド: ソートするインデックス付きフィールドの fieldName を入力します。 ほとんどの場合、これは キーワード フィールドである。 その他の許容可能なオプションは、 date 、任意の numeric datatypeテキスト フィールドを強制的にソートウィジェットで動作させる方法もある(下記参照)。

表示ラベル: 設定されているソートタイプの表示ラベルを設定します。

順序: 昇順または降順で並べ替えます。 クラシックビューを使用している場合、または更新されたコンフィギュレーションUIを含まない以前のLiferayバージョンを使用している場合は、 クラシックコンフィギュレーションでソート順序を制御する を参照してください。

ソートウィジェットの設定から、ソートオプションを追加、編集、または削除します。

デフォルトのソート動作の変更

初期設定では、関連性オプションがソートウィジェットのリストで最初に表示され、ページに適用されるデフォルトの並べ替えになります。 そのため、検索を実行すると、結果は関連性の高い順に並べられます。 関連性による検索は、ほとんどのユーザーにとって期待されるデフォルトの動作ですが、ソートウィジェット設定の最初のオプションを変更することで、デフォルトの検索に異なるソート戦略を及ぼすことができます。

デフォルトのソートオプションを変更するには、次のようにします。

  1. ウィジェットオプションの Widget Options ボタンをクリックして、ソートウィジェットの設定画面を開きます。

  2. 関連性オプションの下にある追加Add ボタンをクリックします。

  3. 現在の関連性オプションの値を複製します。これにより、関連性がリストの2番目のオプションになります。

  4. ここで、トップオプションを変更します。 既存のオプションを選択した場合は、削除Minusをクリックして重複したオプションを削除してください。

  5. 設定を保存します。 検索を入力すると、新しいソートが適用されたことがわかります。

ソート可能なフィールドの検索

適切な権限を持つユーザーは、 コントロールパネル → [設定] → [検索機能] へ行き、ソートウィジェットで使用できるフィールドを見つけることができます。 そこから、[フィールドマッピング]タブを開き、各インデックスのマッピングを参照します。 マッピングの プロパティ セクションまでスクロールし、 キーワード フィールド、 日付 フィールド、または数値データ型を持つフィールドを見つける。 タイプ フィールドが参考になる:

"type" : "keyword"

"type" : "date"

"type" : "long"

どうしても テキスト フィールドでソートしなければならない場合は、 キーワードをタイプとして、新しいバージョンのフィールドをインデックスに追加する。 上記のフィールドマッピング画面で、 liferay-[companyID]というインデックスの firstName フィールドを確認します。

"firstName" : {
    "type" : "text",
    "store" : true
},
"firstName_sortable" : {
    "type" : "keyword",
    "store" : true
},

対応するフィールドには、 _sortableという接尾辞があり、ソートに適した型(keyword)があります。 ソート可能なフィールドは、 ポータルのプロパティ を通して得られたものです。

index.sortable.text.fields=firstName,jobTitle,lastName,name,screenName,title

ここに挙げたすべてのテキスト・フィールドには、 fieldName_sortable の対応するものがインデックスに自動的に作成されます。 さらに追加するには、このプロパティを Liferay Home フォルダの portal-ext.properties ファイルにコピーし、並べ替えに必要な新しいフィールド名を追加して、サーバを再起動してください。

新しいソートオプションの追加

新しいフィールドまたは適切なタイプの既存のフィールドでソートするには、 Add Option ボタンをクリックします。

tip

ウィジェットの設定で、テキストフィールドのfieldName_sortableバージョンを使用していることを確認してください。

すでに適切なデータ型になっている新しいソート・オプションを追加するには、任意のオプションの Field 設定の下にあるプラス記号を使い、フィールドに記入する。 ここでの設定画面でのオプションの順序は、検索用ウィジェットを設定するときのセレクトリストでの順序と一致する。

ソート・オプションの編集と削除

既存のオプションを編集するには、その設定セクションのテキストを編集する。

既存のオプションを削除するには、ゴミ箱アイコンを使用します。

クラシック構成でソート順を制御する

クラシック構成でソート・オプションの順序を制御するには、 fieldNameの後にプラスまたはマイナスの記号を追加する。 CreatedCreated (oldest first) というラベルの付いた既存のソート・オプションがどのように機能するかを理解するために、その方法を見てみよう:

**ラベル:作成日_ フィールド: create-dateとなります。

フィールド名に続く - の記号は、 降順であることを示す 。 この方法で並べ替えると、最近作成された検索結果がリストの一番上に来る。

**ラベル:**作成日(古い順フィールド。 createDate⁺となります。

フィールド名に続く + の記号は、 昇順であることを示す 。 この方法で並べ替えると、最も古い(作成日の)結果がリストの一番上に来る。

ネストしたフィールドでのソート

オブジェクト定義フィールドによる並べ替え

7.4 u72+/ga72+

オブジェクト定義 フィールドは、Elasticsearch ではネストされたフィールドとしてインデックスされます。 インデックス内の既存のドキュメントでオブジェクト・フィールドを検索するには、検索結果ウィジェットの Display Results in Document Form 設定を使用します。

"nestedFieldArray" : [
   {
     "fieldName" : "lastAcessed",
     "valueFieldName" : "value_date",
     "value_date" : "20230502000000"
   },
   {
     "fieldName" : "immunityType",
     "valueFieldName" : "value_keyword",
     "value_keyword" : "diplomatic"
   },
   {
     "fieldName" : "luckyNumber",
     "valueFieldName" : "value_integer",
     "value_integer" : "19"
   }
],

オブジェクトのフィールドでソートするには、 nestedFieldArrayのパターンに従った特別な表記が必要です。[fieldName][valueFieldName]. たとえば、上記の入れ子配列の lastAccessed 日付フィールドでソートするには、Sortウィジェット構成のIndexed Fieldに nestedFieldArray.lastAccessed.value_date と入力します。

Webコンテンツ構造フィールドによる並べ替え

7.2 FP12+、7.3 FP2+、7.4 (すべての更新)

ソートウィジェットは、キーワード、日付、数値の各フィールドに対応しています。 インデックス内の既存のドキュメントでウェブコンテンツ構造(DDM)フィールドを検索するには、検索結果ウィジェットの Display Results in Document Form 設定を使用します。

ドキュメントは、 ddmFieldArray オブジェクトを持ち、ネストされたコンテンツを持つ:

 "ddmFieldArray" : [
    {
      "ddmFieldName" : "ddm__keyword__40806__Textb5mx_en_US",
      "ddmValueFieldName" : "ddmFieldValueKeyword_en_US",
      "ddmFieldValueKeyword_en_US_String_sortable" : "some text has been entered",
      "ddmFieldValueKeyword_en_US" : "some text has been entered"
    },
    {
      "ddmFieldName" : "ddm__keyword__40806__Selectjdw0_en_US",
      "ddmValueFieldName" : "ddmFieldValueKeyword_en_US",
      "ddmFieldValueKeyword_en_US_String_sortable" : "option 3",
      "ddmFieldValueKeyword_en_US" : "value 3"
    },
    {
      "ddmFieldName" : "ddm__keyword__40806__Boolean15cg_en_US",
      "ddmValueFieldName" : "ddmFieldValueKeyword_en_US",
      "ddmFieldValueKeyword_en_US" : "true",
      "ddmFieldValueKeyword_en_US_String_sortable" : "true"
    }
  ],

これらのフィールドの1つをソート構成で使用するには、 ddmFieldName の値(例えば、 ddm__keyword__40806__Testb5mx_ja_US)をインデックス付きフィールド設定として入力する。

お使いのバージョンによっては、 nested field storage がElasticsearchのデフォルトで有効になっている場合があります:

Liferayのバージョンネストされたフィールドはデフォルトで有効
7.4 すべてのアップデート
7.3 すべてのアップデート
DXP 7.2 SP3/FP8+

動作を変更するには、[システム設定] → [Dynamic Data Mapping Indexer]の Enable Legacy Dynamic Data Mapping Index Fields の設定を使用します。