Configuration de la synchronisation de Live Copies

Adobe Experience Manager fournit un certain nombre de configurations de synchronisation prêtes à l’emploi. Avant d’utiliser les Live Copies, tenez compte des points suivants pour définir comment et quand les Live Copies sont synchronisées avec leur contenu source.

  1. Déterminer si les configurations de déploiement existantes répondent à vos besoins
  2. Si les configurations de déploiement existantes ne le font pas, décidez si vous devez créer les vôtres.
  3. Spécifiez les configurations de déploiement à utiliser pour vos Live Copies.

Configurations du déploiement installées et personnalisées

Cette section contient des informations sur les configurations du déploiement installées et les actions de synchronisation qu’elles utilisent, ainsi que sur la création de configurations personnalisées, si nécessaire.

ATTENTION

Il n'est pas recommandé de mettre à jour ou de modifier une configuration de déploiement prête à l'emploi mais. Si une action active personnalisée est requise, elle doit être ajoutée dans une configuration de déploiement personnalisée.

Déclencheurs de déploiement

Chaque configuration du déploiement utilise un déclencheur qui entraîne la survenue du déploiement. Il peut s’agir de l’un des déclencheurs suivants :

  • Au déploiement : La ​commande de déploiement est utilisée sur la page d’impression bleue ou la commande de ​synchronisation est utilisée sur la page Live Copy.
  • En cas de modification : la page source est modifiée.
  • En cas d’activation : la page source est activée.
  • En cas de désactivation : la page source est désactivée.
REMARQUE

L'utilisation du déclencheur On Modification peut avoir un impact sur les performances. Pour plus d’informations, voir Meilleures pratiques MSM.

Configurations du déploiement

Le tableau suivant liste les configurations de déploiement prêtes à l'emploi avec AEM. Le tableau contient les actions de déclenchement et de synchronisation de chaque configuration du déploiement.

Nom Description Déclencheur Actions de synchronisation
Configuration de déploiement standard Configuration du déploiement standard qui permet de démarrer le processus de déploiement à partir d’un déclencheur de déploiement et d’actions d’exécutions : créer, mettre à jour, supprimer le contenu et trier les nœuds enfants En cas de déploiement contentUpdate
contentCopy
contentDelete
referencesUpdate
productUpdate
orderChildren
Activer au moment de l’activation du plan directeur Publie la Live Copy lorsque la source est publiée En cas d’activation targetActivate
Désactiver au moment de la désactivation du plan directeur Désactive la Live Copy lorsque la source est désactivée Lors de la désactivation targetDeactivate
Pousser au moment de la modification Envoie le contenu à la Live Copy lorsque la source est modifiée
Utilisez cette configuration de déploiement avec parcimonie car elle utilise le déclencheur Lors de la modification.
En cas de modification contentUpdate
contentCopy
contentDelete
referencesUpdate
orderChildren
Pousser au moment de la modification (peu profond) Envoie le contenu à la copie dynamique lors de la modification de la page du plan directeur, sans mettre à jour les références (par exemple pour les copies superficielles)
Utilisez cette configuration de déploiement avec parcimonie car elle utilise le déclencheur Lors de la modification.
En cas de modification contentUpdate
contentCopy
contentDelete
orderChildren
Convertir le lancement Configuration de déploiement standard pour la promotion des pages de lancement. En cas de déploiement contentUpdate
contentCopy
contentDelete
referencesUpdate
orderChildren
markLiveRelationship

Actions de synchronisation

Le tableau suivant liste les actions de synchronisation prêtes à l’emploi avec AEM.

