AEM 6.5 における Sites リポジトリの再構築

As described on the parent Repository Restructuring in AEM 6.5 page, customers upgrading to AEM 6.5 should use this page to assess the work effort associated with repository changes impacting the AEM Sites Solution. Some changes require work effort during the AEM 6.5 upgrade process, while others can be deferred until a future upgrade.

6.5 へのアップグレード時におこなう変更

今後のアップグレードの前

6.5 へのアップグレード時におこなう変更

ContextHub セグメント

以前の場所 /etc/segmentation/contexthub
新しい場所

/apps/settings/wcm/segments

/conf/settings/settings/wcm/segments

/conf/<tenant>/settings/wcm/segments

再構築の手引き

新規または変更された ContextHub セグメントが AEM で編集されるのではなく、ソース管理で編集されることを意図している場合は、それらを新しい場所に移行する必要があります。

  1. Copy any new or modified ContextHub Segments from the previous location to the appropriate new location (/%3Ccode%3Eapps%3C/code%3E,%20%3Ccode%3E/conf/global%3C/code%3E%20or%20%3Ccode%3E/conf/<tenant>%3C/code%3E?lang=ja)
  2. 以前の場所のContextHubセグメントへの参照を、新しい場所(/apps/conf/global/conf/<tenant>)に移行したContextHubセグメントに更新します。

次の QueryBuilder クエリは、以前の場所内の ContextHub セグメントへのすべての参照を探します。

path=/content property=cq:segments property.operation=like property.value=/etc/segmentation/contexthub/%

これは、 AEM QueryBuilderデバッガーのUIを介して実行できます。これはトラバースクエリなので、本番環境に対して実行しないでください。必要に応じてトラバーサルの制限を調整してください。

備考

以前の場所に保存されている ContextHub セグメントは、AEM/パーソナライゼーション/オーディエンスに読み取り専用として表示されます。

AEMで編集可能なContextHubセグメントは、新しい場所(/conf/globalまたは/conf/<tenant>)に移行する必要があります。 AEMで作成された新しいContentHubセグメントは、新しい場所(/conf/globalまたは/conf/<tenant>)に保持されます。

AEM Sites Page Properties only allow either the Previous Location (/etc) or a single new location (/apps, /conf/global or /conf/<tenant>) to be selected, thus ContextHub Segments must be migrated accordingly.

AEM 参照サイトからの未使用の ContextHub セグメントは削除でき、新しい場所に移行されません。

  • /etc/segmentation/geometrixx/
  • /etc/segmentation/geometrixx-outdoors

注:ClientContext が使用中の場合は、ContextHub に変換することをお勧めします。

将来のアップグレードの前

Adobe Analytics クライアントライブラリ

以前の場所

/etc/clientlibs/foundation/sitecatalyst

新しい場所 /libs/cq/analytics/clientlibs/analytics
再構築の手引き

これらのクライアントライブラリをカスタムで使用する場合は、パスではなくカテゴリでクライアントライブラリを参照する必要があります。

  1. 以前の場所のパスによるクライアントライブラリへの参照はすべて AEM のクライアントライブラリ参照フレームワークを使用するように更新する必要があります。
  2. AEM のクライアントライブラリ参照フレームワークを使用できない場合、クライアントライブラリの絶対パスは AEM のクライアントライブラリプロキシサーブレットを介して参照できます。
    • /etc.clientlibs/cq/analytics/clientlibs/sitecatalyst/appmeasurement.js
    • /etc.clientlibs/cq/analytics/clientlibs/sitecatalyst/plugins.js
    • /etc.clientlibs/cq/analytics/clientlibs/sitecatalyst/sitecatalyst.js
    • /etc.clientlibs/cq/analytics/clientlibs/sitecatalyst/tracking.js
    • /etc.clientlibs/cq/analytics/clientlibs/sitecatalyst/util.js
備考

これらのクライアントライブラリの編集はサポートされていませんでした。

