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.
Effectuez les tâches suivantes pour contrôler le mode et le moment de synchronisation des Live Copies avec leur contenu source.
Déterminez si les configurations de déploiement existantes répondent à vos besoins ou si vous devez en créer une ou plusieurs.
Spécifiez les configurations de déploiement à utiliser pour vos Live Copies.
Configurations du déploiement installées et personnalisées installed-and-custom-rollout-configurations
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.
CAUTION
La mise à jour ou la modification d’une configuration de déploiement prête à l’emploi (installée) n’est pas recommandée. Si une action en direct et personnalisée est requise, elle doit être ajoutée dans une configuration de déploiement personnalisée.
Déclencheurs de déploiement rollout-triggers
Chaque configuration du déploiement utilise un déclencheur qui entraîne la survenue du déploiement. Les configurations de déploiement peuvent utiliser 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.
NOTE
L’utilisation du déclencheur En cas de modification peut nuire aux performances. Pour plus d’informations, consultez la section Bonnes pratiques MSM.
Configurations de déploiement installées installed-rollout-configurations
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 de déploiement installées ne répondent pas à vos besoins, vous pouvez créer une configuration de déploiement ;.
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.
Envoyer au moment de la modification (superficielle)
Envoie le contenu à la Live Copy lorsque la page de plan directeur est modifiée, 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 En cas de modification .
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 s’exécuter après la configuration de déploiement du contenu de la page de catalogue.
En cas de déploiement
catalogRolloutHooks
Configuration du déploiement des publications DPS
Configuration du déploiement de publication DPS qui permet de lancer le processus de déploiement sur le déclencheur de déploiement tout en excluant les propriétés de liaison FolioProducer sur le déploiement initial
Configuration de déploiement du catalogue héritée (5.6.0)
Obsolète. Utilisez l’API Catalog Generator au lieu de MSM pour les déploiements de catalogue.
En cas de déploiement
editProperties
Actions de synchronisation installées installed-synchronization-actions
Le tableau ci-dessous répertorie les actions de synchronisation installées avec AEM. Si les actions installées ne répondent pas à vos exigences, vous pouvez créer une action de synchronisation.
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 d’action de copie de contenu MSM CQ pour spécifier les types de nœuds, les éléments de paragraphe et les propriétés de page à exclure.
Modifie les propriétés de la Live Copy. La propriété editMap détermine les propriétés qui sont modifiées et leur valeur. La valeur de la propriété editMap doit utiliser le format suivant :
Cette valeur modifie les propriétés des nœuds de la Live Copy comme suit :
Les propriétés sling:resourceType qui sont définies sur contentpage ou sur homepage sont configurées sur mobilecontentpage.
Les propriétés cq:template qui sont définies sur contentpage sont configurées sur mobilecontentpage.
editMap : (Chaîne) Identifie la propriété, la valeur actuelle et la nouvelle valeur. Voir la description pour plus d’informations.
notify
Envoie un événement de page 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
Sur la Live Copy, il classe les enfants (noeuds) en fonction de l’ordre du plan directeur.
referencesUpdate
Sur la Live Copy, cette action de synchronisation met à jour les références telles que les liens J’aime. Il recherche les 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.
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
Démarre 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 à la cible est le chemin d’accès du nœud du modèle.
target : (Chaîne) Chemin d’accès au modèle de processus.
mandatory
Définit l’autorisation de plusieurs listes de contrôle d’accès sur la page Live Copy sur lecture seule pour un groupe d’utilisateurs spécifique. Les listes ACL suivantes 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 plusieurs listes de contrôle d’accès sur la page Live Copy sur lecture seule pour un groupe d’utilisateurs spécifique. Les listes ACL suivantes 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 sur la page Live Copy sur 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 que de déplacer la page Live Copy (associée) de l’emplacement précédant le déplacement vers l’emplacement suivant.
L’action PageMoveAction ne modifie pas la page Live Copy à l’emplacement précédant le déplacement. Par conséquent, pour les configurations de déploiement consécutives, il a l’état d’une relation en direct sans plan directeur.
Cette action doit être la seule action de synchronisation incluse dans une configuration du déploiement.
prop_referenceUpdate : (Booléen) Définissez cette variable 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 destinée à être utilisée dans l’une des situations suivantes :
Génération ou déploiement d’un catalogue (ou d’une section de catalogue)
Un utilisateur restaure l’héritage de synchronisation pour un composant de produit.
markLiveRelationship
Indique qu’il existe une relation dynamique pour le contenu créé par le lancement.
catalogRolloutHooks
Exécute des hooks de déploiement spécifiques à la génération du catalogue. Appelle les méthodes executePageRolloutHooks et executeProductRolloutHooks de CatalogGenerator. Voir com.adobe.cq.commerce.pim.api.CatalogGenerator dans les Javadocs d’AEM.
productUpdate
Met à jour les pages de produits dans une Live Copy d’un catalogue de produits
Création d’une configuration de déploiement creating-a-rollout-configuration
La nouvelle configuration de déploiement est alors disponible pour vous lors de la définition des configurations de déploiement sur une page de plan directeur ou de Live Copy.
Exclusion des propriétés et des types de nœuds de la synchronisation excluding-properties-and-node-types-from-synchronization
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, nombre de propriétés et de sous-nœuds associés au fonctionnement interne d’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. Consultez la section Configuration d’OSGi pour 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 fournit les noms des services à configurer à l’aide de la console web et du PID pour la configuration à l’aide d’un noeud de référentiel.
Le tableau ci-dessous décrit les propriétés que vous pouvez configurer :
Propriété de la console web / Propriété OSGi
Description
Types de nœuds exclus
cq.wcm.msm.action.excludednodetypes
Expression régulière correspondant aux types de nœuds à exclure de l’action de synchronisation.
Éléments de paragraphe exclus
cq.wcm.msm.action.excludedparagraphitems
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 correspondant aux propriétés de page à exclure de l’action de synchronisation.
Types de nœuds mixin ignorés
cq.wcm.msm.action.ignoredMixin
Disponible uniquement pour l’action de mise à jour de contenu MSM CQ. Expression régulière correspondant au nom des types de nœuds Mixin à exclure de l’action de synchronisation.
NOTE
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 verrouillage s’affiche même pour les propriétés qui sont exclues de l’action de synchronisation.
Plusieurs propriétés et types de noeud sont exclus par défaut. Ils sont définis dans la configuration OSGi de Action de mise à jour du contenu CQ MSM, sous Propriétés de page exclues.
Par défaut, les propriétés correspondant aux expressions régulières suivantes sont exclues (c’est-à-dire non mises à jour) au moment 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)$).*
Configuration de la synchronisation pour la mise à jour des références configuring-synchronization-for-updating-references
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. Consultez la section Configuration d’OSGi pour 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 fournit les noms des services à configurer à l’aide de la console web et du PID pour la configuration à l’aide d’un noeud de référentiel.
Propriété de la console web / Propriété OSGi
Description
Mettre à jour de référence sur des Live Copies imbriquées
Disponible uniquement pour l’action de mise à jour des références de 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 ciblant des ressources qui se trouvent dans la branche de la Live Copy la plus élevée.
Disponible uniquement pour l’action de déplacement de page de MSM CQ. Sélectionnez cette option (console web) ou définissez cette propriété booléenne sur true (configuration du référentiel) pour mettre à jour les références afin d’utiliser la page originale au lieu de référencer la page Live Copy.
Spécification des configurations de déploiement à utiliser specifying-the-rollout-configurations-to-use
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 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 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 des pages parentes 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, c’est la configuration du déploiement qui s’applique à la page parente de la page Live Copy qui est utilisée.
Valeurs système par défaut : lorsque la configuration du déploiement de la page parente de la Live Copy ne peut pas être déterminée, c’est la configuration du déploiement des valeurs système par défaut qui 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 suivante décrit un scénario différent concernant l’utilisation 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 de déploiement par défaut du système 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 principale du site de référence We.Retail est configurée avec plusieurs configurations de déploiement et la page principale du site Live Copy est configurée avec un autre ensemble de configurations de déploiement. MSM utilise les configurations de déploiement configurées sur la page racine du site Live Copy.
Définition des configurations de déploiement pour une page Live Copy setting-the-rollout-configurations-for-a-live-copy-page
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 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 du déploiement d’une page Live Copy lorsque vous créez la Live Copy.
Utilisez la console Sites pour sélectionner la page Live Copy.
Sélectionnez Propriétés dans la barre d’outils.
Ouvrez l’onglet Live Copy.
La section Configuration répertorie les configurations de déploiement dont la page hérite.
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.
Effacez la variable 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.
Cliquez ou appuyez sur Enregistrer.
Définition de la configuration du déploiement pour une page de plan directeur setting-the-rollout-configuration-for-a-blueprint-page
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 de déploiement à utiliser, vous pouvez remplacer la configuration que la page hérite de son parent.
Utilisez la console Sites pour sélectionner la page racine du plan directeur.
Sélectionnez Propriétés dans la barre d’outils.
Ouvrez l’onglet Plan directeur.
Sélectionnez une ou plusieurs configurations de déploiement à l’aide du sélecteur de liste déroulante.
Conservez vos mises à jour à l’aide de l’option Enregistrer.
Définition de la configuration du déploiement système par défaut setting-the-system-default-rollout-configuration
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 :
Gestionnaire de relations en direct de gestion de contenu web Day CQ Le PID du service est com.day.cq.wcm.msm.impl.LiveRelationshipManagerImpl
Dans la console web, le nom de la propriété à configurer est Configuration de déploiement par défaut.
Si vous utilisez un nœud 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, qui est la configuration de déploiement standard.
