用途:该技能用于在 Umbraco 后台(backoffice)中实现自定义搜索提供程序(Search Provider),把自有数据源接入后台搜索栏,与内置的内容、媒体、成员搜索并列展示。
主要能力:实现 UmbSearchProvider 接口的 search 方法,接收查询参数并返回符合 UmbSearchResultItemModel 的分页结果;支持通过 searchFrom 参数进行限定范围的搜索;结果项包含 entityType、unique、name、icon、href 等字段,可自定义结果展示与跳转地址。
使用方式:先通过 WebFetch 获取官方最新文档(扩展类型、Foundation、扩展注册表等 URL),再确认要搜索的数据、返回字段与结果展示需求,然后生成 manifest 与 provider 类。manifest 类型为 searchProvider,指定 alias、name、api 动态导入与 meta.label;provider 继承 UmbControllerBase 并实现 search,可调用 fetch 或仓储(Repository Pattern)获取数据。相关基础技能包括 umbraco-repository-pattern 与 umbraco-context-api。
适用场景:需要让编辑人员在后台搜索栏中检索自定义实体、外部 API 数据或业务数据时使用。
限制:资料未提供具体版本要求、安装命令、收费信息或性能数据;实现前必须获取最新官方文档,示例代码需按实际数据源调整,不能直接照搬。