クライアントライブラリのカテゴリを入手するには、CRXDELite で各 cq:ClientLIbraryFolder ノードを検索し、カテゴリプロパティを調べます.

  • /libs/cq/analytics/clientlibs/sitecatalyst/appmeasurement
  • /libs/cq/analytics/clientlibs/sitecatalyst/plugins
  • /libs/cq/analytics/clientlibs/sitecatalyst/sitecatalyst
  • /libs/cq/analytics/clientlibs/sitecatalyst/tracking
  • /libs/cq/analytics/clientlibs/sitecatalyst/util

クラシックな Microsoft Word から Web ページへのデザイン

以前の場所 /etc/designs/wordDesign
新しい場所

/libs/settings/wcm/designs/wordDesign

/apps/settings/wcm/designs/wordDesign

再構築の手引き

SCM で管理されており、実行時にデザインダイアログから書き込まれていないデザインの場合:

  1. Copy the designs from the Previous Location to the New Location (/apps).
  2. を使用して、デザイン内の CSS、JavaScript、静的リソースをクライアントライブラリallowProxy = trueに変換します。
  3. cq:designPath プロパティの以前の場所への参照を更新します。
  4. 以前の場所を参照しているページを更新して、新規のクライアントライブラリカテゴリを使用します(これにはページ実装コードの更新が必要です)。
  5. Update AEM Dispatcher rules to allow serving of Client Libraries via the /etc.clientlibs/ proxy servlet.

SCM で管理されておらず、実行時にデザインダイアログで変更されたデザインの場合:

  • /etcの外にオーサリング可能なデザインを移動しないでください。
備考 該当なし

モバイルデバイスエミュレーター設定

以前の場所

/etc/mobile

新しい場所

/libs/settings/mobile

/apps/settings/mobile

/conf/global/settings/mobile

/conf/<tenant>/settings/mobile

再構築の手引き 新しいモバイルデバイスエミュレーター設定は、新しい場所に移行する必要があります。
  1. 新しいモバイルデバイスエミュレーター設定を前の場所から新しい場所(/apps/conf/global/conf/<tenant>)にコピーします。
  2. これらのモバイルデバイスエミュレータの設定に依存するAEM Sitesページの場合は、ページの jcr :content ノード:
    [cq:Page]/jcr:content@cq: deviceGroups = String[ mobile/groups/responsive ]
  3. これらのモバイルデバイスエミュレータの設定に依存する編集可能なテンプレートに対して、 cq : deviceGroups を「新しい場所」に移動します。
備考

モバイルデバイスエミュレータ設定の解決は、次の順序でおこなわれます。

  1. /conf/<tenant>/settings/mobile
  2. /conf/global/settings/mobile
  3. /apps/settings/mobile
  4. /libs/settings/mobile
  5. /etc/mobile

Multi-site Manager のブループリント設定

以前の場所 /etc/blueprints
新しい場所

/apps/msm (Customer Blueprint configurations)

/libs/msm (Out Of the Box Blueprint configurations for Screens, Commerce)

再構築の手引き

新しい、または変更されたマルチサイトマネージャーのBlueprint設定は、新しい場所(/apps)に移行する必要があります。

  1. 新しいまたは変更したマルチサイトマネージャーのBlueprint設定を、前の場所から新しい場所(/apps)にコピーします。
  2. 移行した Multi-site Manager のブループリント設定を以前の場所から削除します。
備考

Multi-site Manager Blueprint Configurationsを提供するすべてのAEMは、/libsの「新しい場所」に存在します。

コンテンツは Multi-site Manager のブループリント設定を参照していないため、調整するコンテンツ参照はありません。

Multi-site Manager のロールアウト設定

以前の場所

/etc/msm/rolloutConfigs

新しい場所

/libs/msm/wcm/rolloutconfigs

/apps/msm/wcm/rolloutconfigs

再構築の手引き

新規または変更された Multi-Site Manager のロールアウト設定は、新しい場所に移行する必要があります。

  1. Copy any new or modified Multi-site Manager Rollout Configurations from the Previous Location to the new location (/apps).
  2. [AEMページ]の[Multi-site Managerへのロールアウト設定]の参照を更新し、[新しい場所]の対応する場所(/libsまたは/apps)を指定します。

