配置 Live Copy 同步

Adobe Experience Manager提供了大量现成的同步配置。 在使用Live Copy之前,您应考虑以下内容,以定义Live Copy与其源内容同步的方式和时间。

  1. 确定现有转出配置是否满足您的要求
  2. 如果现有转出配置不可用,请决定是否需要创建您自己的转出配置。
  3. 指定要用于Live Copy的转出配置。

已安装的自定义转出配置

本部分提供有关已安装转出配置、其所使用的同步操作以及如何在需要时创建自定义配置的信息。

注意

建议更新或更改现成转出配置​。 如果存在对自定义实时操作的要求,则应在自定义转出配置中添加该操作。

转出触发器

每个转出配置都使用一个可执行转出的转出触发器。转出配置可以使用以下触发器之一:

  • 转出:Rollout ​命令用于蓝色打印页面,或同步 ​命令用于Live Copy页面。
  • 修改时:将修改源页面。
  • 激活:激活源页面。
  • 停用:停用源页面。
注意

使用​On Modification​触发器会影响性能。 请参阅 MSM 最佳实践以了解更多信息。

转出配置

下表列表了随AEM提供的现成转出配置。 该表包含每个转出配置的触发器和同步操作。

名称 描述 触发器 同步操作
标准转出配置 标准转出配置,允许在转出触发器上开始转出进程并运行操作:创建、更新、删除内容和对子节点排序 转出 contentUpdate
contentCopy
contentDelete
referencesUpdate
productUpdate
orderChildren
在 Blueprint 激活时激活 在发布源时发布Live Copy 激活 targetActivate
在 Blueprint 停用时停用 在取消激活源时停用Live Copy 取消激活时 targetDeactivate
修改时推送 在修改源
时将内容推送到Live Copy。使用On Modification触发器时,请少用此转出配置。
修改 contentUpdate
contentCopy
contentDelete
referencesUpdate
orderChildren
修改时推送(简略) 在修改Blueprint页面时将内容推送到Live Copy,而不更新引用(例如,对于浅副本)
在使用On Modification触发器时,请少用此转出配置。
修改 contentUpdate
contentCopy
contentDelete
orderChildren
提升启动项 用于提升启动项页面的标准转出配置。 转出 contentUpdate
contentCopy
contentDelete
referencesUpdate
orderChildren
markLiveRelationship

同步操作

下表列表了随AEM提供的现成同步操作。

操作名称 描述 属性
contentCopy 当源的节点在Live Copy上不存在时,此操作会将节点复制到Live Copy。 配置CQ MSM内容复制 Actionservice以指定要排除的节点类型、段落项和页面属性。
contentDelete 此操作将删除源上不存在的Live Copy节点。 配置CQ MSM内容删除 Actionservice以指定要排除的节点类型、段落项和页面属性。
contentUpdate 此操作会使用源中的更改更新Live Copy内容。 配置CQ MSM内容更新 Actionservice以指定要排除的节点类型、段落项和页面属性。
editProperties 此操作可编辑Live Copy的属性。 editMap属性确定要编辑的属性及其值。 editMap属性的值必须使用以下格式:
[property_name_n]#[current_value]#[new_value]
current_valuenew_value是常规表达式,n是递增整数。
例如,请考虑以下值 editMap:
sling:resourceType#/(contentpage homepage)#/mobilecontentpage,cq:template#/contentpage#/mobilecontentpage
此值编辑Live Copy节点的属性,如
下: sling:resourceType 设置为或 contentpagehomepage 置为的 mobilecontentpage属性。
cq:template 置为的属 contentpage 性设置为 mobilecontentpage
editMap: (String) 标识属性、当前值和新值。有关详细信息,请参阅说明。
notify 此操作会发送页面事件,表明页面已经转出。 要接收通知,首先需要订阅转出事件。
orderChildren 此操作根据Blueprint上的顺序对子节点排序。
referencesUpdate 此同步操作更新了Live Copy上的引用。
它会在Live Copy页面中搜索指向Blueprint中某个资源的路径。找到后,它会更新路径以指向Live Copy中的相关资源。 具有 Blueprint 外部目标的引用不会发生更改。
配置“ CQ MSM引用更新 Actionservice”,以指定要排除的节点类型、段落项和页面属性。
targetVersion 此操作将创建Live Copy的一个版本。
此操作必须是转出配置中包含的唯一同步操作。
targetActivate 此操作将激活Live Copy。
此操作必须是转出配置中包含的唯一同步操作。
targetDeactivate 此操作将停用Live Copy。
此操作必须是转出配置中包含的唯一同步操作。
workflow 此操作将开始由目标属性定义的工作流(仅限页面),并将Live Copy作为有效负荷。
目标路径是模型节点的路径。
target: (String) 是工作流模型的路径。
mandatory 此操作会将Live Copy页面上的多个ACL的权限设置为特定用户组的只读。 已配置以下ACL:
ActionSet.ACTION_NAME_REMOVE
ActionSet.ACTION_NAME_SET_PROPERTY
ActionSet.ACTION_NAME_ACL_MODIFY
仅对页面使用此操作。
target: (String) 是您设置权限的组的ID。
mandatoryContent 此操作会将Live Copy页面上的多个ACL的权限设置为特定用户组的只读。 已配置以下ACL:
ActionSet.ACTION_NAME_SET_PROPERTY
ActionSet.ACTION_NAME_ACL_MODIFY
仅对页面使用此操作。
target: (String) 是您设置权限的组的ID。
mandatoryStructure 此操作会将“Live Copy”页上的ActionSet.ACTION_NAME_REMOVE ACL的权限设置为特定用户组的只读。
仅对页面使用此操作。
target: (String) 是您设置权限的组的ID。
VersionCopyAction 如果Blueprint/源页面至少已发布一次,则此操作将使用已发布的版本创建Live Copy页面。 注意:此操作仅适用于基于已发布的源页面创建Live Copy页面,而不适用于更新现有Live Copy页面。
PageMoveAction PageMoveAction在Blueprint中移动页面时应用。
操作将复制而不是将(相关)Live Copy页面从移动前的位置移动到之后的位置。
PageMoveAction 会更改移动前位置的Live Copy页面。因此,对于连续转出配置,它具有无Blueprint的实时关系状态。
​配置 CQ MSM 页面移动操作服务,以指定要排除的节点类型、段落项和页面属性。
此操作必须是转出配置中包含的唯一同步操作。
prop_referenceUpdate: (Boolean)设置为true(默认)可更新引用。
markLiveRelationship 此操作指示启动项创建的内容存在实时关系。

