报表制作规范.docxVIP

HRP事业部 报 表 制 作 规 范 编写：吴高成 日期：2013-03 审核： 批准： 修订历史 编号 日期 描述 作者 版本 1 2013-03-14 初稿 吴高成 0.5 2 2013-03-28 修改 吴高成 0.6 3 2013-03-29 增加了对工具栏的设置要求 吴高成 0.7 4 2013-06-19 增加字段显示格式设置要求 张宝锋 0.8 5 2013-07-12 增加了查询条件的设计要求 刘丽丽 0.9 6  TOC \o 1-1 \h \z \u 1. 报表文件命名规范 3 2. 数据源命名规范 3 3. 数据源中SQL书写规范 4 4. 报表参数命名规范 6 5. 报表格式规范 7 6. 查询参数页面日期默认值设置 12 7. 报表文件登记对照 13 8. 报表设计人登记备案 14 9. 补充说明 15 10. 关于报表内容显示规范 15 11. 带查询条件的报表设置 19 报表制作规范 报表文件命名规范 报表文件命名采用报表中文名称的拼音全拼汉字的首字母组合，如报表“医院开单收入统计”，在制作报表时就将该报表英文名称保存为“yykdsrtj.cpt”。 编号 报表保存名称 报表说明 1 yyzxsrtj.cpt 医院执行收入统计报表 2 srcjsjbb.cpt 收入采集数据报表 3 srfcsjbb.cpt 收入分成数据报表 4 yykdsryl.cpt 医药开单收入一览 5 yyhssryl.cpt 医药核算收入一览 6 jdsyhztj.cpt 军地收益汇总统计 7 jdsyzhfx.cpt 军地收益综合分析 8 jdcbzcfx.cpt 军地成本支出分析 9 cbftsjbb.cpt 成本分摊数据报表 … … … 表 SEQ 表 \* ARABIC 1 数据源命名规范 在使用帆软报表时，系统默认的数据源链接名称统一修改为“hrp”，具体的数据源配置信息如下图： 图 SEQ 图 \* ARABIC 1 数据源中SQL书写规范 数据源用户模式选择 因在不同环境和用户模式下，数据源连接的信息可能不尽相同，如在开发环境下，统一用用户HRP来连接数据库，而在测试环境下可能用用户HRPTEST来连接数据库，开发部署时又可能以USERHRP来连接数据库，所以为了避免在不同用户模式下的数据连接不一致问题的出现，统一要求在SQL里面不带用户信息，帆软报表默认拖动数据字段时是带用户信息的，可能需要手工清除，否则在实际使用中会出现数据库连接错误的问题。 默认的数据源拖动后的SQL生成窗口如下： 图 SEQ 图 \* ARABIC 2 清理后的信息不包含用户模式信息，正确的数据源SQL示例如下： 图 SEQ 图 \* ARABIC 3 语法规范 数据源中的SQL书写遵循标准基于标准的SQL语法，但在个别涉及参数的地方，需要遵循报表本身内嵌的SQL语法及规范。 如涉及对查询参数页面的查询语法中，需要判断日期是否为空的语句为： SELECT * FROM 表名 where 表名.字段名　操作符 　字段名　 and 1=1 ${if(startDate!=, and表名.日期字段名= to_date( + startDate+,YYYY-MM-DD), )} ${if(endDate!=, and 表名.日期字段名 to_date( + endDate+,YYYY-MM-DD), )} 其中startDate、endDate为报表日期参数，startDate代表查询开始日期； endDate 代表查询截止日期 。 报表参数命名规范 报表参数命名时遵循如下规则： 如果需要报表参数页面作为过滤参数页，则需要注意参数页面全部采用“靠左”模式展示，同时页面中的各个参数控件和参数文本应横平竖直排列，文本原则上上下右对齐，控件宽度应以预览模式下可以全部看到控件弹出的内容为准。如下图： 图 SEQ 图 \* ARABIC 4 实际执行效果如下： 图 SEQ 图 \* ARABIC 5 如果需要提取的结果集是按参数过滤后的数据集，则参数定义放置在数据源里面定义； 如果需要提取的结果集不需要按参数过滤，参数只是用来格式化过滤和展示报表所用，则参数定义必须放置在报表模板中定义； 相同的参数在报表模板里只需要定义一次，不需要重复进行定义； 报表参数应能清楚表单参数意义的方式来定义，尽可能采用英文或者中文拼音简写，对于英文要求从第二个英文单词开始首字母大写外，其它字母均为小写，不允许参数名中间使用或带有特殊符号（如下划线“_”、中划线“-”、特殊符号等），几个常用的参数定义名称参见下表： 序号 参数名 解释 1 startDate