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