Introduction:

Oracle XML Publisher is a template-based publishing solution delivered with the Oracle E-Business Suite. It provides a new approach to report design and publishing by integrating familiar desktop word processing tools with existing E-Business Suite data reporting. The collection of the data is still handled by the E-Business Suite, but now you can design and control how the report outputs will be presented in separate template files. At runtime, XML Publisher merges your designed template files with the report data to create a variety of outputs to meet a variety of business needs, XML Publisher provides the Template Manager to register and maintain report templates and their data sources. Once both have been registered, use the XML Publisher Concurrent Request to merge the template and its data source into the customized report. Template Manager The Template Manager is the repository for your templates and data sources. It is also the interface for to you associate your templates to data definitions and make them available to XML Publisher at runtime. From the Template Manager you can download, update, and preview your templates and translations. XML Report Publisher Concurrent Request (Required in Earlier versions) The XML Report Publisher concurrent request produces the final output of your customized report. Before running this request, run your E-Business Suite report to obtain the XML data file. The XML Report Publisher request accepts as parameters the E-Business Suite report request ID and the desired template. The template must be associated to the report data definition in the Template Manager. The XML Report Publisher request merges the data and the template.

Installation Steps:Installing Oracle XML Publisher - You need to download the patch 4561835 from Metalink and install Oracle XML Publisher on your PC. After installation of Oracle XML Publisher you will see additional menu option Template Builder in Microsoft Word as shown below.

Template Builder Menu

Template Builder Menu Option

For a brief tutorial about template builder read Template_Builder_for_Word_Tutorial.doc, that comes with the XML Publisher Install.

Process Steps :1. For new report

Write the query to collect data in report builder. Save the file as .rdf and upload it to the database server Register a concurrent program to run this report. When defining concurrent program change the output to XML.

Change the output format to XML here

For standard oracle applications report, just change the output format as XML .
Run the report and click on view output. Save the output as an .XML file in a folder on your local machine. This output file will be needed to create the word template.

Sample out is shown below

<?xml version="1.0" ?> - <!-Generated by Oracle Reports version 6.0.8.24.0 --> <XML_TEST> <LIST_G_1> <G_1> <TRX_NUMBER>10000855</TRX_NUMBER> <LIST_G_TRX_NUMBER> <G_TRX_NUMBER> <TRX_DATE>09-APR-97</TRX_DATE> <INVOICE_CURRENCY_CODE>USD</INVOICE_CURRENCY_CODE> <RCTL_CUSTOMER_TRX_ID_RCTL_LINE>77631</RCTL_CUSTOMER_TRX_ID_RCTL_LINE> <LINE_TYPE>LINE</LINE_TYPE> </G_TRX_NUMBER> <G_TRX_NUMBER> <TRX_DATE>09-APR-97</TRX_DATE> <INVOICE_CURRENCY_CODE>USD</INVOICE_CURRENCY_CODE> <RCTL_CUSTOMER_TRX_ID_RCTL_LINE>77631</RCTL_CUSTOMER_TRX_ID_RCTL_LINE> <LINE_TYPE>TAX</LINE_TYPE> </G_TRX_NUMBER> </LIST_G_TRX_NUMBER> </G_1> </LIST_G_1> </XML_TEST> Create the word template using this XML output file. Read

Template_Builder_for_Word_Tutorial.doc for quick start and read XML Publisher Users guide which get installed with XML Publisher for detailed information on creating Word templates. START ALL PROGRAMS ORACLE XML PUBLISHER DESKTOP XML Publishers User Guide.

2. Design Time steps : Register the E-Business Suite report as a Data Definition in the Template manager

Cretae a Data Definition in the Template Manager (Available under XML Publisher Administrator Responsibilty ) . for E-Business Suite report that you wish to customize using XML Publisher. When creating the data definition, the data definition code must match the E-Business Suite report short name.

XML Publisher Administrator HOME Data Definations Create Data Definition.

Should be same as Short Name for E-Business Suite report.

Design the template using the word template builder and save it as a .RTF file on your local machine. Register your Template in the Template Manager.
After creating the template in the template Builder, we need to register and upload the RTF template files in Template Manager.The template must be assigned to the Data Definition Code of the EBusiness Suite report with which it will be merged.

XML Publisher Administrator HOME Templates Create Template.

Runtime steps
After you design your template and register it with Template Manager, run the concurrent program using standard request submission to obtain the XML output. Before you hit the submit button, you can check the template attached to your concurrent program by pressing the options button in Upon Completion section. Below is the screen shot of the concurrent program for which we have defined and attached the Template.

Final Output using the above concurrent program is below: