Restructuration des référentiels dans AEM 6.5

Dernière mise à jour : 2023-11-08
  • Rubriques :
  • Upgrading
    Afficher plus sur ce sujet

Comme indiqué dans la page parent Restructuration des référentiels dans AEM 6.5, les clients effectuant une mise à niveau vers AEM 6.5 doivent utiliser cette page pour évaluer le travail associé aux modifications des référentiels ayant un impact sur la solution AEM Sites. Certaines modifications demandent du travail lors du processus de mise à niveau vers AEM 6.5, tandis que d’autres peuvent être différées jusqu’à une mise à niveau vers une version future.

Avec la mise à niveau vers la version 6.5

Avant de procéder à la mise à niveau vers une future version

Avec la mise à niveau vers la version 6.5

Segments ContextHub

Emplacement précédent /etc/segmentation/contexthub
Nouveaux emplacements

/apps/settings/wcm/segments

/conf/settings/settings/wcm/segments

/conf/<tenant>/settings/wcm/segments

Conseils de restructuration

Si des segments ContextHub nouveaux ou modifiés sont modifiés dans le contrôle de code source plutôt que dans AEM, ils doivent être migrés vers le nouvel emplacement :

  1. Copiez les segments ContextHub nouveaux ou modifiés depuis l’emplacement précédent vers le nouvel emplacement approprié (/%3Ccode%3Eapps%3C/code%3E,%20%3Ccode%3E/conf/global%3C/code%3E%20ou%20%3Ccode%3E/conf/<tenant>%3C/code%3E?lang=fr).
  2. Mettez à jour les références aux segments ContextHub de l’emplacement précédent vers les segments ContextHub migrés dans les nouveaux emplacements client (/apps, /conf/global, /conf/<tenant>).

La requête QueryBuilder ci-dessous recherche toutes les références aux segments ContextHub dans les emplacements précédents.

path=/content property=cq:segments property.operation=like property.value=/etc/segmentation/contexthub/%

Elle peut être exécutée dans l’interface utilisateur du débogueur QueryBuilder AEM. Notez qu’il s’agit d’une requête transversale. Par conséquent, ne l’exécutez pas en exploitation et vérifiez que les limites de traversée sont ajustées en fonction des besoins.

Remarques

Les segments ContextHub persistants à l’emplacement précédent s’affichent en lecture seule dans AEM > Personnalisation > Audiences.

Si les segments ContextHub doivent être modifiables dans AEM, ils doivent être migrés vers le nouvel emplacement (/conf/global or /conf/<tenant>). Tous les nouveaux segments ContentHub créés dans AEM sont persistants dans le nouvel emplacement (/conf/global or /conf/<tenant>).

Les propriétés de la page AEM Sites permettent uniquement la sélection de l’emplacement précédent (/etc) ou d’un nouvel emplacement unique (/apps, /conf/global or /conf/<tenant>). Les segments de ContextHub doivent donc être migrés en conséquence.

Les segments ContextHub inutilisés des sites de référence d’AEM peuvent être supprimés et ne pas être migrés vers le nouvel emplacement :

  • /etc/segmentation/geometrixx/
  • /etc/segmentation/geometrixx-outdoors

Remarque : Si ClientContext est en cours d’utilisation, il est recommandé de le convertir en ContextHub.

Avant de procéder à la mise à niveau vers une future version

Bibliothèques clientes Adobe Analytics

Emplacement précédent

/etc/clientlibs/foundation/sitecatalyst

Nouveaux emplacements /libs/cq/analytics/clientlibs/analytics
Conseils de restructuration

Toute utilisation personnalisée de ces bibliothèques clientes doit faire référence à la bibliothèque cliente par catégorie, et non par chemin d’accès :

  1. Toute référence à la bibliothèque cliente par chemin d’accès à l’emplacement précédent doit être mise à jour pour utiliser AEM framework de référence de bibliothèque cliente.
  2. Si AEM framework de référencement de bibliothèque cliente ne peut pas être utilisé, le chemin absolu des bibliothèques clientes peut être référencé via AEM servlet proxy de bibliothèque cliente.
    • /etc.clientlibs/cq/analytics/clientlibs/sitecatalyst/appmeasurement.js
    • /etc.clientlibs/cq/analytics/clientlibs/sitecatalyst/plugins.js
    • /etc.clientlibs/cq/analytics/clientlibs/sitecatalyst/sitecatalyst.js
    • /etc.clientlibs/cq/analytics/clientlibs/sitecatalyst/tracking.js
    • /etc.clientlibs/cq/analytics/clientlibs/sitecatalyst/util.js
