DITA Map或主題參照會因為過期的fmPostProcessedAt屬性而中斷

使用Adobe Experience Manager as a Cloud Service (AEMaaCS)或AEM 6.5搭配AEM Guides時,DITA Map或主題參照可能已損毀,且UI中可能遺失輸出預設集。 這通常發生在資產因過時fmPostProcessedAt屬性而無法同步時 — 通常是在手動部署或移轉之後。 若要解決此問題,請使用DAM更新資產工作流程重新處理受影響的資產。

說明 description

環境

  • 產品: Adobe Experience Manager (AEM) — 網站
  • 版本: AEM 6.5、AEM as a Cloud Service (AEMaaCS)

問題/症狀

  • 部署後,即使主題存在於存放庫中,DITA Map主題參照在作者UI中仍顯示為損壞(紅色)。

  • 由於未解析或中斷的主題參照,PDF或其他輸出產生失敗。

  • 重新整理頁面或產生檔案後,新建立的輸出預設集從AEM Guides UI中消失,但會顯示在CRXDE中。

  • /bin/guides/presets端點傳回受影響地圖的​ 500伺服器 ​錯誤。

  • 警告/錯誤記錄檔包含訊息,例如:

    • 找到ref GUID-xxxx.ditamap的節點……但由於不同步,傳回null
    • com.adobe.fmdita.rest.presets.PresetsAPI錯誤: {"errorCode":"DXML_MESSAGE_0004"}
    • java.lang.NullPointerException…
  • 手動DITA內容套件部署或環境間的移轉會導致DITA資產不同步。

原因

當DITA資產不同步(通常是由於jcr:createdfmPostProcessedAt屬性不符)時,就會發生問題。 這種不匹配導致Guides UI和API無法正確解析主題參照和輸出預設集。

這種不同步狀態的常見原因包括:

  • 透過封裝或管道移轉DITA內容而不觸發後續處理。
  • 在AEM中手動匯入或編輯DITA資產。
  • 部署後資產工作流程處理不完整或失敗。

解決方法 resolution

若要解決問題,請依照下列步驟進行:

  1. 透過檢查不相符​ ​值的錯誤記錄檔,識別標示為jcr:created不同步fmPostProcessedAt的資產。

  2. 使用AEM中的標準DAM更新資產工作流程重新處理受影響的資產,其中包括DXML後續處理發起人(com.adobe.fmdita.postprocess.PostProcessJobInitiator)步驟,以確保fmPostProcessedAt值正確更新。

  3. 建立自訂工作流程(如有必要):

    • 在AEM中設定僅包含 DXML後續處理發起人 步驟的新工作流程模型。
    • 在受影響的對應或主題上執行此工作流程以更新其同步狀態。
  4. 確認已解決中斷的主題參考、輸出產生成功完成、預設集在AEM Guides UI中正確顯示,以及/bin/guides/presets傳回預期的結果。

相關閱讀

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f