Comme décrit sur 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 nécessitent des efforts lors du processus de mise à niveau d’AEM 6.5, tandis que d’autres peuvent être différées jusqu’à une mise à niveau ultérieure.
Depuis AEM 6.4, il n’existe plus de configuration ContextHub par défaut. Par conséquent, au niveau racine du site, une valeur cq:contextHubPathproperty doit être définie 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.
En outre, sur la configuration ContextHub, la valeur sling:resourceType doit être mise à jour pour être relative et non absolue.
Ouvrez les propriétés du noeud de configuration ContextHub dans CRX DE Lite, par exemple : /apps/settings/cloudsettings/legacy/contexthub
Remplacer sling:resourceType de /libs/granite/contexthub/cloudsettings/components/baseconfiguration par 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 à 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 :
/config/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 produit 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
de 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
Par conséquent, toute personnalisation du lanceur de workflow fourni par AEM et conservé à l’emplacement précédent doit être déplacée vers le nouvel emplacement (/conf/global/settings/workflow/launcher si elles doivent être conservées, sinon elles seront remplacées 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
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 la mise à niveau future
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
N/A
Conceptions de services cloud classiques
Emplacement précédent
/etc/designs/cloudservices
Nouveaux emplacements
/libs/settings/wcm/designs/cloudservices
/apps/settings/wcm/designs/cloudservices
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.
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 une bibliothèque cliente avec allowProxy = true.
Mettez à jour les références à l’emplacement précédent dans la balise
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
N/A
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
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.
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 une bibliothèque cliente avec allowProxy = true.
Mettez à jour les références à l’emplacement précédent dans le
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
N/A
Conceptions de rapports classiques
Emplacement précédent
/etc/designs/reports
Nouveaux emplacements
/libs/settings/wcm/designs/reports
/apps/settings/wcm/designs/reports
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.
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 une bibliothèque cliente avec allowProxy = true.
Mettez à jour les références à l’emplacement précédent dans le
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
N/A
Conceptions par défaut
Emplacement précédent
/etc/designs/default
Nouveaux emplacements
/libs/settings/wcm/designs/default
/apps/settings/wcm/designs/default
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.
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 une bibliothèque cliente avec allowProxy = true.
Mettez à jour les références à l’emplacement précédent dans le
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
N/D
Point de terminaison 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
N/A
Point de terminaison 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
N/A
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 Blueprint de Multi-site Manager
Emplacement précédent
/etc/blueprints
Nouveaux emplacements
/libs/msm
/apps/msm
Conseil de restructuration
Copiez les configurations personnalisées de /etc/blueprints vers /apps/msm.
Remove /etc/blueprints.
Remarques
N/A
Configurations du gadget de tableau de bord AEM Projects
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 AEM Projects nouveaux ou modifiées doivent être migrées vers le nouvel emplacement (/apps).
Copiez les configurations de gadget de tableau de bord AEM Projects 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 AEM Projects 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.
Par l’intermédiaire de la console web AEM, redémarrez le lot OSGi Day Communique 5 Tagging à l’adresse https://serveraddress:serverport/system/console/bundles/com.day.cq.cq-tagging pour qu’AEM reconnaisse que le nouvel emplacement contient du contenu et 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 /etc/tags doit être mis à jour vers /content/
cq
:tags
, ou de préférence réécrit pour utiliser l’API Java TagManager, en même temps que cette migration.
Tous les nouveaux Cloud Services 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 Cloud Services de traduction de l’emplacement précédent vers 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 Cloud Services > Configuration.
AEM Projets via AEM Projets > Projet > Propriétés du projet > Onglet Avancé > Configuration du 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
Toute définition de langue de traduction nouvelle ou modifiée nécessite 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 une bibliothèque cliente avec allowProxy = true.
Mettez à jour les références à l’emplacement précédent dans le
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
N/A
Console web d’activation des arborescences
Emplacement précédent
/etc/replication/treeactivation
Nouveaux emplacements
/libs/replication/treeactivation
Conseil 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 Cloud Services du 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 de Cloud Services du connecteur de traduction de fournisseur de l’emplacement précédent vers 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 Cloud Services > Configuration.
AEM Projets via AEM Projets > Projet > Propriétés du projet > Onglet Avancé > Configuration du 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’email 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’email 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.