Remarques

La modification de ces bibliothèques clientes n’a jamais été prise en charge.

Pour obtenir les catégories des bibliothèques clientes, accédez à chaque nœud cq:ClientLIbraryFolder via CRXDELite et inspectez la propriété des catégories.

  • /libs/cq/analytics/clientlibs/sitecatalyst/appmeasurement
  • /libs/cq/analytics/clientlibs/sitecatalyst/plugins
  • /libs/cq/analytics/clientlibs/sitecatalyst/sitecatalyst
  • /libs/cq/analytics/clientlibs/sitecatalyst/tracking
  • /libs/cq/analytics/clientlibs/sitecatalyst/util

De Microsoft Word classique à la conception de pages web

Emplacement précédent /etc/designs/wordDesign
Nouveaux emplacements

/libs/settings/wcm/designs/wordDesign

/apps/settings/wcm/designs/wordDesign

Conseils de restructuration

Pour les conceptions gérées dans SCM et qui ne sont pas écrites au moment de l’exécution via les boîtes de dialogue de conception.

  1. Copiez les conceptions de l’emplacement précédent dans le nouvel emplacement (/apps).
  2. Convertissez les ressources statiques, CSS et JavaScript dans la conception en bibliothèque cliente avec allowProxy = true.
  3. Mettez à jour les références à l’emplacement précédent dans la propriété cq:designPath .
  4. Mettez à jour les pages faisant référence à l’emplacement précédent pour utiliser la nouvelle catégorie de bibliothèque cliente (cela nécessite la mise à jour du code d’implémentation de la page).
  5. Mettez à jour les règles du Dispatcher AEM pour autoriser le service des bibliothèques clientes via la servlet proxy /etc.clientlibs/.

Pour les conceptions NON gérées dans SCM et modifiées au moment de l’exécution via les boîtes de dialogue de conception :

  • Ne déplacez pas les conceptions activées par l’auteur en dehors de /etc.
Remarques N/A

Configurations de l’émulateur d’appareil mobile

Emplacement précédent

/etc/mobile

Nouveaux emplacements

/libs/settings/mobile

/apps/settings/mobile

/conf/global/settings/mobile

/conf/<tenant>/settings/mobile

Conseils de restructuration Toute nouvelle configuration d’émulateur d’appareil mobile doit être migrée vers le nouvel emplacement.
  1. Copiez les nouvelles configurations d’émulateur d’appareil mobile de l’emplacement précédent vers le nouvel emplacement (/apps, /conf/global, /conf/<tenant>).
  2. Pour toutes les pages AEM Sites qui dépendent de ces configurations d’émulateur d’appareil mobile, mettez à jour le nœud de la page jcr :content  :
    [cq:Page]/jcr:content@cq: deviceGroups = String[ mobile/groups/responsive ]
  3. Pour les modèles modifiables qui dépendent de ces configurations d’émulateur d’appareil mobile, mettez-les à jour, en faisant pointer cq  : deviceGroups sur le nouvel emplacement.
Remarques

La résolution des configurations d’émulateur d’appareil mobile se produit dans l’ordre suivant :

  1. /conf/<tenant>/settings/mobile
  2. /conf/global/settings/mobile
  3. /apps/settings/mobile
  4. /libs/settings/mobile
  5. /etc/mobile

Configurations de plans directeurs de Multi-site Manager

Emplacement précédent /etc/blueprints
Nouveaux emplacements

/apps/msm (configurations de plans directeurs clientes)

/libs/msm (configurations de plans directeurs prêtes à l’emploi pour Screens, Commerce)

Conseils de restructuration

Les configurations de plans directeurs de Multi-site Manager nouvelles ou modifiées doivent être migrées vers le nouvel emplacement (/apps).

  1. Copiez les configurations de plans directeurs de Multi-site Manager nouvelles ou modifiées de l’emplacement précédent vers le nouvel emplacement (/apps).
  2. Supprimez les configurations de plans directeurs de Multi-site Manager migrées de l’emplacement précédent.
Remarques

Toutes les configurations de plans directeurs de Multi-site Manager fournies par AEM existent dans le nouvel emplacement de /libs.

Le contenu ne fait pas référence aux configurations bleues de Multi-site Manager. Il n’existe donc pas de références de contenu à ajuster.