Nom de l’action Description Propriétés
contentCopy Lorsque les noeuds de la source n’existent pas dans Live Copy, cette action copie les noeuds dans Live Copy. Configurez le service Action de copie de contenu MSM de CQ afin de spécifier les types de noeud, les éléments de paragraphe et les propriétés de page à exclure.
contentDelete Cette action supprime les noeuds de Live Copy qui n’existent pas sur la source. Configurez le service de suppression d’action de contenu MSM CQ pour spécifier les types de noeud, les éléments de paragraphe et les propriétés de page à exclure.
contentUpdate Cette action met à jour le contenu Live Copy avec les modifications de la source. Configurez le service Action de mise à jour de contenu MSM de CQ afin de spécifier les types de noeud, les éléments de paragraphe et les propriétés de page à exclure.
editProperties Cette action modifie les propriétés de la Live Copy. La propriété editMap détermine quelles propriétés sont modifiées et leur valeur. La valeur de la propriété editMap doit utiliser le format suivant :
[property_name_n]#[current_value]#[new_value]
current_value et new_value sont des expressions régulières et n est un entier incrémenté.
Par exemple, tenez compte de la valeur suivante pour editMap:
sling:resourceType#/(contentpagehomepage)#/mobilecontentpage,cq:template#/contentpage#/mobilecontentpage
Cette valeur modifie les propriétés des noeuds Live Copy comme suit :
Les sling:resourceType propriétés qui sont soit définies sur contentpage ou sur lesquelles homepage sont définies sur .mobilecontentpage
Les cq:template propriétés qui sont définies sur contentpage sont définies sur mobilecontentpage.
editMap: (String) identifie la propriété, la valeur actuelle et la nouvelle valeur. Voir la description pour plus d’informations.
notify Cette action envoie un événement de page indiquant que la page a été déployée. Pour être averti, un utilisateur doit d’abord s’abonner aux événements de déploiement.
orderChildren Cette action commande les noeuds enfants en fonction de l'ordre du plan.
referencesUpdate Cette action de synchronisation met à jour les références sur Live Copy.
Il recherche les chemins dans les pages Live Copy qui pointent vers une ressource du plan. Lorsqu’elle est trouvée, elle met à jour le chemin d’accès pour qu’il pointe vers la ressource associée dans Live Copy. Les références qui comportent des cibles en dehors du plan directeur ne sont pas modifiées.
Configurez le service de mise à jour des références MSM de CQ afin de spécifier les types de noeud, les éléments de paragraphe et les propriétés de page à exclure.
targetVersion Cette action crée une version de Live Copy.
Cette action doit être la seule action de synchronisation incluse dans une configuration du déploiement.
targetActivate Cette action active la Live Copy.
Cette action doit être la seule action de synchronisation incluse dans une configuration du déploiement.
targetDeactivate Cette action désactive la Live Copy.
Cette action doit être la seule action de synchronisation incluse dans une configuration du déploiement.
workflow Cette action début le flux de travail défini par la propriété cible (pour les pages uniquement) et prend la Live Copy en charge.
Le chemin d’accès à la cible est le chemin d’accès du noeud du modèle.
target: (String) est le chemin d’accès au modèle de processus.
mandatory Cette action définit l’autorisation de plusieurs ACL sur la page Live Copy sur lecture seule pour un groupe d’utilisateurs spécifique. Les listes de contrôle d’accès suivantes sont configurées :
ActionSet.ACTION_NAME_REMOVE
ActionSet.ACTION_NAME_SET_PROPERTY
ActionSet.ACTION_NAME_ACL_MODIFY
Utilisez cette action uniquement pour les pages.
target: (String) est l’identifiant du groupe pour lequel vous définissez des autorisations.
mandatoryContent Cette action définit l’autorisation de plusieurs ACL sur la page Live Copy sur lecture seule pour un groupe d’utilisateurs spécifique. Les listes de contrôle d’accès suivantes sont configurées :
ActionSet.ACTION_NAME_SET_PROPERTY
ActionSet.ACTION_NAME_ACL_MODIFY
Utilisez cette action uniquement pour les pages.
target: (String) est l’identifiant du groupe pour lequel vous définissez des autorisations.
mandatoryStructure Cette action définit l’autorisation de l’ACL ActionSet.ACTION_NAME_REMOVE sur la page Live Copy sur lecture seule pour un groupe d’utilisateurs spécifique.
Utilisez cette action uniquement pour des pages.
target: (String) est l’identifiant du groupe pour lequel vous définissez des autorisations.
VersionCopyAction Si la page source/prototype a été publiée au moins une fois, cette action crée une page Live Copy à l'aide de la version publiée. Remarque : cette action n’est disponible que pour la création d’une page Live Copy basée sur une page source publiée, et non pour la mise à jour d’une page Live Copy existante.
PageMoveAction Le PageMoveAction s'applique lorsqu'une page a été déplacée dans le plan.
L’action copie plutôt que de déplacer la page Live Copy (associée) de l’emplacement avant le déplacement vers l’emplacement suivant.
La page Live Copy PageMoveAction ne change pas à l’emplacement avant le déplacement. Par conséquent, pour les configurations de déploiement consécutives, il a l'état d'une relation active sans schéma.
Configurez le service CQ MSM Page Move Action pour spécifier les types de nœuds, les éléments de paragraphe et les propriétés de page à exclure.
Cette action doit être la seule action de synchronisation incluse dans une configuration du déploiement.
Définissez prop_referenceUpdate: (Boolean) sur true (par défaut) pour mettre à jour les références.
markLiveRelationship Cette action indique qu’il existe une relation dynamique pour le contenu créé au lancement.

Exclusion des propriétés et des types de nœuds de la synchronisation

Vous pouvez configurer différents services OSGi qui prennent en charge les actions de synchronisation correspondantes afin qu’ils n’affectent pas des types de nœuds et des propriétés spécifiques. Par exemple, de nombreuses propriétés et sous-noeuds liés au fonctionnement interne de l’AEM ne doivent pas être inclus dans une Live Copy. Seul le contenu pertinent pour l’utilisateur de la page doit être copié.

