从自定义AEM工作流中的页面发布中排除体验片段
本文介绍如何更新自定义Adobe Experience Manager (AEM)工作流,以便体验片段不与页面一起发布,从而允许按单独的计划管理和发布体验片段。
描述 description
环境
- 具有自定义页面发布工作流的AEM Sites实例
- 自定义工作流收集引用并提交页面和引用路径以进行复制
问题/症状
- 自定义工作流使用
ReferenceProvider.findReferences()收集所有引用的内容,然后使用Replicator.replicate().发布页面及其引用 - 引用的体验片段将随页面一起发布,即使作者按单独的计划管理和发布这些片段也是如此。
- 标准的“管理发布”流程允许作者取消选择引用。 自定义工作流不提供该选项,除非工作流实施它。
- 自定义工作流需要一个确定性规则来排除体验片段引用,然后才能提交路径进行复制。
原因
自定义工作流在提交进行复制的列表中包含体验片段路径。 由于工作流不筛选这些路径,因此引用的体验片段将随页面一起发布。 标准的管理发布流具有引用选择控件,但自定义工作流必须实施自己的筛选或选择逻辑。
解决方法 resolution
请按照以下步骤解决问题。
-
在调用
Replicator.replicate()之前,更新您的自定义WorkflowProcess实施以排除体验片段引用。 -
通过
ReferenceProvider.findReferences()检索引用后,识别指向体验片段的任何引用。 体验片段通常存储在/content/experience-fragments路径下。 -
在复制收集的引用之前,筛选出体验片段路径。 以下示例显示了一种方法:
code language-none // Collect references List<Reference> references = referenceProvider.findReferences(resourceResolver, pagePath, ...); // Filter out Experience Fragments List<String> pathsToReplicate = references.stream() .map(Reference::getTargetPath) .filter(path -> !path.startsWith("/content/experience-fragments")) .collect(Collectors.toList()); // Add the page path itself pathsToReplicate.add(pagePath); // Replicate only the filtered paths for (String path : pathsToReplicate) { replicator.replicate( session, ReplicationActionType.ACTIVATE, path ); } -
如果需要进行其他验证,请解析每个引用目标,并通过检查其资源类型或使用您的AEM版本中提供的体验片段API来验证它是否为体验片段。
-
部署更新后的工作流并发布测试页面。
-
验证页面是否已成功发布,以及引用的体验片段是否除非单独发布,否则不会复制。
recommendation-more-help
experience-cloud-kcs-help-kbarticles