DocumentazioneExperience Cloud KCS

Guida all’architettura di AEM Sites per la migrazione di pagine HTML statiche

Ultimo aggiornamento: 30 ottobre 2026

Questo articolo illustra l’architettura consigliata e i passaggi di migrazione per trasferire pagine HTML e CSS statiche in Adobe Experience Manager Sites quando non è necessario modificare i contenuti.

Descrizione description

Ambiente

  • Adobe Experience Manager (tutte le versioni).

Sintomi

  • È necessario migrare ad AEM Sites circa 100 pagine HTML e CSS statiche.
  • Il contenuto non richiede modifiche dopo la migrazione.
  • Il layout esistente deve essere mantenuto.
  • Le pagine devono trovarsi in AEM Author, con distribuzione pubblica facoltativa tramite AEM Publish.
  • Alcune sezioni ricorrenti esistono tra le pagine, ma molte pagine hanno layout univoci.
  • JavaScript e CSS sono presenti e devono essere gestiti in modo appropriato.
  • Alcune pagine includono i moduli.

Causa

La tradizionale architettura di AEM Sites offre un approccio più manutenibile e a basso rischio per la migrazione di pagine HTML statiche che non richiedono modifiche continue dei contenuti, rispetto alla creazione di componenti specifici per le pagine o all’adozione di Edge Delivery Services per questo caso d’uso.

Risoluzione resolution

Per risolvere il problema, segui la procedura riportata di seguito.

  1. Valutare i layout di pagina e la riutilizzabilità:

    1. Identifica sezioni ricorrenti nelle pagine statiche che possono essere implementate come componenti AEM riutilizzabili.
    2. Determina se è possibile utilizzare un modello di pagina condiviso o se sono necessari più modelli per i layout univoci.

  2. Implementare la struttura AEM Sites:

    1. Crea in AEM modelli di pagina che riflettano la struttura e il layout comuni delle pagine statiche.
    2. Sviluppa componenti riutilizzabili per sezioni ricorrenti come intestazioni, piè di pagina, navigazione e moduli.
    3. Evita di creare un singolo componente di grandi dimensioni per ogni pagina, in quanto ciò riduce la manutenibilità e la riutilizzabilità.

  3. Migrazione del contenuto statico:

    1. Utilizza uno script di importazione o un’utility di migrazione per creare la struttura della pagina e popolare il contenuto dai file HTML esistenti.
    2. Gestisci JavaScript e CSS tramite le librerie lato client di AEM (clientlibs).
    3. Integra tutti i moduli come componenti di AEM o incorporali in base alle esigenze.

  4. Convalida migrazione:

    1. Esegui il test di un set rappresentativo di pagine migrate in un ambiente inferiore.
    2. Convalida l’accuratezza visiva, i collegamenti, i riferimenti alle risorse, i metadati SEO e il comportamento di JavaScript.

  5. Determinare i requisiti di consegna:

    • Se le pagine devono essere accessibili al pubblico, configura la consegna tramite AEM Publish.
    • Se le pagine sono necessarie solo in AEM Author per uso interno, non è necessaria alcuna configurazione di consegna pubblica.

  6. Considerazione Edge Delivery Services:

    • Edge Delivery Services non è consigliato per la migrazione diretta di HTML/CSS statici arbitrari, in quanto richiede l’adattamento del contenuto al modello a blocchi di Edge Delivery Services e all’editor universale.
    • Considera Edge Delivery Services solo se la distribuzione pubblica ad alte prestazioni è un obiettivo primario e il team è pronto ad adottare il suo modello di sviluppo e authoring.
recommendation-more-help
experience-cloud-kcs-help-kbarticles