DocumentazioneExperience Cloud KCS

Classic Compatibility Package non supportato e componenti /libs/commerce non disponibili dopo l’aggiornamento in AEM 6.5 LTS SP3

Ultimo aggiornamento: 13 ottobre 2026

In Adobe Experience Manager 6.5 LTS SP3, la libreria dei componenti /libs/commerce risulta mancante dopo l’aggiornamento da AEM 6.5 SP24 e le implementazioni che si basano su componenti CIF classici cessano di funzionare. Questo problema riguarda le finestre di dialogo dei componenti e i modelli di pagina che fanno riferimento a /libs/commerce tipi di risorse. Per risolvere questo problema, sostituire le dipendenze dai componenti classici di CIF con un approccio di integrazione Commerce supportato in Adobe Experience Manager 6.5 LTS SP3.

Descrizione description

Ambiente

Adobe Experience Manager (AEM) 6,5 LTS SP3

Sintomi

  • Dopo l’aggiornamento da AEM 6.5 SP24 a 6.5 LTS SP3, la libreria dei componenti /libs/commerce risulta mancante.
  • Le implementazioni che si basano su componenti classici di CIF (Commerce integration framework), come finestre di dialogo dei componenti e modelli di pagina che fanno riferimento a tipi di risorse /libs/commerce, non funzionano correttamente.

Causa

Il pacchetto di compatibilità di CIF Classic non è supportato in AEM 6.5 LTS SP3 e i componenti classici di CIF sono stati rimossi in questa versione.

Risoluzione resolution

  1. Non installare il pacchetto di compatibilità di CIF Classic su AEM 6.5 LTS SP3, in quanto non è supportato e causa problemi.

  2. Se l’implementazione dipende dai componenti classici di CIF, utilizza AEM 6.5 SP24 con il pacchetto di compatibilità implementato come soluzione temporanea.

  3. Inizia un progetto di migrazione per eseguire il refactoring dell’implementazione dai componenti classici di CIF ai moderni componenti aggiuntivi di CIF e componenti core di CIF (basati su GraphQL):

    1. Identifica tutti gli utilizzi dei componenti classici di CIF (ad esempio /libs/commerce, /var/commerce e com.adobe.cq.commerce.*) in finestre di dialogo, modelli e bundle.
    2. Utilizzare strumenti quali il rilevatore pattern o l’analizzatore LTS per individuare queste dipendenze.
    3. Aggiorna la base di codice per utilizzare i componenti aggiuntivi e i componenti core CIF moderni supportati.

  4. Procedi con l’aggiornamento ad AEM 6.5 LTS SP3 solo dopo aver rimosso tutte le dipendenze classiche di CIF dalla tua implementazione.

  5. Dopo la migrazione e l’aggiornamento, verifica che i componenti e le pagine relativi all’e-commerce funzionino come previsto nel nuovo ambiente.

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