Configurations du déploiement de Multi-site Manager

Emplacement précédent

/etc/msm/rolloutConfigs

Nouveaux emplacements

/libs/msm/wcm/rolloutconfigs

/apps/msm/wcm/rolloutconfigs

Conseils de restructuration

Toute configuration de déploiement de Multi-site Manager nouvelle ou modifiée doit être migrée vers le nouvel emplacement.

  1. Copiez les configurations de déploiement de Multi-site Manager nouvelles ou modifiées de l’emplacement précédent vers le nouvel emplacement (/apps).
  2. Mettez à jour toutes les références sur les pages AEM vers les configurations de déploiement de Multi-site Manager de l’emplacement précédent, afin qu’elles pointent vers leurs homologues dans les nouveaux emplacements (/libs ou /apps).

Supprimez les configurations de déploiement de Multi-site Manager migrées de l’emplacement précédent.

Remarques Si vous ne supprimez pas les configurations de déploiement multi-site Manager migrées de l’emplacement précédent, des options de déploiement en double s’affichent pour les auteurs AEM.

Modèle d’e-mail de notification d’événement de page

Emplacement précédent

/etc/notification/email/default/com.day.cq.wcm.core.page

Nouveaux emplacements

/libs/settings/notification-templates/com.day.cq.wcm.core.page

/apps/settings/notification-templates/com.day.cq.wcm.core.page

Conseils de restructuration

Les seuls nouveaux modèles d’e-mail de notification d’événement de page pris en charge sont la prise en charge de nouveaux paramètres régionaux.

La résolution du modèle d’e-mail d’événement de page s’effectue dans l’ordre suivant :

  1. /etc/notification/email/default/com.day.cq.wcm.core.page
  2. /apps/settings/notification-templates/com.day.cq.wcm.core.page
  3. /libs/settings/notification-templates/com.day.cq.wcm.core.page
Remarques

Tout modèle d’e-mail de notification d’événement de page nouveau ou modifié doit être migré vers le nouvel emplacement sous /apps :

  1. Copiez les modèles d’e-mail de notification d’événement de page nouveaux ou modifiés de l’emplacement précédent vers le nouvel emplacement (/apps).
  2. Supprimez tous les modèles d’e-mail de notification d’événement de page migrés de l’emplacement précédent.

Génération de modèles automatique de pages

Emplacement précédent /etc/scaffolding
Nouveaux emplacements

/libs/settings/ wcm /template-types/scaffolding/scaffolding

/apps/settings/ wcm /template-types/scaffolding/scaffolding

Conseils de restructuration Les structures créées à l’emplacement précédent utilisent l’infrastructure existante et ne peuvent pas être migrées vers le nouvel emplacement. Pour s’aligner sur le nouvel emplacement, tout modèle de génération de modèles automatique hérité doit être redéveloppé à l’aide de la structure de génération de modèles automatique prise en charge.
Remarques N/A

Grille réactive LESS

Emplacement précédent /etc/clientlibs/wcm/foundation/grid/grid_base.less
Nouveaux emplacements /libs/wcm/foundation/clientlibs/grid/grid_base.less
Conseils de restructuration

Toutes les références à l’emplacement précédent dans les fichiers LESS personnalisés doivent être mises à jour pour être importées à partir du nouvel emplacement.

  • Mettez à jour tous les fichiers LESS personnalisés référençant grid_base.less dans l’emplacement précédent pour référencer le nouvel emplacement.
Remarques Si vous référencez un fichier grid_base.less qui n’existe pas, le mode Mise en page de l’éditeur de pages et de modèles ne fonctionne pas et la mise en page est perturbée.

Conceptions de modèles statiques

Emplacement précédent /etc/designs/<custom-site>
Nouveaux emplacements /apps/settings/wcm/designs/<custom-site>
Conseils de restructuration

Pour les conceptions gérées dans SCM et qui ne sont pas écrites au moment de l’exécution via les boîtes de dialogue de conception.

  1. Copiez les conceptions de l’emplacement précédent dans le nouvel emplacement (/apps).
  2. Convertissez les ressources statiques, CSS et JavaScript dans la conception en bibliothèque cliente avec allowProxy = true.
  3. Mettez à jour les références à l’emplacement précédent dans la propriété cq:designPath via AEM > Sites > Pages de site personnalisées > Propriétés de page > Onglet avancé > Champ de conception.
  4. Mettez à jour les pages faisant référence à l’emplacement précédent pour utiliser la nouvelle catégorie de bibliothèque cliente (cela nécessite la mise à jour du code d’implémentation de la page).
  5. Mettez à jour les règles du Dispatcher AEM pour autoriser le service des bibliothèques clientes via la servlet proxy /etc.clientlibs/.

