DocumentationExperience Cloud KCS

Package de compatibilité classique non pris en charge et composants /libs/commerce non disponibles après la mise à niveau dans AEM 6.5 LTS SP3

Dernière mise à jour : 13 octobre 2026

Dans le SP3 LTS Adobe Experience Manager 6.5, la bibliothèque de composants /libs/commerce est manquante après la mise à niveau à partir du SP24 d’AEM 6.5 et les implémentations qui reposent sur des composants CIF classiques ne fonctionnent plus. Cela affecte les boîtes de dialogue de composant et les modèles de page qui font référence à des types de ressources /libs/commerce. Pour résoudre ce problème, remplacez les dépendances sur les composants CIF classiques par une approche d’intégration Commerce prise en charge dans Adobe Experience Manager 6.5 LTS SP3.

Description description

Environnement

Adobe Experience Manager (AEM) 6.5 LTS SP3

Symptômes

  • Après la mise à niveau d’AEM 6.5 SP24 vers 6.5 LTS SP3, la bibliothèque de composants /libs/commerce est manquante.
  • Les implémentations qui reposent sur des composants CIF (Commerce integration framework) classiques, tels que les boîtes de dialogue de composants et les modèles de page qui font référence à des types de ressources /libs/commerce, ne fonctionnent pas.

Cause

Le package de compatibilité CIF Classic n’est pas pris en charge dans AEM 6.5 LTS SP3 et les composants CIF classiques ont été supprimés dans cette version.

Résolution resolution

  1. N’installez pas le package de compatibilité CIF Classic sur AEM 6.5 LTS SP3, car il n’est pas pris en charge et entraîne des problèmes.

  2. Si votre implémentation dépend des composants CIF classiques, conservez le pack de compatibilité AEM 6.5 SP24 avec le package de compatibilité en place en tant que solution temporaire.

  3. Lancez un projet de migration pour refactoriser votre implémentation des composants CIF classiques vers le module complémentaire CIF moderne et les composants principaux CIF (basés sur GraphQL) :

    1. Identifiez toutes les utilisations des composants CIF classiques (tels que /libs/commerce, /var/commerce et com.adobe.cq.commerce.*) dans vos boîtes de dialogue, modèles et lots.
    2. Utilisez des outils tels que l’outil de détection des motifs ou l’analyseur LTS pour localiser ces dépendances.
    3. Mettez à jour votre base de code pour utiliser le module complémentaire CIF moderne pris en charge et les composants principaux CIF.

  4. Procédez à la mise à niveau vers AEM 6.5 LTS SP3 uniquement après avoir supprimé toutes les dépendances de CIF classique de votre mise en œuvre.

  5. Après la migration et la mise à niveau, vérifiez que vos composants et pages liés au commerce fonctionnent comme prévu dans le nouvel environnement.

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