BI+Publisher开发报表实例教程

BI Publisher开发报表实例教程
Author: Rongjie Zhang
Creation Date: 2009-05-12
Last Updated: April 10, 2010
Document Ref: <Document Reference Number>
Version: 1.0
Copy Number _____
Document Control
Change Record
Reviewers
Distribution
Note To Holders:
If you receive an electronic copy of this document and print it out, please write your
name on the equivalent of the cover page, for document control purposes.
If you receive a hard copy of this document, please write your name on the front
cover, for document control purposes.
Contents
Document Control (2)
BI Publisher报表开发 (4)
文档约束前提 (4)
数据源配置 (4)
BI Publisher报表创建 (5)
RTF模板开发 (13)
章节二 .................................................................................................... 错误！未定义书签。

Pre-Install ....................................................................................... 错误！未定义书签。

章节内容1 ....................................................................................... 错误！未定义书签。

章节内容2 ....................................................................................... 错误！未定义书签。

Open and Closed Issues for this Deliverable .. (18)
Open Issues (18)
Closed Issues (18)
BI Publisher报表开发
本教程以开发一个资产负债表为例，介绍BI Publisher报表开发的相关方法，包含如
下几个部分：
●BI Publisher报表创建
●RTF模板开发
文档约束前提
本文假设你已安装并配置好
●BI Publisher Enterprise
●Office 2003或Office 2000
数据源配置
1.打开BI Publisher登录窗口，以Administrator/administrator登录BI
Publisher。

如下图所示：
2.进入后，点击左上角的“管理”，进入管理页面。

3.选择“数据源>JDBC连接”，进入“数据源”查看界面：
4.选择添加数据源，将会出现如下图所示页面，输入数据源相关信息即可。

下图
是一个示例，同样地，完成相其他关数据源的配置，从而保证在创建报表后能
够正确连接到数据库。

BI Publisher报表创建
1.点击左上角的“报表”Tab页，进入相关目录。

2.进入你想要创建报表的目录，点击右边“文件夹与报表任务”中的“创建新报
表”，输入报表名称“资产负债表”，然后点击“创建”按钮。

如下所示：
3.然后点击报表下面“编辑”，进入报表定义界面。

4.选择“数据模型”，然后点击左上角的“新建”按钮，新建一个数据模型，将
数据模型命名为“mainSQL”，类型设置为“SQL查询”，数据源设置为
“irdemo_dev”
数据模型设置：
这里使用的类型是“SQL查询”，其他类型的配置方法请参照其他相关文档。

5.在上面的SQL查询中，使用了参数（以:开头的变量），那么就要在“参数”中
定义同名的参数，这样在报表运行的时候，“参数”中定义的参数值会自动传
递给SQL查询，从而实现报表查询的功能。

新建参数的方法：点击“参数”，然后点击左上角“新建”新建一个参数，将名字命名为“p_gdb_coa_company”，这个名字与SQL查询中的:
p_gdb_coa_company对应，在参数属性页面，定义好相关的属性：
同样地，根据需要建立起“p_current_code”、“p_current_date”参数：参数p_current_code设置：
参数p_current_date设置：
6.设置值列表
为了实现参数的下拉列表的形式，我们需要“值列表”来输入参数的值。

新建值表表的方法：点击“值列表”，然后点左上角的“新建”按钮，新建一个名称为“gdb_coa_company”的值表表。

相关属性设置如下：
注意：在“值表列表”中SQL查询要select 两个表，其中第一个列是我们在下拉列表中显示的字段，第二个表是则是传递给参数的值。

相应的完成“gdb_currencies_vl”值列表的创建。

如下图所示：
7.映射值列表到参数：
将参数的“参数类型”设置为“菜单”，然后会出现菜单设置，选择值列表为上面我们创建的“gdb_coa_company”，同时在“选项”中勾选“可以多选”，并设置当多选时传递给参数的值为“传递了NULL值”，这样当选择菜单中的“全部”时，参数接收到的值将会是：NULL，于是我们可以在程序中使用NVL来处理这个参数。

同样地，设置参数p_current_code的值列表为“gdb_currencies_vl”。

如下图所示：
8.上传模板
点击左边的“布局”，在右边“管理模板文件”上传做好的RTF模板。

注意：这里可以先只上传一个空的RTF文件到系统，在下一节中会介绍如何通过Office
插件开发RTF模板。

9.新建布局
点击左上角的“新建”按钮，新建一个布局。

输入名称“资产负债表”，从下拉
列表中选择为“资产负债表”保存即可。

RTF模板开发
1．安装Office插件
打开BI Publisher目录结构，然后在右边中找到“开发人员工具”，选择下载
“template builder”工具，直接按默认安装即可。

打开MS Word，看到菜单栏是否多了“Oracle BI Publisher”菜单，如下图所示，如果有，则表明已安装成功，否则需要重要安装。

2．从Word中登录Oracle BI Publisher，选择模板文件。

点击Word菜单栏中的“Oracle BI Publisher”，选择“登录”如下图所示，在用户名与密码中输入前台web登录用的用户名与密码，在报表服务器上输入前台web登录的地址。

登录后，浏览工作区，找到刚才创建的报表模板，然后点击“打开布局模板”，打开模板文件，这样会打开一个新的模板文件，在这个模板文件中进入开发，保存后可以直接
上传到服务器上。

3．下载xml文件方便分析。

这一步不是必须，只是提供一种分析方法，为了使报表能够正确展示出
来，我会常常需要分析XML数据，这时可以通过在点击“视图”如下图所示：
在视图中选择“数据”，然后点击“视图”这样可以生成XML数据，再点击导出可以将XML数据导出到本地：
注意：如果在下拉列表中没有找到“视图”，则可能是在布局中没有启动它，启用方法：
在“编辑”模式下，选择布局的常规设置可以选择输出格式，如下图所示：
4．关于rtf模板的开发。

RTF模板的开发，请参照官方文档“BI Publisher用户指南”（在安装完“Template Builder”后，可以开始菜单中找到（或到安装目录中查找）），实际上“BI Publisher用户指南”与Oracle的“XML Publisher用户指南”基本相同，如果掌握了Oracle XML Publisher，则可以在BI Publisher上完全无障碍开发。

在BI Publisher中，点击域后将弹出BI Publihser属性，在属性里可以直接设置循环、分组、排序等属性，templete builder会自动生成相应的代码，可以在“高级”中查看到。

这为开发人员节省了大量时间，比起以前的XML Publisher，BI Publihser极大地提高了开发的效率！
关于rtf模板的开发是一个大专题，具体开发技巧请参考相关文档或本人后续文档《BI Publisher开发常用技术》，作为示例与参考，下面给出一个已开发好的资产负债表的rtf模板，基本已覆盖常用技术。

C:\Documents and
Settings\Rondge\桌面
Open and Closed Issues for this Deliverable Open Issues
Closed Issues。