DocumentationAEM 6.4Guide de déploiement

Restructurer les référentiels pour AEM Communities dans la version 6.4 repository-restructuring-for-aem-communities-in

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • Developer
CAUTION
AEM 6.4 a atteint la fin de la prise en charge étendue et cette documentation n’est plus mise à jour. Pour plus d’informations, voir notre période de support technique. Rechercher les versions prises en charge here.

Comme indiqué dans la page parent Restructuration des référentiels dans AEM 6.4, 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 nécessitent des efforts lors de la mise à niveau vers AEM 6.4, tandis que d’autres peuvent être différées jusqu’à une mise à niveau vers la version 6.5.

Avec la mise à niveau vers la version 6.4

Avant la mise à niveau vers la version 6.5

Avec la mise à niveau vers la version 6.4 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 mots-clés 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 la mise à niveau vers la version 6.5 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. Vous avez besoin d’entrées client sur le compartiment conf (global ou spécifique au site) que vous souhaitez utiliser pour votre site.

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

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

  1. Créez un compartiment contextuel de site à l’aide de la variable Explorateur de configuration under 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 de 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 au réseau social Facebook via l’interface utilisateur de création AEM à l’adresse Outils > Cloud Services > Configuration de la connexion 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 de 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 de 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
6a71a83d-c2e0-4ce7-a6aa-899aa3885b56