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

As described on the parent Repository Restructuring in AEM 6.4 page, customers upgrading to AEM 6.4 should use this page to assess the work effort associated with repository changes impacting the AEM Sites Solution. 一部の変更は AEM 6.4 アップグレードプロセス中に作業が必要ですが、それ以外は 6.5 アップグレードまで延期できます。

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

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

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

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. Update references to ContextHub Segments in the previous location to the migrated ContextHub Segments in the new locations (/apps, /conf/global, /conf/<tenant>).

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

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

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

備考

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

If ContextHub Segments are to be editable in AEM, they must be migrated to the new location (/conf/global or /conf/<tenant>). Any new ContentHub Segments segments created in AEM are persisted to the new location (/conf/global or /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 に変換することをお勧めします。

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

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 で管理されておらず、実行時にデザインダイアログで変更されたデザインの場合:

  • Do not move author-able Designs out of /etc.
備考 該当なし

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

以前の場所

/etc/mobile

新しい場所

/libs/settings/mobile

/apps/settings/mobile

/conf/global/settings/mobile

/conf/<tenant>/settings/mobile

再構築の手引き 新しいモバイルデバイスエミュレーター設定は、新しい場所に移行する必要があります。
  1. Copy any new Mobile Device Emulator Configurations from the Previous Location to the new location (/apps, /conf/global, /conf/<tenant>).
  2. これらのモバイルデバイスエミュレーター設定に依存するAEM Sitesページの場合は、ページの jcr :content ノードを更新します。
    [cq:Page]/jcr:content@cq: deviceGroups = String[ mobile/groups/responsive ]
  3. For any Editable Templates that depend on these Mobile Device Emulator Configurations, update the Editable Templates, pointing the cq : deviceGroups to the New Location.
備考

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

  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 (お客様のBluePrint構成)

/libs/msm (画面の青写真の設定はすぐに使用でき、コマース)

再構築の手引き

Any new or modified Multi-site Manager Blueprint Configurations must be migrated to the New Location (/apps).

  1. Copy any new or modified Multi-site Manager Blueprint Configurations from the Previous Location to the New Location (/apps).
  2. 移行した Multi-site Manager のブループリント設定を以前の場所から削除します。
備考

All AEM provided Multi-site Manager Blueprint Configurations exist in the New Location in /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. Update any references on AEM Pages to Multi-site Manager Rollout Configurations in the Previous Location, to point to their counterparts in the New Locations (/libs or /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/scaffolding/scaffolding

/apps/settings/ wcm /template-types/scaffolding/scaffolding

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

レスポンシブグリッド 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. Update AEM Dispatcher rules to allow the serving of Client Libraries via the /etc.clientlibs/ proxy servlet.

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

このページ