AEM 6.4 a atteint la fin de la prise en charge étendue et cette documentation n’est plus mise à jour. Pour plus d’informations, voir notre période de support technique. Rechercher les versions prises en charge here.
Comme indiqué dans la page parent Restructuration des référentiels dans AEM 6.4, les clients effectuant une mise à niveau vers AEM 6.4 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 de la mise à niveau vers AEM 6.4, tandis que d’autres peuvent être différées jusqu’à une mise à niveau vers la version 6.5.
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.4, comme ils existent dans l’emplacement précédent.
Modifiez le modèle de processus à l’aide de AEM’éditeur de modèle de processus sous AEM > Outils > Processus > Modèles.
Lors de la migration de modèles de processus fournis par AEM modifiés
Une fois l’éditeur de modèle de processus ouvert, modifiez l’URL de l’adresse du navigateur et 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 processus qui copiera la définition du modèle de processus dans /conf/global/workflow/models.
Appuyez sur le bouton Synchroniser pour synchroniser les modifications apportées au modèle de processus d’exécution sous /var/workflow/models.
Exportez le modèle de workflow (/conf/global/workflow/models/?lang=fr)<workflow-model>) et le modèle de processus d’exécution (/var/workflow/models/?lang=fr)<workflow-model>) et intégrer dans le projet AEM.
Par exemple, exporter :
/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 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 de modèle de workflow fournie 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, et 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 restructurer 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 et les modèles de workflow de référence mis à jour pour refléter le nouvel emplacement.
Copiez les scripts de workflow nouveaux ou modifiés de l’emplacement précédent vers 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. Sinon, la modification et l’enregistrement des étapes de workflow référençant des scripts à l’emplacement précédent supprime entièrement la référence du script de workflow de l’étape de workflow, et seuls les scripts de workflow dans de nouveaux emplacements seront disponibles dans la liste déroulante de sélection de script.
Avant la mise à niveau vers la version 6.5
Configurations ContextHub
Emplacement précédent
/etc/cloudsettings
Nouveaux emplacements
/libs/settings/cloudsettings
/conf/global/settings/cloudsettings
/conf/<tenant>/settings/cloudsettings
Conseil de restructuration
Toute configuration ContextHub nouvelle ou modifiée doit être migrée vers le nouvel emplacement et les pages AEM Sites de référencement doivent être mises à jour pour refléter le nouvel emplacement.
Copiez les configurations ContextHub nouvelles ou modifiées de l’emplacement précédent vers le nouvel emplacement.
Associez les configurations AEM applicables aux hiérarchies de contenu AEM.
Hiérarchies de page AEM Sites via AEM Sites > Page > Propriétés de page > Onglet avancé > Configuration cloud.
Dissociez les configurations ContextHub héritées migrées des hiérarchies de contenu AEM mentionnées ci-dessus.
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 du Dispatcher AEM pour autoriser le service des bibliothèques clientes via /etc.clientlibs/.. servlet proxy.
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 du Dispatcher AEM pour autoriser le service des bibliothèques clientes via /etc.clientlibs/.. servlet proxy.
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 du Dispatcher AEM pour autoriser le service des bibliothèques clientes via /etc.clientlibs/.. servlet proxy.
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 du Dispatcher AEM pour autoriser le service des bibliothèques clientes via /etc.clientlibs/.. servlet proxy.
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 public précédent agit comme un 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 public précédent agit comme un 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 fonctionnent.
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 package de compatibilité AEM 6.4 est appliqué, il sera nécessaire d'effectuer les activités d'alignement du référentiel au moment de la suppression du package de compatibilité.
Toutes les balises doivent être migrées vers /content/cq:tags.
Copiez toutes les balises de l’emplacement précédent vers 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 OSGi Day Communique Tagging n’enregistrera le nouvel emplacement en tant que 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 le nouvel emplacement pour toutes les fonctionnalités qui utilisent AEM API TagManager 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 de nouvelles configurations de Cloud Services de traduction via l’interface utilisateur de création AEM à l’adresse Outils > Cloud Services > Cloud Services 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 de page AEM Sites via AEM Sites > Page > Propriétés de page > Onglet avancé > Configuration cloud.
AEM des hiérarchies de fragments d’expérience via AEM Fragments d’expérience > Fragment d’expérience > Propriétés > Onglet Cloud Services > Configuration cloud.
AEM des hiérarchies de dossiers de fragments d’expérience via AEM Fragments d’expérience > Dossier > Propriétés > Onglet Cloud Services > 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 Cloud Services 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 une superposition de fusion, ce qui signifie que le chemin résolu doit contenir toutes les langues prises en charge et n’héritera pas des langues prises en charge de résolutions d’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 du Dispatcher AEM pour autoriser le service des bibliothèques clientes via /etc.clientlibs/.. servlet proxy.
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 de l’arborescence est désormais 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 Cloud Services de connecteur de traduction de fournisseur via le AEM l’interface utilisateur de création sous Outils > Cloud Services > Cloud Services 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 de page AEM Sites via AEM Sites > Page > Propriétés de page > Onglet avancé > Configuration cloud.
AEM des hiérarchies de fragments d’expérience via AEM Fragments d’expérience > Fragment d’expérience > Propriétés > Onglet Cloud Services > Configuration cloud.
AEM des hiérarchies de dossiers de fragments d’expérience via AEM Fragments d’expérience > Dossier > Propriétés > Onglet Cloud Services > 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’e-mail de notification de workflow modifiés de l’emplacement précédent vers le nouvel emplacement.
Supprimez les modèles d’e-mail de notification de workflow migrés 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 modules de workflow existants situés à 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 dans le cas contraire.
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 les packages de workflow qui sont référencés par un autre contenu à l’emplacement précédent.
Remarques
Les modules 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 au nouvel emplacement.
Les packages de workflow stockés aux emplacements précédents ou précédents peuvent être gérés via la console Miscadmin de l’interface utilisateur classique.