Adobe Experience Manager as a Cloud Service使用 Sling内容分发 能够将内容移动到要复制到在AEM运行时以外的Adobe Developer上运行的管道服务的功能。
阅读分发以了解更多信息。
如果您有兴趣批量发布内容,请使用 发布内容树工作流.
此工作流步骤是专为Cloud Service构建的,可有效处理大型负载。
不建议自行构建批量发布自定义代码。
如果您必须出于任何原因进行自定义,则可以使用现有工作流API触发此工作流/工作流步骤。
始终最好是仅发布必须发布的内容。 此外,如果不需要的话,对于不尝试发布大量内容也要谨慎。 但是,您可以通过发布内容树工作流发送的内容量没有任何限制。
此功能允许您立即发布选定的页面,而无需通过“管理发布”方法选择其他选项。
有关更多信息,请参阅管理发布。
开始时间和关闭时间的附加可能性可从页面属性的“基本”选项卡获得。
要实现此功能的自动复制,请启用 自动复制 在 OSGi配置 开启关闭触发器配置:
与快速发布相比,管理发布提供了更多选项,允许包含子页面、自定义引用和启动任何适用的工作流,并且还提供了以后发布的选项。
为“稍后发布”选项包含文件夹的子项会调用发布内容树工作流,如本文所述。
您可以在出版基础文档中找到有关管理出版的更多详细信息。
您可以通过选择工具 – 工作流 – 模型和复制发布内容树现成的工作流模型,如下所示:
请勿调用原始模型。 相反,请确保首先复制模型并调用该副本。
与所有工作流一样,也可以通过 API 调用。 有关更多信息,请参阅 以编程方式与工作流交互.
或者,您可以创建一个工作流模型,该模型使用 Publish Content Tree
流程步骤:
从 AEM as a Cloud Service 主页,转到工具 – 工作流 – 模型.
在“工作流模型”页面中,按屏幕右上角的创建.
为模型添加标题和名称。 有关更多信息,请参阅创建工作流模型。
从列表中选择新创建的模型,然后按 编辑
在以下窗口中,将“流程步骤”拖放到当前模型流中:
选择流中的流程步骤,然后选择 配置 按扳手图标。
选择 进程 选项卡并选择 Publish Content Tree
,然后检查 处理程序前进 复选框
在参数字段中设置任何附加参数。 可以将多个以逗号分隔的参数字符串在一起。 例如:
enableVersion=true,agentId=publish,includeChildren=true
有关参数列表,请参阅参数部分。
按完成以保存工作流模型。
参数
includeChildren
(布尔值,默认:false
)。 值 false
这意味着仅发布路径; true
意味着子项也被发布。replicateAsParticipant
(布尔值,默认:false
)。 如果配置为 true
,则复制操作将使用 userid
执行参与者步骤的主体。enableVersion
(布尔值,默认: true
)。 此参数可确定复制时是否创建了新版本。agentId
(字符串值,默认表示仅使用发布代理)。 建议明确说明 agentId;例如,将其设置为值:发布。 将代理设置为 preview
发布到preview服务。filters
(字符串值,默认表示激活所有路径)。 可用值包括:
onlyActivated
— 仅激活已(已)激活的页面。 作为重新激活的一种形式。onlyModified
– 仅激活已激活且修改日期晚于激活日期的路径。onlyActivated|onlyModified
。记录
当树激活工作流步骤启动时,它将在“信息”日志级别记录其配置参数。 激活路径时,也会记录 INFO 语句。
在工作流步骤复制了所有路径之后,将记录最终的INFO语句。
此外,您还可以将日志记录器的日志级别提高到以下 com.day.cq.wcm.workflow.process.impl
到DEBUG/TRACE以获取更多日志信息。
如果出现错误,工作流步骤将终止 WorkflowException
,用于封装基础异常。
以下是在示例发布内容树工作流中生成的日志示例:
21.04.2021 19:14:55.566 [cm-p123-e456-aem-author-797aaaf-wkkqt] *INFO* [JobHandler: /var/workflow/instances/server60/2021-04-20/brian-tree-replication-test-2_1:/content/wknd/us/en/adventures] com.day.cq.wcm.workflow.process.impl.treeactivation.TreeActivationWorkflowProcess TreeActivation options: replicateAsParticipant=false(userid=workflow-process-service), agentId=publish, chunkSize=100, filter=, enableVersion=false
21.04.2021 19:14:58.541 [cm-p123-e456-aem-author-797aaaf-wkkqt] *INFO* [JobHandler: /var/workflow/instances/server60/2021-04-20/brian-tree-replication-test-2_1:/content/wknd/us/en/adventures] com.day.cq.wcm.workflow.process.impl.ChunkedReplicator closing chunkedReplication-VolatileWorkItem_node1_var_workflow_instances_server60_2021-04-20_brian-tree-replication-test-2_1, 17 paths replicated in 2971 ms
恢复支持
该工作流会按块处理内容,每个块表示要发布的完整内容的子集。 如果系统停止了工作流,它将重新启动并处理尚未处理的块。 日志语句声明内容已从特定路径恢复。
您可以使用 AEM as a Cloud Service 中提供的复制 API 发布内容。
有关详细信息,请参阅 API 文档。
API 的基本用法
@Reference
Replicator replicator;
@Reference
ReplicationStatusProvider replicationStatusProvider;
....
Session session = ...
// Activate a single page to all agents, which are active by default
replicator.replicate(session,ReplicationActionType.ACTIVATE,"/content/we-retail/en");
// Activate multiple pages (but try to limit it to approx 100 at max)
replicator.replicate(session,ReplicationActionType.ACTIVATE, new String[]{"/content/we-retail/en","/content/we-retail/de"});
// ways to get the replication status
Resource enResource = resourceResolver.getResource("/content/we-retail/en");
Resource deResource = resourceResolver.getResource("/content/we-retail/de");
ReplicationStatus enStatus = enResource.adaptTo(ReplicationStatus.class);
// if you need to get the status for more more than 1 resource at once, this approach is more performant
Map<String,ReplicationStatus> allStatus = replicationStatusProvider.getBatchReplicationStatus(enResource,deResource);
使用特定代理进行复制
如上面的示例所示,在复制资源时,将只使用默认处于活动状态的代理。 在AEMas a Cloud Service中,它仅意味着称为“发布”的代理,用于将作者连接到发布层。
为了支持预览功能,已添加名为“预览”的新代理,默认情况下该代理处于非活动状态。 此代理用于将作者连接到预览层。 如果只想通过预览代理复制,则必须通过 AgentFilter
.
请参阅以下示例:
private static final String PREVIEW_AGENT = "preview";
ReplicationStatus beforeStatus = enResource.adaptTo(ReplicationStatus.class); // beforeStatus.isActivated == false
ReplicationOptions options = new ReplicationOptions();
options.setFilter(new AgentFilter() {
@Override
public boolean isIncluded (Agent agent) {
return agent.getId().equals(PREVIEW_AGENT);
}
});
// will replicate only to preview
replicator.replicate(session,ReplicationActionType.ACTIVATE,"/content/we-retail/en", options);
ReplicationStatus afterStatus = enResource.adaptTo(ReplicationStatus.class); // afterStatus.isActivated == false
ReplicationStatus previewStatus = afterStatus.getStatusForAgent(PREVIEW_AGENT); // previewStatus.isActivated == true
如果您没有提供此类过滤器,并且只使用“发布”代理,则不使用“预览”代理,并且复制操作不会影响预览层。
仅当复制操作包括至少一个默认处于活动状态的代理时,才会修改资源的整体ReplicationStatus
。 在上面的示例中,此流不是这种情况。 复制只是使用“预览”代理。 因此,您必须使用新的 getStatusForAgent()
方法,允许查询特定代理的状态。 此方法也适用于“发布”代理。 如果已使用提供的代理完成任何复制操作,则返回非空值。
您可以直接使内容失效,方法是使用作者的Sling内容失效(SCD)(首选方法),或使用复制API调用发布Dispatcher刷新复制代理。 请参阅 缓存 页面,了解更多详细信息。
复制 API 容量限制
一次复制不到100个路径,以500为限制。 超出限制,a ReplicationException
被抛出。
如果您的应用程序逻辑不需要原子复制,则可以通过设置 ReplicationOptions.setUseAtomicCalls
为false,接受任意数量的路径,但在内部创建存储段以保持在此限制以下。
每次复制调用传输的内容大小不得超过 10 MB
。 此规则包括节点和属性,但不包括任何二进制文件(工作流包和内容包被视为二进制文件)。
要对复制问题进行故障诊断,请导航到 AEM 创作服务 Web UI 中的复制队列:
如果内容无法发布,则整个发布将从 AEM 发布服务中恢复。
在这种情况下,可编辑的主队列将显示红色状态,应该进行审查以确定哪些项目导致取消发布。 通过单击该队列,将显示其待处理项目,如果需要,可从中清除单个项目或所有项目。