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

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 sur la solution AEM Assets. 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.

Avec la mise à niveau vers la version 6.5

Avant de procéder à la mise à niveau vers une future version

Avec la mise à niveau vers la version 6.5

Divers

Emplacement précédent /etc/dam/jobs
Nouveaux emplacements /var/dam/jobs
Conseil de restructuration

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.

Remarques S/O

Avant de procéder à la mise à niveau vers une future version

Modèle de notification par e-mail d’événement de ressource/collection

Emplacement précédent /etc/notification/email/default
Nouveaux emplacements

/libs/settings/dam/notification

/apps/settings/dam/notification

Conseil de restructuration

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.
Remarques N/A

Conceptions classiques de partage de ressources

Emplacement précédent /etc/designs/assetshare
Nouveaux emplacements

/libs/settings/wcm/designs/assetshare

/apps/settings/wcm/designs/assetshare

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, 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 Bibliothèque cliente. Cela nécessite la mise à jour du code de mise en oeuvre 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.

Remarques N/A

Modèle de notification par e-mail de téléchargement de ressource

Emplacement précédent /etc/dam/workflow/notification/email/downloadasset
Nouveaux emplacements

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

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

Conseil de restructuration

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.
Remarques Bien que /conf/global/settings/dam/workflownotification/email/downloadasset soit pris en charge techniquement (avec la priorité sur /apps via la recherche habituelle Sling CAConfig/etc), le modèle peut être placé dans /conf/global/settings/dam/workflownotification/email/downloadasset. Cependant, cela n’est pas recommandé car il n’y a pas d’IU d’exécution pour faciliter la modification du modèle d’e-mail.

Exemple de licences DRM

Emplacement précédent /etc/dam/drm/licenses/
Nouveaux emplacements /libs/settings/dam/drm
Conseils de restructuration S/O
Remarques S/O
Emplacement précédent /etc/dam/adhocassetshare
Nouveaux emplacements

/libs/settings/dam/adhocassetshare

/apps/settings/dam/adhocassetshare

Conseil de restructuration

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.
Remarques Bien que /conf/global/settings/dam/adhocassetshare soit techniquement pris en charge pour la recherche (il est prioritaire par rapport à /apps dans la recherche habituelle Sling CAConfig, mais passe après /etc), le modèle peut être placé dans /conf/global/settings/dam/adhocassetshare. Cependant, cela n’est pas recommandé car il n’y a pas d’IU d’exécution pour faciliter la modification du modèle d’e-mail.

Scripts de workflow InDesign

Emplacement précédent /etc/dam/indesign/scripts
Nouveaux emplacements

/libs/settings/dam/indesign

/apps/settings/dam/indesign

Conseil de restructuration

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.
Remarques Il est recommandé de stocker les scripts personnalisés sous /apps, car il s’agit de l’emplacement où le code doit être stocké.

Configurations de transcodage vidéo

Emplacement précédent /etc/dam/video
Nouveaux emplacements

/libs/settings/dam/video

/apps/settings/dam/video

Conseil de restructuration

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
Remarques S/O

Configurations des paramètres prédéfinis de la visionneuse

Emplacement précédent /etc/dam/presets/viewer
Nouveaux emplacements

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

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

Conseil de restructuration

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.

Remarques S/O

Divers

Emplacement précédent

/etc/clientlibs/foundation/asseteditor

/etc/clientlibs/foundation/assetshare

/etc/clientlibs/foundation/assetinsights

Nouveaux emplacements /libs/dam/clientlibs
Conseil de restructuration

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/

Remarques N/A

Sur cette page