从自定义AEM工作流中的页面发布中排除体验片段

本文介绍如何更新自定义Adobe Experience Manager (AEM)工作流,以便体验片段不与页面一起发布,从而允许按单独的计划管理和发布体验片段。

描述 description

环境

  • 具有自定义页面发布工作流的AEM Sites实例
  • 自定义工作流收集引用并提交页面和引用路径以进行复制

问题/症状

  • 自定义工作流使用ReferenceProvider.findReferences()收集所有引用的内容,然后使用Replicator.replicate().发布页面及其引用
  • 引用的体验片段将随页面一起发布,即使作者按单独的计划管理和发布这些片段也是如此。
  • 标准的“管理发布”流程允许作者取消选择引用。 自定义工作流不提供该选项,除非工作流实施它。
  • 自定义工作流需要一个确定性规则来排除体验片段引用,然后才能提交路径进行复制。

原因

自定义工作流在提交进行复制的列表中包含体验片段路径。 由于工作流不筛选这些路径,因此引用的体验片段将随页面一起发布。 标准的管理发布流具有引用选择控件,但自定义工作流必须实施自己的筛选或选择逻辑。

解决方法 resolution

请按照以下步骤解决问题。

  1. 在调用Replicator.replicate()之前,更新您的自定义WorkflowProcess实施以排除体验片段引用。

  2. 通过ReferenceProvider.findReferences()检索引用后,识别指向体验片段的任何引用。 体验片段通常存储在/content/experience-fragments路径下。

  3. 在复制收集的引用之前,筛选出体验片段路径。 以下示例显示了一种方法:

    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
        );
    }
    
  4. 如果需要进行其他验证,请解析每个引用目标,并通过检查其资源类型或使用您的AEM版本中提供的体验片段API来验证它是否为体验片段。

  5. 部署更新后的工作流并发布测试页面。

  6. 验证页面是否已成功发布,以及引用的体验片段是否除非单独发布,否则不会复制。

recommendation-more-help
experience-cloud-kcs-help-kbarticles