DocumentationAEM 6.5Guide de l’utilisateur

Restructuration des référentiels pour AEM Communities dans la version 6.5 repository-restructuring-for-aem-communities-in

Last update: Thu Apr 25 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Rubriques :

Créé pour :

  • Administration

Comme indiqué dans la page parent Restructuration des référentiels dans AEM 6.5, les clients effectuant une mise à niveau vers AEM 6.4 doivent utiliser cette page pour évaluer le travail associé aux modifications des référentiels ayant un impact sur la solution AEM Communities. 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 with-upgrade

Modèles de notification par e-mail e-mail-notification-templates

Emplacement précédent
/etc/community/notifications
Nouveaux emplacements
/libs/settings/community/notifications
Conseil de restructuration

Une migration manuelle est requise pour déplacer les configurations vers le nouvel emplacement sous « /apps/settings ». Vous pouvez utiliser le Gestionnaire de configuration Granite pour effectuer la migration.

Vous pouvez effectuer la migration en définissant la propriété mergeList sur true sur le nœud « /libs/settings/community/subscriptions » et en ajoutant un nœud enfant nt:unstructured.

Remarques
N/A

Configurations des abonnements subscription-configurations

Emplacement précédent
/etc/community/subscriptions
Nouveaux emplacements
/libs/settings/community/subscriptions
Conseil de restructuration

Une migration manuelle est requise pour déplacer les configurations vers le nouvel emplacement sous « /apps/settings ». Vous pouvez utiliser le Gestionnaire de configuration Granite pour effectuer la migration.

Vous pouvez effectuer la migration en définissant la propriété mergeList sur true sur le nœud « /libs/settings/community/subscriptions » et en ajoutant un nœud enfant nt:unstructured.

Remarques
N/A

Configurations des signaux watchwords-configurations

Emplacement précédent
/etc/watchwords
Nouveaux emplacements
/libs/community/watchwords
Conseil de restructuration

Une tâche de migration différée est disponible pour nettoyer les configurations de Communities.

La tâche déplace les mots-clés depuis /etc/watchwords vers /conf/global/settings/community/watchwords.

Si des mots-clés personnalisés sont stockés dans SCM, ils doivent être déployés sur /apps/settings/.... Vous devez en outre vérifier qu’aucune configuration de recouvrement /conf/global/settings/... prioritaire n’existe.

La tâche de migration supprime les emplacements /etc.

Remarques
N/A

Avant de procéder à la mise à niveau vers une future version prior-to-upgrade

Configurations des badges badging-configurations

Emplacement précédent
/etc/community/badging
Nouveaux emplacements

Règles de badge :

/libs/settings/community/badging

Images de badge :

Pour les images par défaut : /etc/community/badging/images are moved to /libs/community/badging/images

Pour les images personnalisées : /content/community/badging/images

Conseil de restructuration

La migration manuelle est requise.

Si votre instance a personnalisé les règles de badge/score, aucune méthode automatisée ne permet de placer toutes les règles dans un compartiment. Nécessite des entrées clientes sur le compartiment conf (global ou spécifique au site) à utiliser pour votre site.

Aucune interface utilisateur n’est disponible pour configurer le badge et la notation d’un site.

