B i publisher开发报表实例教程.doc

BI Publisher开发报表实例教程Author:Rongjie ZhangCreation Date:2009-05-12Last Updated:九月 10, 2011Document Ref: Version:1.0 Copy Number_Document ControlChange Record18DateAuthorVersionChange Reference2009-05-12Rongjie zhang1.0No Previous DocumentReviewersNamePositionDistributionCopy No.NameLocation1234Note 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.ContentsDocument Control2BI Publisher报表开发4文档约束前提4数据源配置4BI Publisher报表创建5RTF模板开发9章节二10Pre-Install10章节内容110章节内容210Open and Closed Issues for this Deliverable11Open Issues11Closed Issues11BI Publisher报表开发本教程以开发一个资产负债表为例，介绍BI Publisher报表开发的相关方法，包含如下几个部分：l BI Publisher报表创建l RTF模板开发文档约束前提 本文假设你已安装并配置好l BI Publisher Enterprisel 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_code数据类型字符串默认值CNY参数类型文本显示标签币种:参数p_current_date设置：属性值标识p_current_date数据类型日期默认值2006-12-31参数类型日期显示标签日期：文本字段大小12日期格式字符串yyyy-MM-dd6. 设置值列表为了实现参数的下拉列表的形式，我们需要“值列表”来输入参数的值。新建值表表的方法：点击“值列表”，然后点左上角的“新建”按钮，新建一个名称为“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目录结构，然后在右边中找到“开发人员工具”，C:OracleBIxmlpXMLPTools，选择下载“template builder”工具，直接按默认安装即可。打开MS Word，看到菜单栏是否多了“Oracle BI Publisher”菜单，如下图所示，如果有，则表明已安装成功，否则需要重要安装。2 从Word中登录Oracle BI Publisher，选择模板文件。点击Word菜单栏中的“Oracle BI Publisher”，选择“登录”如下图所示，在用户名与密码中输入前台web登录用的用户名与密码，在报表服务器上输入前台web登录的地址http:/localhost:9704/xmlpserver。登录后，浏览工作区，找到刚才创建的报表模板，然后点击“打开布局模板”，打开模板文件，这样会打开一个新的模板文件，在这个模板文件中进入开发，保存后可以直接上传到服务器上。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