配置 Live Copy 同步 configuring-live-copy-synchronization

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：

创建对象：

管理员

CAUTION

AEM 6.4已结束扩展支持，本文档将不再更新。有关更多详细信息，请参阅技术支助期. 查找支持的版本此处.

执行以下任务以控制Live Copy如何以及何时与其源内容同步。

确定现有的转出配置是否满足您的要求，或者您是否需要创建一个或多个。
指定要用于Live Copy的转出配置。

已安装和自定义转出配置 installed-and-custom-rollout-configurations

本节提供有关已安装的转出配置及其使用的同步操作的信息，以及如果需要，如何创建自定义配置。

CAUTION

正在更新或更改现成的（已安装）转出配置 not 推荐。如果需要自定义实时操作，则应将其添加到自定义转出配置中。

转出触发器 rollout-triggers

每个转出配置都使用一个导致转出发生的转出触发器。转出配置可以使用以下触发器之一：

转出时:的转出命令，或者同步命令。
修改：修改源页面。
激活：激活源页面。
停用：停用源页面。

NOTE

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

已安装的转出配置 installed-rollout-configurations

下表列出了随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

目录页面内容转出配置

从目录 Blueprint 中应用页面模板。

转出

contentUpdate
contentCopy
contentDelete
referencesUpdate
productCreateUpdate
orderChildren

目录页面更新转出配置

从目录Blueprint中应用目标属性。必须在目录页面内容转出配置后运行。

转出

catalogRolloutHooks

DPS 发布转出配置

DPS发布转出配置，该配置允许在转出触发器上启动转出进程，同时在初始转出时排除FolioProducer绑定属性

转出

contentUpdate
contentCopy
contentDelete
referencesUpdate
orderChildren
dpsMetadataFilter

旧版(5.6.0)目录转出配置

已弃用。请使用 Catalog Generator 代替 MSM 进行目录转出。

转出

editProperties

已安装的同步操作 installed-synchronization-actions

下表列出了随AEM一起安装的同步操作。如果已安装的操作不符合您的要求，您可以创建新的同步操作.

操作名称

描述

属性

contentCopy

如果Live Copy上不存在源节点，则将节点复制到Live Copy。配置CQ MSM内容复制操作服务指定要排除的节点类型、段落项和页面属性。

contentDelete

删除源上不存在的Live Copy节点。配置 CQ MSM 内容删除操作服务，以指定要排除的节点类型、段落项和页面属性。

contentUpdate

使用源中的更改更新Live Copy内容。配置CQ MSM内容更新操作服务指定要排除的节点类型、段落项和页面属性。

editProperties

编辑Live Copy的属性。 editMap属性确定要编辑的属性及其值。 editMap属性的值必须使用以下格式：

[property_name_1]#[current_value]#[new_value],
[property_name_2]#[current_value]#[new_value],
... ,
[property_name_n]#[current_value]#[new_value]

的 current_value 和 new_value 项目是正则表达式。

例如，请考虑editMap的以下值：

sling:resourceType#/(contentpage|homepage)#/
mobilecontentpage，
cq:template#/contentpage#/mobilecontentpage

此值编辑Live Copy节点的属性，如下所示：

的 sling:resourceType 属性设置为 contentpage 或 homepage 设置为 mobilecontentpage.
的 cq:template 设置为的属性 contentpage 设置为 mobilecontentpage.

editMap:（字符串）标识属性、当前值和新值。有关信息，请参阅描述。

notify

发送已转出页面的页面事件。要接收通知，首先需要订阅转出事件。

orderChildren

在Live Copy中，它会根据Blueprint上的顺序对子项（节点）进行排序

referencesUpdate

在Live Copy上，此同步操作会更新引用，如链接。
它会搜索Live Copy页面中指向Blueprint中资源的路径。找到后，它会更新路径，以指向Live Copy（而不是Blueprint）中的相关资源。具有 Blueprint 外部目标的引用不会发生更改。

配置 CQ MSM 引用更新操作服务，以指定要排除的节点类型、段落项和页面属性。

targetVersion

创建Live Copy的版本。

此操作必须是转出配置中包含的唯一同步操作。

