Birt模板设计操作手册范文

文件版次：

业务需求说明书_综合查询

Birt模板设计操作手册

目录

1 BIRT模板设计器................................................................................................................. 错误！未定义书签。

1.1环境准备 ....................................................................................................................... 错误！未定义书签。

1.2启动B IRT报表编辑器.................................................................................................. 错误！未定义书签。2BIRT模板制作..................................................................................................................... 错误！未定义书签。

2.1将E XCEL格式模板转换为B IRT模板 ......................................................................... 错误！未定义书签。

2.2调整转换后生成的B IRT模板...................................................................................... 错误！未定义书签。3模板数据绑定 ....................................................................................................................... 错误！未定义书签。

3.1设置模板数据源 ........................................................................................................... 错误！未定义书签。

3.2创建报表的数据集 ....................................................................................................... 错误！未定义书签。

3.3模板与数据集进行绑定 ............................................................................................... 错误！未定义书签。4模板存放 ............................................................................................................................... 错误！未定义书签。

业务需求说明书_综合查询

本文的建议读者为现场项目实施人员，需修改的配置已用红色加粗文字标出。

1Birt模板设计器

1.1环境准备

确保本地环境已安装JDK1.6版本，并配置系统环境变量JA V A_HOME指向此JDK安装路径。

1.2启动Birt报表编辑器

启动eclipse.exe

Birt模板设计操作手册2Birt模板制作

2.1将Excel格式模板转换为Birt模板

进入Birt报表模板设计器，选择ETB插件，如下图所示：

在弹出的对话框中，设置要转换的Excel模板及准换后的模板位置。

说明：

需要将厂商提供的Excel模板文件，使用EXCEL软件打开，另存为2003格式的Excel文件，否则，转换时会不成功。

转换的设置选择如下图所示：

选择“开始转换”，会在所设置的“xml文件路径”下生成对应的文件，如下图所示：

业务需求说明书_综合查询

2.2调整转换后生成的Birt模板新建一个报表工程，操作如下图所示：

选择“Report Project”，如下图所示：

Birt模板设计操作手册

下一步后，输入工程名称，如下图所示：

点击“完成”。

在左侧工程栏中，创建一个文件夹，将2.1步骤生成的Birt模板导入进此文件夹，导入后如下图所示：

业务需求说明书_综合查询

由于转换后生成的Birt模板与Excel模板格式会有格式上的差异，需要借助设计器进行手动调整，包括格式的样式，表格的宽度，字体大小，最终调整后与业务系统的报表模板文件一致。本例中调整后的模板格式截图如下图所示：

选择“Preview”可以对模板进行预览：

Birt模板设计操作手册

在弹出的错误提示框中，选择“OK”，可预览调整后的模板如：

确认格式与业务系统格式一致。

业务需求说明书_综合查询

3模板数据绑定

3.1设置模板数据源

选择设计器左侧的“Data Explorer”，功能说明如下图所示：

Birt模板设计操作手册鼠标右键点击“Data Source”，选择“New Data Source”，如下图选择：

弹出的页面如下：

由于现场是通过写SQL语句与模板绑定方式生成报表，

所以请选择“JDBC Data Source”，选择“Next”，

选择/填写相关的参数，参考如下图所示：

业务需求说明书_综合查询

参数说明：

Driver Class：数据库驱动类型

Database URL：数据库连接串

User Name：数据库连接用户

Password：数据库连接用户的密码

设置完毕后，选择“Test Connection”对数据源进行测试，现场可以通过配置连接测试的数据库保证可以测试成功即可。测试成功界面如下图所示：

点击“OK”，选择“Finish”。完成数据源的创建。

Birt模板设计操作手册3.2创建报表的数据集

说明：数据集的创建（名称及个数）取决于报表模板前台配置时设置的“内容数据源”。需要保证数据集的个数与名称，与系统“内容数据源”中配置的内容一致。

以电力营销“催费通知单”为例：

内容数据源中的数据集个数为1个，名称为“ds1”，则，需要我们在报表设计器中，定义此报表模板的数据集名称为ds1：

业务需求说明书_综合查询

新建一个数据集：

