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

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

Avec la mise à niveau vers la version 6.5

Avant la mise à niveau ultérieure

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

Avant la mise à niveau future

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 de courrier électronique /libs/settings/dam/notification doit être copié de /etc/notification/email/default vers /apps/settings/notification/email/default
    1. Comme 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'email à l'intérieur.
    1. Si aucune mise à jour n’a été apportée au modèle de courrier électronique sous /etc/notification/email/default, le dossier peut être supprimé, car le modèle de courrier électronique 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 une 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 DAM > Page de partage des actifs > 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 des 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 de courrier électronique mis à jour doit être copié de /etc/dam/workflow/notification/email/downloadasset vers /apps/settings/dam/workflow/notification/email/downloadasset
    1. Comme 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’email à l’intérieur.
    1. Si aucune mise à jour n’a été apportée au modèle de courrier électronique sous /etc, le dossier peut être supprimé, car le modèle de courrier électronique 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 techniquement pris en charge pour la recherche (est prioritaire avant /apps via la recherche habituelle Sling CAConfig, mais après /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
Conseil de restructuration N/A
Remarques N/A
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 de courrier électronique mis à jour doit être copié de /etc/dam/adhocassetshare vers /apps/settings/dam/adhocassetshare
    1. Comme 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'email à l'intérieur.
    1. Si aucune mise à jour n’a été apportée au modèle de courrier électronique sous /etc, le dossier peut être supprimé, car le modèle de courrier électronique 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 (elle est prioritaire avant /apps par l’intermédiaire de la recherche habituelle de configuration CAConfig Sling, mais après /etc), le modèle peut être placé dans /conf/global/settings/dam/adhocassetshare. Toutefois, cela n’est pas recommandé, car il n’existe pas d’interface utilisateur 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 de /etc/dam/indesign/scripts vers /apps/settings/dam/indesign/scripts
    1. Seuls les scripts nouveaux ou modifiés copiés comme 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 de processus, mettez à jour les chemins dans la configuration afin qu’ils pointent explicitement vers les scripts appropriés sous /apps/settings/dam/indesign/scripts ou /libs/settings/dam/indesign/scripts, selon le cas.
  3. Supprimez entièrement /etc/dam/indesign/scripts.
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 sous les chemins /apps ou /conf équivalents, le cas échéant.

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

  1. Copiez toutes les configurations vidéo modifiées de /etc/dam/video vers /apps/settings/dam/video
  2. Remove /etc/dam/video
Remarques N/A

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 devrez exécuter un script de migration pour déplacer le noeud 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 que vous n’avez pas à ajuster leur code copyURL/embed pour pointer vers /conf. La requête existante vers /etc sera redirigée vers le contenu correct à partir de /conf.

Remarques N/A

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 toutes les références pour pointer vers les nouvelles ressources sous /libs à l’aide du préfixe /etc.clientlibs/ allow proxy.

Enfin, effectuez un nettoyage en supprimant les dossiers des bibliothèques clientes migrées depuis /etc/clientlibs/foundation/

Remarques N/A

Sur cette page