移行した Multi-site Manager のロールアウト設定を以前の場所から削除します。

備考 移行した Multi-site Manager のロールアウト設定を以前の場所から削除しないと、ロールアウトオプションが AEM 作成者に重複して表示されます。

ページイベント通知電子メールテンプレート

以前の場所

/etc/notification/email/default/com.day.cq.wcm.core.page

新しい場所

/libs/settings/notification-templates/com.day.cq.wcm.core.page

/apps/settings/notification-templates/com.day.cq.wcm.core.page

再構築の手引き

サポートされている唯一の新規ページイベント通知電子メールテンプレートは、新しいロケールをサポートするものです。

ページイベント電子メールテンプレートの解決は、次の順序でおこなわれます。

  1. /etc/notification/email/default/com.day.cq.wcm.core.page
  2. /apps/settings/notification-templates/com.day.cq.wcm.core.page
  3. /libs/settings/notification-templates/com.day.cq.wcm.core.page
備考

Any new or modified Page Event Notification E-mail Templates must be migrated to the new location under /apps:

  1. Copy any new or modified Page Event Notification E-mail Templates from the Previous Location to the new location (/apps).
  2. 移行したページイベント通知電子メールテンプレートを以前の場所からすべて削除します。

ページ基礎モード

以前の場所 /etc/scaffolding
新しい場所

/libs/settings/ wcm /template-types/skaffold/scaffoldhoold

/apps/settings/ wcm /template-types/skaffold/scaffoldhoold

再構築の手引き 以前の場所の下に作成された基礎モードは、従来の基礎モードフレームワークを使用するため、新しい場所に移行できません。新しい場所に合わせるには、サポートされている基礎モードフレームワークを使用して、従来の基礎モードを再開発する必要があります。
備考 該当なし

レスポンシブグリッド LESS

以前の場所 /etc/clientlibs/wcm/foundation/grid/grid_base.less
新しい場所 /libs/wcm/foundation/clientlibs/grid/grid_base.less
再構築の手引き

カスタム LESS ファイル内の以前の場所への参照はすべて、新しい場所からインポートするように更新する必要があります。

  • 以前の場所で grid_base.less を参照している参照カスタム LESS ファイルを、新しい場所を参照するように更新します。
備考 存在しない grid_base.less ファイルを参照すると、ページのレイアウトモードとテンプレートエディターが機能せず、ページレイアウトが中断されます。

静的テンプレートデザイン

以前の場所 /etc/designs/<custom-site>
新しい場所 /apps/settings/wcm/designs/<custom-site>
再構築の手引き

SCM で管理されており、実行時にデザインダイアログから書き込まれていないデザインの場合:

  1. Copy the designs from the Previous Location to the New Location (/apps).
  2. を使用して、デザイン内の CSS、JavaScript、静的リソースをクライアントライブラリallowProxy = trueに変換します。
  3. cq:designPathAEM/Sites/カスタムサイトページ/ページのプロパティ/詳細タブ/デザインフィールド プロパティの以前の場所への参照を更新します。
  4. 以前の場所を参照しているページを更新して、新規のクライアントライブラリカテゴリを使用します(これにはページ実装コードの更新が必要です)。
  5. AEMディスパッチャールールを更新し、/etc.clientlibs/プロキシサーブレットを介したクライアントライブラリの提供を許可します。

SCM で管理されておらず、実行時にデザインダイアログで変更されたデザインの場合:

  • Do not move author-able Designs out of /etc.
備考 推奨されるアプローチは、デザインの代わりに構造コンテンツとポリシーを使用する編集可能なテンプレートを使用して AEM Sites とページを構築することです。

Adobe Search and Promote 統合クライアントライブラリ

以前の場所

/etc/clientlibs/foundation/searchpromote

新しい場所 /libs/cq/searchpromote/clientlibs/searchpromote
再構築の手引き

