润乾报表设计器简易教程.doc

润乾报表设计器简易教程
建立一个新的报表由存储过程的编写和表样的设计两部分组成，其中,表样的设计是利用润乾设计器进行的。用润乾建立一个新的表样可以分为以下几步：新建数据源、连接数据源、设置参数、设置数据集、绘制表样、预览表样.
在以下步骤说明中,以预算上报下达差异表为例进行说明。该报表的查询条件包括年度、单位和模板.表样如下所示：
2010年预算上报下达差异表
制表部门：查询单位
期间：2010年

单位：万元
预算科目
本单位
下级单位1
下级单位2
上报值
下达值
差异
上报值
下达值
差异
…
预算科目1

预算科目2

预算科目3

预算科目4

预算科目5

合计

制表人：登录用户

制表时间：2010-07-26
1 新建数据源
配置数据源的目的是为了连接数据库.
配置的步骤如下：
Ø 打开设计器后，点击配置——数据源,打开配置数据源的界面。
Ø 点击新建，在数据库类型中根据实际情况选择数据库类型，针对TBM系统，选择的是关系数据库，点击确定。
Ø 在数据源常规属性设置页面进行数据源的设置，如下图所示：

ü 数据源名称：可以任意指定，建议采取tbmbj等名称对各地数据库进行直观性区分。
ü 数据库类型：选择对应数据库类型,TBM系统采用的是DB2数据库。
ü 客户端字符集：指的是从数据库取出的数据在客户端展现时的字符编码,可以采用默认的GBK。
ü 数据库字符集：指的是从数据库中取过来的字符编码，根据数据库的编码类型选择，可以采用默认的GBK。
ü 驱动程序:输入“com.ibm.db2。jcc。DB2Driver”即可。
ü 数据源URL：数据源URL的输入格式为jdbc:db2:// IP地址：端口号/数据库名，例如:jdbc：db2://192。168。168.6:50000/tbmbj。
ü 用户、口令：数据库用户名和密码。
Ø 设置完成后，点击【确定】按钮，回到数据源配置界面,关系数据库类型的数据源就配置完成了,数据源配置界面中就列出了新建的数据源。
2 连接和断开数据源
选中需要连接和断开的数据源后，点击数据源配置窗口的连接或断开即可.
3 设置参数
此处设置的参数是指报表中需要的参数，包括报表的查询条件、从页面URL传过来的参数等。
对于预算上报和下达差异表，需要传入两类参数：一是查询条件，包括年份dateflag、单位dptid和模板groupid；二是从URL中传过来的参数，用于显示制表部门和制表人，其中指标部门即用户在查询条件中选择的单位，无需再次设置该参数,制表人即当前登录用户，因此需设置参数userid。由于从页面或URL传入的都是ID而不是名称，所以在设置参数的时候也是设置的dptid而不是dptname，别的参数类似。
Ø 点击配置—-参数，打开参数编辑页面,点击增加后在该页面增加一条参数记录；

Ø 修改参数名称为dateflag，其数据类型为字符串型；与此类推，增加其他参数，最后结果如下图所示：

4 设置数据集
数据集是报表的数据来源，可以通过数据库的sql查询获得，也可以通过存储过程获得.在TBM的报表中，采取的是通过存储过程获取报表中需要查询的数据，同时会使用sql语句进行辅助字段的查询,例如通过使用sql语句查询url传入的userid对应的username，从而显示制表人的名称。
4.1 增加存储过程类数据集
Ø 点击配置——数据集,弹出数据集配置窗口。
Ø 点击增加，在弹出窗口中选择数据集类型为存储过程，点击确定.
Ø 定义标签页中输入{CALL PRC_R_TY_CYBJ_SBXD（?，？，？)｝,其中PRC_R_TY_CYBJ_SBXD为预算上报下达差异表对应的存储过程的名称，三个问号表明该存储过程需要传入三个参数,依次是年度、单位、模板。
Ø 在参数标签页中对应地新建三个参数,双击第一个参数的参数表达式，弹出如下窗口，在报表表达式窗口中删除原有的arg1,双击数据列表中的＠dateflag，点击确定.

Ø 单位和模板参数的设置与上步类似,最后得到如下结果。需要注意的是，这三个参数的顺序与存储过程中参数的顺序必须保持一致.

Ø 点击确定后，在数据集设置页面增加了一个类型为存储过程的数据集

Ø 点击数据集设置页面的确定按钮,设计器右下角的数据集标签页也相应的多了一个名为ds1的数据集,展开该数据集可以看到对应的存储过程查出的字段

