Show Menu
SUJETS×

Restructuration des référentiels dans AEM 6.5

As described on the parent Repository Restructuring in AEM 6.5 page, customers upgrading to AEM 6.5 should use this page to assess the work effort associated with repository changes impacting the AEM Sites Solution. Certaines modifications nécessitent un effort de travail pendant le processus de mise à niveau d’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. Copy any new or modified ContextHub Segments from the previous location to the appropriate new location (/ apps , /conf/global or /conf/<tenant> )
  2. Update references to ContextHub Segments in the previous location to the migrated ContextHub Segments in the new locations ( /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 l’interface utilisateur du débogueur d’ API Query Builder AEM 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.
Notes
Les segments ContextHub persistants à l’emplacement précédent s’affichent en lecture seule dans AEM > Personnalisation > Audiences .
If ContextHub Segments are to be editable in AEM, they must be migrated to the new location ( /conf/global or /conf/<tenant> ). Any new ContentHub Segments segments created in AEM are persisted to the new location ( /conf/global or /conf/<tenant> ).
AEM Sites Page Properties only allow either the Previous Location ( /etc ) or a single new location ( /apps , /conf/global or /conf/<tenant> ) to be selected, thus ContextHub Segments must be migrated accordingly.
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 future

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
Notes
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. Update AEM Dispatcher rules to allow serving of Client Libraries via the /etc.clientlibs/ proxy servlet.
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 .
Notes 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. Copy any new Mobile Device Emulator Configurations from the Previous Location to the new location ( /apps , /conf/global , /conf/<tenant> ).
  2. Pour toutes les pages de sites AEM qui dépendent de ces configurations d’émulateur de périphériques mobiles, mettez à jour le noeud jcr de la page :content : [cq:Page]/jcr:content@cq: deviceGroups = String[ mobile/groups/response ]
  3. For any Editable Templates that depend on these Mobile Device Emulator Configurations, update the Editable Templates, pointing the cq : deviceGroups to the New Location.
Notes
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.
Notes
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. Update any references on AEM Pages to Multi-site Manager Rollout Configurations in the Previous Location, to point to their counterparts in the New Locations ( /libs or /apps ).
Supprimez les configurations de déploiement de Multi-site Manager migrées de l’emplacement précédent.
Notes 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
Notes
Any new or modified Page Event Notification E-mail Templates must be migrated to the new location under /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/scaffolding/scaffolding
/apps/settings/ wcm /template-types/scaffolding/scaffolding
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.
Notes 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
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.
Notes 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. Update AEM Dispatcher rules to allow the serving of Client Libraries via the /etc.clientlibs/ proxy servlet.
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 .
Notes 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
Notes
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
Notes
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
Notes
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