用途:Entity Actions 用于对 Umbraco 中的特定条目执行操作,是关联文档、媒体或自定义实体类型的通用扩展点。这些操作会出现在后台各处的上下文菜单中,并可由用户权限控制。
主要能力:通过清单(manifest)注册 entityAction 类型扩展,指定别名、名称、权重、API 类、适用实体类型(forEntityTypes)以及图标和标签等 meta 信息;操作类继承 UmbEntityActionBase,在 execute() 中通过 this.unique 获取实体唯一标识并执行逻辑;可结合仓储(Repository)访问数据,或通过 getHref() 实现基于链接的操作。常见实体类型包括 document、media、member、data-type、document-type、media-type。
使用方式:实现前应先用 WebFetch 获取最新官方文档(主文档、Foundation、Extension Registry 三个链接),确认实体类型、要执行的操作和所需权限,再生成 manifest 与操作类文件,并说明如何测试。示例清单使用 type: 'entityAction'、api 指向操作类、forEntityTypes 指定实体类型;操作类构造函数接收 host 与包含 unique、entityType 的参数。
适用场景:为后台条目添加次级功能,如权限操作、自定义数据处理等;官方源码中提供了权限操作与用户权限两个参考示例。
限制:资料未提供具体收费、价格、平台或效果信息;实现细节以官方最新文档为准,示例应保持最小化并生成完整可运行代码。