Pour les conceptions NON gérées dans SCM et modifiées au moment de l’exécution via les boîtes de dialogue de conception :

  • Ne déplacez pas les conceptions activées par l’auteur en dehors de /etc.
Remarques L’approche recommandée consiste à créer des sites et des pages AEM Sites à l’aide de modèles modifiables qui utilisent le contenu et les politiques de la structure au lieu de conceptions.

Bibliothèques clientes d’intégration d’Adobe Target

Emplacement précédent

/etc/clientlibs/foundation/target

Nouveaux emplacements /libs/cq/testandtarget/clientlibs/testandtarget
Conseils de restructuration

Toute utilisation personnalisée de ces bibliothèques clientes doit faire référence à la bibliothèque cliente par catégorie, et non par chemin d’accès.

  1. Toute référence à la bibliothèque cliente par chemin d’accès à l’emplacement précédent doit être mise à jour pour utiliser AEM framework de référence de bibliothèque cliente.
  2. Si AEM framework de référencement de bibliothèque cliente ne peut pas être utilisé, le chemin absolu des bibliothèques clientes peut être référencé via AEM servlet proxy de bibliothèque cliente :
  • /etc.clientlibs/cq/testandtarget/clientlibs/testandtarget/testandtarget.js
  • /etc.clientlibs/cq/testandtarget/clientlibs/testandtarget/atjs.js
  • /etc.clientlibs/cq/testandtarget/clientlibs/testandtarget/atjs-integration.js
  • /etc.clientlibs/cq/testandtarget/clientlibs/testandtarget/init.js
  • /etc.clientlibs/cq/testandtarget/clientlibs/testandtarget/mbox.js
  • /etc.clientlibs/cq/testandtarget/clientlibs/testandtarget/parameters.js
  • /etc.clientlibs/cq/testandtarget/clientlibs/testandtarget/util.js
Remarques

La modification de ces bibliothèques clientes n’a jamais été prise en charge.

Pour obtenir les catégories de la bibliothèque cliente, consultez chaque noeud cq:ClientLIbraryFolder via CRXDELite et examinez la propriété categories :

  • /libs/cq/testandtarget/clientlibs/testandtarget/testandtarget
  • /libs/cq/testandtarget/clientlibs/testandtarget/atjs
  • /libs/cq/testandtarget/clientlibs/testandtarget/atjs-integration
  • /libs/cq/testandtarget/clientlibs/testandtarget/init
  • /libs/cq/testandtarget/clientlibs/testandtarget/mbox
  • /libs/cq/testandtarget/clientlibs/testandtarget/parameters
  • /libs/cq/testandtarget/clientlibs/testandtarget/util

Bibliothèques clientes de gestion de contenu web de base

Emplacement précédent

/etc/clientlibs/wcm/foundation

Nouveaux emplacements /libs/wcm/foundation/clientlibs
Conseils de restructuration

Toute utilisation personnalisée de ces bibliothèques clientes doit faire référence à la bibliothèque cliente par catégorie, et non par chemin d’accès.

  1. Toute référence à la bibliothèque cliente par chemin d’accès à l’emplacement précédent doit être mise à jour pour utiliser AEM framework de référence de bibliothèque cliente.
  2. Si AEM framework de référencement de bibliothèque cliente ne peut pas être utilisé, le chemin absolu des bibliothèques clientes peut être référencé via AEM servlet proxy de bibliothèque cliente.
  • /etc.clientlibs/wcm/foundation/clientlibs/accessibility.css
  • /etc.clientlibs/wcm/foundation/clientlibs/main.css
  • /etc.clientlibs/wcm/foundation/clientlibs/main.js
Remarques

La modification de ces bibliothèques clientes n’a jamais été prise en charge.

Pour obtenir les catégories des bibliothèques clientes, accédez à chaque nœud cq:ClientLIbraryFolder via CRXDELite et inspectez la propriété des catégories :

  • /libs/wcm/foundation/clientlibs/accessibility
  • /libs/wcm/foundation/clientlibs/main

Sur cette page