Show Menu
SUJETS×

Configuration de la synchronisation de Live Copies

Procédez comme suit pour contrôler la façon dont les Live Copies sont synchronisées avec leur contenu source.
  • Déterminez si des configurations de déploiement existantes répondent à vos besoins ou si vous devez en créer d’autres.
  • Spécifiez les configurations du déploiement à utiliser avec les 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.

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 :
  • En cas de déploiement  : la commande Déploiement est utilisée dans la page Plan directeur ou la commande Synchroniser est utilisée dans 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.
L’utilisation du déclencheur En cas de modification peut nuire aux performances. Pour plus d’informations, voir Meilleures pratiques MSM .

Configurations de déploiement installées

Le tableau ci-dessous répertorie les configurations de déploiement installées avec AEM. Le tableau contient les actions de déclenchement et de synchronisation de chaque configuration du déploiement. Si les actions de configuration du déploiement installées ne répondent pas à vos exigences, vous pouvez créer une autre configuration du déploiement .
Nom Description Déclencheur Actions de synchronisation Voir aussi Actions de synchronisation installées
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. En cas de désactivation targetDeactivate
Pousser au moment de la modification
Envoie le contenu de la Live Copy lorsque la source est modifiée.
Utilisez cette configuration du déploiement avec parcimonie, car elle utilise le déclencheur En cas de modification.
En cas de modification contentUpdate contentCopy contentDelete referencesUpdate orderChildren
Pousser au moment de la modification (peu profond)
Envoie le contenu vers la Live Copy lorsque la page Plan directeur est modifiée, sans mettre à jour des références (par exemple, pour les copies réduites).
Utilisez cette configuration du déploiement avec parcimonie, car elle utilise le déclencheur En cas de 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
Configuration du déploiement du contenu des pages du catalogue Applique des modèles de pages depuis le plan directeur d’un catalogue. En cas de déploiement contentUpdate contentCopy contentDelete referencesUpdate productCreateUpdate orderChildren
Configuration du déploiement des mises à jour des pages du catalogue Applique des propriétés cibles à partir du plan directeur d’un catalogue. Doit être exécuté après la configuration du déploiement du contenu des pages du catalogue. En cas de déploiement catalogRolloutHooks
Configuration du déploiement des publications DPS Configuration du déploiement des publications DPS qui permet de lancer le processus de déploiement avec le déclencheur de déploiement, tout en excluant les propriétés de liaison de FolioProducer sur le déploiement initial. En cas de déploiement contentUpdate contentCopy contentDelete referencesUpdate orderChildren dpsMetadataFilter
Configuration du déploiement du catalogue (5.6.0) hérité Obsolète. Utilisez l’API Catalog Generator au lieu de MSM pour les déploiements de catalogues. En cas de déploiement editProperties

Actions de synchronisation installées

Le tableau ci-dessous répertorie les actions de synchronisation installées avec AEM. If the installed actions do not meet your requirements, you can Create a New Synchronization Action .
Nom de l’action Description Propriétés
contentCopy Si les nœuds de la source n’existent pas sur la Live Copy, ils y sont copiés. Configurez le service Action CQ MSM Content Copy pour spécifier les types de noeud, les éléments de paragraphe et les propriétés de page à exclure.
contentDelete
Supprime les noeuds de la copie dynamique qui n’existent pas sur la source. Configurez le service CQ MSM Content Delete Action pour spécifier les types de noeud, les éléments de paragraphe et les propriétés de page à exclure.
contentUpdate Met à jour le contenu de la Live Copy avec les modifications provenant de la source. Configurez le service d’action CQ MSM Content Update pour spécifier les types de noeud, les éléments de paragraphe et les propriétés de page à exclure.
editProperties
Modifie les propriétés de la Live Copy. La propriété editMap détermine les propriétés modifiées et leur valeur. La valeur de la propriété editMap doit utiliser le format suivant :
[property_name_1]#[current_value]# [nouvelle_valeur], [property_name_2]#[current_value]# [nouvelle_valeur], ... , [property_name_n]#[current_value]# [nouvelle_valeur]
Les éléments current_value et new_value sont des expressions régulières.
Prenons l’exemple de la valeur suivante pour la propriété editMap :
sling:resourceType#/ (contentpage|homepage)#/ mobilecontentpage, cq:template#/contentpage#/mobilecontentpage
Cette valeur modifie les propriétés des nœuds de la Live Copy comme suit :
  • The sling:resourceType properties that are either set to contentpage or to homepage are set to mobilecontentpage.
  • The cq:template properties that are set to contentpage are set to mobilecontentpage.
