Step by Step to Define a BI Publisher Report

这里演示一下，开发一个最简单BI Publisher Report的流程，下图为开发的基本流程.

Data Template(.xml) 作为Data Source，用于数据源的定义，以及取数的SQL语句;

Template(.rtf) 用于定义输出展示(Layout); (RTF:Rich Text Format)

1.首先创建一个Demo数据

CREATETABLE demo_products
( product_code NUMBER,
product_name VARCHAR2 (100));
INSERTINTO demo_products
VALUES (569, 'Oracle Cost Management');
INSERTINTO demo_products
VALUES (401, 'Oracle Inventory Management');
COMMIT;

2.Define Data Template

Date Template为XML文件，基本的格式如下图

<parameters><parameter>为传入参数项

<dataQuery><sqlStatement>为Report所执行的Query语句

<dataTrigger>用于指定beforeReport或afterReport，调用那个Function/Procedure

<dataStructure>为XML输出的结构

这里创建我们的Data Template文件

<?xmlversion="1.0"encoding="UTF-8"?>
<dataTemplatename="demoProductsDT"description="Demo Products Details"version="1.0">
<parameters>
<parametername="p_product_id"datatype="number"/>
</parameters>
<dataQuery>
<sqlStatementname="DQ">
<![CDATA[ SELECT product_code, product_name FROM demo_products
WHERE product_code = NVL(:p_product_id,product_code) ]]>
</sqlStatement>
</dataQuery>
<dataStructure>
<groupname="G_DP"source="DQ">
<elementname="PRODUCT_CODE"value="product_code"/>
<elementname="PRODUCT_NAME"value="product_name"/>
</group>
</dataStructure>
</dataTemplate>

最后保存成ABC.xml

3.Create Data Definition & Associate with Data Template

XML Publisher Administrator -> Data Definitions -> Create Data Definition

这里的Code会被后边定义的Concurrent Program用到.

接下来，Data Template 'Add File'，选择我们第二步定义的XML Data Template.

4.接下来切换到Application Developer职责下，定义一个新的Concurrent Program

注意：
1. Output format应该XML
2. Short Name和之前定义Data Definition中的Code完全一样

What is XDODTEXE used in the Executable section of Concurrent Program?

XDODTEXE is a BI Publisher Data Template Executable. The purpose of this executable is to identify data template file (.xml) and execute the data template to generate the raw xml data, that later can be used by BI Publisher formatting engine to format as as per the layout (RTF, PDF etc).
This executable will be used by all the BI Publisher reports (Concurrent Program) which are using Data Template to generate the xml data.

5.Concurrent Program Parameter

Note:Token is p_product_id. This is the bind parameter we have used in date template. For every bind parameter used in the data template, we have to define parameter in the concurrent program.

6.把这个新定义的Concurrent Program绑定到对应Request Group里

切换到System Admin职责，Security > Responsibility > Request，把刚定义好的Program绑定到一个Request Group里