Show Menu
SUJETS×

Restructuration des référentiels dans AEM 6.5

Présentation

Avant AEM 6.4, le code client était déployé dans des zones imprévisibles du JCR susceptibles d’être modifiées lors des mises à niveau. C’est pourquoi il était courant que les versions formelles d’AEM remplacent le code, la configuration ou le contenu personnalisé. En outre, les modifications apportées aux clients remplaçaient parfois le code ou le contenu du produit AEM, annulant les fonctionnalités du produit.
Il est possible d’éviter ces conflits en définissant clairement les hiérarchies applicables au code du produit AEM et au code client.
À cette fin, à partir d’AEM 6.4 et pour être poursuivi dans les versions ultérieures, le contenu est restructuré depuis /etc vers d’autres dossiers du référentiel, ainsi que des directives sur le contenu à l’emplacement, en respectant les règles de haut niveau suivantes :
  • Le code de produit AEM sera toujours placé dans /libs, qui ne peut pas être écrasé par du code personnalisé.
  • Le code personnalisé doit être placé dans /apps, /content et /conf

Impact sur les mises à niveau vers le version 6.5

Lors de la mise à niveau vers AEM 6.5, un sous-ensemble important du contenu sous /etc sera dupliqué dans d’autres dossiers du référentiel. Ces nouveaux emplacements sont les emplacements favoris dans lesquels le contenu est référencé. Cependant, tout a été mis en œuvre pour que la mise à niveau d’AEM 6.5 soit rétrocompatible avec les emplacements précédents du dossier /etc. Ainsi, dans la plupart des cas, les anciens emplacements continueront à être référencés par le code AEM jusqu’à ce que les modifications soient activement - et dans de nombreux cas manuellement - créées dans l’application d’un client. Du point de vue de la chronologie, il existe deux catégories de modifications :
  • Avec la mise à niveau vers la version 6.5 : quelques modifications de restructuration /etc ne sont pas compatibles avec les versions antérieures. Par conséquent, les modifications doivent être planifiées et implémentées dans le cadre de la mise à niveau d’AEM 6.5.
  • Avant la prochaine mise à niveau - la grande majorité des modifications de la restructuration de /etc peuvent être reportées jusqu'à un certain temps dans le futur après la mise à niveau. Comme mentionné précédemment, le code AEM 6.5 continuera à faire référence aux anciens emplacements jusqu’à ce que les modifications soient implémentées dans le cadre d’une version client. Bien qu’il n’y ait pas de calendrier forcé pour lequel les modifications doivent être apportées, il est recommandé de les faire avant la prochaine mise à niveau, car les futures fonctionnalités peuvent dépendre des nouveaux emplacements référencés. De plus, par convention, la documentation relative à une fonctionnalité donnée référencera les nouveaux emplacements. Cela pourrait donc prêter à confusion si les anciens emplacements sont toujours utilisés.

Restructuring Guidance

Lors de la planification d’une mise à niveau vers AEM 6.5, les pages suivantes par solution doivent être référencées afin d’évaluer le travail :
Chaque page contient deux sections correspondant à l’urgence des modifications nécessaires. Tout élément de la section « Avec la mise à niveau vers la version 6.5 » doit être traité dans le cadre du projet de mise à niveau d’AEM 6.5. Tout ce qui se trouve sous la section "Avant la mise à niveau future" peut éventuellement être reporté à une mise à niveau ultérieure.
Chaque entrée de la page comprend un champ "Guide de restructuration", qui détaille la stratégie technique recommandée pour s'aligner sur le nouveau modèle de référentiel 6.5 afin que les nouveaux emplacements soient référencés pour le contenu situé précédemment sous le dossier /etc. Un champ supplémentaire « Remarques » fournit un contexte utile.