Restructuration des référentiels d’Assets dans AEM 6.5

Si du code personnalisé dépend de cet emplacement (par exemple, le code repose explicitement sur ce chemin), il doit être mis à jour pour utiliser le nouvel emplacement avant de procéder à la mise à niveau. Idéalement, les API Java sont utilisées lorsqu’elles sont disponibles pour limiter les dépendances sur un chemin spécifique dans JCR.

Emplacement temporaire pour contenir le fichier zip à télécharger par le client. Il n’est pas nécessaire d’effectuer une mise à jour, car lorsque le client demande de télécharger la ressource, il génère un fichier au nouvel emplacement.

/libs/settings/dam/notification

/apps/settings/dam/notification

Si les modèles d’e-mail ont été modifiés par le client, effectuez les actions suivantes afin de vous aligner sur la nouvelle structure de référentiel :

1. Le modèle d’e-mail /libs/settings/dam/notification doit être copié à partir de /etc/notification/email/default vers /apps/settings/notification/email/default.
   1. Étant donné que la destination se trouve dans /apps, cette modification doit être conservée dans SCM.
2. Supprimez le dossier /etc/dam/notification/email/default après le déplacement des modèles d’e-mail qu’il contient.
   
   1. Si aucune mise à jour n’a été apportée au modèle d’e-mail sous //etc/notification/email/default, le dossier peut être supprimé car le modèle d’e-mail d’origine existe sous /libs/settings/notification/email/default dans le cadre de l’installation d’AEM 4.

/libs/settings/wcm/designs/assetshare

/apps/settings/wcm/designs/assetshare

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, effectuez les actions suivantes pour vous aligner sur le dernier modèle :

1. Copiez les conceptions de l’emplacement précédent vers le nouvel emplacement sous /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 > Administrateur de gestion des ressources numériques > Page de partage des ressources > Propriétés de la 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 de Dispatcher pour autoriser le service de bibliothèques clientes via la servlet proxy /etc.clientlibs/.

Pour les conceptions qui ne sont pas 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.

/libs/settings/dam/workflownotification/email/downloadasset

/apps/settings/dam/workflownotification/email/downloadasset

Si les modèles d’e-mail (downloadasset ou transientworkflowcompleted) ont été modifiés, suivez la procédure ci-dessous pour vous aligner sur la nouvelle structure :

1. Le modèle d’e-mail mis à jour doit être copié depuis /etc/dam/workflow/notification/email/downloadasset dans /apps/settings/dam/workflow/notification/email/downloadasset.
   1. Étant donné que la destination se trouve dans /apps, cette modification doit être conservée dans SCM.
2. Supprimez le dossier /etc/dam/workflow/notification/email/downloadasset après le déplacement des modèles d’e-mail qu’il contient.
   
   1. Si aucune mise à jour n’a été apportée au modèle d’e-mail sous //etc, le dossier peut être supprimé car le modèle d’e-mail d’origine existe sous /libs/settings/dam/workflownotification/email/downloadasset dans le cadre de l’installation d’AEM 6.4.

/libs/settings/dam/adhocassetshare

/apps/settings/dam/adhocassetshare

Si le modèle d’e-mail a été modifié par le client, alignez-le sur la nouvelle structure de référentiel :

1. Le modèle d’e-mail mis à jour doit être copié depuis /etc/dam/adhocassetshare dans /apps/settings/dam/adhocassetshare.
   1. Étant donné que la destination se trouve dans /apps, cette modification doit être conservée dans SCM.
2. Supprimez le dossier /etc/dam/adhocassetshare après le déplacement des modèles d’e-mail qu’il contient.
   
   1. Si aucune mise à jour n’a été apportée au modèle d’e-mail sous //etc, le dossier peut être supprimé car le modèle d’e-mail d’origine existe sous /libs/settings/dam/adhocassetshare dans le cadre de l’installation d’AEM 6.4.

/libs/settings/dam/indesign

/apps/settings/dam/indesign

Pour s’aligner sur la nouvelle structure de référentiel :

1. Copiez tous les scripts personnalisés ou modifiés depuis /etc/dam/indesign/scripts vers /apps/settings/dam/indesign/scripts
   .
   1. Copiez uniquement les scripts nouveaux ou modifiés, car les scripts non modifiés fournis par AEM seront disponibles via /libs/settings dans AEM 6.5.
2. Recherchez tous les modèles de workflow qui utilisent l’étape de workflow Processus d’extraction de médias et
   1. pour chaque instance de l’étape du workflow, mettez à jour les chemins de config pour qu’ils pointent explicitement vers les scripts appropriés sous //apps/settings/dam/indesign/scripts ou /libs/settings/dam/indesign/scripts, selon vos besoins.
3. Supprimez /etc/dam/indesign/scripts entièrement.

/libs/settings/dam/video

/apps/settings/dam/video

Les personnalisations au niveau du projet doivent être coupées et collées dans des chemins /apps ou /conf équivalents.

Pour vous aligner sur la structure de référentiel AEM 6.4 :

1. Copiez toutes les configurations vidéo modifiées depuis /etc/dam/video vers /apps/settings/dam/video
2. Supprimez /etc/dam/video

/libs/settings/dam/dm/presets/viewer

/conf/global/settings/dam/dm/presets/viewer

Les paramètres prédéfinis prêts à l’emploi de la visionneuse ne seront disponibles que dans le nouvel emplacement.

Pour les paramètres prédéfinis personnalisés de la visionneuse :

• vous devez exécuter un script de migration pour déplacer le nœud de /etc vers /conf. Le script se trouve à l’adresse https://serveraddress:serverport/libs/settings/dam/dm/presets.migratedmcontent.json
• ou vous pouvez modifier la configuration pour qu’ils soient enregistrés automatiquement au nouvel emplacement.

Notez qu’il n’est pas nécessaire d’ajuster leur code copyURL/embed pour pointer vers /conf. La requête existante vers /etc sera réacheminée vers le contenu correct à partir de /conf.

/etc/clientlibs/foundation/asseteditor

/etc/clientlibs/foundation/assetshare

/etc/clientlibs/foundation/assetinsights

Ajustez les références pour pointer vers les nouvelles ressources sous /libs à l’aide de /etc.clientlibs/.

Enfin, procédez à un nettoyage en supprimant les dossiers des clientlibs migrés depuis /etc/clientlibs/foundation/