Restructuration des référentiels dans AEM 6.4

/apps/settings/wcm/segments

/conf/settings/settings/wcm/segments

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

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 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.

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.

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.

/etc/clientlibs/foundation/sitecatalyst

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

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

/libs/settings/wcm/designs/wordDesign

/apps/settings/wcm/designs/wordDesign

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.

/etc/mobile

/libs/settings/mobile

/apps/settings/mobile

/conf/global/settings/mobile

/conf/<tenant>/settings/mobile

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.

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

/apps/msm (configurations de plans directeurs clientes)

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

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.

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 Blueprint de Multi-site Manager. Par conséquent, il n’y a pas de références de contenu à ajuster.

/etc/msm/rolloutConfigs

/libs/msm/wcm/rolloutconfigs

/apps/msm/wcm/rolloutconfigs

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.

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

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

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

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

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 les modèles d’e-mail de notification d’événement de page migrés de l’emplacement précédent.

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

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

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.

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.

/etc/clientlibs/foundation/target

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

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

/etc/clientlibs/wcm/foundation

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

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