公共数据集
在「系统 > 公共数据集」统一维护 SQL 数据集,供多张报表引用;含创建步骤、字段说明与引用方式。
概述
公共数据集是在后台统一维护、可被多张报表引用的 SQL 数据集。适合科室字典、人员列表等多张报表都要用的查询,修改一处,引用它的报表共同受益。
功能入口
- 维护:「系统」菜单 >「公共数据集」,需要系统权限
datasource。 - 引用:报表设计器数据集面板的「公共数据集」标签页,右键数据集选择「引用到本模板」。
操作步骤
新建公共数据集
- 进入「公共数据集」页,点击「新建公共数据集」。
- 填写「名称」,选择「数据连接」,编写 SQL。
- 点击「刷新参数」,从 SQL 中提取参数,在参数表设置类型和默认值。
- 点击「预览数据」验证。
- 保存。SQL 执行失败时提示「SQL执行失败: …」。
在报表中引用
- 打开报表设计器,切到数据集面板的「公共数据集」标签页。
- 右键目标数据集,选择「引用到本模板」。数据集(含字段)被拷贝进当前模板,提示「已引用「名称」…」;模板中已有同名数据集时提示「本模板里已经有同名数据集「名称」了」,不会重复引用。
- 公共数据集节点本身在设计器里不能编辑,只能引用;需要修改公共数据集,请回到「系统 > 公共数据集」页面。
属性说明
| 属性 | 说明 | 取值/默认值 |
|---|---|---|
| 名称 | 公共数据集名称 | 必填 |
| 数据连接 | 执行 SQL 的连接 | 必填 |
| SQL | 查询语句,语法同 SQL 参数与动态语法 | 必填 |
| 查询行数限制 | 行数上限 | 留空使用全局值 |
| 查询超时(秒) | 超时 | 留空使用全局值 |
| 数据粒度 | 明细或已汇总 | 自动判断 |
| 聚合下推 | 是否由数据库聚合 | 由系统决定 |
| 参数 | 参数名称、参数类型、默认值 | 类型:字符串、数值、布尔值、日期、日期时间、集合 |
| 数据集描述 | 说明文字 | 可选 |
参数类型未选时提示「请先为参数选择类型」。
只读查看时页面提示:「只读查看中。公共数据集可能被多张报表引用,修改请点右上角「编辑」。」删除时确认提示「确认删除…?」。
示例
建立公共数据集 pub_dept,供所有门诊报表的科室下拉框使用:
SELECT dept_code, dept_name
FROM department
WHERE parent_code IS NOT NULL
ORDER BY dept_code
无参数,预览得到科室列表。在报表中「引用到本模板」后,可把 dept_code 作为查询表单下拉框的值、dept_name 作为显示文本。
注意事项
注意:引用是把数据集拷贝进模板(模板需要能独立导入导出),拷贝之后与公共数据集不再联动。公共数据集之后被修改,已引用的模板不会随之更新,需要在模板中重新引用(先删除同名数据集)。
注意:删除公共数据集前,先确认没有报表还在使用。
提示:公共数据集的数据连接仍然按连接自身的账号权限执行,见 数据源配置。