Lorsque vous utilisez AEM, plusieurs méthodes permettent de gérer les paramètres de configuration pour ces services. Voir Configuration d’OSGi pour avoir plus de détails et connaître les pratiques recommandées.

Le tableau ci-dessous répertorie les actions de synchronisation pour lesquelles vous pouvez spécifier les nœuds à exclure. Le tableau contient le nom des services à configurer à l’aide de la console web et le PID pour la configuration à l’aide d’un nœud de référentiel.

Action de synchronisation Nom du service dans la console Web Service PID
contentCopy Action de copie de contenu MSM CQ com.day.cq.wcm.msm.impl.actions.ContentCopyActionFactory
contentDelete Action de suppression de contenu MSM CQ com.day.cq.wcm.msm.impl.actions.ContentDeleteActionFactory
contentUpdate Action de mise à jour du contenu MSM CQ com.day.cq.wcm.msm.impl.actions.ContentUpdateActionFactory
PageMoveAction Action de déplacement de page MSM CQ com.day.cq.wcm.msm.impl.actions.PageMoveActionFactory
referencesUpdate Action de mise à jour des références MSM CQ com.day.cq.wcm.msm.impl.actions.ReferencesUpdateActionFactory

Le tableau ci-dessous décrit les propriétés que vous pouvez configurer :

Propriété de la console Web OSGi, propriété Description
Types de noeud exclus cq.wcm.msm.action.excludednodetypes Expression régulière qui correspond aux types de noeud à exclure de l’action de synchronisation
Éléments de paragraphe exclus cq.wcm.msm.action.excludedparagraphitems Expression régulière qui correspond aux éléments de paragraphe à exclure de l’action de synchronisation
Propriétés de page exclues cq.wcm.msm.action.excludedprops Expression régulière qui correspond aux propriétés de page à exclure de l’action de synchronisation
Types de noeuds mixtes ignorés cq.wcm.msm.action.ignoredMixin Expression régulière qui correspond aux noms des types de noeud de mixin à exclure de l'action de synchronisation (disponible uniquement pour l'action contentUpdate)

CQ MSM Content Update Action – Exclusions

Différents types de nœuds et propriétés sont exclus par défaut. Ils sont définis dans la configuration OSGi du service CQ MSM Content Update Action sous Propriétés de page exclues.

Par défaut, les propriétés correspondant aux expressions régulières ci-dessous sont exclues (c’est-à-dire non mises à jour) lors du déploiement :

Régimes d’exclusion Live Copy

Vous pouvez modifier les expressions en définissant la liste d’exclusions, au besoin.

Par exemple, si vous souhaitez que le titre de la page soit inclus dans les modifications prises en compte pour le déploiement, supprimez jcr:title des exclusions. Par exemple, dans l’expression régulière :

jcr:(?!(title)$).*

Configuration de la synchronisation pour la mise à jour des références

Vous pouvez configurer différents services OSGi qui prennent en charge les actions de synchronisation correspondantes associées à la mise à jour des références.

Lorsque vous utilisez AEM, plusieurs méthodes permettent de gérer les paramètres de configuration pour ces services. Voir Configuration d’OSGi pour avoir plus de détails et connaître les pratiques recommandées.

Le tableau ci-dessous répertorie les actions de synchronisation pour lesquelles vous pouvez spécifier la mise à jour des références. Le tableau contient le nom des services à configurer à l’aide de la console web et le PID pour la configuration à l’aide d’un nœud de référentiel.

Propriété de la console Web OSGi, propriété Description
Référence de mise à jour sur les LiveCopies imbriquées cq.wcm.msm.impl.action.referencesupdate.prop_updateNested Sélectionnez cette option dans la console Web ou définissez cette propriété booléenne sur true en utilisant la configuration du référentiel pour remplacer les références qui cible toute ressource se trouvant dans la branche de Live Copy la plus élevée. Uniquement disponible pour l'action referencesUpdate.
Mettre à jour les pages de référence cq.wcm.msm.impl.actions.pagemove.prop_referenceUpdate Sélectionnez cette option dans la console Web ou définissez cette propriété booléenne sur true à l’aide de la configuration du référentiel pour mettre à jour toutes les références afin d’utiliser la page d’origine pour référencer la page Live Copy. Disponible uniquement pour PageMoveAction.

Spécification des configurations de déploiement à utiliser

MSM vous permet de spécifier des ensembles de configurations de déploiement généralement utilisés et, si nécessaire, vous pouvez les remplacer pour des Live Copies spécifiques. MSM fournit différents emplacements pour la spécification des configurations de déploiement à utiliser. L’emplacement détermine si la configuration s’applique à une Live Copy spécifique.

