金蝶二次开发技能
产品线识别
收到需求后先识别目标产品：
| 关键词 | 产品 | 技术栈 | 参考 |
|---|---|---|---|
| 星空、K3 Cloud、K/3 Cloud、BOS IDE、C#插件 | 金蝶云星空 | C# / .NET / SQL Server / IIS | references/xingkong-plugin-dev.md |
| 苍穹、Cosmic、AI苍穹、低代码、KingScript | 金蝶云苍穹 | Java / Spring Cloud / PostgreSQL | references/cangqiong-dev.md |
无法判断时，问用户。
需求分析流程
拿到一个二开需求，按以下步骤拆解：
- 明确产品线 → 星空 or 苍穹
- 需求分类 → 属于哪类开发：
- 插件开发（重点）：表单交互 / 列表过滤 / 操作校验 / 报表数据 / 单据转换 / 服务扩展
- BOS建模：新建或扩展单据、字段、菜单
- 接口开发：WebAPI 对接第三方系统
- 报表开发：直接SQL账表 / 简单账表
- 数据层：SQL查询 / 数据迁移
- 选择插件类型 → 见下方插件选择矩阵
- 编码 → 使用
references/plugin-templates.md中对应模板 - 测试调试 → 参
references/deployment-ops.md - 打包部署 → 参
references/deployment-ops.md
插件选择矩阵（星空）
| 需求场景 | 插件类型 | 基类 | 参考 |
|---|---|---|---|
| 单据界面交互（按钮点击、字段变更、数据联动） | 表单插件 | AbstractFormPlugin | references/xingkong-plugin-dev.md §表单插件 |
| 列表界面过滤、工具栏操作 | 列表插件 | AbstractListPlugin | references/xingkong-plugin-dev.md §列表插件 |
| 保存/提交/审核时校验或干预 | 操作插件 | AbstractOperationServicePlugIn | references/xingkong-plugin-dev.md §操作插件 |
| 报表数据查询与展示 | 报表插件 | AbstractSysReportServicePlugIn | references/xingkong-plugin-dev.md §报表插件 |
| 下推转单时干预转换逻辑 | 单据转换插件 | AbstractConvertPlugIn | references/xingkong-plugin-dev.md §单据转换插件 |
| 自定义WebAPI / 定时任务 / 后台服务 | 服务插件 | ISysReportService / IDOService | references/xingkong-plugin-dev.md §服务插件 |
核心参考文件
| 文件 | 内容 | 何时读取 |
|---|---|---|
references/xingkong-plugin-dev.md | 星空6大类插件完整开发指南（重点） | 星空插件开发需求 |
references/plugin-templates.md | 各类插件完整代码模板 | 编码阶段直接套用 |
references/xingkong-bos-ide.md | BOS IDE 操作手册 | 需要BOS建模/配置时 |
references/xingkong-webapi.md | WebAPI 接口开发 | 第三方对接需求 |
references/database-reference.md | 数据库核心表/SQL/多语言/LK表 | 写SQL/查数据时 |
references/cangqiong-dev.md | 苍穹二次开发 | 苍穹相关需求 |
references/common-patterns.md | 常见开发模式 + 社区FAQ | 遇到典型问题/报错时 |
references/deployment-ops.md | 打包部署/调试/运维 | 部署阶段 |
编码规范
- 命名：插件类名 =
{业务对象}{功能}PlugIn，如SaleOrderValidatePlugIn - 多语言：涉及中文名称的字段必须关联
_L表，FLOCALEID=2052 - 上下游关联：使用
_LK关联表，FSID→ 上游明细FENTRYID - 单据操作：系统自带单据先"扩展"再修改，修改前必须"签出"，改完"保存→签入"
- 发布：单据修改后必须"发布到主控台"才能在前台看到