从同步中排除属性和节点类型

您可以配置多个支持相应同步操作的 OSGi 服务,以便它们不会影响特定的节点类型和属性。例如,Live Copy中不应包含许多与AEM内部功能相关的属性和子节点。 仅应复制与页面用户相关的内容。

使用AEM时,有多种方法可管理此类服务的配置设置。有关更多详细信息和建议的做法,请参阅配置OSGi

下表列出了可以为其指定要排除节点的同步操作。该表提供了要使用 Web 控制台进行配置的服务名称以及要使用存储库节点进行配置的 PID。

同步操作 Web控制台中的服务名称 服务PID
contentCopy CQ MSM内容复制操作 com.day.cq.wcm.msm.impl.actions.ContentCopyActionFactory
contentDelete CQ MSM内容删除操作 com.day.cq.wcm.msm.impl.actions.ContentDeleteActionFactory
contentUpdate CQ MSM内容更新操作 com.day.cq.wcm.msm.impl.actions.ContentUpdateActionFactory
PageMoveAction CQ MSM页面移动操作 com.day.cq.wcm.msm.impl.actions.PageMoveActionFactory
referencesUpdate CQ MSM引用更新操作 com.day.cq.wcm.msm.impl.actions.ReferencesUpdateActionFactory

下表描述了您可以配置的属性:

Web控制台属性 OSGi属性 描述
排除的节点类型 cq.wcm.msm.action.excludednodetypes 与要从同步操作中排除的节点类型相匹配的常规表达式
排除的段落项目 cq.wcm.msm.action.excludedparagraphitems 与要从同步操作中排除的段落项匹配的常规表达式
排除的页面属性 cq.wcm.msm.action.excludedprops 与要从同步操作中排除的页面属性匹配的常规表达式
忽略的Mixin NodeTypes cq.wcm.msm.action.ignoredMixin 与要从同步操作中排除的混合节点类型名称匹配的常规表达式(仅适用于contentUpdate操作)

CQ MSM 内容更新操作 - 排除项

默认情况下,将排除多个属性和节点类型,这些属性和节点类型在 CQ MSM 内容更新操作​的​排除的页面属性​下的 OSGi 配置中定义。

默认情况下,在转出时排除(即不更新)与以下正则表达式匹配的属性:

Live Copy排除规则

您可以根据需要更改定义排除列表的表达式。

例如,如果您希望将页面​标题​包含在考虑转出的更改中,请从排除项中删除 jcr:title。例如,使用正则表达式:

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

配置同步以更新引用

您可以配置多个 OSGi 服务以支持与更新引用相关的对应同步操作。

