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

AEM 6.5](/docs/experience-manager-65/sites-deploying/repository-restructuring.html?lang=ja)の親ページ[リポジトリの再構築に関する説明に従い、AEM 6.5にアップグレードしたお客様は、このページを使用して、AEM Sites・ソリューションに影響を与えるリポジトリの変更に関連する作業量を評価する必要があります。 一部の変更ではAEM 6.5のアップグレードプロセス中に作業が必要になり、残りの変更は将来のアップグレードまで延期できます。

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. 新しい、または変更したContextHubセグメントを前の場所から適切な新しい場所（/apps、/conf/global、または/conf/<tenant>）にコピーします。
  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のページプロパティでは、「前の場所」(/etc)または「1つの新しい場所」(/apps、/conf/global、/conf/<tenant>)のみを選択できるので、ContextHubセグメントを適切に移行する必要があります。

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. 前の場所のデザインを新しい場所(/apps)にコピーします。
  2. を使用して、デザイン内の CSS、JavaScript、静的リソースをクライアントライブラリallowProxy = trueに変換します。
  3. cq:designPath プロパティの以前の場所への参照を更新します。
  4. 以前の場所を参照しているページを更新して、新規のクライアントライブラリカテゴリを使用します（これにはページ実装コードの更新が必要です）。
  5. AEMディスパッチャールールを更新し、/etc.clientlibs/プロキシサーブレットを介したクライアントライブラリの提供を許可します。

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 （お客様のBluePrint構成）

/libs/msm （画面の青写真の設定はすぐに使用でき、コマース）
再構築の手引き

新しい、または変更されたマルチサイトマネージャーの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. 新しい、または変更したマルチサイトマネージャロールアウト設定を、前の場所から新しい場所(/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
備考

新しい、または変更されたページイベント通知電子メールテンプレートは、/appsの下の新しい場所に移行する必要があります。

  1. 新しい、または変更したページイベント通知電子メールテンプレートを、前の場所から新しい場所(/apps)にコピーします。
  2. 移行したページイベント通知電子メールテンプレートを以前の場所からすべて削除します。

ページ基礎モード

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

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

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

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

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

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

このページ