4.2 增加SQL检索数据集
Ø 点击配置——数据集,弹出数据集配置窗口。
Ø 点击增加，在弹出窗口中选择数据集类型为SQL检索，点击确定。
Ø 可以直接在语法标签页中输入SQL语句,也可以逐个设置SQL编辑器各标签页的数据和条件，让润乾报表设计器在语法标签页自动生成SQL语句。
Ø SQL语句中需要传入参数的地方依旧用问号标示，并在参数标签页进行设置。
5 绘制表样
润乾报表采取的是类EXCEL界面,在操作上与EXCEL类似。
由于该报表文件需要展示的是所选单位及其下级直属单位的预算上报下达差异情况,也就是说需要对报表的展示单位根据实际情况进行扩展.
Ø 绘制空白表样.按照EXCEL设计的表样在设计器中设计出空白的表样，如下图

Ø 从存储过程中获取报表文件的字段信息：
ü 该存储过程查出的字段如下图，依次表示预算科目ID，预算科目名称，预算科目展示顺序，部门ID，部门名称，部门展示顺序，预算上报值，预算集团下达值;

ü 获取预算科目的值，点击ds1下面的SHOWNAME,然后拖动至报表文件的A5中，如下图所示，图中红色的箭头表示该单元格的扩展方式为纵向扩展

ü 同理,将上报值下达值的字段拖入表中，由于上报下达值是针对特定的预算科目的，因此将方式设为取值，然后拖入表中即可，如下图：

ü 根据报表需要，在设计时要将同一部门的上报值、下达值和差异进行分组展示，因此选择的方式是分组，将扩展方式改为横向扩展，如下图

ü 由于在展示部门时，其顺序要按照省本部,省本部财务部这样的顺序展示，因此需要对B3单元格的表达式进行更改，增加其排序方式，更改为：ds1.Group（DPTNAME,false，，DPTVIEWORDER)。更改的方式是双击B3单元格的表达式，在弹出的表达式编辑对话框中进行更改，在表达式编辑对话框中双击字段就可以将双击的字段添加到表达式光标所在位置.

