Set Up an Existing Report for Bursting

37-4 Oracle Reports Users Guide to Building Reports To edit the distribution XML file: 1. In a text editor, such as Notepad, open the sample distribution.xml file we have provided. 2. Find the placeholder text: YourFilePath, and replace it with the location of where your resulting PDFs will be stored. Example: Replacing the placeholder text with: d:\temp\ changes the path to: d:\temp\Rep_amp;lt;citygt;.pdf Using this complete path places the resulting PDF files in d:\temp. 3. Find the placeholder text: OriginEmailAddress, and replace it with the senders e-mail address. 4. Perform step 3 for all instances of the placeholder text: OriginEmailAddress. 5. Find the placeholder text: DestinationEmailAddress, and replace it with the recipients e-mail address. 6. Perform step 5 for all instances of the placeholder text: DestinationEmailAddress. 7. Save the XML file to the same directory where you have saved inventoryreport_dist_your_initials.rdf. You have finished customizing the distribution XML file to send a single e-mail to corporate headquarters with all of the individual warehouse reports, and multiple e-mails with a single attachment each to the individual warehouses.

37.4 Run the Report

You can distribute the report using a Web browser. Type the following command in the Location field of your browser: http:host:portreportsrwservlet?REPORT=your_pathinventory_report_dist_your_ initials .rdfUSERID=your_login_IDSERVER=your_server_nameDISTRIBUTE=YES DESTINATION=your_pathdistribution.xml Note: For this example, we show you how to send e-mails to static e-mail addresses. However, if you want to send the report to various e-mail destinations, you must create a recipient field in your data model. Then, in the ex2 section of distribution.xml, replace the placeholder text DestinationEmailAddress with amp;lt;recipientgt;. You can then delete the first section of the distribution.xml file marked ex1. Note: It is not required that you save the XML file to the same directory where your RDF is located, as you can specify the location of the XML file at runtime. Either distribution.xml and RDF must be in Reports Path, or provide the complete path in the command line URL. Bursting and Distributing a Report 37-5 where your_path is where your RDF file and the distribution.xml file is located. your_login_ID is your login information for the sample schema you have used with the sample RDF. The SMTP mail server is set up during the installation process. If you did not specify a server during installation, you can set up the mail server manually before distributing your report to an e-mail destination. You can specify the outgoing mail server using pluginParam in the server config file. EXAMPLE: pluginParam name=mailServersmtp01.mycorp.compluginParam For more information on setting up the mail server, refer to the chapter Configuring Oracle Reports Services in the Oracle Fusion Middleware Publishing Reports to the Web with Oracle Reports Services manual, available on the Oracle Technology Network Oracle Reports Documentation page http:www.oracle.comtechnologydocumentationreports.html . Running the report creates a file for each warehouse based on the warehouse ID in the specified directory. When the report is distributed, a single e-mail is sent to one address with all of these files attached to the e-mail. If you set up the distribution.xml file for multiple e-mail addresses, each warehouse or each e-mail address would be sent a single e-mail with a single attachment file that includes the report for that warehouse.

37.5 Summary

Congratulations You have distributed a report. You now know how to: ■ modify the layout of an existing report to burst on a group in your layout. ■ distribute a report using e-mail by modifying the distribution.xml file. For more information on any of the wizards, views, or properties used in this example, refer to the Oracle Reports online Help, which is available in Oracle Reports Builder or hosted on the Oracle Technology Network OTN, as described in Section 4.1.1, Using the Oracle Reports online Help .