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

AEM 6.5の親リポジトリの再構築ページで説明したように、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セグメントを以前の場所から適切な新しい場所(/%3Ccode%3Eapps%3C/code%3E%E3%80%81%3Ccode%3E/conf/global%3C/code%3E%E3%80%81%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 Debugger 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 Dispatcherのルールを更新し、/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 （お客様のブループリント設定）

/libs/msm （Screens、Commerceの標準ブループリント設定）
再構築の手引き

新規または変更されたMulti-site Managerのブループリント設定は、新しい場所(/apps)に移行する必要があります。

  1. 新規または変更されたMulti-site Managerのブループリント設定を以前の場所から新しい場所(/apps)にコピーします。
  2. 移行した Multi-site Manager のブループリント設定を以前の場所から削除します。
備考

AEMが提供するMulti-site Managerのブループリント設定はすべて、/libsの新しい場所に存在します。

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

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

以前の場所

/etc/msm/rolloutConfigs
新しい場所

/libs/msm/wcm/rolloutconfigs

/apps/msm/wcm/rolloutconfigs
再構築の手引き

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

  1. 新規または変更されたMulti-site Managerのロールアウト設定を以前の場所から新しい場所(/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/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. デザインを以前の場所から新しい場所(/apps)にコピーします。
  2. を使用して、デザイン内の CSS、JavaScript、静的リソースをクライアントライブラリallowProxy = trueに変換します。
  3. cq:designPathAEM／Sites／カスタムサイトページ／ページのプロパティ／詳細タブ／デザインフィールドで プロパティの以前の場所への参照を更新します。
  4. 以前の場所を参照しているページを更新して、新規のクライアントライブラリカテゴリを使用します（これにはページ実装コードの更新が必要です）。
  5. AEM Dispatcherルールを更新し、/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

このページ