editMap : (chaîne) identifie la propriété, la valeur actuelle et la nouvelle valeur. Pour plus d’informations, consultez la description.
notify Envoie un événement de page que la page a déployé. Pour être averti, un utilisateur doit d’abord s’abonner aux événements de déploiement.
orderChildren Sur la Live Copy, les enfants (nœuds) sont classés suivant l’ordre du plan directeur .
referencesUpdate
Dans la Live Copy, cette action de synchronisation met à jour les références, comme les liens « J’aime ». Elle recherche des chemins d’accès dans les pages Live Copy, qui pointent vers une ressource dans le plan directeur. Ensuite, elle met à jour le chemin d’accès pour qu’il pointe vers la ressource associée dans la Live Copy (au lieu du plan directeur). Les références qui comportent des cibles en dehors du plan directeur ne sont pas modifiées.
Configurez le service Action de mise à jour des références MSM CQ pour spécifier les types de noeud, les éléments de paragraphe et les propriétés de page à exclure.
targetVersion
Crée une version de la Live Copy.
Cette action doit être la seule action de synchronisation incluse dans une configuration du déploiement.
targetActivate
Active la Live Copy.
Cette action doit être la seule action de synchronisation incluse dans une configuration du déploiement.
targetDeactivate
Désactive la Live Copy.
Cette action doit être la seule action de synchronisation incluse dans une configuration du déploiement.
workflow
Lance le workflow défini par la propriété cible (pour les pages uniquement) et utilise la Live Copy comme charge utile.
Le chemin d’accès cible est le chemin d’accès au nœud du modèle ; par exemple, /etc/workflow/models/request_for_activation/jcr:content/model
target : (chaîne) chemin d’accès au modèle de workflow.
mandatory
Définit l’autorisation de différentes listes de contrôle d’accès dans la page Live Copy en lecture seule pour un groupe d’utilisateurs spécifique. Les listes de contrôle d’accès ci-dessous sont configurées :
  • ActionSet.ACTION_NAME_REMOVE
  • ActionSet.ACTION_NAME_SET_PROPERTY
  • ActionSet.ACTION_NAME_ACL_MODIFY
Utilisez cette action uniquement pour des pages.
cible : (chaîne) identifiant du groupe pour lequel vous définissez des autorisations.
mandatoryContent
Définit l’autorisation de différentes listes de contrôle d’accès dans la page Live Copy en lecture seule pour un groupe d’utilisateurs spécifique. Les listes de contrôle d’accès ci-dessous sont configurées :
  • ActionSet.ACTION_NAME_SET_PROPERTY
  • ActionSet.ACTION_NAME_ACL_MODIFY
Utilisez cette action uniquement pour des pages.
cible : (chaîne) identifiant du groupe pour lequel vous définissez des autorisations.
mandatoryStructure Définit l’autorisation de la liste de contrôle d’accès ActionSet.ACTION_NAME_REMOVE dans la page Live Copy en lecture seule pour un groupe d’utilisateurs spécifique. Utilisez cette action uniquement pour des pages. cible : (chaîne) identifiant du groupe pour lequel vous définissez des autorisations.
VersionCopyAction Si la page source/de plan directeur a été publiée au moins une fois, une page Live Copy est créée à l’aide de la version publiée. Remarque : Cette action est disponible pour créer une page Live Copy sur une page source publiée, et non pour mettre à jour une page Live Copy existante.
PageMoveAction
L’action PageMoveAction s’applique lorsqu’une page a été déplacée dans le plan directeur.
L’action copie plutôt qu’elle ne déplace la page Live Copy (associée) de l’emplacement précédant le déplacement vers l’emplacement suivant le déplacement.
L’action PageMoveAction ne modifie pas la page Live Copy à l’emplacement précédant le déplacement. Par conséquent, pour les actions RolloutConfigurations consécutives, son état est LiveRelationhip sans plan directeur.
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.
prop_referenceUpdate : (booléen) définissez cette action sur true pour mettre à jour les références. La valeur par défaut est true.
productCreateUpdate Crée ou met à jour des ressources de produit dans un catalogue. Cette action est conçue pour être utilisée dans l’une des situations suivantes :
  • Génération ou déploiement d’un catalogue (ou d’une partie d’un catalogue).
  • Un utilisateur restaure l’héritage de synchronisation pour un composant de produit.
markLiveRelationship Indique qu’il existe une relation en direct pour le contenu créé au lancement.
catalogRolloutHooks Exécute des hooks de déploiement spécifiques à la génération d’un catalogue. Appelle les méthodes executePageRolloutHooks et executeProductRolloutHooks de CatalogGenerator. Voir com.adobe.cq.commerce.pim.api.CatalogGenerator dans les documents Java d’AEM.
productUpdate Met à jour des pages de produit dans une Live Copy d’un catalogue de produits.

Création d’une configuration du déploiement