选择“Next”，在弹出的页面的“Query Text”中，将业务厂商提供的SQL语句的最外层展示列(英文字段)取出，编辑成Birt模板的数据集，为模板构建绑定关系。如此例中的业务SQL语句最外层所包含的列形成的绑定SQL语句示例为：

SELECT ''AS THE_YM,

''AS MR_SECT_NO,

''AS CONS_NO,

''AS CONS_NAME,

''AS DEAD_DAY,

'2012-08-14'AS PLAN_DAY,

'23129.00'AS OWE_AMT,

''AS ELEC_ADDR,

'0.00'AS OLD_OWE_AMT,

'23129.00'AS THIS_OWE_AMT,

'2012'AS THE_YEAR,

'25'AS THE_DAY,

Birt模板设计操作手册'8'AS THE_MONTH,

''AS ORG_NO,

''AS ORG_NAME,

''AS CITY_NAME,

'YK_TEST'AS CONTACT_NAME,

''AS MOBILE,

''AS EPM_NO_EN,

''AS ORGN_CONS_NO,

''AS MADE_NO,

''AS PEAK_BS,

''AS FLAT_BS,

''AS OFFPK_BS,

''AS ALL_YG,

''AS ALL_WG,

''AS MADE_NO1,

''AS PEAK_BS1,

''AS FLAT_BS1,

''AS OFFPK_BS1,

''AS ALL_YG1,

''AS ALL_WG1,

''AS MADE_NO2,

''AS PEAK_BS2,

''AS FLAT_BS2,

''AS OFFPK_BS2,

''AS ALL_YG2,

''AS ALL_WG2,

''AS MADE_NO3,

''AS PEAK_BS3,

''AS FLAT_BS3,

''AS OFFPK_BS3,

''AS ALL_YG3,

''AS ALL_WG3,

''AS THIS_READ,

''AS LAST_MR_NUM,

''AS THIS_READ_PQ,

''AS REAL_NAME,

''AS TELEPHONE,

''AS PAY_NO,

''AS T_PQ,

''AS RCVBL_AMT,

''AS PREPAY_BAL,

''AS T_SETTLE_PQ,

''AS MR_SN,

''AS ASSET_NO,

'0.00'AS PENALTY_AMT

FROM DUAL

上面语句，红色加粗标识的部分为厂商提供的SQL语句中的最外层的查询语句展示的列名称，为了对模板进行预览时查看数据的展示效果，所以带上了部分的测试数据。将上面的语句粘贴到“Query Text”中，如下图所示：

业务需求说明书_综合查询

选择“Finish”，弹出如下图：

选择“OK”后，在左侧的“Data Explorer”中出现此次添加的数据集“Data Set”，如下图所示：

Birt模板设计操作手册

修改此数据集的名称与WEB界面中配置的数据集名称一致（也可以调整WEB页面中的内容数据源中的数据集名称与模板一致），本例中调整模板的数据集名称为“ds1”，鼠标右键选择“Data Set”，选择“Rename”，键入ds1，调整后如下图所示：

3.3模板与数据集进行绑定

展开“ds1”数据集，如下图所示：

业务需求说明书_综合查询

“ds1”下所包含的列名，为业务系统厂商提供的SQL语句所包含的列，我们只需要将对应的列和报表模板的展示位置，进行关联即可。数据集中的字段在报表模板展示区域位置需要实施人员与提供SQL业务系统人员进行确认。模板绑定的具体关联操作为：

鼠标左键选择数据集中的一列，如“THE_YM”，拖放到模板中的“年月”之后的位置，如下图所示：

即完成一列的绑定，其它报表各个位置的数据绑定，以此方法，在数据集ds1中查找到并拖放到模板中。

绑定后的模板如下图所示：

Birt模板设计操作手册

绑定后，选择“Preview”对模板进行预览，通过设置的测试数据，可以查看绑定区域的字体大小等格式设置是否正确：

核对格式正确后，完成模板绑定。

业务需求说明书_综合查询

4模板存放

将之前生成报表模板存放到“系统参数”→“birtParam”→birtDesignPath所设置的应用服务器的路径下。通过“结构化数据电子化定义”功能，将电子文件与所对应的模板进行关联即可。参考截图如下：