报表制作规范.doc

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  1. 报表文件命名规范 3 2. 数据源命名规范 3 3. 数据源中SQL书写规范 4 4. 报表参数命名规范 6 5. 报表格式规范 7 6. 查询参数页面日期默认值设置 12 7. 报表文件登记对照 13 8. 报表设计人登记备案 14 9. 补充说明 15 10. 关于报表内容显示规范 15 11. 带查询条件的报表设置 19  报表制作规范 1. 报表文件命名规范 报表文件命名采用报表中文名称的拼音全拼汉字的首字母组合，如报表“医院开单收入统计”，在制作报表时就将该报表英文名称保存为“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 成本分摊数据报表 … … … 表 1 2. 数据源命名规范 在使用帆软报表时，系统默认的数据源链接名称统一修改为“hrp”，具体的数据源配置信息如下图： 图 1 3. 数据源中SQL书写规范 1) 数据源用户模式选择 因在不同环境和用户模式下，数据源连接的信息可能不尽相同，如在开发环境下，统一用用户HRP来连接数据库，而在测试环境下可能用用户HRPTEST来连接数据库，开发部署时又可能以USERHRP来连接数据库，所以为了避免在不同用户模式下的数据连接不一致问题的出现，统一要求在SQL里面不带用户信息，帆软报表默认拖动数据字段时是带用户信息的，可能需要手工清除，否则在实际使用中会出现数据库连接错误的问题。 默认的数据源拖动后的SQL生成窗口如下： 图 2 清理后的信息不包含用户模式信息，正确的数据源SQL示例如下： 图 3 2) 语法规范 数据源中的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 代表查询截止日期 。 4. 报表参数命名规范 报表参数命名时遵循如下规则： 3) 如果需要报表参数页面作为过滤参数页，则需要注意参数页面全部采用“靠左”模式展示，同时页面中的各个参数控件和参数文本应横平竖直排列，文本原则上上下右对齐，控件宽度应以预览模式下可以全部看到控件弹出的内容为准。如下图： 图 4 实际执行效果如下： 图 5 4) 如果需要提取的结果集是按参数过滤后的数据集，则参数定义放置在数据源里面定义； 5) 如果需要提取的结果集不需要按参数过滤，参数只是用来格式化过滤和展示报表所用，则参数定义必须放置在报表模板中定义； 6) 相同的参数在报表模板里只需要定义一次，不需要重复进行定义； 7) 报表参数应能清楚表单参数意义的方式来定义，尽可能采用英文或者中文拼音简写，对于英文要求从第二个英文单词开始首字母大写外，其它字母均为小写，不允许参数名中间使用或带有特殊符号（如下划线“_”、中划线“-”、特殊符号等），几个常用的参数定义名称参见下表： 序号 参数名 解释 1 startDate 开始日期 2 endDate 结束日期 3 deptCode 部门代码 4 reckonItemCode 核算项目代码 5 costItemNo 成本项目代码 6 reckonUnitId 核算单元ID 7 serviceCode 内部定价项目代码 8 … … 表 2 5. 报表格式规范 表格边框、字体颜色、大小等默认规范（用户特定的要求除外）。 报表格式要求： 1） 普通报表模板“页面设置”参照如下参数设置： 图 6 2） 每张报表都必须要有 报表标题、表头、数据展示三部分内容，缺一不可； 3） 标题题目：字体：（宋体18号加粗）可以分成1或2行居中，颜色：黑色； 4） 表头：题目下空一行 字体：（宋体9号加粗），样式选择head2样式： 图 7 5） 数据展示区：紧挨表头行，字体：（宋体9号），样式选择“cell”： 图 8 6） 数据展示区中金额类数字列靠右显示外，其它内容均靠左或者居中显示； 7） 数据区表格线框颜色选择：RGB(153，204，255)：单击边框线选择按钮后再设置颜色上单击即可弹出RGB选择框： 图 9 图 10 8） 对于数据行自动扩展出来的行标题，采用字体：（宋体9号），只有一级的行标题默认靠左显示，如果出现二级标题，则二级标题和一级标题应采用不同的显示位置，如果出现三级以上标题，除了用靠左、居中、靠右三种显示处理外，应通过如字体取消加粗、倾斜等方式处理； 9） 数据展示前需要加“编号”列，对应记录的数据行号； 10） 如果报表有查询条件窗口，则将必要的查询条件信息显示在报表标题和表头之间，采用字体：（宋体9号），颜色：黑色； 11） 报表页面按钮默认设置。通过单击报表模板 菜单“分页预览”走侧的齿轮标记，在弹出的窗口中可单独设计报表页面及工具栏内容，首先单击选择“为该模板单独设置”选项： 图 11 然后按如下步骤选择工具栏图标： 图 12 正确配置并定义工具栏后报表实际展示页面如下图： 图 13 6. 查询参数页面日期默认值设置 查询日期时间默认值，开始日期和截止日期默认间隔一个月。其中： 开始日期：系统当前日期之前一个月对应日期； 截止日期：系统当前日期。 对应的公式分别设置为： 开始日期：f(x)= MONTHDELTA(today(),-1) 截止日期：f(x)= today() 图 14 实际执行时效果： 图 15 7. 报表文件登记对照 开发设计完成的报表模板将通过模块注册的形式，实现在HRP系统的展现，需要定期更新和对照报表文件和模块的对应关系。系统通过文件来记录。对应配置文件名及放置位置如下（SVN目录）： …\yxt\代码\trunk\ReportTemplate\System\报表模板清单.xlsx 对于报表的修改和更新，需要先备份，然后对照检查文件名和模块的对应关系，并及时编写修改备注，确保报表测试、实施和部署的正确对应。 8. 报表设计人登记备案 在报表模板中的左下角，报表设计者通过合并单元格并录入本人的姓名和报表设计完成日期（格式：设计人 设计完成日期 字体：宋体10号，颜色:灰色RGB(204,204,204)），并设置为“重复结尾行”。以方便报表后期修改完善工作的追溯。本信息只作为内部流转和测试使用，正式发布到用户现场前应由专人进行清理。实际浏览页面中报表登记人信息显示位置如下： 表 3 9. 补充说明 1) 对于用户已经确定的格式化固定的报表，原则上需要设计出和原表完全一样的报表，此时可依照实际报表格式（页面大小、边框、字体大小、显示位置等）进行单独报表设计，不受此规范的限制和影响; 2) 报表设计者设计的报表信息将建立对照关系表，以方便报表的后续修改和完善。 10. 关于报表内容显示规范 10.1显示内容对齐格式要求 1) 字段对齐： 左对齐：名称类，如：厂家，物品名，库房名称 居中：日期，时间，人员姓名，类别，分类，单号 右对齐：金额，数字，数量 2) 报表行高 行高：默认5.02mm 3) 格式化 金额型格式化为2位小数位 4) 表示数量、个数的字段，不需要格式化，原样输出即可 5) 日期型字段，统一使用‘yyyy-MM-dd’格式 如：’2013-06-19’、’2013-06-19 09:42:30’ 6) 报表尾部 合计字段 全部使用粗体，字体大小跟报表明细保持一致，即9号宋体，居中显示。 效果如图： 10.2 报表边距及标题 1) 带标题的报表左侧插入空列，列宽15mm，上侧插入空行，行高1mm。 效果如图： 2) 标题与表头之间不加空行。 效果如图： 3) 表头也是默认行高5.02mm。 效果如图： 4) 不带标题的数据列表形式报表，左侧、上侧都不要留空行或空列。 效果如图： 5) 标题字体：宋体14号 加粗,标题行高6.0 效果如图： 6) 如果标题行存在合并行情况，且有两行标题，则上标题垂直向下对齐，下标题垂直向上对齐。 效果如图： 7) 数字、金额字段宽度：（25mm、30mm）右对齐,并设置该列为自适应宽度。 10.3 冻结设置 1) 所有报表的标题行都要求冻结，报表尾部的合计也要求设置冻结。 设置冻结行、列之前，必须先设置重复标题行、列，重复结尾行、列。 设置冻结： 2) 如果报表中嵌入了图表元素，如果图表元素处于数据列表的右侧，则在数据列表和图表之间插入空列，列宽为5mm，且图表的上边紧贴报表上边缘。如图： 3) 如果图表显示在数据列表的下方，则在数据列表的下方和图表之间插入空行，行高5mm。 10.4 带标题的报表设置 1) 标题位于数据列表与报表工具栏之间，插入空行 2) 数据列表形式的报表，每页固定50行分页。 3) 尾部合计字段显示要求：“合计：”，居中，不带底色，粗体，字体默认值，所有合计行不带表格线。 11. 带查询条件的报表设置 1) 做查询条件控件时，将屏幕分辨率调整到1024*768，保证在此分辨率下所有的查询条件都可见； 2) 每行查询条件距离上标尺位置5像素，距离左标尺位置0像素，行间距5像素，距离蓝色分割线5像素； 3) 控件的高度按照默认高度显示，控件一行显示不下，可以分行显示，查询按钮放在最后一行； 4) 控件之间的距离设置：有关联的控件（比如：查询日期：2009-01-22）之间不留间隔，没有任何关联的控件之间间隔10像素， 5) “查询”控件距离前面控件的间隔设置两种标准，各个子系统根据实际情况选择一种间隔距离； A. 查询条件比较少时，如下图所示的，间隔50像素， B. 查询条件比较多时，如下图所示的，间隔20像素。 6) 日期类的控件，对于显示“年-月-日”的控件，宽度设置在100像素；显示“年-月”的控件，宽度设置在80像素；只显示“年”或“月”或“日”的控件，宽度设置在60像素； 7) 有下拉选项的控件，设置的宽度要能涵盖字符最长的选项。 8) 核算单元：宽度150，报表项目、成本项目、核算项目：列宽120。单位、军地、数据来源等两个字的控件宽度60，“查询”按钮宽度：80 9) 报表的查询条件离低端1个刻度，也就是5个像素，两行查询条件之间的距离也是1刻度 10）查询条件顺序：核算单元、核算项目、成本项目、报表项目、统计时间、同期、单位、军地、数据来源等 11）查询条件的日期统一叫“统计日期”，报表小标题：有年月日写成：“统计日期：”，只有年月的写成：“统计月份：”，“开始日期”和“结束日期”之间统一用“至”；统计分析报表小标题统一写成:本期：从…至… 12)核算单元：允许输入代码、名称进行检索 12. 行、列锁定 1、 所有报表都要求添标题行锁定； 2、 报表在1024X768分辨率下，若报表出现横向滚动条（菜单区域正常显示），则要求对此报表添加列锁定，具体锁定列由开发组长和设计人员讨论决定。 13. 数据排序 报表内容需要添加数据排序，具体排序规则，由开发组长和设计人员讨论决定。