金蝶插件类型
大约 2 分钟
金蝶插件类型
金蝶云·星空（BOS 平台）目前（2025 年）所有官方提供的、真正常用的插件基类就只有下面这 10 个，基本上覆盖了 100% 的开发场景。
我按使用频率从高到低给你排好序，并标明到底注册到哪里：
| 序号 | 基类名称 | 主要用途 | 注册位置（开发工具） | 使用频率 |
|---|---|---|---|---|
| 1 | AbstractBillPlugIn | 单据界面所有自定义按钮、事件（打开单据后看到的界面） | 单据界面插件（或设计器按钮直接填插件类） | ★★★★★ |
| 2 | AbstractListPlugIn | 列表界面所有自定义按钮、事件（列表工具栏按钮） | 列表界面插件 | ★★★★★ |
| 3 | AbstractOperationServicePlugIn | 列表批量操作按钮（支持多选，显示绿勾红叉结果） | 操作服务插件 | ★★★★ |
| 4 | AbstractBillServicePlugIn | 单据的保存、审核、反审核、删除等操作的前后事件 | 单据服务插件（替代旧的 Save/AuditPlugIn） | ★★★★ |
| 5 | AbstractDynamicFormPlugIn | 自定义表单（动态表单设计器做的页面）所有按钮事件 | 动态表单插件 | ★★★ |
| 6 | AbstractReportPlugIn | 帐表、报表自定义按钮和行颜色、单元格样式等 | 报表插件 | ★★★ |
| 7 | AbstractScheduleServicePlugIn | 定时任务（每天/每周自动执行的后台任务） | 定时任务插件 | ★★ |
| 8 | AbstractWebApiPlugIn | 自定义 Web API 接口（给外部系统调用） | WebApi 插件 | ★★ |
| 9 | AbstractImportServicePlugIn | 自定义导入插件（Excel 导入时加自己的校验逻辑） | 导入服务插件 | ★★ |
| 10 | AbstractAppPlugIn | 移动端 APP 自定义页面插件（极少用） | 移动应用插件 | ★ |
已经彻底淘汰或几乎没人用的老基类（不要再用）
| 基类名称 | 说明 | 替代方案 |
|---|---|---|
| AbstractSavePlugIn | 老版保存插件 | → AbstractBillServicePlugIn |
| AbstractAuditPlugIn | 老版审核插件 | → AbstractBillServicePlugIn |
| AbstractUnAuditPlugIn | 老版反审核插件 | → AbstractBillServicePlugIn |
| AbstractPushPlugIn | 老版下推插件 | → AbstractOperationServicePlugIn |
| AbstractConvertPlugIn | 老版转换插件 | → AbstractOperationServicePlugIn |
99% 开发者每天只用前 4 个就够了
| 你要做什么？ | 用哪个基类？ | 注册到哪里？ |
|---|---|---|
| 单据上加一个按钮（比如“打印”“生成XX”） | AbstractBillPlugIn | 单据界面插件 |
| 列表上加一个普通按钮 | AbstractListPlugIn | 列表界面插件 |
| 列表上加一个“批量”按钮（多选后执行） | AbstractOperationServicePlugIn | 操作服务插件 |
| 单据保存/审核前校验、后写其他单据 | AbstractBillServicePlugIn | 单据服务插件 |
记住这 4 个基类 + 注册位置，你在金蝶里 95% 的插件需求都可以完美解决。其余 6 个属于“偶尔需要”或“专业场景”。
总结一句话：
日常开发只认这四个就够了：BillPlugIn → ListPlugIn → OperationServicePlugIn → BillServicePlugIn
其他的全是“高级玩家”用的。