由於AEM Guides中的快取,Assets已在DXML後處理中跳過

AEM Guides中的DXML後續處理對於確保資產中繼資料(例如標題、檔案狀態和連結參考)在使用者介面中正確同步化及呈現而言至關重要。 如此可讓編寫的內容精確顯示且導覽可靠。 如果AEM Guides中的資產未正確處理(例如遺失中繼資料、主題連結中斷或不完整的輸出預設集),問題可能源於DXML後處理器中的快取路徑。 本文會說明如何識別存放庫中被忽略的路徑,並將其移除,以還原適當的資產處理和中繼資料同步化。

說明 description

環境

  • 產品: Adobe Experience Manager (AEM) Managed Services
  • 版本: AEM 6.5, Guides 4.0+

問題/症狀

  • DITA檔案中的 標題 欄位未保留更新,並在重新整理後回覆成先前的狀態。
  • 檔案狀態欄位不存在於[屬性]主控台中,但顯示在[檔案屬性]面板中。
  • 檔案顯示為檔案,而不是指南中預期的 主題 型別。
  • 新增到地圖的主題以紅色顯示,表示中斷或無法使用的連結,而不是藍色。
  • 如果資產位於CRX/DE中/var/dxml/postprocess/ignoredPaths節點下所列的路徑中,新建立的地圖可能會遺漏輸出預設集。 這些路徑會被視為已從DXML後處理中排除,而問題可能會發生在該節點中定義的任何位置。
  • 檔案屬性下的 用於傳出連結 參考未正確更新。

解決方法 resolution

此問題的根本原因是後處理工作流程會因為快取資產路徑而忽略特定路徑。 AEM Guides提供OSGi設定,讓管理員可指定哪些資料夾應排除在後續處理之外 — 請參閱AEM Guides檔案中的停用資料夾的後處理。 除了此設定,存放庫在/var/dxml/postprocess/ignoredPaths處包含一個節點,充當要略過的路徑快取。 如果資產位於這些路徑之一,在DXML後續處理期間將會被忽略,並且可能會出現INFO層級的記錄訊息,例如:

[個後處理]路徑因快取設定而略過
[後處理]正在略過下列承載的後處理: /content/dam/<資產路徑>

要解決的步驟

  1. 確認受影響的路徑列在CRX/DE的/var/dxml/postprocess/ignoredPaths下。 導覽至此節點,並檢查與已忽略路徑對應的屬性。 如需相關步驟,請參閱AEM as a Cloud Service使用手冊中的CRXDE Lite快速入門

  2. ignoredPaths節點移除不必要的專案:僅保留預設值/content/dam/projects/translation_output。 如需相關步驟,請參閱AEM 6.5使用手冊中的How to Delete Properties and Nodes with cURL。 如果您POST具有空值的屬性給節點,AEM會刪除該屬性。 若要從指定節點移除屬性,請使用下列格式:

    code language-none
    curl -u 'userId:password' \
    -F "propertyName=" \
    http://localhost:4502/path/to/node
    

    propertyName應取代為您要移除之屬性的名稱。

    path/to/node應為屬性存在的存放庫路徑。 將等號(=)之後的值保留為空白,會告訴AEM刪除指定的屬性。

    注意您必須針對要從節點移除的每個屬性重複此命令。

  3. 刪除與受影響路徑相關的所有其他專案。 或僅刪除導致受影響資產被忽略的路徑。 如需相關步驟,請參閱AEM 6.5使用手冊中的Sling內容

  4. 對受影響路徑下的所有資產重新執行DAM更新資產工作流程。 這可確保中繼資料的產生和資產的正確處理。 如需相關步驟,請參閱AEM Assets教學課程中的執行DAM更新資產工作流程

  5. 驗證:

    1. 標題會在更新後持續存在。

    2. Document State欄位在介面中正確顯示。

    3. 檔案圖示會顯示為主題

    4. 主題新增到地圖時以藍色顯示。

    5. 所有輸出預設集都可用於新地圖。

    6. 參考(用於傳出連結)已正確更新。

      您可以參閱AEM Guides檔案中的AEM Guides報告,以開發驗證檢查清單,驗證跨資產和地圖的內容狀態、參照和輸出相關屬性。

在清除忽略的路徑並重新執行資產工作流程後,先前遺失的資產和中繼資料將會重新出現,並在AEM Guides中正確顯示。 標題、檔案狀態、連結和輸出預設集將如預期更新,確認處理已正常恢復。

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