金蝶云星空报表开发助手

概述

本技能面向金蝶云星空二次开发者，提供报表开发全流程指导：从"选哪种报表类型"到"SQL 怎么写、权限怎么控、报错怎么排查"。配套 kingdee-cloud-dictionary 技能（数据字典）可查字段标识与物理表，本技能负责把字段变成可用的报表。

知识文件布局

工作流程

1. 确定报表类型（先选型，再开发）

向用户询问业务场景后，用 references/report-types.txt 判断：

• 直接SQL账表：数据来自业务表、需要灵活取数、简单列表/汇总展示 → 首选，零代码
• 单据报表：基于单据/序时簿模板、按单据维度展示 → 用单据报表
• 动态表单报表：需要复杂交互、图表、下钻、自定义布局 → 动态表单 + 报表插件
• RDL报表：复杂打印/分页/分组布局 → RDL（RDLC）报表
• 即时报表/简易报表：临时查询、快速验证 → 即时报表

2. 直接SQL账表开发（最高频场景）

按 references/direct-sql-account.txt 的步骤指导：

1. BOS 平台 → 新建账表对象（选"直接SQL账表"）
2. 编写取数 SQL（仅允许 SELECT；INSERT/UPDATE/DELETE/CREATE 会被禁止）
3. 配置数据集字段 → 映射账表列
4. 设计过滤条件与参数（references/filter-params.txt）
5. 配置权限与取数范围（references/data-scope.txt）
6. 发布 → 分配功能权限

写 SQL 时，字段标识/物理表查 kingdee-cloud-dictionary 技能的 references/fields-*.txt 与 entities.txt；表名以 T_ 开头（如 T_SAL_SALEORDER），单据头+明细通过 FID/FEntryID 关联。

3. 取数范围控制（权限，最容易踩坑）

凡涉及"发布后看不见数据/越权看到数据"，查 references/data-scope.txt：

• 按组织控制：SQL 中关联组织过滤（创建组织 FCreateOrgId / 使用组织 FUseOrgId 或业务组织字段）
• 数据权限：账表需配置数据权限规则（按角色/用户/组织授权）
• 字段授权/功能授权：控制列可见性与功能入口

4. 报错排查

按 references/faq.txt 对照症状给方案。常见问题：

• 发布后报表列表看不到 → 功能授权未分配
• 取数为空 → 组织/数据权限范围、参数默认值、SQL 结果为空
• SQL 执行报错 → 只允许 SELECT、动态视图名称、字段大小写
• 慢查询 → 加索引建议、避免 SELECT *、分页

注意事项

• 先选型再写代码：用户描述需求后，第一步永远是给出报表类型建议及理由，再进入开发细节。
• SQL 只读约束：金蝶直接SQL账表禁止写操作语句，务必提醒用户。
• 组织/权限是金蝶报表的重灾区：回答 SQL 时主动带上组织过滤与数据权限建议，不要只给裸 SQL。
• 字段来源以数据字典为准：不确定字段时，引导查询 kingdee-cloud-dictionary 技能，不要凭记忆编造表名/字段名。
• 涉及具体版本差异（如 BOS 菜单路径）时，提示以当前环境实际界面为准。