7.3の検索の新機能

テンプレート処理中にエラーが発生しました。

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		}

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/>

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>

57					<span class="learn-article-nav-text">${navigationMenuItems[productJSONObject.getString("title")].title}</span>

58				</div>

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>

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>

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>

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>

120				<span>${parentJSONObject.getString("title")}</span>

121			</div>

122		</#if>

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>

フィードバックを送信

#7.3の検索の新機能

Elasticsearchの統合

Elasticsearch 7のサポート

利用可能:Liferay CE 7.3 GA4以降、Liferay DXP 7.3 GA1以降

Liferay DXP 7.3では、Elasticsearch 7を標準でサポートしています。最小限必要なバージョンは7.9です。詳細なサポート情報については、検索エンジンの互換性マトリックスを参照してください。

important

Liferay CE/DXP 7.3ではElasticsearch 6.xはサポートされていません。

Elasticsearch 7コネクタはRESTクライアントに基づいています

利用可能:Liferay CE 7.3 GA4以降、Liferay DXP 7.3 GA1以降

DXP 7.3にバンドルされているElasticsearch 7コネクタは、 ElasticのJava RESTクライアントを使用して、HTTPを介してElasticsearchと通信します。この通信プロトコルは、DXPとElasticsearch間のJavaシリアル化を必要としないため、Elasticsearch 7ノードをLiferay DXPとは異なるJVMで実行できるようになりました。

X-Pack Security機能が統合されました

利用可能:Liferay 7.3 CE GA4以降、Liferay DXP 7.3 GA1以降

