Restructuration des référentiels dans AEM 6.5

Comme décrit sur la page parent Restructuration du référentiel dans AEM 6.5, les clients qui effectuent la mise à niveau vers AEM 6.5 doivent utiliser cette page pour évaluer l'effort de travail associé aux modifications du référentiel qui affectent la solution AEM Sites. Certaines modifications nécessitent un effort de travail pendant le processus de mise à niveau AEM 6.5, tandis que d’autres peuvent être différées jusqu’à une mise à niveau ultérieure.

Avec la mise à niveau vers la version 6.5

Avant la mise à niveau future

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

Conseil de restructuration

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

  1. Copiez tous les segments ContextHub nouveaux ou modifiés de 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 (/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/%

Cette opération peut être exécutée via AEM interface utilisateur du débogueur QueryBuilder. Notez qu’il s’agit d’une requête transversale. Par conséquent, ne l’exécutez pas en production 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 ou /conf/<tenant>). Tout nouveau segment ContentHub créé dans AEM est conservé au nouvel emplacement (/conf/global ou /conf/<tenant>).

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

Tous les segments ContextHub inutilisés des sites de référence 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é d’effectuer un conversion en ContextHub.

Avant la mise à niveau ultérieure

Bibliothèques clientes Adobe Analytics

Emplacement précédent

/etc/clientlibs/foundation/sitecatalyst

Nouveaux emplacements /libs/cq/analytics/clientlibs/analytics
Conseil 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 :

  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 l’infrastructure de référencement de la bibliothèque cliente AEM.
  2. Si l’infrastructure de référencement des bibliothèques clientes AEM ne peut pas être utilisée, le chemin absolu des bibliothèques clientes peut être référencé via la servlet proxy des bibliothèques clientes AEM.
    • /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

Conseil 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 une 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 répartiteur AEM pour autoriser la diffusion des bibliothèques clientes par le biais de 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

Conseil de restructuration Toute nouvelle configuration d’émulateur d’appareil mobile doit être migrée vers le nouvel emplacement.
  1. Copiez toute nouvelle configuration d'émulateur de périphérique 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 de périphérique mobile, mettez à jour le de la page. jcr Noeud :content :
    [cq:Page]/jcr:content@cq: deviceGroups = Chaîne[ mobile/groupes/réactif ]
  3. Pour tous les modèles modifiables qui dépendent de ces configurations d'émulateur de périphériques mobiles, mettez à jour les modèles modifiables en pointant le cq : deviceGroups au 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 Blueprint de Multi-site Manager

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

/apps/msm (Configurations du plan directeur client)

/libs/msm (Configurations du plan directeur prêtes à l'emploi pour les écrans, Commerce)

Conseil de restructuration

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

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

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

Le contenu ne fait pas référence aux configurations Blueprint de Multi-site Manager. Par conséquent, il n’y a 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

Conseil 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 AEM pages vers les configurations de déploiement multisite Manager à l'emplacement précédent, afin de pointer 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 de Multi-site Manager migrées de l’emplacement précédent, des options de déploiement en double sont affichées pour les auteurs d’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

Conseil de restructuration

Les seuls nouveaux modèles d’e-mail de notification d’événement de page gérés doivent prendre en charge de nouveaux paramètres régionaux.

La résolution des modèle d’e-mail d’événement se produit 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 de courriel de notification de É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 les modèles d’e-mail de notification d’événement de page migrés de l’emplacement précédent.

Structure de page

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

/libs/settings/ wcm /template-types/échafaudage/échafaudage

/apps/settings/ wcm /template-types/échafaudage/échafaudage

Conseil 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, toute structure existante doit être re-développée à l’aide de l’infrastructure prise en charge.
Remarques S/O

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
Conseil de restructuration

Toute référence à l’emplacement précédent dans les fichiers LESS personnalisés doit être mise à jour pour pouvoir être importée à partir du nouvel emplacement.

  • Mettez à jour tous les fichiers LESS personnalisés faisant référence à 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èle statique

Emplacement précédent /etc/designs/<custom-site>
Nouveaux emplacements /apps/settings/wcm/designs/<custom-site>
Conseil 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 une bibliothèque cliente avec allowProxy = true.
  3. Mettez à jour les références à l’emplacement précédent dans propriétés de 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 répartiteur AEM afin d’autoriser la diffusion de 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 règles de la structure au lieu de conceptions.

Bibliothèques clientes d’intégration Adobe Search and Promote

Emplacement précédent

/etc/clientlibs/foundation/searchpromote

Nouveaux emplacements /libs/cq/searchpromote/clientlibs/searchpromote
Conseil de restructuration

Toute utilisation personnalisée de ces bibliothèques clientes doit référencer la bibliothèque cliente par catégorie, et non par le chemin.

  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 l’infrastructure de référencement des bibliothèques clientes AEM.
  2. Si l’infrastructure de référencement des bibliothèques clientes AEM ne peut pas être utilisée, le chemin absolu des bibliothèques clientes peut être référencé via la servlet proxy des bibliothèques clientes AEM :
  • /etc.clientlibs/cq/searchpromote/clientlibs/searchpromotei.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/searchpromote/clientlibs/searchpromote

Bibliothèques clientes d’intégration Adobe Target

Emplacement précédent

/etc/clientlibs/foundation/target

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

Toute utilisation personnalisée de ces bibliothèques clientes doit référencer la bibliothèque cliente par catégorie, et non par le chemin.

  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 l’infrastructure de référencement des bibliothèques clientes AEM.
  2. Si l’infrastructure de référencement des bibliothèques clientes AEM ne peut pas être utilisée, le chemin absolu des bibliothèques clientes peut être référencé via la servlet proxy des bibliothèques clientes AEM :
  • /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 des bibliothèques clientes, accédez à chaque nœud cq:ClientLIbraryFolder via CRXDELite et inspectez la propriété des catégories :

  • /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 WCM Foundation

Emplacement précédent

/etc/clientlibs/wcm/foundation

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

Toute utilisation personnalisée de ces bibliothèques clientes doit référencer la bibliothèque cliente par catégorie, et non par le chemin.

  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 l’infrastructure de référencement des bibliothèques clientes AEM.
  2. Si l’infrastructure de référencement des bibliothèques clientes AEM ne peut pas être utilisée, le chemin absolu des bibliothèques clientes peut être référencé via la servlet proxy des bibliothèques clientes AEM.
  • /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

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now