文档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