AEMaaCS への移行後、オンプレミスの Sling マッピングが失敗する

Last update: Tue Oct 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Sling マッピングをオンプレミスのAEM セットアップからAdobe Experience Manager as a Cloud Service（AEMaaCS）に移行すると、クラウド環境の不変の特性により、互換性の問題が発生します。この問題を解決するには、サポートされているクラウド互換の形式を使用して、sling マッピングを再構築およびデプロイします。

説明 description

環境

Adobe Experience Manager as a Cloud Service（AEMaaCS） - Sites

問題/症状

複数のパスやドメインのマッピングで、正しい URL を生成できない。
/etc/map の下の前方および後方へのマッピングは、AEMaaCS では機能しません。
送信 URL は正しく表示されませんが、正しい宛先にリダイレクトされます。
受信 URL は正しく動作しますが、送信動作に一貫性がありません。
AEMaaCS では、AEMaaCS の不変性により、Sling マッピングをコード経由でデプロイする必要があります。

解決策 resolution

AEMaaCS と互換性のある sling マッピングを変換してデプロイするには、次の手順に従います。

既存の sling マッピングをオンプレミスの /etc/map ディレクトリから .zip パッケージにエクスポートする。
書き出した .zip パッケージを your_project/ui.content/src/main/content/jcr_root/ の下のプロジェクトコードベースに追加します。
etc ディレクトリ内の map フォルダーの名前を map.publish に変更します。
/etc/map.publish をマッピングの場所として参照するように、Apache Sling Resource Resolver 設定を更新します。
1. PID org.apache.sling.jcr.resource.internal.JcrResourceResolverFactoryImpl の OSGi 設定 JSON を作成または更新します。
2. resource.resolver.map.location を /etc/map.publish に設定します。
3. 必要に応じて、JCR からマッピングロジックを移行する場合は、カスタム配列値で resource.resolver.mapping を更新します。
すべての変更を保存し、Adobe Cloud Managerを使用して更新されたコードベースをデプロイし、変更を AEMaaCS にプッシュします。
実稼動環境にデプロイする前に、開発環境とステージング環境でマッピングを十分にテストし、受信および送信 URL の両方が正しく動作することを確認します。

AEMaaCS への移行後、オンプレミスの Sling マッピングが失敗する

説明 description

環境

問題/症状

解決策 resolution

関連資料