RDF2BIP CONVERSION
ORACLE REPORTSTo BI PUBLISHER REPORTS CONVERSION
PROCESSReference:Version:Date:C00xx0.119th Jun 2014
SPAN Infotech (India) Pvt. Ltd.A-40 A, Landmark Plaza, F3 Tower,
7th Floor,Quark City New Building, Industrial Area, Phase VIII
Extension, Industrial Focal PointS.A.S Nagar,
Mohali-160071,Punjab,IndiaPhone: +91 172-667 5063URL:
www.spansystems.com
Document ControlChange RecordDateAuthorVersionChange
Reference
22-07-2014Sandeep Kaur1.0 New document
DistributionNameOrganisation
Contents
1.1Change
Record11.2Distribution11.PURPOSE32.PREREQUISITES32.1.jar
Files32.2Oracle Developer Suite 10g33.PROCESS33.1Place JAR files
inside a folder33.2Convert RDF report to XML43.3Create Data
Template from Oracle Report53.4Create RTF Template from Oracle
Report63.5Compile PL/SQL Package in Database73.6Create Concurrent
Program & Assign to Responsibility73.7Create Data
Definition83.8Create Data Template103.9Run the Concurrent
Program124.Conclusion135.Open Points13
1. PURPOSEWith release of Oracle R12 and Fusion applications,
Oracle BI Publisher is taking over the Oracle reports due its wide
range of new and flexible features. Thus, many organizations may
require to convert their existing Oracle Reports into BI Publisher
reports along with migration from Oracle 11i to Oracle R12
application. This document describes the process for converting
Oracle reports into BI Publisher reports; and registering the BI
Publisher reports into XML Publisher responsibility in Oracle EBS.
PREREQUISITES .jar FilesFollowing JAR files are required to carry
out the conversion process: Aolj.jar Collections.jar
Versioninfo.jar Xdocore.jar (or xdo-core.jar) Xdoparser.jar
Xdoparserv2.jar j5472959_xdo.zipSource: These .jar files are
available after installation of BI Publisher Server. (I got these
from BI Publisher 11.1.1.7.1 Trial Edition under folder: C:\Program
Files\Oracle\BI Publisher Trial
Edition\bip\server\domains\bipdomain\servers\bipserver\tmp\_WL_user\xmlpserver\7tre7g\war\WEB-INF\lib)The
j5472959_xdo.zip can be found under patch p5472959_11i_WINNT
downloadable from Metalink.Oracle Developer Suite 10g This suite
includes rwconverter utility which is used to convert .rdf files
into .xml files. It is feature of reports builder tool.
PROCESSPlace JAR files inside a folderKeep the jar files and the
patch zip file inside a folder on any drive, and set CLASSPATH for
these files. Create a new environment variable CLASSPATH and give
path for each jar file in the value field. Also, correct java path
should be set under PATH environment variable. Convert RDF report
to XML Create two folders: SourceFiles and TargetFiles. Place RDF
report in SourceFiles folder. Run the following command to convert
a RDF file into XML file and place it into destination folder.
rwconverter batch=yes
source=D:\BIPConversion\SourceFiles\Po_Info.rdf
dest=D:\BIPConversion\TargetFiles\Po_Info.xml dtype=xmlfile
overwrite=yes
(I used the GUI version from folder where developer suite has
been installed - C:\DevSuiteHome_1\BIN\rwconverter).Po_Info.xml got
generated in TargetFiles folder.
Create Data Template from Oracle Report Now, create Data
Template from Oracle Report using the DataTemplateGenerator class
available inside the patch downloaded from Metalink.Use below
command by giving name of the xml generated in above step:
"C:\Program Files (x86)\Java\jre7\bin\java.exe" -verbose -cp
D:\BIPConversion\JarFiles\aolj.jar;D:\BIPConversion\JarFiles\xdoparser.jar;D:\BIPConversion\JarFiles\collections.jar;D:\BIPConversion\JarFiles\j5472959_xdo.zip;D:\BIPConversion\JarFiles\versioninfo.jar;D:\BIPConversion\JarFiles\xmlparserv2.jar
oracle.apps.xdo.rdfparser.DataTemplateGenerator
D:\BIPConversion\TargetFiles\Po_Info.xml
(There was problem in CLASSPATH variable, so needed to give full
path for each jar file in the command)The DataTemplateGenerator
process completed succefully.
Following files got generated in the TargetFiles folder:
This process completed with three files as outcome: Data
template (Po_Info_Template.xml) Pl/Sql Package Specification
(Po_InfoS) Pl/Sql Package body (Po_InfoB)Create RTF Template from
Oracle ReportUse below command to generate the RTF template and log
file for the Oracle report:"C:\Program Files
(x86)\Java\jre7\bin\java.exe" -verbose -cp
D:\BIPConversion\JarFiles\aolj.jar;D:\BIPConversion\JarFiles\xdoparser.jar;D:\BIPConversion\JarFiles\collections.jar;D:\BIPConversion\JarFiles\j5472959_xdo.zip;D:\BIPConversion\JarFiles\versioninfo.jar;D:\BIPConversion\JarFiles\xmlparserv2.jar
oracle.apps.xdo.rdfparser.RTFTemplateGenerator
D:\BIPConversion\TargetFiles\Po_Info.xml
The RTFTemplateGenerator class process successfully:
Following files got generated under TargetFiles folder:
This process completed with following files as output: RTF
template (Po_Info.xml) Log file (Po_Info.txt)Compile PL/SQL Package
in DatabaseAfter this, compile the package specification and
package body on database of the OEBS suite. Before compilation, you
must manually check the package code for any formatting errors. It
is very common that there are formatting issues in the code
generated. For example, a function name generated with spaces in
between words; assignment operator missing colon, etc. Need to
manually solve these minor errors.Create Concurrent Program &
Assign to ResponsibilityCreate a concurrent program in Oracle
applications to run the BI publisher report generated in above
steps.Navigation: System AdministratorConcurrentProgramDefine a new
concurrent program with executable XDODTEXE and output format as
XML. XDODTEXE is XML Publisher Data Template Executable Engine,
which is a Java Concurrent Program.
Then assign this concurrent program to any responsibility from
which you want to run it. Here, it is assigned to Purchasing
responsibility with assignment group as All Reports.
Note down the short name for the concurrent program, will be
used to create data definition.
Follow below steps to assign the program to a
responsibility:Navigation: System
AdministratorSecurityResponsibilityRequest
Search for All Reports request group. Go to Requests block and
click on any Program name; then click new and search for the
concurrent program name (RDF2BIP Conversion Test Po Info) from the
LOV. Press tab and save the record.Now this concurrent program is
accessible from requests in purchasing responsibility.
Create Data Definition Now, need to create data definition and
data template for running the BI Publisher concurrent program.
Navigation: XML Publisher ResponsibilityData Definition
Click on Create Data Definition button, a new screen will
appear. Give a name (Po Info Data Definition). Select
responsibility (Purchasing) same as selected for the concurrent
program. Give short name of the concurrent program (RDF2BIPPOINFO)
in the Code field. Click apply.
Then go the Files section on the same page and click on Add File
button against the Data Template field. A new screen will appear.
Browse for the data definition file (Po_Info_Template.xml) in
TargetFiles folder. Click apply.
The Files section show that data definition file has been
uploaded.
Create Data Template
Now create data template for the BI publisher report.
Navigation: XML Publisher ResponsibilityData Template
Click on Create Template button.
Give name for the template (Po Info Test) Select application
(Purchasing) Give code i.e. conc program short name (RDF2BIPPOINFO)
Select data definition from the search button (Po Info Data
Definition) The type is RTF by default. Select default Output Type
(PDF) from list given which will decide output format for the
concurrent program.
Go to Template File block and upload the RTF file (Po_Info.rtf)
from TargetFiles folder.
Select language (English)
Click apply. Template Po Info Test has been created
successfully.
The concurrent program will use this template and data
definition to get the output from database using the Pl/Sql package
complied earlier. The linkage between concurrent program and data
definition is through the program short name given as code
here.
Run the Concurrent Program Navigation: PurchasingRequestSubmit
New RequestSingle RequestNow run the concurrent program to see
output for the BI Publisher report generated through above process.
Query the program name here and submit with default parameters (no
parameter).
Go to request and see the report completed successfully without
any errors.
Click on view output to see the output in PDF format as
below:
ConclusionWe used Oracle BI Publisher utility to carry out a
simple conversion process for converting the Oracle Report into BI
Publisher Report using some .jar files and java classes to create
necessary files for the report to run.We used a very simple
customized .rdf report for carrying out the conversion process. The
report consisted a simple select clause and count function to
display the row count. We took the RDF report and run various
command to generate necessary files for registering the report in
XML Publisher responsibility and got the output in PDF format.Open
PointsIt was a very simple RDF report here with no complex logic.
It got converted successfully. But this process needed to be tested
for complex Oracle reports which may cause some issues while doing
conversion process.
SPAN Confidential 2013 Ver. 1.0 Page 13 of 13