1. Liferay Help Center
  2. ナレッジベース
  3. Liferay Enterprise Search

ドキュメンテーション

Liferay Enterprise Search Experiences 1.1.0 for DXP 7.3 リリースハイライトとアップグレードの手順

環境

  • Liferay DXP 7.3 アップデート 14
  • Liferayエンタープライズサーチエクスペリエンスv1.1.0

リリースハイライト

このアプリケーションリリースでは、 Liferay Enterprise Search Experiencesにおいて、以下の機能強化およびバグフィックスが提供されています。ブループリント 上の DXP 7.3 Update 14+:

エンハンスメント

LPS-150724 : 要素の編集 、カスタム JSON 要素の使用、および ブループリント設定 エディタでの JSON オートコンプリートを追加して、ブループリントの作成エクスペリエンスを向上させました。

LPS-150879 : ブループリントとエレメントに、以下の重要なサービスおよびデータベース層の変更を導入しています。

  1. SXPエンティティ（SXPBlueprintとSXPElement）には、2つの新しいフィールドが追加されました。「externalReferenceCode" (ERC)と "version "の2つのフィールドが追加された。
    • すぐに使える（システム）要素には、デフォルト（en_US）のタイトルから派生した、一意の決定論的ERCが入力されます（たとえば、BOOST_ALL_KEYWORDS_MATCHなど）。
    • カスタム要素には、ランダムに生成されるERCが付与されます。
    • ブループリント内の各要素のインスタンスには、そのERCが含まれます。
  2. フィールドは、新しいエントリーが作成されたときに自動的に設定されます。 バージョンは保存するたびにインクリメントされます。
  3. ElementsにERCが必要な理由とは？
    • ERCは、JSONがブループリントに埋め込まれている場合でも、システム全体で特定のシステム要素の発見と更新（例えば、バグ修正や機能追加）を可能にします。
  4. なぜBlueprintsにERCとバージョンが必要なのですか？
    • Element ERCとversionフィールドは、将来的にSXPでアップグレード可能なアウトオブボックスBlueprintsを出荷することを可能にするものです。 これらは、特定の一般的なユースケースを解決するブループリントや、特定の機能を構築するために必要なブループリントになります。

バグフィックス

  1. LPS-152791
  2. LPS-152073
  3. LPS-158782
  4. LPS-158873
  5. LPS-162591

ローカライズ

  1. LPS-162299

インストールとアップグレードの説明

このバージョンには、 DXP 7.3 Update 14 以降が必要です。

また、起動時やアプリ LPKG のデプロイ時に、アップグレード処理の実行を促すログメッセージがコンソールに表示されます。

2022-10-21 15:51:03.626 WARN  [main][MainServlet:451] Required upgrades in modules are pending. Run the upgrade process or type upgrade:checkAll in the Gogo shell to get more information.

モジュールのアップグレードを実行しない場合、製品メニューからブループリントまたはエレメンツのページを開くと、 エラー が発生する場合があります。

アップグレード処理を実行する便利な方法は、 Gogo Shell:で、次のコマンドを入力することです。

upgrade:execute com.liferay.search.experiences.service

アップグレード処理が正常に実行されると、次のようなログ出力が表示されます。 :

