DocumentationExperience Cloud KCS

conseils d’architecture AEM Sites pour la migration de pages HTML statiques

Dernière mise à jour : 29 octobre 2026

Cet article décrit l’architecture recommandée et les étapes de migration pour transférer des pages HTML et CSS statiques dans Adobe Experience Manager Sites lorsque la modification de contenu n’est pas nécessaire.

Description description

Environnement

  • Adobe Experience Manager (toutes les versions).

Symptômes

  • Une centaine de pages HTML et CSS statiques doivent être migrées vers AEM Sites.
  • Le contenu ne doit pas être modifié après la migration.
  • La disposition existante doit être conservée.
  • Les pages doivent résider dans l’instance de création AEM, avec une diffusion publique facultative via l’instance de publication AEM.
  • Certaines sections récurrentes existent sur plusieurs pages, mais de nombreuses pages ont des mises en page uniques.
  • JavaScript et CSS sont présents et doivent être gérés de manière appropriée.
  • Certaines pages contiennent des formulaires.

Cause

L’architecture traditionnelle d’AEM Sites offre une approche plus facile à gérer et à moindre risque pour migrer des pages HTML statiques qui ne nécessitent pas de modification de contenu continue, par rapport à la création de composants spécifiques à une page ou à l’adoption de Edge Delivery Services pour ce cas d’utilisation.

Résolution resolution

Suivez les étapes ci-dessous pour résoudre le problème.

  1. Évaluer les mises en page et la réutilisation :

    1. Identifiez les sections récurrentes sur les pages statiques qui peuvent être implémentées en tant que composants AEM réutilisables.
    2. Déterminez si un modèle de page partagé peut être utilisé ou si plusieurs modèles sont nécessaires pour des mises en page uniques.

  2. Implémentez la structure d’AEM Sites :

    1. Créez des modèles de page dans AEM qui reflètent la structure et la disposition communes des pages statiques.
    2. Développer des composants réutilisables pour les sections récurrentes telles que les en-têtes, pieds de page, navigation et formulaires.
    3. Évitez de créer un seul composant volumineux pour chaque page entière, car cela réduit la facilité de maintenance et de réutilisation.

  3. Migration du contenu statique :

    1. Utilisez un script d’importation ou un utilitaire de migration pour créer la structure de page et renseigner le contenu à partir des fichiers HTML existants.
    2. Gérez JavaScript et CSS via les bibliothèques côté client d’AEM (clientlibs).
    3. Intégrez tous les formulaires en tant que composants AEM ou incorporez-les si nécessaire.

  4. Valider la migration :

    1. Tester un ensemble représentatif de pages migrées dans un environnement inférieur
    2. Validez la précision visuelle, les liens, les références de ressources, les métadonnées d’optimisation du moteur de recherche et le comportement de JavaScript.

  5. Détermination des exigences de diffusion :

    • Si les pages doivent être accessibles au public, configurez la diffusion via l’instance de publication AEM.
    • Si les pages ne sont requises que dans l’instance de création AEM pour une utilisation interne, aucune configuration de diffusion publique n’est nécessaire.

  6. Considérations relatives à Edge Delivery Services :

    • Edge Delivery Services n’est pas recommandé pour la migration directe d’HTML/CSS statique arbitraire, car il nécessite d’adapter le contenu au modèle de bloc Edge Delivery Services et à l’éditeur universel.
    • N’utilisez Edge Delivery Services que si une diffusion publique hautement performante est un objectif principal et que l’équipe est prête à adopter son modèle de développement et de création.
recommendation-more-help
experience-cloud-kcs-help-kbarticles