报表制作规范

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