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 potentiel sur toutes les solutions. 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.
Depuis AEM 6.4, il n’existe plus de configuration ContextHub par défaut. Par conséquent, une cq:contextHubPathproperty doit être définie au niveau racine du site pour indiquer la configuration à utiliser.
Accédez à la racine du site.
Ouvrez les propriétés de la page racine et sélectionnez ensuite l’onglet Personnalisation.
Dans le champ Chemin d’accès ContextHub, saisissez votre propre chemin d’accès de configuration ContextHub.
Dans la configuration ContextHub, la propriété sling:resourceType doit, en outre, être mise à jour, passant de « Relative » à « Absolue ».
Ouvrez les propriétés du nœud de configuration ContextHub dans CRX DE Lite : /apps/settings/cloudsettings/legacy/contexthub, par exemple.
Modifiez sling:resourceType de /libs/granite/contexthub/cloudsettings/components/baseconfiguration en granite/contexthub/cloudsettings/components/baseconfiguration.
En d’autres termes, la propriété sling:resourceType de la configuration ContextHub doit être relative et non absolue.
Modèles de workflow
Emplacement précédent
/etc/workflow/models
Nouveaux emplacements
/libs/settings/workflow/models
/conf/global/settings/workflow/models
/var/workflow/models
Conseil de restructuration
Les modèles de workflow, nouveaux ou modifiés, doivent être migrés vers /conf/global/workflow/models.
Déployez les modèles de workflow modifiés dans une instance locale de développement AEM 6.5, comme ils existent dans l’emplacement précédent.
Modifiez le modèle de workflow à l’aide de l’éditeur de modèle de workflow d’AEM dans AEM > Outils > Workflow > Modèles.
Lors de la migration des modèles de workflow fournis par AEM modifiés
L’éditeur de modèle de workflow étant ouvert, modifiez l’URL du navigateur, puis remplacez le segment de chemin /libs/settings/workflow/models par /etc/workflow/models.
Par exemple, modifiez http://localhost:4502/editor.html/libs/settings/workflow/models/dam/update_asset.html en http://localhost:4502/editor.html/etc/workflow/models/dam/update_asset.html
Activez le mode d’édition dans l’éditeur de modèle de workflow pour copier la définition du modèle de workflow dans /conf/global/workflow/models.
Appuyez sur le bouton de synchronisation pour synchroniser les modifications avec le modèle de workflow d’exécution sous /var/workflow/models.
Exportez le modèle de workflow (/conf/global/workflow/models/<mod%C3%A8le-workflow>?lang=fr) et le modèle de workflow d’exécution (/var/workflow/models/<mod%C3%A8le-workflow>?lang=fr) et procédez à l’intégration dans le projet AEM.
Par exemple, exportez :
/conf/global/settings/workflow/models/dam/my_workflow_model et
/var/workflow/models/dam/my_workflow_model
Remarques
La résolution d’un modèle de workflow s’effectue dans l’ordre suivant :
/conf/global/settings/workflow/models
/libs/settings/workflow/models
/etc/workflow/models
Ainsi, toute personnalisation des modèles de workflow fournis par AEM et conservés à l’emplacement précédent doit être déplacée vers /conf/global/settings/workflow/models si elle doit être conservée, sinon elle sera remplacée par la définition du modèle de workflow fourni par AEM dans /libs/settings/workflow/models.
Instances de workflow
Emplacement précédent
/etc/workflow/instances
Nouveaux emplacements
/var/workflow/instances
Conseil de restructuration
Aucune action n’est requise pour s’aligner sur le nouvel emplacement.
Les instances de workflow historiques peuvent continuer à résider en toute sécurité à l’emplacement précédent. De nouvelles instances de workflow seront créées dans le nouvel emplacement.
Remarques
Toute référence de chemin explicite dans
le code
custom
vers l’emplacement précédent doit également prendre en compte le nouvel emplacement. Il est recommandé de refactoriser ce code pour utiliser les API de workflow AEM.
Lanceurs de workflow
Emplacement précédent
/etc/workflow/launcher/config
Nouveaux emplacements
/libs/settings/workflow/launcher/config
/conf/global/settings/workflow/launcher/config
Conseil de restructuration
Les lanceurs de workflow nouveaux ou modifiés doivent être migrés vers /conf/global/workflow/launcher/config.
Copiez les configurations nouvelles ou modifiées du lanceur de workflow de l’emplacement précédent dans un nouvel emplacement (/conf/global).
Remarques
La résolution du lanceur de workflow s’effectue dans l’ordre suivant :
/conf/global/settings/workflow/launcher
/libs/settings/workflow/launcher
/etc/workflow/launcher
Ainsi, toute personnalisation du lanceur de workflow fourni par AEM et conservée à l’emplacement précédent doit être déplacée vers le nouvel emplacement (/conf/global/settings/workflow/launcher si elle doit être conservée), sinon, elle sera remplacée par la définition du lanceur de workflow fourni par AEM dans /libs/settings/workflow/launcher.
Scripts de workflow
Emplacement précédent
/etc/workflow/scripts
Nouveaux emplacements
/libs/workflow/scripts
/apps/workflow/scripts
Conseil de restructuration
Les scripts de workflow nouveaux ou modifiés doivent être migrés vers le nouvel emplacement. Les modèles de workflow de référencement doivent être aussi mis à jour pour prendre en compte le nouvel emplacement.
Copiez les scripts de workflow nouveaux ou modifiés de l’emplacement précédent dans le nouvel emplacement.
/apps/workflow/scripts doit être conservé dans SCM.
Mettez à jour les références aux scripts de workflow à l’emplacement précédent dans les modèles de workflow pour pointer vers les nouveaux emplacements.
Remarques
AEM 6.4 SP1, à sa publication, permet de différer cette restructuration jusqu’à la mise à niveau vers la version 6.5
upgrade
.
Si vous effectuez une mise à niveau vers AEM 6.4 avant la publication d’AEM 6.4 SP1, cette restructuration doit être effectuée dans le cadre du projet de mise à niveau. Sans cela, la modification et l’enregistrement des étapes de workflow faisant référence aux scripts de l’emplacement précédent suppriment entièrement la référence de script de workflow de l’étape de workflow. Seuls les scripts de workflow situés dans de nouveaux emplacements sont disponibles dans la liste déroulante de sélection de script.
Avant de procéder à la mise à niveau vers une future version
Configurations ContextHub
Emplacement précédent
/etc/cloudsettings
Nouveaux emplacements
/libs/settings/cloudsettings
/conf/global/settings/cloudsettings
/conf/<tenant>/settings/cloudsettings
Conseil de restructuration
Les configurations ContextHub nouvelles ou modifiées doivent être migrées vers le nouvel emplacement. Les pages d’AEM Sites de référencement doivent être aussi mises à jour pour prendre en compte le nouvel emplacement.
Copiez les configurations ContextHub nouvelles ou modifiées de l’emplacement précédent dans le nouvel emplacement.
Associez les configurations AEM applicables aux hiérarchies de contenu AEM.
Hiérarchies des pages AEM Sites via AEM Sites > Page > Propriétés de la page > Onglet avancé > Configuration cloud.
Dissociez les anciennes configurations ContextHub migrées des hiérarchies de contenu AEM susmentionnées.
Remarques
S/O
Conceptions de services cloud classiques
Emplacement précédent
/etc/designs/cloudservices
Nouveaux emplacements
/libs/settings/wcm/designs/cloudservices
/apps/settings/wcm/designs/cloudservices
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.
Copiez les conceptions de l’emplacement précédent dans le nouvel emplacement (/apps).
Convertissez les ressources statiques, CSS et JavaScript dans la conception en bibliothèque cliente avec allowProxy = true.
Mettez à jour les références à l’emplacement précédent dans la propriété
cq
:
designPath
.
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).
Mettez à jour les règles de Dispatcher AEM pour activer le service des bibliothèques clientes via la servlet de 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
S/O
Conceptions de tableaux de bord classiques
Emplacement précédent
/etc/designs/dashboards
Nouveaux emplacements
/libs/settings/wcm/designs/dashboards
/apps/settings/wcm/designs/dashboards
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.
Copiez les conceptions de l’emplacement précédent dans le nouvel emplacement (/apps?lang=fr).
Convertissez les ressources statiques, CSS et JavaScript dans la conception en bibliothèque cliente avec allowProxy = true.
Mettez à jour les références à l’emplacement précédent dans la propriété
cq
:
designPath
.
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).
Mettez à jour les règles de Dispatcher AEM pour activer le service des bibliothèques clientes via la servlet de 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
S/O
Conceptions de rapports classiques
Emplacement précédent
/etc/designs/reports
Nouveaux emplacements
/libs/settings/wcm/designs/reports
/apps/settings/wcm/designs/reports
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.
Copiez les conceptions de l’emplacement précédent dans le nouvel emplacement (/apps?lang=fr).
Convertissez les ressources statiques, CSS et JavaScript dans la conception en bibliothèque cliente avec allowProxy = true.
Mettez à jour les références à l’emplacement précédent dans la propriété
cq
:
designPath
.
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).
Mettez à jour les règles de Dispatcher AEM pour activer le service des bibliothèques clientes via la servlet de 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
S/O
Conceptions par défaut
Emplacement précédent
/etc/designs/default
Nouveaux emplacements
/libs/settings/wcm/designs/default
/apps/settings/wcm/designs/default
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.
Copiez les conceptions de l’emplacement précédent dans le nouvel emplacement (/apps?lang=fr).
Convertissez les ressources statiques, CSS et JavaScript dans la conception en bibliothèque cliente avec allowProxy = true.
Mettez à jour les références à l’emplacement précédent dans la propriété
cq
:
designPath
.
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).
Mettez à jour les règles de Dispatcher AEM pour activer le service des bibliothèques clientes via la servlet de 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
S/O
Point d’entrée Javascript Adobe DTM
Emplacement précédent
/etc/clientlibs/dtm
Nouveaux emplacements
/var/cq/dtm/clientlibs
Conseil de restructuration
Aucune action requise.
L’emplacement précédent public fait office de point de terminaison proxy pour le nouvel emplacement privé.
Remarques
S/O
Point d’entrée Web-Hook Adobe DTM
Emplacement précédent
/etc/dtm-hook
Nouveaux emplacements
/var/cq/dtm/web-hook
Conseil de restructuration
Aucune action requise.
L’emplacement précédent public fait office de point de terminaison proxy pour le nouvel emplacement privé.
Remarques
S/O
Tâches de la boîte de réception
Emplacement précédent
/etc/taskmanagement
Nouveaux emplacements
/var/taskmanagement
Conseil de restructuration
Utilisez la tâche de maintenance de purge de la boîte de réception pour supprimer les anciennes tâches de l’emplacement précédent en cas de besoin.
Remarques
Aucune action n’est requise pour la migration des tâches vers le nouvel emplacement.
Les tâches présentes dans l’emplacement précédent restent disponibles et fonctionnelles.
De nouvelles tâches sont créées dans le nouvel emplacement.
Configurations de plans directeurs de Multi-site Manager
Emplacement précédent
/etc/blueprints
Nouveaux emplacements
/libs/msm
/apps/msm
Conseil de restructuration
Copiez les configurations personnalisées depuis /etc/blueprints vers /apps/msm.
Supprimez /etc/blueprints.
Remarques
S/O
Configurations du gadget de tableau de bord Projets AEM
Emplacement précédent
/etc/projects/dashboard/gadgets
Nouveaux emplacements
/libs/cq/core/content/projects/dashboard/gadgets
/apps/cq/core/content/projects/dashboard/gadgets
Conseil de restructuration
Les configurations de gadget de tableau de bord Projets AEM nouvelles ou modifiées doivent être migrées vers le nouvel emplacement (/apps).
Copiez les configurations de gadget de tableau de bord Projets AEM nouvelles ou modifiées de l’emplacement précédent dans le nouvel emplacement (/apps).
Ne copiez pas les configurations non modifiées, car elles existent maintenant dans le nouvel emplacement (/libs).
Mettez à jour les modèles Projets AEM faisant référence à l’emplacement précédent pour qu’ils pointent vers le nouvel emplacement approprié.
Remarques
Si le module de compatibilité AEM 6.4 est appliqué, il sera nécessaire d’exécuter les activités d’alignement des référentiels au moment de la suppression du module de compatibilité.
Toutes les balises doivent être migrées vers /content/cq:tags.
Copiez toutes les balises de l’emplacement précédent dans le nouvel emplacement.
Supprimez toutes les balises de l’emplacement précédent.
Dans la console Web AEM, redémarrez le lot OSGi Tagging Day Communique 5 à l’adresse https://serveraddress:serverport/system/console/bundles/com.day.cq.cq-tagging pour qu’AEM détermine que le nouvel emplacement contient du contenu et qu’il doit être utilisé.
Remarques
Le redémarrage du lot Day Communique Tagging OSGi n’enregistrera le nouvel emplacement comme racine de balise que si l’emplacement précédent est vide.
Les références à l’emplacement précédent continueront à fonctionner après la migration vers un nouvel emplacement pour toutes les fonctionnalités qui utilisent l’API TagManager d’AEM pour la résolution des balises.
Tout code personnalisé qui référence explicitement le chemin d’accès /etc/tags doit être remplacé par /content/
cq
:tags
, ou de préférence réécrit en utilisant l’API Java TagManager, en même temps que cette migration.
Les nouveaux services cloud de traduction doivent être migrés vers le nouvel emplacement (/apps, /conf/global ou /conf/<tenant>).
Migrez les configurations existantes de l’emplacement précédent vers le nouvel emplacement.
Recréez manuellement les nouvelles configurations des services de cloud de traduction via l’interface utilisateur de création d’AEM dans Outils > Services cloud > Services cloud de traduction. OU
Copiez les nouvelles configurations de services cloud de traduction de l’emplacement précédent dans le nouvel emplacement (/apps, /conf/global ou /conf/<tenant>).
Associez les configurations AEM applicables aux hiérarchies de contenu AEM.
Hiérarchies des pages AEM Sites via AEM Sites > Page > Propriétés de la page > Onglet avancé > Configuration cloud.
Hiérarchies de fragments d’expérience AEM via Fragments d’expérience AEM > Fragment d’expérience > Propriétés > Onglet Services cloud > Configuration cloud.
Hiérarchies des dossiers de fragments d’expérience AEM via Fragments d’expérience AEM > Dossier > Propriétés > Onglet Services cloud > Configuration cloud.
Hiérarchies des dossiers AEM Assets via AEM Assets > Dossier > Propriétés du dossier > Onglet Services cloud > Configuration.
Projets AEM via Projets AEM > Projet > Propriétés du projet > Onglet avancé > Configuration cloud.
Dissociez les anciens services cloud de traduction migrés des hiérarchies de contenu AEM mentionnées ci-dessus.
Remarques
La résolution des services cloud de traduction s’effectue dans l’ordre suivant :
Les services cloud de traduction migrés doivent être compatibles avec AEM 6.4.
Langues de traduction
Emplacement précédent
/etc/translation/supportedLanguages
Nouveaux emplacements
/libs/settings/translation/supportedLanguages
/apps/settings/translation/supportedLanguages
Conseil de restructuration
Les définitions de langue de traduction nouvelles ou modifiées requièrent une migration de toutes les définitions de langue de traduction vers le nouvel emplacement (/apps).
Si des ajouts ou des modifications ont été apportés aux définitions de langue de traduction, copiez toutes les définitions de langue de traduction dans le nouvel emplacement (/apps).
Remarques
La résolution du chemin de langue de traduction s’effectue dans l’ordre suivant :
/etc/translation/supportedLanguages
/apps/settings/translation/supportedLanguage
/libs/settings/translation/supportedLanguages
Cette résolution ne prend pas en charge de superposition de fusion, ce qui signifie que le chemin résolu doit contenir toutes les langues prises en charge et qu’il n’héritera pas des langues prises en charge des résolutions d’un ordre supérieur.
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.
Copiez les conceptions de l’emplacement précédent dans le nouvel emplacement (/apps?lang=fr).
Convertissez les ressources statiques, CSS et JavaScript dans la conception en bibliothèque cliente avec allowProxy = true.
Mettez à jour les références à l’emplacement précédent dans la propriété
cq
:
designPath
.
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).
Mettez à jour les règles de Dispatcher AEM pour activer le service des bibliothèques clientes via la servlet de 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
S/O
Console Web d’activation des arborescences
Emplacement précédent
/etc/replication/treeactivation
Nouveaux emplacements
/libs/replication/treeactivation
Conseils de restructuration
Aucune action requise.
Remarques
La console web d’activation des arborescences est maintenant disponible via Outils > Déploiement > Réplication > Activer l’arborescence.
Services cloud de connecteur de traduction de fournisseur
Les nouveaux services cloud de connecteur de traduction de fournisseur doivent être migrés vers le nouvel emplacement (/apps, /conf/global ou /conf/<tenant>).
Migrez les configurations existantes de l’emplacement précédent vers le nouvel emplacement.
Créez manuellement de nouvelles configurations de services cloud de connecteur de traduction de fournisseur via l’interface utilisateur de création AEM dans Outils > Services cloud > Services cloud de traduction. OU
Copiez les nouvelles configurations des services cloud de connecteur de traduction de fournisseur de l’emplacement précédent dans le nouvel emplacement (/apps, /conf/global ou /conf/<tenant>).
Associez les configurations AEM applicables aux hiérarchies de contenu AEM.
Hiérarchies des pages AEM Sites via AEM Sites > Page > Propriétés de la page > Onglet avancé > Configuration cloud.
Hiérarchies des fragments d’expérience AEM via Fragments d’expérience AEM > Fragment d’expérience > Propriétés > Onglet Services cloud > Configuration cloud.
Hiérarchies des dossiers de fragments d’expérience AEM via Fragments d’expérience AEM > Dossier > Propriétés > Onglet Services cloud > Configuration cloud.
Hiérarchies des dossiers AEM Assets via AEM Assets > Dossier > Propriétés du dossier > Onglet Services cloud > Configuration.
Projets AEM via Projets AEM > Projet > Propriétés du projet > Onglet avancé > Configuration cloud.
Dissociez les anciens services cloud de traduction migrés des hiérarchies de contenu AEM mentionnées ci-dessus.
Remarques
La résolution des services cloud de traduction s’effectue dans l’ordre suivant :
Les modèles d’e-mail de notification de workflow modifiés doivent être migrés vers le nouvel emplacement (/conf/global).
Copiez les modèles d’email de notification de workflow modifiés de l’emplacement précédent dans le nouvel emplacement.
Supprimez les modèles d’email de notification de workflow de l’emplacement précédent.
Remarques
La résolution du modèle d’e-mail de notification de workflow s’effectue dans l’ordre suivant :
/etc/workflow/notification
/conf/global/settings/workflow/notification
/libs/settings/workflow/notification
Packages de workflow
Emplacement précédent
/etc/workflow/packages
Nouveaux emplacements
/var/workflow/packages
Conseil de restructuration
Les packages de workflow existants dans l’emplacement précédent doivent être migrés vers le nouvel emplacement.
Supprimez les packages de workflow de l’emplacement précédent qui ne sont pas référencés par un autre contenu et qui ne sont pas requis.
Déplacez les packages de workflow de l’emplacement précédent qui ne sont pas référencés par un autre contenu, mais qui sont requis dans le nouvel emplacement.
Laissez tous les packages de workflow qui sont référencés par un autre contenu dans l’emplacement précédent.
Remarques
Les packages de workflow créés via la console Miscadmin de l’interface utilisateur classique sont conservés à l’emplacement précédent, tandis que tous les autres sont conservés dans le nouvel emplacement.
Les packages de workflow stockés dans les emplacements nouveaux ou précédents peuvent être gérés via la console Miscadmin de l’interface utilisateur classique.