Vous pouvez créer une configuration du déploiement lorsque les configurations de déploiement installées ne respectent pas les exigences de votre application :
La nouvelle configuration de déploiement est alors disponible lorsque vous définissez des configurations du déploiement dans un plan directeur ou une page Live Copy.

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 d’AEM ne doivent pas être inclus dans une copie dynamique. 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
PID de service
contentCopy
Action CQ MSM Content Copy
com.day.cq.wcm.msm.impl.actions.ContentCopyActionFactory
contentDelete
Action de suppression du 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 console Web / propriété OSGi Description
Nodetypes 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.excludeditems
Expression régulière correspondant 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 la page à exclure de l’action de synchronisation.
Types de noeud mixte ignorés
cq.wcm.msm.action.ignoreMixin
Disponible uniquement pour CQ MSM Content Update Action. Expression régulière correspondant au nom des types de nœuds Mixin à exclure de l’action de synchronisation.
Dans l’interface utilisateur classique, l’icône de verrou qui s’affiche dans la boîte de dialogue Propriétés de page pour les pages Live Copy ne reflète pas la configuration de la propriété Propriétés de page exclues. L’icône de verrou s’affiche même pour les propriétés exclues de l’action de synchronisation.
In the touch-enabled UI see also Configuring MSM Locks on Page Properties) .

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 :
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)$).*
Avant la version 5.5 SP2, les propriétés de page exclues étaient configurées dans la console système sous Day CQ WCM Rollout Manager . Depuis la version 5.5 SP2, les paramètres de propriétés de page exclues dans ce panneau sont ignorés. Property exclusion on rollout is configured as described above, in CQ MSM Content Update Action .
Par conséquent, si vous avez ajusté manuellement ce paramètre dans une installation antérieure à la version 5.5 SP2 et que vous effectuez une mise à niveau vers la version 5.5 SP2 ou ultérieure, vous devez transférer manuellement ces paramètres de l’ancien panneau de configuration vers le nouveau .

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 console Web / propriété OSGi Description
Référence de mise à jour sur les LiveCopies imbriquées
cq.wcm.msm.impl.action.referencesupdate.prop_updateNested
Uniquement disponible pour l’action de mise à jour des références MSM CQ. Sélectionnez cette option (console Web) ou définissez cette propriété booléenne sur true (configuration du référentiel) pour remplacer les références qui ciblent toute ressource se trouvant dans la branche de LiveCopy la plus élevée.
Mettre à jour les pages de référence
cq.wcm.msm.impl.actions.pagemove.prop_referenceMise à jour
Disponible uniquement pour l’action de déplacement de page MSM CQ. Select this option (Web Console) or set this boolean property to true (repository configuration) to update any references to use the original page to instead reference the LiveCopy page.

Spécification des configurations de déploiement à utiliser

MSM permet de spécifier des groupes de configurations de déploiement généralement utilisées et, si nécessaire, de 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 ci-après des 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 des pages 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 des pages de plan directeur  : ​lorsqu’une Live Copy est basée sur un plan directeur et que la page Live Copy n’est pas configurée avec une configuration de déploiement, la configuration du déploiement associée à la page source du plan directeur est utilisée.
  • ​Propriétés de la page parente de copie en direct : Lorsque ni la page de copie dynamique 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 de copie dynamique est utilisée.
  • Définition de la configuration du déploiement système par défaut Valeur par défaut ​du système : Lorsque la configuration de déploiement de la page parente de la copie dynamique 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 site de référence We.Retail 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 de plan directeur ou des pages Live Copy n’est configurée pour utiliser une configuration du déploiement. MSM utilise la configuration du déploiement système par défaut pour toutes les pages Live Copy.
  • La page principale du site de référence We.Retail 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 de référence Web.Retail est configurée avec plusieurs configurations de déploiement et la page racine du site de copie dynamique est configurée avec un ensemble différent de configurations de déploiement. MSM utilise les configurations de déploiement configurées sur la page principale du site Live Copy.

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

Configurez une page Live Copy avec des configurations du 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 du déploiement à utiliser, vous remplacez la configuration qui a été héritée pas la page Live Copy de son parent.
Vous pouvez également configurer les configurations du déploiement d’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.
  4. Si nécessaire, ajustez l’indicateur Héritage de Live Copy . Si cette option est activé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.
  6. Cliquez ou appuyez sur Enregistrer .

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. Use the Sites console to select the root page of the blueprint.
  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

Spécifiez une configuration du déploiement à utiliser comme valeur système par défaut. Pour spécifier la valeur par défaut, configurez le service OSGi :
  • Day CQ WCM Live Relationship Manager Le PID du service est com.day.cq.wcm.msm.impl.LiveRelationshipManagerImpl .
Configure the service using either the Web Console or a repository node .
  • Dans la console web, le nom de la propriété à configurer est « Configuration de déploiement par défaut ».
  • Using a repository node, the name of the property to configure is 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. The default value is /etc/msm/rolloutconfigs/default , which is the Standard Rollout Config .