Report报表开发设计说明书

Report报表开发设计说明

书

第一部份: Report Builder的简介

Report，报表，就是将数据库的数据合理、清晰、汇总的展示出来。输入一定条件的参数，得到一定的数据的展示的结果，其实就是一个select查询的过程。查询，就是说，不要对有任何的增加原数据，修改原数据的功能。Report虽然能够轻易的实现改变原数据，但是这样的需求是不合理的，报表的就是一个展示的功能，不管多复杂的报表，不能改变原数据，不能影响流程。

Report Builder，简单的说，就是一个资料模型，就是你的报表数据查询来源，一个布局模型，你要的报表的展示格式。使用Report之前，你需要的基本能力就是会使用SQL/PLSQL 语句，语法是其次，关键是数据之间的逻辑关系，起码能将左外联接，迪卡尔积等几个名词说的清楚，那么，OK，继续往下看。

第二部份: Report的基本开发步骤

1.先进行ERP环境下的REPORT的格式属性设定.

1.1请采用手工方式，并不使用report使用的精灵来制作报表，将出现在画面中的module原始文件另存为你的目的地址，并使用你的项目报表名称。

1.2建立报表后，选中报表名称段，按F4打开属性，字符模式->用字符单位设计->选择”是”。

1.3在布局模型中，选择主要节段，按F4打开属性，字符模式->报表高度和报表宽度按照设计书填写，节段->宽度和高度，这个设置直接影响布局模型字符模式下的点距。

小技巧：节段的高度和宽度，与报表高度和报表宽度最好对应成比例，并且，这个比例的倍数最好是整数，由于将来可能出现的报表长宽发生变化，报表高度和报表宽度调整后，节段的高度和宽度就要按比例调整，这样每个格子的形状、大小不变，同时你报表中的内容不会拉长、压扁；

同时建议将表头节段，表尾节段也设置来同主要节段相同。

例如：表头,表尾,主要节段三个的属性,请将节段高度和报表高度按比列设置(如1:10), 节段宽度和报表宽度,按比例设置(如1:6),而且三个节段的属性要设置相同.

这样做的好处是将来一旦调整报表大小,只需按比例不变的情况下调整,框架中每格大小不变,表格也就不会混乱.

1.4在布局模型中拉框架前，选择格式->布局选项->标尺设定，画面中点选，单位->字符单位，网格线间隔->１，对齐点数目->１，字符单位大小不要改动。.

这样设置的目的在于拉动框架时，间距都是1个字符，符合ERP报表的定位方式。这样，你的前期工作就算完成了。

2．定义你的使用者参数

将详细设计文件中，ERP环境传入的参数和你自己定义的参数，一一设置好，提醒注意数据类型和大小，传入参数和自定义参数要区分开，请按照规范文档来。注意，自定义参数对报表的开发灵活性作用巨大，要使用有含义的名称。

Parameter Name自定义参数命名参考

1 “PI_”+XXXXX 传入值用的参数, 如果 parameter 的用途是真正作为传入参数用时，名称一律以” PI _”开头;不可使用系统默认值。

2 “GLB_” +XXXXX 报表中使用的变量参数, 如果 parameter 的用途是作为共享变量时，名称一律以” GLB _”开头; 不可使用系统默认值。

3 有起迄的参数需要在后面XXXXX +”_F”表示FROM, XXXXX+”_T”表示TO; 不可使用系统默认值。

小技巧：date类型的传入参数，有时根据value set设置的不同要使用格式遮罩，固定它的时间格式，不然会出现错误。同时建议在设置大小时要适当放大一些，避免有多国语言文字时出现错误。

3．Report执行过程的说明

从画面上触发器的摆放次序，是从上到下的。为参数前，参数后，报表前，翻页中，报表后。其中参数后和报表前为最常使用的两个触发器，一般情况下，使用报表前（before report）来编写在报表运行前需要处理的数据，比如给自定义参数赋值，运行一段存储过程，定义一段动态sql，插入临时表格数据等。当报表前插入临时表格数据，那么after report 就是执行删除临时表格数据的动作。

4．建立资料模型

一般来说，除了矩阵，布局无非就是固定框架和循环框架的组合，每一个循环框架就对应一个资源模型中的一级。当然，这么一句话并没有什么实质意义，而要把这个讲清楚，就通过图形和实例来讲解。下一部份重点讲解该注意一些技巧和特点。

4.1最一般的单循环普通报表

按“sql”按钮，点入画布中，再导入事先写好的sql script。

导入sql后，这个报表的资料模型非常之简单。（注此报表并非模范，请按照规范命名。）

5，建立布局模型

5.1先拖1个固定框，再在固定框内画1个循环框

5.2，将固定框和循环框拖拉到合适的大小，再内部填充上数据栏位和文字栏位

5.3属性的设定

固定框

上下设为浮动的，左右为固定的，显示为“第一页”“包含模式”。循环框

上下设为浮动的，左右为固定的，显示为“第一页”“包含物件”，每页最多显示多少，这里为1，当然根据需要而定。

内部栏位

上下设为固定的，左右为固定的，显示为“第一页”“包含模式”

6 报表完成

这里的第3,4,5小节只是一点简单的步骤介绍，详细方法和技巧并没有呈现出来。下面这个部分，将就资料模型和布局模型的关系作详细的探讨。

7 参数规范参考

框架Layout中,字段名称命名

“F_”+XXXXXX: XXXXX为可表达其意义的名字,最好能与抓取值名称对应上；不可使用系统默认值。

查询主体名称命名

“Q_”+XXXXXX: XXXXX为可表达其意义的名字；不可使用系统默认值。

固定框名称命名

“M_”+XXXXXX: XXXXX为可表达其意义的名字；不可使用系统默认值。循环框名称命名

“R_”+XXXXXX: XXXXX为可表达其意义的名字；不可使用系统默认值。文字框名称命名

“B_”+XXXXXX: XXXXX为可表达其意义的名字；不可使用系统默认值。Formula Column Name公式直栏命名：

“CF_”+XXXXXX: XXXXX为可表达其意义的名字；不可使用系统默认值。Placeholder Name占位符命名：

“CP_”+XXXXXX: XXXXX为可表达其意义的名字；不可使用系统默认值。