XMLP Concurrent Program- Revisited with BurstingSunday, 27 April 2008 17:15 Anil Passi|   Print   |

 

Thanks to the wonderful XML Bursting article written by Prasad CP. Following his explanations in this link, I have re-created the old tutorial for XML Publisher Concurrent Program that was written in Year 2006.Old tutorial has now been further enhanced to burst the report output to each email address in the manager table.This article simply shows the steps, however for detailed explanation of concepts bursting control file etc, please read Prasad CP's articles, where he has explained each node of the Bursting Control File.

You will also be able to download each of the component used in this demo.

 

Overview of steps in this article are

1. Create table which will provide data for Bursting Report

2.

3.

4. Create a report name XX_MANAGERS.rdf

5. Run the report in preview mode in reports designer

6. Add user parameters to this report and FTP to $AR_TOP/reports/US

7. Register this report as concurrent program of type XML

8. Add this report to Receivables group

9. Run this report and save the xml file as xx_manager_output.xml

10. Download & install XML Publisher desktop software latest version[as yet]

11. Import xx_manager_output.xml in MS Word, and create default layout

12. Save the default layout as rtf file MANAGER_XML_TEMPLATE.rtf

13. Preview the report output within MS Word using XMLP Preview option

14. Define data definition for the XMLP Report

15. Prepare a simple bursting file, with help of XML xx_manager_output.xml

16. Upload the bursting control file to data definition

17. Create XMLP Template XX_MANAGERS, and upload MANAGER_XML_TEMPLATE.rtf to this template.

18. Create pl/sql procedure xx_submit_bursting in apps schema, that submits fnd_request for XDOBURSTREP,

with debug parameter= Y

19. Call XDOBURSTREP from After report trigger, passing it current request_id

20. Ensure that srw.user_exit('FND SRWINIT') has been called from before report trigger

21. FTP the XX_MANAGERS.rdf againt to $AR_TOP/reports/US

22. Run the report, and you will see the Bursted Output in mailbox.

Ensure that you have the desired patches, as per your EBS Level, as mentioned in Prasad's article.

select application_short_name, bug_number, to_char(creation_date,'DD-MON-YYYY HH24:MI:SS') datedfrom apps.ad_bugswhere bug_number = '5968876';

Run the below in non-apps schema [but for demo I am using APPS]--Create the tables as belowcreate table xx_managers ( manager_no integer, manager_name varchar2(200) ) ;insert into xx_managers ( manager_no, manager_name ) values ( 1000, 'Anil Passi') ;insert into xx_managers ( manager_no, manager_name ) values ( 1001, 'Martin') ;commit;--add email address column to the table

commit;Note:- To each record in the table, we will Burst the output via Email.Please note, the intention is just to show the steps, and not necessary the breakdown of data structure.

Hence only a simple single repeating frame based layout is being used. 

In control file you need to specify the level at which data should be broken down while bursting.

Create a new report as shown below, and name it XX_MANAGERS

Add the user parameters[i.e. P_CONC_REQUEST_ID, P_RESPONSIBILITY_ID, P_USER_ID] as shown above.

Preview the report in reports builder itself, by running the same in Reports Builder

FTP XX_MANAGERS.rdf to $AR_TOP/reports/USSilly it is, but for demo I will use standard Application [forgive me, but I am making it easier for you to run the source code].

Create Concurrent program executable for XMLP report, as if it is a normal report

Create a concurrent program for the executable. Note that I have kept the shortname and the program name both as XX_MANAGERS.IMPORTANT:- Note that format is XML

Register this program with Receivables request group.Now, make the report available to default request set of “Receivables Manager” responsibility.

DECLAREBEGINfnd_program.add_to_group(program_short_name => 'XX_MANAGERS',program_application => 'AR',request_group => 'Receivables All',group_application => 'AR');COMMIT;EXCEPTIONWHEN OTHERS THENdbms_output.put_line('Object already exists');END;/

Login to receivables Manager, and Run the report from Submit Request window, as a concurrent program submission. 

Output will appear as shown below

IMPORTANT NOTE - Save the above XML outpur as xx_manager_output.xml on your PC.

Ensure that you have installed the latest version of XML Publisher desktop software

http://updates.oracle.com/ARULink/PatchDetails/process_form?patch_num=5887917

 Open MS Word, you will see the menu’s as shown

Load the xml output of concurrent program into XMLP Desktop tool

Now, click on insert and click on Table/Form

Within Insert Table/Form, as shown below, drag the List G Manager No to Template section

The default Layout is created as below

You can preview the output as below from within MS Word, using XMLP Desktop Preview option

Preview is as shown below

Now, lets do the real bit in attaching the Concurrent Program definition to XML Publisher. Logon to responsibility “XML Publisher Administrator”.

Click on “Data Definition” menu as above…so that we can create the XMLs source data Definition. Effectively we are saying that output of the Concurrent program becomes the data definition for XMLP.

Lets create “Data Definition” with the values in below fields Name : XX_MANAGERSApplication : ReceivablesCode : XX_MANAGERS [Note: This is the short name of the Concurrent program]Start Date : Leave it to default SysdateClick on “Apply”

As soon as you create a Data Definition, you will then be presented with Bursting Control File option as shown below.

Click on the button for uploading Bursting Control File

Ensure that a bursting file created as below has been uploaded

Sample definition of bursting control file is

Ensure that temp directory is set, for this, navigate to Administration in XML Publisher Administrator

In this case, I am setting the Temporary directory to /tmp

Ensure that the XML Template file is there on the server. It can be anywhere on server, we simply note down the path to use it in bursting control file.

In the above example, the RTF template file[MANAGER_XML_TEMPLATE.rtf] is in /tmp Hence in bursting control file, we will mention the path /tmp/MANAGER_XML_TEMPLATE.rtfVERY IMPORTANT NOTE- In real life, this rtf file will not be in /tmp directoryIf your concurrent managers run on DB Tier itself, then ensure that rtf template file has been FTP’ed to /tmp on DB Tier.

Create template as below, by uploading the rtf file during template creationName : XX_MANAGERS [this is the name of the template]Code : XX_MANAGERS [short name of conc program]Application : ReceivablesData Definition : XX_MANAGERS [the one that we created in prior step 12]

Start Date : Leave this default.Type : RTFClick on browse and select the RTF file[MANAGER_XML_TEMPLATE.rtf] that you had saved using MS-Word/ 

Click on Apply, and you will get the below record.

Your template has now been created

Run the below procedure in APPS SchemaCREATE OR REPLACE PROCEDURE xx_submit_bursting(p_request_id IN INTEGER) ASn_request_id NUMBER;BEGINn_request_id := fnd_request.submit_request('XDO','XDOBURSTREP',NULL,NULL,FALSE,p_request_id,'Y');END xx_submit_bursting;/

Ensure that the procedure has been created

Open report XX_MANAGERS in reports editor, and in the After Report Trigger & Before Report Triggers, write code belowFUNCTION afterreport RETURN BOOLEAN ISBEGINxx_submit_bursting(:p_conc_request_id);RETURN(TRUE);END;

FUNCTION beforereport RETURN BOOLEAN ISBEGINsrw.user_exit('FND SRWINIT');RETURN(TRUE);END;

Next, ftp the file XX_MANAGERS.rdf again to the $AR_TOP/reports/US. This is so, because, now we are calling the bursting process from the After Report Trigger

Run the XX_MANAGERS as below, this will submit the Bursting process too.

I can now see the emails in my inbox, as below

First email is as shown below

Second email is as shown below