Liferay Enterprise Search Security(以前の Liferay Connector to X-Pack Security）モジュールの機能は、 Liferay Connector to Elasticsearch 7 に含まれています。 CE/DXP 7.3のすべてのお客様は、 Liferay Enterprise Search (LES) サブスクリプションなしでElasticsearchクラスターに安全に接続できます。

アップグレードガイドには、暗号化設定をElasticsearch 7コネクタに移動するための情報が含まれています。

複数のElasticsearch接続

利用可能:Liferay CE 7.3 GA4以降、Liferay DXP 7.3 GA1以降

複数のElasticsearchクラスターへの接続を設定します。 Liferay DXP 7.2では、Liferayが接続されているElasticsearchクラスター内の任意のインデックス(Liferay以外のインデックスも含む）に対してクエリを実行できました。 Lifera以外のElasticsearchクラスターのインデックスに対してクエリを実行できるようになりました。これにより、低レベル検索オプションおよび検索結果ウィジェットと組み合わせて使用することで、Elasticsearchクラスターを使用しているサードパーティシステムからの結果を表示することができます。この機能は、主にLiferay Enterprise Search(LES）のクラスター横断レプリケーション機能をサポートするために追加されました。

組み込みモードがサイドカーに置き換えられました

利用可能:Liferay CE 7.3 GA4以降、Liferay DXP 7.3 GA1以降

「開発」の「サイドカー」セクションを参照してください。

検索インフラストラクチャ & 管理

マルチテナントインデックス名

利用可能：Liferay 7.3 CE GA6以降、Liferay DXP 7.3 GA1以降、Liferay DXP 7.2 SP3以降/FP8以降

マルチテナントインストールでは、単一のElasticsearchクラスターが複数のLiferay CE/DXPデプロイメントのインデックスを保持します。ネームスペースが適切なインデックスの必要性が最も重要です。 7.2(FP8/SP3より前）では、インデックスの命名に一貫性がなく、マルチテナントのインストールが不可能になることがありました。最新の7.2パッチおよび7.3では、すべてのLiferay CE/DXPインデックス(特定のアプリケーションによって制御されるインデックスを含む）のプレフィックスは、システム設定のElasticsearch 7設定エントリーから構成されています。サードパーティーアプリケーションのインデックスは、同じAPIを利用して、インストール全体でネームスペースが一貫したインデックスを確保できるようになりました。

[indexNamePrefix]-[companyId]-[appName]

例:

liferay-20096-search-tuning-rankings

DXP 7.2 SP2以前から7.3にアップグレードすると、新しいDXPインデックスが自動的に作成されます。完全なインデックスの再構築と正常なアップグレードの確認後、古いインデックスを削除できます。

検索管理の接続

利用可能:Liferay CE 7.3 GA1以降、Liferay DXP 7.3 GA1以降

コントロールパネルの検索エントリ(［Configurations］セクションにあります）を使用して、Elasticsearch接続のステータスと正常性を表示します。以下を参照してください。

接続されている各Elasticsearchクラスターの状態
各クラスター内のノード名とバージョン
Elasticsearchクライアントのバージョン

これは、以前のバージョンの［アクションをインデックスする］ページの上部にある情報バーに置き換わるものです。

標準化されたインデックスドキュメントID

利用可能:Liferay CE 7.3 GA1以降、Liferay DXP 7.3 GA1以降

インデックスドキュメントのUID(または id）は、Liferay DXPエンティティのデータベース行と1対1のパリティを持つようになりました。

検索ウィジェット

ウィジェットテンプレートを使用して検索ウィジェットをカスタマイズする

利用可能:Liferay CE 7.3 GA4以降、Liferay DXP 7.3 GA1以降

検索ウィジェットは、FreemarkerまたはVelocityテンプレートを使用して各ウィジェットの視覚的なルックアンドフィールをカスタマイズするために、ウィジェットテンプレート(以前はアプリケーションディスプレイテンプレート）をサポートするようになりました。たとえば、検索結果ウィジェットはカードレイアウトを表示するように設定でき、authorやmodified dateのようなアセットのプロパティを表示または非表示にすることができます。サポートされている検索ウィジェットごとに、すぐに使えるデフォルトテンプレートがいくつか用意されています。

類似結果

サブスクライバー

利用可能：Liferay DXP 7.3 GA1以降にバンドルされており、類似結果マーケットプレイスアプリを介してLiferay DXP 7.2 SP2以降にインストール可能

類似結果ウィジェットには、ページのメインアセットに類似したアセットのコレクションが表示されます。このウィジェットは、URLを使用してメインのアセット表示を決定し、Elasticsearchの more like this query を利用して追加のアセットを検索します。メインアセットは、表示ウィジェット(ブログウィジェットなど）またはアセットパブリッシャーを使用して表示できます。

類似結果の最初のバージョンは、ブログ、掲示板、ドキュメント、およびWikiをサポートしています。拡張ポイントを実装することにより、追加のアセットタイプ(ネイティブアセットとカスタムアセットの両方）のサポートが可能になります。ドキュメント類似性を判断するために使用されるロジックは、ElasticsearchのMore Like This クエリパラメーターごとに設定できます。

詳細は、類似結果を参照してください。

検索の調整

サブスクライバー

検索の調整：結果ランキング

利用可能:Liferay DXP 7.2 SP1以降、Liferay DXP 7.3 GA1以降

結果ランキングは、特定のクエリの結果の関連性をカスタム調整するためのグラフィカルUIです。結果ランキングには、関連性を手動で調整するための3つの主要な機能があります。

クエリの結果は、リストの一番上に固定して並べ替えることができます。目的のドキュメントが元の結果リストにない場合は、手動で追加できます。これにより、ユーザーは価値の高い結果をプロモートできます。
結果は結果リストから非表示にすることができます。この機能を使用して、古くなった結果や無関係な結果を削除できます。
エイリアスは、同じカスタムの固定された結果および非表示の結果を代替検索クエリに適用します。たとえば、クエリ「デジタルエクスペリエンスプラットフォーム」の結果を固定および非表示にして結果ランキングを作成する場合、エイリアス「portal」および「dxp」を追加すると、同じ固定された結果と非表示の結果が適用されます。

検索の調整：同義語

利用可能:Liferay DXP 7.2 SP1以降、Liferay DXP 7.3 GA1以降

同義語は、同様の意味を持つクエリを関連付け、検索時に同義クエリに同等の重みを与えます。たとえば、「mobile phone」、「cell phone」、「hand phone」というクエリは同等の意味を持ち、同義で使用できます。これらの3つのクエリで同義語セットを定義すると、「mobile phone」と検索したユーザーには、「cell phone」または「hand phone」という単語を含むドキュメントが表示されます。 Synonyms documentation from Elastic を参照してください。

Liferay Enterprise Search(LES）

**LESサブスクライバー

クラスター横断レプリケーション(LES）

利用可能：Liferay DXP 7.2 SP3以降、Liferay DXP 7.3 GA1以降で、Liferay Enterprise Searchクラスター横断レプリケーションアプリケーションを使用。

クラスター横断レプリケーションアプリケーションは、ディザスタリカバリ(高可用性）と地理的近接パフォーマンスの最適化のために、リモートデータセンター全体でElasticsearchクラスターを複製します。 Elasticsearchのクラスター横断レプリケーション機能を活用し、アクティブパッシブモデルを使用して分散したクラスター間で検索インデックスを複製します。すべてのDXPノードのすべての書き込み操作は単一のリーダーインデックスにルーティングされますが、各DXPクラスターノードは任意のフォロワーインデックスから読み取るように設定できます。

Learning to Rank(LES）

利用可能：Liferay DXP 7.2 SP2以降、Liferay DXP 7.3 GA1以降で、 Liferay Enterprise Search Learning to Rank アプリケーションを使用。

最適な結果を得るために検索を手動で調整することは困難です。ある特定のクエリに対して検索アルゴリズムを最適化すると、他の数百のクエリの結果が意図せず悪くなる可能性があります。

Learning to Rank(LTR）は、機械学習(ML）モデルを適用して検索結果を改善することにより、この課題に取り組んでいます。モデルのトレーニングでは以下を行います。

「機能」の選択(モデルのトレーニング時に考慮する検索要素の用語—たとえば、最新性、地理的近接性、タグの一致）
手動(クエリの結果を評価する検索エキスパートなど）または半自動(クエリのユーザークリック率の測定など）で管理される判断リスト(「グラウンドトゥルース」とも呼ばれます）の提供。

判断リストは、モデルのトレーニングに情報を提供し、導くための信頼できる情報源です。ユーザーが検索クエリを送信すると、LTRは検索エンジンから返された最初の × 件の結果(デフォルトでは最初の1,000件の結果）を受け取り、学習したモデルを使ってそれらの結果を再スコアリングして並べ替えた後、リストをユーザーに返します。

LESアプリケーションの名前が変更されました

Liferay CE/DXP 7.3リリースには明示的にリンクされていませんが、次のアプリは、機能をより適切に反映し、LESアプリとしてのアイデンティティを強調するために名前が変更されました。

機能	旧アプリ名	新アプリ名
Elasticsearchクラスターのモニタリング	Liferay Connector to X-Pack Monitoring [Elastic Stack 6.x] (英語)	Liferay Enterprise Search Monitoring
Elasticsearchクラスターの保護	Liferay Connector to X-Pack Security [Elastic Stack 6.x]を使用しています。	Liferay Enterprise Search Security
機械学習を使用した検索アルゴリズムの最適化	Liferay Connector to Elasticsearch Learning to Rank	Liferay Enterprise Search Learning to Rank
リモートデータセンター間でのインデックスの複製	NA(新アプリ）	Liferay Enterprise Searchクラスター横断レプリケーション

開発

新しいインデックス設定コントリビューター拡張ポイント

利用可能:Liferay CE 7.3 GA6以降、Liferay DXP 7.3 GA1以降

Elasticsearchのバージョンに依存しないIndexSettingsContributorが追加されました( srcコードはこちら）：

com.liferay.portal.search.spi.settings.IndexSettingsContributor
com.liferay.portal.search.spi.settings.IndexSettingsHelper.java
com.liferay.portal.search.spi.settings.TypeMappingsHelper.java

Sidecar Elasticsearch 7がバンドルされています

利用可能:Liferay CE 7.3 GA4以降、Liferay DXP 7.3 GA1以降

互換性のあるバージョンのElasticsearchがLiferay CE/DXP 7.3+ Tomcatバンドルにバンドルされ、 sidecar JVMで同時に起動されます。このサイドカーのインストールは、 開発モード と呼ばれ、以前の 組み込み モードに置き換わるものです(どちらも本番環境のインストールではサポートされていません）。サイドカーのシステム設定には、Elasticsearch 7設定に専用のプロパティがあります。デフォルトでは、HTTPポート9201で実行されます。詳細は、サイドカーまたはEmbedded モードのElasticsearchの使用を参照してください。

初回起動時にサイドカーElasticsearchサーバーが自動ダウンロードされます。デプロイでサイドカーサーバーをダウンロードできない場合は、 Elasticsearchをリモートサーバーとしてインストールします。

DXP 7.3へのアップグレード

以前のDXPバージョンから7.3にアップグレードするには、 RESTクライアントに切り替えるため、いくつかの特別な手順が必要です。アップグレードに役立つ重要な情報については、アップグレードのドキュメンテーションを参照してください。

Cloud

Commerce

Content Management System

Development and Tooling

Digital Asset Management

DXP Self-Hosted Installation, Maintenance, and Administration

Integration

Personalization

Platform

Search

Security

Sites

Analytics Cloud

Commerce

DXP

Liferay Cloud

Reference