使用AEM时,有多种方法可管理此类服务的配置设置。有关更多详细信息和建议的做法,请参阅配置OSGi

下表列出了可以为其指定引用更新的同步操作。该表提供了要使用 Web 控制台进行配置的服务名称以及要使用存储库节点进行配置的 PID。

Web控制台属性 OSGi属性 描述
跨嵌套LiveCopy更新引用 cq.wcm.msm.impl.action.referencesupdate.prop_updateNested 在Web控制台中选择此选项,或使用存储库配置将此布尔属性设置为true以替换目标位于最顶层Live Copy分支中的任何资源的引用。 仅适用于referencesUpdate操作。
更新引用页面 cq.wcm.msm.impl.actions.pagemove.prop_referenceUpdate 在Web控制台中选择此选项,或使用存储库配置将此布尔属性设置为true以更新任何引用以使用原始页面来改为引用Live Copy页面。 仅适用于PageMoveAction

指定要使用的转出配置

MSM允许您指定一般使用的转出配置集,如果需要,您可以为特定Live Copy覆盖这些配置集。 MSM 提供了多个位置可指定要使用的转出配置。该位置决定配置是否适用于特定Live Copy。

以下位置列表,您可以在其中指定要使用的转出配置,描述MSM如何确定要用于Live Copy的转出配置:

  • Live Copy页面属性: 当Live Copy页面配置为使用一个或多个转出配置时,MSM会使用这些转出配置。
  • Blueprint页面属性: 当Live Copy基于Blueprint,且Live Copy页面未配置转出配置时,将使用与Blueprint源页面关联的转出配置。
  • Live Copy父页面属性: 当Live Copy页面和Blueprint源页面都未配置转出配置时,将使用应用于Live Copy页面父页面的转出配置。
  • 系统默认: 当无法确定Live Copy父页面的转出配置时,将使用系统默认转出配置。

例如,Blueprint使用WKND tutorial站点作为源内容。 从该 Blueprint 创建一个网站。以下列表中的每个项都描述了有关使用转出配置的不同场景:

  • 未将任何Blueprint页面或Live Copy页面配置为使用转出配置。 MSM对所有Live Copy页面使用系统默认转出配置。
  • WKND站点的根页面配置了多个转出配置。 MSM对所有Live Copy页面都使用这些转出配置。
  • WKND站点的根页面配置了多个转出配置,而Live Copy站点的根页面配置了一组不同的转出配置。 MSM使用在Live Copy站点的根页面上配置的转出配置。

为 Live Copy 页面设置转出配置

使用转出配置配置配置Live Copy页面,以便在转出源页面时使用。 子页面默认情况下会继承该配置。当您配置要使用的转出配置时,您将覆盖Live Copy页面从其父页面继承的配置。

创建Live Copy时,您还可以为Live Copy页面配置转出配置。

  1. 使用​站点​控制台选择Live Copy页面。

  2. 从工具栏中选择​属性

  3. 打开 Live Copy 选项卡。

    配置​部分将显示页面继承的转出配置。

    Live Copy从父页面继承

  4. 如果需要,可调整 Live Copy 继承​标记。如果选中,则Live Copy配置对所有子项都有效。

  5. 清除​继承父项的转出配置​属性,然后从列表中选择一个或多个转出配置。

    选择的转出配置将显示在下拉列表下。

    覆盖Live Copy配置继承

  6. 单击或点按​保存并关闭

为 Blueprint 页面设置转出配置

使用要在转出 Blueprint 页面时使用的转出配置对 Blueprint 页面进行配置。

请注意,Blueprint 页面的子页面将继承该配置。在配置要使用的转出配置时,可能会覆盖页面从其父页面继承的配置。

  1. 使用​站点​控制台选择 Blueprint 的根页面。
  2. 从工具栏中选择​属性
  3. 打开 Blueprint 选项卡。
  4. 使用下拉选择器选择一个或多个​转出配置
  5. 使用​保存​持久存储您的更新。

设置系统默认转出配置

要指定要用作系统默认值的转出配置,请配置以下OSGi服务。

  • Day CQ WCM Live Relationship Manager与服务PID com.day.cq.wcm.msm.impl.LiveRelationshipManagerImpl

使用Web控制台存储库节点配置服务。

  • 在Web控制台中,要配置的属性的名称为​默认转出配置
  • 使用存储库节点时,要配置的属性名称为liverelationshipmgr.relationsconfig.default

将此属性值设置为要用作系统默认值的转出配置的路径。默认值为/libs/msm/wcm/rolloutconfigs/default,即​标准转出配置

On this 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