执行以下任务可控制活动副本与其源内容同步的方式和时间。
此部分提供有关已安装的转出配置及其使用的同步操作的信息,以及如何在必要时创建自定义配置的信息。
更新或更改现成(已安装)转出配置是 非 推荐。 如果需要自定义实时操作,则应将其添加到自定义转出配置中。
每个转出配置都使用一个可执行转出的转出触发器。转出配置可以使用以下触发器之一:
转出:和 转出 命令用于blue print页,或者 同步 命令用于live copy页面。
修改:修改源页面。
激活:激活源页面。
停用:停用源页面。
使用“修改”触发器可能会影响性能。 请参阅 MSM 最佳实践以了解更多信息。
下表列出了随AEM一起安装的转出配置。 该表包含每个转出配置的触发器和同步操作。 如果安装的转出配置操作不符合您的要求,您可以 创建转出配置.
名称 | 描述 | 触发器 | 同步操作 另请参阅 安装的同步操作 |
---|---|---|---|
标准转出配置 | 标准转出配置,允许在触发转出时启动转出流程,并执行以下操作: 创建、更新、删除内容和排序子节点。 | 转出 | contentupdate contentCopy contentDelete referencesupdate 产品更新 orderChildren |
在 Blueprint 激活时激活 | 在发布源时发布Live Copy。 | 激活 | targetActivate |
在 Blueprint 停用时停用 | 在停用源时停用Live Copy。 | 停用 | targetDeactivate |
修改时推送 | 修改源时将内容推送到Live Copy。 谨慎使用此转出配置,因为它使用“修改”触发器。 |
修改 | contentupdate contentCopy contentDelete referencesupdate orderChildren |
修改时推送(简略) | 修改Blueprint页面时将内容推送到Live Copy,而不更新引用(例如,对于浅层副本)。 谨慎使用此转出配置,因为它使用“修改”触发器。 |
修改 | contentupdate contentCopy contentDelete orderChildren |
提升发布内容 | 用于提升发布页面的标准转出配置。 | 转出 | contentupdate contentCopy contentDelete referencesupdate orderChildren markLiveRelationship |
目录页面内容转出配置 | 从目录 Blueprint 中应用页面模板。 | 转出 | contentupdate contentCopy contentDelete referencesupdate productCreateUpdate orderChildren |
目录页面更新转出配置 | 从目录Blueprint中应用目标属性。 必须在目录页面内容转出配置后运行。 | 转出 | catalogRolloutHooks |
DPS 发布转出配置 | DPS发布转出配置,允许在触发转出时启动转出过程,同时在初始转出时排除FolioProducer绑定属性 | 转出 | contentupdate contentCopy contentDelete referencesupdate orderChildren dpsMetadataFilter |
旧版(5.6.0)目录转出配置 | 已弃用。 使用目录生成器而不是MSM进行目录转出。 | 转出 | editProperties |
下表列出了随AEM一起安装的同步操作。 如果安装的操作不符合您的要求,您可以 创建新的同步操作.
操作名称 | 描述 | 属性 |
---|---|---|
contentCopy | 当源节点在Live Copy上不存在时,会将节点复制到Live Copy。 配置CQ MSM内容复制操作服务 指定要排除的节点类型、段落项和页面属性。 |
|
contentDelete | 删除源上不存在的Live Copy节点。 配置CQ MSM内容删除操作服务 指定要排除的节点类型、段落项和页面属性。 |
|
contentupdate | 使用来自源的更改来更新Live Copy内容。 配置CQ MSM内容更新操作服务 指定要排除的节点类型、段落项和页面属性。 |
|
editProperties | 编辑Live Copy的属性 editMap属性确定编辑哪些属性及其值。 editMap属性的值必须使用以下格式:
此 例如,请为editMap考虑以下值:
此值编辑Live Copy节点的属性,如下所示:
|
editMap: (字符串)标识属性、当前值和新值。 有关信息,请参阅描述。 |
notify | 发送已转出的页面的页面事件。 要接收通知,首先需要订阅转出事件。 | |
orderChildren | 在Live Copy上,它会根据Blueprint上的顺序对子项(节点)进行排序 |
|
referencesupdate | 在Live Copy上,此同步操作会更新引用,例如链接。 配置CQ MSM引用更新操作服务 指定要排除的节点类型、段落项和页面属性。 |
|
targetVersion | 创建Live Copy的版本。 此操作必须是转出配置中包含的唯一同步操作。 |
|
targetActivate | 激活Live Copy。 此操作必须是转出配置中包含的唯一同步操作。 |
|
targetDeactivate | 停用Live Copy。 此操作必须是转出配置中包含的唯一同步操作。 |
|
工作流 | 启动由Target属性定义的工作流(仅适用于页面),并将Live Copy作为有效负载。 目标路径是模型节点的路径。 |
target: (字符串)工作流模型的路径。 |
必需 | 将Live Copy页面上多个ACL的权限设置为对特定用户组的只读。 已配置以下ACL:
仅对页面使用此操作。 |
target: (字符串)要为其设置权限的组的ID。 |
必选内容 | 将Live Copy页面上多个ACL的权限设置为对特定用户组的只读。 已配置以下ACL:
仅对页面使用此操作。 |
target: (字符串)要为其设置权限的组的ID。 |
mandatoryStructure | 将Live Copy页面上ActionSet.ACTION_NAME_REMOVE ACL的权限设置为特定用户组的只读。 仅对页面使用此操作。 | target: (字符串)要为其设置权限的组的ID。 |
VersionCopyaction | 如果已至少发布过一次Blueprint/源页面,则使用发布的版本创建Live Copy页面。 注意:此操作仅适用于基于已发布的源页面创建Live Copy页面,而不能用于更新现有Live Copy页面。 | |
PageMoveAction | 当页面在Blueprint中移动时将应用PageMoveAction。 该操作会将(相关的)LiveCopy页面从移动前的位置复制到移动后的位置,而不是移动页面。 PageMoveAction不会更改位于移动前位置的LiveCopy页面。 因此,对于连续RolloutConfigurations,它具有不带Blueprint的LiveRelationship状态。 配置CQ MSM页面移动操作服务 指定要排除的节点类型、段落项和页面属性。 此操作必须是转出配置中包含的唯一同步操作。 |
prop_referenceUpdate: (布尔值)设置为true可更新引用。 默认值为true。
|
productCreateUpdate | 创建或更新目录中的产品资源。 此操作用于以下情况之一:
|
|
markLiveRelationship | 指示启动项创建的内容存在实时关系。 | |
catalogRolloutHooks | 执行特定于目录生成的转出挂接。 调用CatalogGenerator的executePageRolloutHooks和executeProductRolloutHooks方法。 请参阅AEM Javadocs中的com.adobe.cq.commerce.pim.api.CatalogGenerator 。 |
|
产品更新 | 更新产品目录的Live Copy中的产品页面 |
您可以 创建转出配置 当安装的转出配置不符合您的应用程序要求时:
然后,在 Blueprint 或 Live Copy 页面上设置转出配置时,您就可以使用新的转出配置。
您可以配置多个支持相应同步操作的 OSGi 服务,以便它们不会影响特定的节点类型和属性。例如,许多与AEM内部功能相关的属性和子节点不应包含在Live Copy中。 只应复制与页面用户相关的内容。
使用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 节点类型 cq.wcm.msm.action.ignoredMixin |
仅适用于CQ MSM内容更新操作。 匹配要从同步操作中排除的mixin节点类型名称的正则表达式。 |
在经典UI中,LiveCopy页面的“页面属性”对话框中显示的锁图标不反映“排除的页面属性”属性的配置。 即使对于从同步操作中排除的属性,也会显示锁定图标。
在触控优化的UI中,另请参阅 在页面属性上配置MSM锁定(触屏优化UI).
默认情况下,将排除多个属性和节点类型,这些属性和节点类型在 CQ MSM 内容更新操作的已排除页面属性下的 OSGi 配置中定义。
默认情况下,在转出时排除(即不更新)与以下正则表达式匹配的属性:
您可以根据需要更改定义排除列表的表达式。
例如,如果您希望将页面标题包含在考虑转出的更改中,请从排除项中删除 jcr:title
。例如,使用正则表达式:
jcr:(?!(title)$).*
您可以配置多个 OSGi 服务以支持与更新引用相关的对应同步操作。
使用AEM时,可通过多种方法管理此类服务的配置设置;请参阅 配置OSGi 以了解更多详细信息和建议的做法。
下表列出了可以为其指定引用更新的同步操作。该表提供了要使用 Web 控制台进行配置的服务名称以及要使用存储库节点进行配置的 PID。
Web控制台属性/OSGi属性 | 描述 |
---|---|
跨嵌套 Live Copy 更新引用 cq.wcm.msm.impl.action.referencesupdate.prop_updateNested |
仅适用于CQ MSM引用更新操作。 选择此选项(Web控制台)或将此布尔属性设置为true(存储库配置)可替换针对位于最顶层LiveCopy分支内任何资源的引用。 |
更新引用页面 cq.wcm.msm.impl.actions.pagemove.prop_referenceUpdate |
仅适用于CQ MSM页面移动操作。 选择此选项(Web控制台)或将此布尔属性设置为 true (存储库配置)更新任何引用以使用原始页面来引用LiveCopy页面。 |
MSM允许您指定通常使用的转出配置集,并且在需要时,您可以覆盖特定活动副本的转出配置集。 MSM 提供了多个位置来指定要使用的转出配置。该位置可确定配置是否适用于特定的Live Copy。
下面列出了可在其中指定要使用的转出配置的位置,并描述了MSM如何确定要用于Live Copy的转出配置:
例如,某个Blueprint使用We.Retail引用站点作为源内容。 从该 Blueprint 创建一个网站。以下列表中的每个项都描述了有关使用转出配置的不同场景:
使用要在转出源页面时使用的转出配置配置Live Copy页面。 子页面默认情况下会继承该配置。在配置要使用的转出配置时,您将覆盖Live Copy页面从其父页面继承的配置。
您还可以在以下情况下为Live Copy页面配置转出配置 创建live copy.
使用 站点 控制台以选择Live Copy页面。
从工具栏中选择属性。
打开 Live Copy 选项卡。
配置部分将显示页面继承的转出配置。
如有必要,请调整 Live Copy继承 标志。 如果选中,Live Copy配置将在所有子项上都有效。
清除继承父项的转出配置属性,然后从列表中选择一个或多个转出配置。
选择的转出配置将显示在下拉列表下。
单击保存。
使用要在转出 Blueprint 页面时使用的转出配置对 Blueprint 页面进行配置。
Blueprint页面的子页面继承配置。 在配置要使用的转出配置时,可能会覆盖页面从其父页面继承的配置。
指定要用作系统默认值的转出配置。 要指定默认值,请配置OSGi服务:
com.day.cq.wcm.msm.impl.LiveRelationshipManagerImpl
liverelationshipmgr.relationsconfig.default
。将此属性值设置为要用作系统默认值的转出配置的路径。默认值为 /libs/msm/wcm/rolloutconfigs/default
,这是标准转出配置。