文件Experience Cloud KCS

AEM as a Cloud Service：讓自訂內容片段屬性可在新的Assets UI中搜尋

最後更新： 2026年7月27日

本文說明在Adobe Experience Manager as a Cloud Service的全新Assets UI中，讓自訂內容片段屬性可供搜尋所需的步驟。

說明 description

環境

Adobe Experience Manager as a Cloud Service (AEMaaCS) （所有版本）

症狀

  • 新增到內容片段的自訂屬性無法在新的Assets UI （Assets檢視）中搜尋，即使某些欄位可在傳統DAM Assets管理UI中搜尋。
  • 自訂內容片段欄位會在自訂Lucene索引中編制索引，並可透過傳統Assets管理UI進行搜尋。
  • 相同的欄位不會顯示為新Assets UI中的可用搜尋欄位或篩選器。
  • 嘗試調整索引設定（例如新增欄位、變更屬性型別、增加Boost或重新索引）並不能解決新Assets UI的問題。
  • 未顯示特定錯誤訊息，但自訂內容片段屬性缺少預期的搜尋/篩選功能。

原因

新的Assets UI使用不同的搜尋機制，除了包含在Lucene索引中，還要求透過「可搜尋屬性索引」公開自訂屬性。 若沒有此設定，將無法在新版Assets UI中搜尋自訂內容片段屬性。

解決方法 resolution

請依照下列步驟解決問題：

  1. 檢閱搜尋架構：傳統Assets管理UI會直接針對Oak/Lucene索引使用QueryBuilder，而新的Assets UI仰賴AEM存放庫API (R-API)和可搜尋屬性索引。 只有以search:indexed： true​公開的屬性才可供搜尋和篩選。
  2. 驗證Lucene索引設定：確認自訂Lucene索引覆蓋中包含自訂內容片段屬性。 如果屬性的型別為​Long，請將它們變更為​ String ​型別，或在自訂索引覆蓋中明確包含​ Long ​屬性。
  3. 在可搜尋屬性索引中公開屬性：將必要的自訂屬性新增至可搜尋屬性索引設定，以便這些屬性在新的Assets UI中顯示為搜尋欄位和篩選器。 屬性必須在jcr:content/metadata/...之下，才能在Assets檢視篩選中使用。 不支援jcr:content/data/...下的屬性用於此目的。
  4. 組態變更後重新索引：更新索引組態和「可搜尋的屬性索引」後，觸發重新索引以確保變更生效。
  5. 在新的Assets UI中驗證：確認自訂屬性現在顯示為新的Assets UI中可用的搜尋欄位和篩選器。 測試搜尋功能，確保屬性可如預期搜尋。
recommendation-more-help
experience-cloud-kcs-help-kbarticles