これらのクライアントライブラリをカスタムで使用する場合は、パスではなくカテゴリでクライアントライブラリを参照する必要があります。

  1. 以前の場所のパスによるクライアントライブラリへの参照はすべて AEM のクライアントライブラリ参照フレームワークを使用するように更新する必要があります。
  2. AEM のクライアントライブラリ参照フレームワークを使用できない場合、クライアントライブラリの絶対パスは AEM のクライアントライブラリプロキシサーブレットを介して参照できます:
  • /etc.clientlibs/cq/searchpromote/clientlibs/searchpromotei.js
備考

これらのクライアントライブラリの編集はサポートされていませんでした。

クライアントライブラリのカテゴリを入手するには、CRXDELite で各 cq:ClientLIbraryFolder ノードを検索し、カテゴリプロパティを調べます:

  • /libs/cq/searchpromote/clientlibs/searchpromote

Adobe Target 統合クライアントライブラリ

以前の場所

/etc/clientlibs/foundation/target

新しい場所 /libs/cq/testandtarget/clientlibs/testandtarget
再構築の手引き

これらのクライアントライブラリをカスタムで使用する場合は、パスではなくカテゴリでクライアントライブラリを参照する必要があります。

  1. 以前の場所のパスによるクライアントライブラリへの参照はすべて AEM のクライアントライブラリ参照フレームワークを使用するように更新する必要があります。
  2. AEM のクライアントライブラリ参照フレームワークを使用できない場合、クライアントライブラリの絶対パスは AEM のクライアントライブラリプロキシサーブレットを介して参照できます:
  • /etc.clientlibs/cq/testandtarget/clientlibs/testandtarget/testandtarget.js
  • /etc.clientlibs/cq/testandtarget/clientlibs/testandtarget/atjs.js
  • /etc.clientlibs/cq/testandtarget/clientlibs/testandtarget/atjs-integration.js
  • /etc.clientlibs/cq/testandtarget/clientlibs/testandtarget/init.js
  • /etc.clientlibs/cq/testandtarget/clientlibs/testandtarget/mbox.js
  • /etc.clientlibs/cq/testandtarget/clientlibs/testandtarget/parameters.js
  • /etc.clientlibs/cq/testandtarget/clientlibs/testandtarget/util.js
備考

これらのクライアントライブラリの編集はサポートされていませんでした。

クライアントライブラリのカテゴリを入手するには、CRXDELite で各 cq:ClientLIbraryFolder ノードを検索し、カテゴリプロパティを調べます:

  • /libs/cq/testandtarget/clientlibs/testandtarget/testandtarget
  • /libs/cq/testandtarget/clientlibs/testandtarget/atjs
  • /libs/cq/testandtarget/clientlibs/testandtarget/atjs-integration
  • /libs/cq/testandtarget/clientlibs/testandtarget/init
  • /libs/cq/testandtarget/clientlibs/testandtarget/mbox
  • /libs/cq/testandtarget/clientlibs/testandtarget/parameters
  • /libs/cq/testandtarget/clientlibs/testandtarget/util

WCM Foundation クライアントライブラリ

以前の場所

/etc/clientlibs/wcm/foundation

新しい場所 /libs/wcm/foundation/clientlibs
再構築の手引き

これらのクライアントライブラリをカスタムで使用する場合は、パスではなくカテゴリでクライアントライブラリを参照する必要があります。

  1. 以前の場所のパスによるクライアントライブラリへの参照はすべて AEM のクライアントライブラリ参照フレームワークを使用するように更新する必要があります。
  2. AEM のクライアントライブラリ参照フレームワークを使用できない場合、クライアントライブラリの絶対パスは AEM のクライアントライブラリプロキシサーブレットを介して参照できます。
  • /etc.clientlibs/wcm/foundation/clientlibs/accessibility.css
  • /etc.clientlibs/wcm/foundation/clientlibs/main.css
  • /etc.clientlibs/wcm/foundation/clientlibs/main.js
備考

これらのクライアントライブラリの編集はサポートされていませんでした。

クライアントライブラリのカテゴリを入手するには、CRXDELite で各 cq:ClientLIbraryFolder ノードを検索し、カテゴリプロパティを調べます:

  • /libs/wcm/foundation/clientlibs/accessibility
  • /libs/wcm/foundation/clientlibs/main

このページ

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now