技能介绍

解决的问题

金蝶云星空二次开发里的报表需求经常卡在三个地方：报表类型选错后返工、直接SQL账表取数和字段映射不规范、发布后数据看不见或越权看见。本技能面向这类问题，把“先选型、再开发、后排错”的路径整理成可执行步骤。

技能如何工作

选型：根据业务场景判断应使用直接SQL账表、单据报表、动态表单报表、RDL报表、即时报表还是简易报表。
直接SQL账表开发：指导在 BOS 新建账表对象，编写取数 SQL，配置数据集字段到账表列的映射，设计过滤条件和参数，再配置权限与取数范围。
权限控制：说明按组织过滤，例如关联 FCreateOrgId、FUseOrgId 或业务组织字段；配置数据权限规则；区分字段授权与功能授权。
取数与计算：覆盖报表取数、计算函数、AbstractReportPlugIn 取数插件开发要点，以及单据过滤、下拉参数、默认值、组织参数和日期范围设计。
排错：按 references/faq.txt 对照发布后看不到报表、取数为空、权限不足、SQL 报错和慢查询等现象给排查方向。

适用边界与注意点

直接SQL账表只允许 SELECT，INSERT、UPDATE、DELETE、CREATE 会被禁止。字段标识和物理表应以 kingdee-cloud-dictionary 技能的数据字典为准，不要凭记忆编造；单据头和明细通常通过 FID、FEntryID 关联。BOS 菜单路径等界面细节可能随版本变化，需以当前环境为准。