ドキュメントExperience Cloud KCS

Classic Compatibility AEM 6.5 LTS SP3のアップグレード後にサポートされていないパッケージと/libs/commerce コンポーネントが使用できない

最終更新日： 2026年10月13日

Adobe Experience Manager 6.5 LTS SP3では、AEM 6.5 SP24からアップグレードした後、/libs/commerce コンポーネントライブラリが見つからず、従来のCIF コンポーネントに依存していた実装が機能しなくなります。 これは、/libs/commerce個のリソースタイプを参照するコンポーネントダイアログとページテンプレートに影響します。 この問題を修正するには、Adobe Experience Manager 6.5 LTS SP3で、従来のCIF コンポーネントへの依存関係を、サポートされているCommerce統合アプローチに置き換えます。

説明 description

環境

Adobe Experience Manager （AEM） 6.5 LTS SP3

症状

  • AEM 6.5 SP24から6.5 LTS SP3にアップグレードすると、/libs/commerce コンポーネントライブラリが見つかりません。
  • /libs/commerce個のリソースタイプを参照するコンポーネントダイアログやページテンプレートなど、従来のCIF（Commerce integration framework）コンポーネントに依存する実装は機能しません。

原因

CIF Classic Compatibility Packageは、AEM 6.5 LTS SP3ではサポートされていません。このリリースでは、従来のCIF コンポーネントは削除されています。

解決策 resolution

  1. AEM 6.5 LTS SP3にはCIF Classic Compatibility Packageはサポートされていないため、インストールしないでください。また、問題も発生します。

  2. 実装が従来のCIF コンポーネントに依存している場合は、互換性パッケージを配置したAEM 6.5 SP24を一時的なソリューションとして使用します。

  3. 移行プロジェクトを開始して、従来のCIF コンポーネントから最新のCIF アドオンおよびCIF コアコンポーネント（GraphQL ベース）に実装をリファクタリングします。

    1. ダイアログ、テンプレート、バンドル内の従来のCIF コンポーネント（/libs/commerce、/var/commerce、com.adobe.cq.commerce.*など）のすべての使用状況を特定します。
    2. パターン検出やLTS アナライザーなどのツールを使用して、これらの依存関係を見つけます。
    3. サポートされている最新のCIF アドオンとCIF コアコンポーネントを使用するようにコードベースを更新します。

  4. AEM 6.5 LTS SP3へのアップグレードは、CIFの従来の依存関係をすべて実装から削除した後でのみ行います。

  5. 移行とアップグレードが完了したら、コマース関連のコンポーネントとページが新しい環境で期待どおりに機能することを確認します。

recommendation-more-help
experience-cloud-kcs-help-kbarticles