targetActivate

激活Live Copy。

此操作必须是转出配置中包含的唯一同步操作。

targetDeactivate

停用Live Copy。

此操作必须是转出配置中包含的唯一同步操作。

工作流

启动由Target属性定义的工作流（仅限页面），并将Live Copy作为有效负载。

目标路径是模型节点的路径。

目标：（字符串）工作流模型的路径。

强制

将Live Copy页面上多个ACL的权限设置为特定用户组的只读权限。配置了以下ACL:

ActionSet.ACTION_NAME_REMOVE
ActionSet.ACTION_NAME_SET_PROPERTY
ActionSet.ACTION_NAME_ACL_MODIFY

仅对页面使用此操作。

目标：（字符串）您为其设置权限的组的ID。

mandatoryContent

将Live Copy页面上多个ACL的权限设置为特定用户组的只读权限。配置了以下ACL:

ActionSet.ACTION_NAME_SET_PROPERTY
ActionSet.ACTION_NAME_ACL_MODIFY

仅对页面使用此操作。

目标：（字符串）您为其设置权限的组的ID。

mandatoryStructure

将Live Copy页面上的ActionSet.ACTION_NAME_REMOVE ACL的权限设置为特定用户组的只读权限。仅对页面使用此操作。

目标：（字符串）您为其设置权限的组的ID。

VersionCopyAction

如果Blueprint/源页面至少已发布一次，则使用已发布的版本创建Live Copy页面。注意：此操作仅适用于基于已发布的源页面创建Live Copy页面，而不适用于更新现有Live Copy页面。

PageMoveAction

在Blueprint中移动了页面后，将应用PageMoveAction。

操作会复制（相关）LiveCopy页面，而不是从移动之前的位置移动到之后的位置。

PageMoveAction不会更改LiveCopy页面在移动前所在位置的位置。因此，对于连续的RolloutConfigurations，它的状态为不带Blueprint的LiveRelationhip。

配置 CQ MSM 页面移动操作服务，以指定要排除的节点类型、段落项和页面属性。

此操作必须是转出配置中包含的唯一同步操作。

prop_referenceUpdate:（布尔值）设置为true可更新引用。默认值为true。

productCreateUpdate

在目录中创建或更新产品资源。此操作将用于以下任一情况：

生成或转出目录（或目录部分）
用户恢复产品组件的同步继承。

markLiveRelationship

表示启动项创建的内容存在实时关系。

catalogRolloutHooks

执行特定于目录生成的转出挂接。调用CatalogGenerator的executePageRolloutHooks和executeProductRolloutHooks方法。
请参阅AEM Javaoc中的com.adobe.cq.commerce.pim.api.CatalogGenerator 。

productUpdate

更新产品目录Live Copy中的产品页面

创建转出配置 creating-a-rollout-configuration

您可以创建转出配置当安装的转出配置不符合您的应用程序要求时：

然后，在Blueprint或Live Copy页面上设置转出配置时，您可以使用新的转出配置。

从同步中排除属性和节点类型 excluding-properties-and-node-types-from-synchronization

您可以配置多个支持相应同步操作的 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节点类型名称匹配的正则表达式。

NOTE

在经典UI中，LiveCopy页面的“页面属性”对话框中显示的锁定图标未反映“排除的页面属性”属性的配置。即使对于从同步操作中排除的属性，也会显示锁图标。

NOTE

在触屏UI中，另请参阅在页面属性上配置MSM锁定).

CQ MSM内容更新操作 — 排除项 cq-msm-content-update-action-exclusions

默认情况下，会排除一些属性和节点类型，这些属性和节点类型在的OSGi配置中定义 CQ MSM内容更新操作，在 排除的页面属性.

默认情况下，转出时将排除（即未更新）与以下正则表达式匹配的属性：

chlimage_1-18

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

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

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

配置同步以更新引用 configuring-synchronization-for-updating-references

您可以配置多个 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页面。

指定要使用的转出配置 specifying-the-rollout-configurations-to-use

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使用We.Retail引用站点作为源内容。从Blueprint创建站点。以下列表中的每个项目都描述了有关使用转出配置的不同方案：

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