ü 在合计、差异等单元格添上计算公式,其中 SUM（B5｛｝）中B5{｝表示把B5所代表的上报值根据预算科目扩展后的所有上报值单元格进行相加,若写成B5（）则表示只汇总扩展后的第一个上报值单元格，即取第一个单元格的值：

在点击需要超链接的单元格后，设计器的右边会有以下图片中的名称显示：超链接处，填写链接地址,双击进入后，在表达式一栏中填入需要用到的页面、参数以及链接的报表raq文件；
例子：
”/tbm/report/reportcontent。jsp?dateflag=”+@dateflag+”&dptid="+@dptid+"＆groupid=”+＠groupid+”&userid="+@userid+”＆itemid=”+B4+”＆raq=/TY/TY_BMSB_YS_KMXM。raq”
“/tbm/report/reportcontent.jsp?" 为显示页面，此段一般是写死的，基本无变化。
“dateflag=”+@dateflag+"&dptid="+＠dptid+”&groupid=”+＠groupid+"＆userid=”+＠userid+”&itemid=”+B4+””此段是参数 一般为主表所用到的全部参数以及被链接表的参数,由于普通情况都是 主表参数为 A+B+C 被链接参数为 A+B+C+D； 那么，我们也可以理解为将被链接参数全部填入即可；只是被链接报表多出的参数 一般都是 在 链接项 所选的单元格 .
“&raq=/TY/TY_BMSB_YS_KMXM.raq” 最后一段既是被连接的 报表raq文件名。
超链接窗口 只要在中间空处填死“_blank”即可

ü 新建SQL检索的数据集ds2，目的是通过dptid和userid获取dptname和username，按照增加SQL检索类数据集的步骤建立,SQL语句是SELECT BAS_DPT.DPTNAME,BAS_USERINFO。USERNAME FROM BAS_DPT,BAS_USERINFO WHERE BAS_DPT。DPTID =？ AND BAS_USERINFO。USERID =?，两个参数分别取之前建好的参数dptid和userid。
如图，将A2单元格的表达式设置为“=’制表部门：'+ds2.DPTNAME",当传入dptid后，通过SQL检索获取dptname，然后显示在报表文件中，例如传入dptid的值2，显示发布报表后显示为“制表部门：省本部”。
同理，对A7单元格的公式进行更改。

ü 将制表时间、期间两个单元格的表达式更改如下，各函数的含义分别是：
=’制表时间:’+str（year（now(）)）+’—'+str（month(now()））+'—’+str（day（now(）））
='期间:'+str(int（＠dateflag)/100，"#")+'年'
² ‘—’：表示引用单引号内的字符(串）
² now():获取当前的日期时间
² year(）：从日期型数据中获得年信息,例如year("1972-11—08 10:20:30”） 返回：1972
² month():从日期型数据中获得月信息，例如year(”1972-11-08 10:20:30") 返回:11
² day（）：从日期型数据中获得日信息，例如year（"1972—11—08 10:20：30”) 返回：8
² str(）：将对象转换成字符型，转换过程中可以进行格式化，例如str(3456.9876，"￥#,#＃0.00"） 返回值：”￥3,456.99"
² int():将字符串或数字转换成整数，例如int(100.9999） 返回：100
ü 设置报表标题，报表头。我们希望能够像EXCEL冻结拆分一样，在翻页的时候使表名，表头和左边第一列固定不变；这在润乾报表中是通过将行列的属性设置为头标题、报表头、左表头等实现的。

6 预览表样
6.1 在设计器中进行预览：
点击润乾报表工具栏的预览按钮会弹出报表参数设置对话框，用于模拟查询条件以及URL参数的传入情况。设置dateflag的值为201000,dptid为2,groupid为20000，userid为1,即查询2010年省本部模板ID为20000的模板的所有预算科目的上报下达情况,制表部门为省本部,制表人即登录用户为userid为1的系统管理员.

6.2 发布到本机进行预览：
Ø 启动默认服务器：点击本地应用-预览—发布报表，或点击工具栏中的按钮启动默认服务器,工具栏的按钮变成.
Ø 发布报表文件：点击弹出“请输入报表名称”对话框，在对话框中编辑报表发布的路径和文件名，点击【确定】按钮即可完成报表的发布.其中，报表发布路径不需更改,因为润乾的发布路径必须在安装路径之下。
Ø 在IE浏览器中进行查看：点击工具栏的IE浏览器图标，会自动在IE中打开发布文件，表样为空表样。IE中的地址为报表文件在本机中的地址，还需手动在该地址后面输入报表文件的参数，点击跳转即可看到该查询条件下的报表内容。
原地址：http://127。0.0.1:6001/demo/reportJsp/showReport.jsp？raq=/TY_CYBJ_SBXD.raq
在URL中手动输入参数：
http://127.0。0。1:6001/demo/reportJsp/showReport.jsp？raq=/TY_CYBJ_SBXD。raq＆dateflag=201000＆dptid=2&groupid=20702&userid=1
一。润乾报表的部署涉及到以下基本配置文件的修改:
1.reportConfig.xml中〈name>license</name〉下面的一行是指定许可证文件的，需要使用润乾的有效.lic文件，该文件在应用中的地点是：/tbm/report/lic，文件名和地址不能错,根据现在所拥有的操作系统，各省应该使用类似这样的文件：xxxOther。lic。
在reportConfig.xml中有以下配置是对db2的：
<config〉
<name>dataSource〈/name>
<value〉jdbc/tbm，db2，1,UTF—8,UTF—8，1</value>
</config〉
如果是oracle版：
〈config〉
〈name>dataSource</name〉
〈value〉jdbc/tbm,oracle，1,UTF—8，UTF—8，1</value>
〈/config>

其中jdbc/tbm是在东方通或websphere中创建的jndi名。
2.通用的报表设计文件及其它相关文件在下发的包中都有;
3。自定义的报表文件(。raq),放置在/reportFiles/XX下，XX各省可自己指定，如北京可以写为BJ，在报表管理的界面中，新建一个组专门放自定义报表，添加自定义报表，报表的url仿照通用的报表连接，将连接中的TY改为BJ，raq文件改为自己的即可，然后添加权限即可访问.

二。水晶报表
先创建以下菜单（可与润乾报表菜单同级）：
菜单标题 url内容
水晶—项目概览表 /report/Xcelsius。do？action=xcelsiusPrj
水晶—预算科目分析表 /report/Xcelsius.do？action=xcelsiusItem
水晶—科目预算完成表 /report/Xcelsius.do?action=xcelsiusKeyItem
水晶-损益分析表 /report/Xcelsius.do？action=xcelsiusProfit

然后给相应角色配置这些菜单即可。

更多帮助及使用手册请参考润乾用户手册等文件。