Restructuration des référentiels d’Assets dans AEM 6.5 assets-repository-restructuring-in-aem

Comme indiqué dans la page parent Restructuration des référentiels dans AEM 6.5, les clients et clientes 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 la future mise à niveau

Avec la mise à niveau vers la version 6.5 with-upgrade

Divers misc

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

Si du code personnalisé dépend de cet emplacement (c’est-à-dire que le code s’appuie explicitement sur ce chemin), le code doit être mis à jour pour utiliser le nouvel emplacement avant la mise à niveau. Idéalement, les API Java™ sont utilisées lorsqu’elles sont disponibles pour réduire les dépendances sur un chemin spécifique dans le JCR.

Emplacement temporaire pour contenir un fichier compressé à 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 la future mise à niveau prior-to-upgrade

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

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

/libs/settings/dam/notification

/apps/settings/dam/notification

Conseils de restructuration

Si les modèles d’e-mail ont été modifiés par le client ou la cliente, 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 classic-asset-share-designs

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

/libs/settings/wcm/designs/assetshare

/apps/settings/wcm/designs/assetshare

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, 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 tous les fichiers CSS, JavaScipt et les ressources statiques 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 de gestion des ressources numériques > Page de partage des ressources > Propriétés de la page > Onglet avancé > Champ de conception.
  4. Pour utiliser la nouvelle catégorie Bibliothèque cliente, mettez à jour toutes les pages faisant référence à l’emplacement précédent. Cela nécessite de mettre à jour du code d’implémentation de la page.
  5. Mettez à jour les règles de Dispatcher afin de pouvoir autoriser le service des bibliothèques clientes via le servlet de 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 le créateur ou la créatrice en dehors de /etc.

Remarques
N/A

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

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

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

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

Conseils 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 pour la recherche (il est prioritaire par rapport à /apps via la recherche habituelle Sling CAConfig, mais passe 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’interface utilisateur d’exécution pour faciliter la modification du modèle d’e-mail.

Exemple de licences DRM example-drm-licenses

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 indesign-workflow-scripts

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 video-transcoding-configurations

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

/libs/settings/dam/video

/apps/settings/dam/video

Conseils 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

Configuration des paramètres prédéfinis de la visionneuse viewer-preset-configurations

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

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

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

Conseils de restructuration

Le paramètre prédéfini de visionneuse prêt à l’emploi n’est disponible que dans le nouvel emplacement.

Pour le paramètre prédéfini de visionneuse personnalisé :

  • Exécutez un script de migration afin de pouvoir 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.
  • Vous pouvez également modifier la configuration. L’enregistrement est automatiquement effectué au nouvel emplacement.

Vous n’avez pas besoin d’ajuster le 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 misc2

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
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2