從自訂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