2022-10-21 15:56:05.588 INFO  [pipe-upgrade:execute com.liferay.search.experiences.service][UpgradeProcess:108] Upgrading com.liferay.search.experiences.internal.upgrade.v1_1_0.SXPElementUpgradeProcess
2022-10-21 15:56:06.008 INFO  [pipe-upgrade:execute com.liferay.search.experiences.service][UpgradeProcess:122] Completed upgrade process com.liferay.search.experiences.internal.upgrade.v1_1_0.SXPElementUpgradeProcess in 420 ms
2022-10-21 15:56:06.021 INFO  [pipe-upgrade:execute com.liferay.search.experiences.service][UpgradeProcess:108] Upgrading com.liferay.search.experiences.internal.upgrade.v1_1_0.SXPBlueprintUpgradeProcess
2022-10-21 15:56:06.354 INFO  [pipe-upgrade:execute com.liferay.search.experiences.service][UpgradeProcess:122] Completed upgrade process com.liferay.search.experiences.internal.upgrade.v1_1_0.SXPBlueprintUpgradeProcess in 333 ms
2022-10-21 15:56:06.366 INFO  [pipe-upgrade:execute com.liferay.search.experiences.service][UpgradeProcess:108] Upgrading com.liferay.search.experiences.internal.upgrade.SXPUpgradeStepRegistrator$1
2022-10-21 15:56:06.367 INFO  [pipe-upgrade:execute com.liferay.search.experiences.service][BaseExternalReferenceCodeUpgradeProcess:58] Upgrade table SXPBlueprint
2022-10-21 15:56:06.532 INFO  [pipe-upgrade:execute com.liferay.search.experiences.service][LoggingTimer:83] Starting com.liferay.portal.kernel.upgrade.BaseExternalReferenceCodeUpgradeProcess#upgradeExternalReferenceCode
2022-10-21 15:56:06.558 INFO  [pipe-upgrade:execute com.liferay.search.experiences.service][LoggingTimer:44] Completed com.liferay.portal.kernel.upgrade.BaseExternalReferenceCodeUpgradeProcess#upgradeExternalReferenceCode in 26 ms
2022-10-21 15:56:06.559 INFO  [pipe-upgrade:execute com.liferay.search.experiences.service][BaseExternalReferenceCodeUpgradeProcess:58] Upgrade table SXPElement
2022-10-21 15:56:06.772 INFO  [pipe-upgrade:execute com.liferay.search.experiences.service][LoggingTimer:83] Starting com.liferay.portal.kernel.upgrade.BaseExternalReferenceCodeUpgradeProcess#upgradeExternalReferenceCode
2022-10-21 15:56:07.034 INFO  [pipe-upgrade:execute com.liferay.search.experiences.service][LoggingTimer:44] Completed com.liferay.portal.kernel.upgrade.BaseExternalReferenceCodeUpgradeProcess#upgradeExternalReferenceCode in 262 ms
2022-10-21 15:56:07.035 INFO  [pipe-upgrade:execute com.liferay.search.experiences.service][UpgradeProcess:122] Completed upgrade process com.liferay.search.experiences.internal.upgrade.SXPUpgradeStepRegistrator$1 in 669 ms
2022-10-21 15:56:07.047 INFO  [pipe-upgrade:execute com.liferay.search.experiences.service][UpgradeProhttps://customer.liferay.com/downloads/-/download/liferay-dxp-7-3-update-13-download cess:108] Upgrading com.liferay.search.experiences.internal.upgrade.v2_0_0.SXPBlueprintUpgradeProcess
2022-10-21 15:56:07.054 INFO  [pipe-upgrade:execute com.liferay.search.experiences.service][LoggingTimer:83] Starting com.liferay.portal.kernel.upgrade.UpgradeProcess#alter
2022-10-21 15:56:07.262 INFO  [pipe-upgrade:execute com.liferay.search.experiences.service][LoggingTimer:44] Completed com.liferay.portal.kernel.upgrade.UpgradeProcess#alter in 208 ms
2022-10-21 15:56:07.559 INFO  [pipe-upgrade:execute com.liferay.search.experiences.service][LoggingTimer:83] Starting com.liferay.portal.kernel.upgrade.UpgradeProcess#alter
2022-10-21 15:56:07.717 INFO  [pipe-upgrade:execute com.liferay.search.experiences.service][LoggingTimer:44] Completed com.liferay.portal.kernel.upgrade.UpgradeProcess#alter in 158 ms
2022-10-21 15:56:07.821 INFO  [pipe-upgrade:execute com.liferay.search.experiences.service][UpgradeProcess:122] Completed upgrade process com.liferay.search.experiences.internal.upgrade.v2_0_0.SXPBlueprintUpgradeProcess in 775 ms
2022-10-21 15:56:07.838 INFO  [pipe-upgrade:execute com.liferay.search.experiences.service][LoggingTimer:83] Starting com.liferay.portal.upgrade.internal.index.updater.IndexUpdaterUtil#updateIndexes#Updating database indexes for com.liferay.search.experiences.service
2022-10-21 15:56:08.015 INFO  [pipe-upgrade:execute com.liferay.search.experiences.service][BaseDB:713] Dropping stale indexes
2022-10-21 15:56:08.022 INFO  [pipe-upgrade:execute com.liferay.search.experiences.service][BaseDB:783] drop index IX_F6C6095A on SXPBlueprint
2022-10-21 15:56:08.049 INFO  [pipe-upgrade:execute com.liferay.search.experiences.service][BaseDB:75] Adding indexes
2022-10-21 15:56:08.049 INFO  [pipe-upgrade:execute com.liferay.search.experiences.service][BaseDB:99] create unique index IX_7A27FEA3 on SXPBlueprint (companyId, externalReferenceCode);
2022-10-21 15:56:08.094 INFO  [pipe-upgrade:execute com.liferay.search.experiences.service][BaseDB:99] create unique index IX_D4D87BCC on SXPElement (companyId, externalReferenceCode);
2022-10-21 15:56:08.152 INFO  [pipe-upgrade:execute com.liferay.search.experiences.service][LoggingTimer:44] Completed com.liferay.portal.upgrade.internal.index.updater.IndexUpdaterUtil#updateIndexes#Updating database indexes for com.liferay.search.experiences.service in 314 ms

モジュールアップグレードの実行方法については、 https://learn.liferay.com/dxp/latest/en/installation-and-upgrades/upgrading-liferay/reference/database-upgrade-options.html を参照してください。

アップグレードが完了したら、グローバル製品メニューを開き、コントロールパネル - 検索 - インデックスアクション に移動して、SXPエンティティのインデックスを再作成してください。

com.liferay.search.experiences.model.SXPBlueprint
com.liferay.search.experiences.model.SXPElement

ダウンロード

クイックスタート

新しいSearch Experiencesのテスト環境を立ち上げるには、以下の方法があります。

  1. アプリケーションのバイナリや設定ファイルを提供するために、DXPコンテナのシステムフォルダにバインドマウント可能なローカルフォルダ構造を作成します。 
    • dxp
      ├── data
      ├── deploy
      ├── files/portal-ext.properties
      ├── Liferay Enterprise Search Experiences 1.1.0.lpkg
  2. DXPのDockerイメージを引っ張ってくる（7.3 U14+であることを確認する）。
    • docker pull liferay/dxp:7.3.10-u14
  3. DXPを実行し、Search Experiencesをマウントする。 
    • docker run -it --network="host" -p 8080:8080 \
      -v "$(pwd)/data:/opt/liferay/data" \
      -v "$(pwd)/files:/mnt/liferay/files" \
      -v "$(pwd)/deploy:/mnt/liferay/deploy" \
      -v "$(pwd)/Liferay Enterprise Search Experiences 1.1.0.lpkg:/opt/liferay/osgi/marketplace/Liferay Enterprise Search Experiences 1.1.0.lpkg" \
      liferay/dxp:7.3.10-u14

この記事は役に立ちましたか？
0人中0人がこの記事が役に立ったと言っています