Pour aligner la structure du nouveau référentiel :

  1. Créez un compartiment contextuel de site à l’aide de la variable Explorateur de configuration dans Outils.
  2. Accédez à la racine du site.
  3. Définissez cq:confproperty sur le chemin du compartiment où vous souhaitez stocker tous vos paramètres. Le même résultat peut être obtenu par le biais de l’assistant de modification - Définir l’entrée de configuration du cloud.
  4. Déplacez les règles de badge et de score appropriées depuis /etc/community/* vers le compartiment contextuel de site créé à l’étape précédente.
  5. Ajustez les propriétés des règles de badge et de score à la racine du site pour avoir des références relatives aux nouveaux emplacements de règles.
    1. Par exemple, si la propriété est définie pour cq:conf = /conf/we-retail, alors badgingRules [] = community/badging/rules si les règles sont maintenant déplacées vers ce nouveau compartiment.
  6. De même, ajustez les références aux règles de score dans un nœud de règle de badge pour obtenir un chemin relatif.

Enfin, effectuez un nettoyage en supprimant la ressource /etc/community/badging

Remarques
N/A

Conceptions des consoles classiques de Communities classic-communities-console-designs

Emplacement précédent
/etc/designs/social/console
Nouveaux emplacements

/libs/settings/wcm/designs/social/console

/apps/settings/wcm/designs/social/console

Conseil de restructuration
S/O
Remarques
N/A

Configurations des connexions au réseau social Facebook facebook-social-login-configurations

Emplacement précédent
/etc/cloudservices/facebookconnect
Nouveaux emplacements

/conf/global/settings/cloudconfigs/facebookconnect

/conf/<tenant>/settings/cloudconfigs/facebookconnect

Conseil de restructuration

Toute nouvelle configuration du cloud Facebook doit être migrée vers le nouvel emplacement.

  1. Migrez les configurations existantes de l’emplacement précédent vers le nouvel emplacement.

    1. Recréez manuellement de nouvelles configurations de connexion sociale à Facebook via l’interface utilisateur de création d’AEM en suivant le chemin Outils > Cloud Services > Configurations des connexions au réseau social Facebook.
      ou
    2. Copiez toute nouvelle configuration de cloud Facebook depuis l’emplacement précédent dans le nouvel emplacement approprié, sous /conf/global or /conf/<tenant>.

  2. Mettez à jour n’importe quelle racine de site AEM Communities pour faire référence à la nouvelle configuration de connexion au réseau social Facebook en définissant la propriété [cq:Page]/jcr:content@cq:conf sur le chemin absolu dans le nouvel emplacement.

  3. Dissociez l’ancien service de cloud Facebook Connect des racines de site AEM Communities mises à jour pour faire référence au nouvel emplacement.

Remarques
N/A

Configurations des options linguistiques language-options-configurations

Emplacement précédent
/etc/social/config/languageOpts
Nouveaux emplacements
/libs/social/translation/languageOpts
Conseil de restructuration
N/A
Remarques
N/A

Configurations des connexions au réseau social Pinterest pinterest-social-login-configurations

Emplacement précédent
/etc/cloudservices/pinterestconnect
Nouveaux emplacements

/conf/global/settings/cloudconfigs/pinterestconnect

/conf/<tenant>/settings/cloudconfigs/pinterestconnect

Conseil de restructuration

Toute nouvelle configuration du cloud Pinterest doit être migrée vers le nouvel emplacement.

  1. Migrez les configurations existantes de l’emplacement précédent vers le nouvel emplacement.

    1. Recréez manuellement les nouvelles configurations des connexions au réseau social Pinterest via l’interface utilisateur de création AEM dans Outils > Services cloud > Configuration de la connexion au réseau social Pinterest.
      ou
    2. Copiez toute nouvelle configuration de cloud Pinterest depuis l’emplacement précédent vers le nouvel emplacement approprié sous /conf/global or /conf/<tenant>.

  2. Mettez à jour toute racine de site AEM Communities pour faire référence à la nouvelle configuration de connexion du réseau social Pinterest en définissant la propriété [cq:Page]/jcr:content@cq:conf sur le chemin absolu dans le nouvel emplacement.

  3. Dissociez l’ancien service de cloud Pinterest Connect des racines de site AEM Communities mises à jour pour faire référence au nouvel emplacement.

Remarques
N/A

Configurations des scores scoring-configurations

Emplacement précédent
/etc/community/scoring
Nouveaux emplacements
/libs/settings/community/scoring
Conseil de restructuration

Pour s’aligner sur la nouvelle structure de référentiel, les règles de score peuvent être stockées dans /apps/settings/ ou /conf/.../settings

  1. Pour /apps/settings, cela agit comme règles globales ou par défaut gérées dans SCM.

Créez des configurations selon le contexte dans /conf/ à l’aide de CRXDELite :

  1. Créez des configurations à l’/conf/.../settingsemplacement
    souhaité.
  2. La propriété cq:conf doit être définie pour le site Communities.
    1. Si aucune propriété cq:conf n’est définie, les règles de score sont directement lues à partir du chemin donné pour la propriété ’scoringRules’ au nœud racine du site, par exemple : /content/we-retail/us/en/community/jcr:content

Nettoyage : supprime la ressource. /etc/community/scoring

Remarques
N/A

Configurations des connexions au réseau social Twitter twitter-social-login-configurations

Emplacement précédent
/etc/cloudservices/twitterconnect
Nouveaux emplacements

/conf/global/settings/cloudconfigs/twitterconnect

/conf/<tenant>/settings/cloudconfigs/twitterconnect

Conseil de restructuration

Toute nouvelle configuration du cloud Twitter doit être migrée vers le nouvel emplacement.

  1. Migrez les configurations existantes de l’emplacement précédent vers le nouvel emplacement.

    1. Recréez manuellement les nouvelles configurations des connexions au réseau social Twitter via l’interface utilisateur de création d’AEM sous Outils > Services cloud > Configuration de la connexion au réseau social Twitter.
      ou
    2. Copiez toute nouvelle configuration de cloud Twitter de l’emplacement précédent dans le nouvel emplacement approprié, sous /conf/global or /conf/<tenant>.

  2. Mettez à jour toute racine de site AEM Communities pour faire référence à la nouvelle configuration de connexion du réseau social Twitter en définissant la propriété [cq:Page]/jcr:content@cq:conf sur le chemin absolu dans le nouvel emplacement.

  3. Dissociez l’ancien service de cloud Twitter Connect des racines du site AEM Communities mises à jour pour faire référence au nouvel emplacement.

Remarques
N/A

Divers misc

Emplacement précédent
/etc/community/templates
Nouveaux emplacements
/libs/settings/community/templates
Conseil de restructuration

Adobe a fourni un utilitaire de migration à l’adresse suivante :

https://github.com/Adobe-Marketing-Cloud/aem-communities-ugc-migration/tree/master/bundles/communities-template-migration

Remarques
Les modèles personnalisés existants sont déplacés vers /conf/global/settings/community/template/<groups/sites/functions>
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2