La liste suivante d’emplacements où vous pouvez spécifier les configurations de déploiement à utiliser décrit comment MSM détermine les configurations de déploiement à utiliser pour une Live Copy :

  • Propriétés de la page Live Copy : lorsqu’une page Live Copy est configurée pour utiliser une ou plusieurs configurations de déploiement, MSM utilise ces configurations de déploiement.
  • Propriétés de la page Plan : Lorsqu'une Live Copy est basée sur un plan et que la page Live Copy n'est pas configurée avec une configuration de déploiement, la configuration de déploiement associée à la page source du plan directeur est utilisée.
  • Propriétés de la page parent Live Copy : lorsque ni la page Live Copy ni la page source du plan directeur ne sont configurées avec une configuration de déploiement, la configuration de déploiement qui s’applique à la page parente de la page Live Copy est utilisée.
  • Valeur par défaut du système : lorsque la configuration de déploiement de la page parente de Live Copy ne peut pas être déterminée, la configuration de déploiement par défaut du système est utilisée.

Par exemple, un plan directeur utilise le didacticiel WKND site comme contenu source. Un site est créé à partir du plan directeur. Chaque élément de la liste ci-dessous décrit un scénario d’utilisation distinct des configurations de déploiement :

  • Aucune des pages du plan directeur ou des pages Live Copy n'est configurée pour utiliser une configuration de déploiement. MSM utilise la configuration de déploiement par défaut du système pour toutes les pages Live Copy.
  • La page racine du site WKND est configurée avec plusieurs configurations de déploiement. MSM utilise ces configurations de déploiement pour toutes les pages Live Copy.
  • La page racine du site WKND est configurée avec plusieurs configurations de déploiement et la page racine du site Live Copy est configurée avec un ensemble différent de configurations de déploiement. MSM utilise les configurations de déploiement qui sont configurées sur la page racine du site Live Copy.

Définition des configurations de déploiement pour une page Live Copy

Configurez une page Live Copy avec les configurations de déploiement à utiliser lorsque la page source est déployée. Les pages enfants héritent de la configuration par défaut. Lorsque vous configurez la configuration de déploiement à utiliser, vous remplacez la configuration héritée par la page Live Copy de son parent.

Vous pouvez également configurer les configurations de déploiement pour une page Live Copy lorsque vous créez la Live Copy.

  1. Utilisez la console Sites pour sélectionner la page Live Copy.

  2. Sélectionnez Propriétés dans la barre d’outils.

  3. Ouvrez l’onglet Live Copy.

    La section Configuration répertorie les configurations de déploiement dont la page hérite.

    Héritage de Live Copy à partir de la page parente

  4. Si nécessaire, ajustez l’indicateur Héritage de Live Copy. Si cette option est cochée, la configuration de Live Copy est effective sur tous les enfants.

  5. Désélectionnez la propriété Hériter de la configuration de déploiement du parent, puis sélectionnez une ou plusieurs configurations de déploiement dans la liste.

    Les configurations de déploiement sélectionnées s’affichent sous la liste déroulante.

    Remplacement de l’héritage de configuration de Live Copy

  6. Cliquez ou appuyez sur Enregistrer et fermer.

Définition de la configuration du déploiement pour une page de plan directeur

Configurez une page de plan directeur avec les configurations de déploiement à utiliser lorsque la page de plan directeur est déployée.

Notez que les pages enfants de la page de plan directeur héritent de la configuration. Lorsque vous configurez la configuration du déploiement à utiliser, il se peut que vous remplaciez la configuration dont la page hérite de son parent.

  1. Utilisez la console Sites pour sélectionner la page racine du plan.
  2. Sélectionnez Propriétés dans la barre d’outils.
  3. Ouvrez l’onglet Plan directeur.
  4. Sélectionnez une ou plusieurs configurations de déploiement à l’aide du sélecteur de liste déroulante.
  5. Conservez vos mises à jour à l’aide de l’option Enregistrer.

Définition de la configuration du déploiement système par défaut

Pour spécifier une configuration de déploiement à utiliser comme valeur par défaut du système, configurez le service OSGi suivant.

  • Day CQ WCM Live Relationship Manager avec le PID de service com.day.cq.wcm.msm.impl.LiveRelationshipManagerImpl

Configurez le service à l'aide de la console Web ou d'un noeud de référentiel.

  • Dans la console Web, le nom de la propriété à configurer est Default rollout config.
  • A l’aide d’un noeud de référentiel, le nom de la propriété à configurer est liverelationshipmgr.relationsconfig.default.

Définissez la valeur de cette propriété sur le chemin d’accès à la configuration de déploiement à utiliser comme valeur système par défaut. La valeur par défaut est /libs/msm/wcm/rolloutconfigs/default, c'est-à-dire Config de déploiement standard.

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
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now