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

親の AEM 6.4 のリポジトリ再構築に記載されているように、AEM 6.4 にアップグレードするユーザーは、このページを使用して、AEM Sites ソリューションに影響を与えるリポジトリの変更に関連する作業量を評価する必要があります。一部の変更は 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. 新規または変更された ContextHub セグメントを以前の場所から適切な新しい場所(/apps/conf/global/conf/<tenant> のいずれか)にコピー
  2. 以前の場所の ContextHub Segments への参照を、新しい場所(/apps/conf/global/conf/<tenant> のいずれか)の移行された ContextHub Segments に更新します。

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

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

これは AEM QueryBuilder Debugger UI を使用して実行できます。これは走査クエリであるため、実稼働環境に対して実行しないでください。また、必要に応じて走査制限を調整してください。

メモ

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

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

AEM Sites ページのプロパティでは、以前の場所(/etc)または単一の新しい場所(/apps/conf/global/conf/<tenant> のいずれか)しか選択できないため、それに応じて ContextHub セグメントを移行する必要があります。

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

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

マルチサイトマネージャーのブループリント設定

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

/apps/msm (カスタマーブループリント設定)

/libs/msm (Screens、Commerce のための標準ブループリント設定)

再構築の手引き

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

  1. 新規または変更されたマルチサイトマネージャーのブループリント設定を以前の場所から新しい場所(/apps)にコピーします。
  2. 移行したマルチサイトマネージャーのブループリント設定を以前の場所から削除します。
メモ

AEM が提供するマルチサイトマネージャーのブループリント設定はすべて、/libs の新しい場所にあります。

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

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

以前の場所

/etc/msm/rolloutConfigs

新しい場所

/libs/msm/wcm/rolloutconfigs

/apps/msm/wcm/rolloutconfigs

再構築の手引き

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

  1. 新規または変更したマルチサイトマネージャーのロールアウト設定を以前の場所から新しい場所(/apps)にコピーします。
  2. AEM ページで、以前の場所にあるマルチサイトマネージャーのロールアウト設定への参照をすべて、新しい場所(/libs または /apps)の対応する場所を指すように更新します。

移行したマルチサイトマネージャーのロールアウト設定を以前の場所から削除します。

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

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

  • オーサリング可能なデザインを /etc から移動しないでください。
メモ 推奨されるアプローチは、デザインの代わりに構造コンテンツとポリシーを使用する編集可能なテンプレートを使用して AEM Sites とページを構築することです。

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 ノードを検索し、categories プロパティを調べます。

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

このページ