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

注意

AEM 6.4 の拡張サポートは終了し、このドキュメントは更新されなくなりました。 詳細は、 技術サポート期間. サポートされているバージョンを見つける ここ.

親の 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 Client Library の参照フレームワーク.
  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
再構築の手引き 「以前の場所」の下に作成された基礎モードは、従来の基礎モードフレームワークを使用しているので、新しい場所に移行することはできません。 新しい場所に合わせるには、サポートされている 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 Client Library の参照フレームワーク.
  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 ノードにアクセスし、 categories プロパティを調べます。

  • /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 Client Library の参照フレームワーク.
  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

このページ