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

Comme décrit sur la page parent Restructuration du référentiel dans AEM 6.5, les clients qui effectuent la mise à niveau vers AEM 6.5 doivent utiliser cette page pour évaluer l'effort de travail associé aux modifications du référentiel qui affectent la solution AEM Assets. Certaines modifications nécessitent un effort de travail pendant le processus de mise à niveau 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 future

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 ultérieure

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 est /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 de courrier électronique.
    1. Si aucune mise à jour n'a été effectuée sur le 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 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 du répartiteur pour autoriser la diffusion 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 S/O

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 est /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 de courrier électronique.
    1. Si aucune mise à jour n'a été effectuée sur le 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 AEM 6.4.
Remarques Bien que /conf/global/settings/dam/workflownotification/email/downloadasset soit techniquement pris en charge pour la recherche (est prioritaire sur /apps par le biais de la recherche classique de données CAConfig Sling, 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 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 de courrier électronique mis à jour doit être copié de /etc/dam/adhocassetshare vers /apps/settings/dam/adhocassetshare.
    1. Comme la destination est /apps, cette modification doit être conservée dans SCM.
  2. Supprimez le dossier : /etc/dam/adhocassetshare après le déplacement des modèles de courrier électronique.
    1. Si aucune mise à jour n'a été effectuée sur le 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 AEM 6.4.
Remarques Bien que /conf/global/settings/dam/adhocassetshare soit techniquement pris en charge pour la recherche (elle prévaut avant /apps par le biais de la recherche habituelle de données CAConfig Sling, mais après /etc), le modèle peut être placé dans /conf/global/settings/dam/adhocassetshare. Toutefois, cette méthode n’est pas recommandée car il n’existe pas d’interface utilisateur d’exécution pour faciliter la modification du modèle de courrier électronique.

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. Copier tous les scripts personnalisés ou modifiés de /etc/dam/indesign/scripts vers /apps/settings/dam/indesign/scripts
    1. Seules les copies de scripts nouveaux ou modifiés en tant que 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 flux de travaux, mettez à jour les chemins d’accès 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 des chemins équivalents /apps ou /conf, selon le cas.

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

  1. Copier toutes les configurations vidéo modifiées de /etc/dam/video dans /apps/settings/dam/video
  2. Remove /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 noeud de /etc à /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 envoyée à /etc sera redirigée vers le contenu correct 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 toutes les références pour pointer vers les nouvelles ressources sous /libs à l'aide du préfixe proxy /etc.clientlibs/ allow.

Enfin, supprimez les dossiers des clientlibs migrés de /etc/clientlibs/foundation/

Remarques S/O

Sur cette page

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free