Professional Documents
Culture Documents
Agenda
Business Intelligence Publisher Overview Tips and Best Practices Implementation Case Study
Oracle E-Business Suite Credit-to-Cash modules Oracle E-Business Suite Record-to-Report modules Oracle E-Business Suite Procure-to-Pay modules
Checks
Payment Server
EFT/EDI
Business Intelligence Publisher Single Solution Use BI Publisher For: Authoring Managing Delivering Meet Business Requirements Remove Complexity Reduce TCO
Destinations XML / EFT / EDI Labels
Checks Invoices
Reports
HTML XSL
Excel Power Point Flash
Layout Templates
E-Business Suite, PeopleSoft, Siebel, JDE
Printer
RTF
Fax
CSV XML
Repository
OLAP
EDI EFT
e-Commerce
Web Services
Data Sources
Layout Tools
8
Output Formats
Destinations
10
Running 11i -> MOS 422508.1 About Oracle XMLP Release 5.6.3 Running R12 -> Congrats, you already have 5.6.3!
11
MOS 1138602.1 Overview of Available Patches for Oracle XML Publisher (embedded in Oracle E-Business Suite)
Some Individual Patches are available Patch Sets are rolled into ATG Family Packs.
12
BI Publisher Releases
Release 11.5.10
Release 12
BI Publisher 5.6.3
Runtime Optimization, Enhancements
In 11i --500 templates R12.1 --ALL reports are BI Publisher: 2724 templates and 2092 data sources or data templates across 95 products Oracle Reports to Publisher Conversion Assistant
13
14
http://www.oracle.com/technetwork/middleware/bi-publisher/overview/index.html
15
Covers: Large data set strategies XML structures Lots of great template tips for performance, consistency, formatting.
16
17
18
19
Session: Many Faces of BI Publisher in EBS (S319051) Tuesday 12:30 1:30 Moscone West 2011
20
21
22
Fax
Printer
23
24
25
26
27
Fax
Utilizes IPP to communicate with 3rd party software/hardware to transmit data. Set Fax Number only
Print
Utilizes IPP/CUPS to communicate with Printers Ensure that printers can handle output data or filter first.
28
29
30
31
Know When To Ask For Help and How and Where To Ask For It
32
33
Help! - Documentation
Documentation!
34
Help! - Debugging
Turn on debugging Review the logs
35
How to Get Help on Forums: a. b. c. d. e. Search First, Ask Second Be someone (not user8840234) Be Specific Reward others for their assistance It is better to give than receive
36
Forums Community Contributed Resource Documents examples: Troubleshooting Oracle XML Publisher How To Install a Font Using XMLP Admin
37
38
Best Practices
Get to the Latest Version of BIP for EBS Know Oracles Published Best Practices Utilize the Correct Tools for your version of BIP Know what BIP is Capable of Within Different Applications Understand Your Delivery Options Understand How To Troubleshoot Know When To Ask For Help and How and Where to Ask For it
39
40
Prepare Environment
Prepare you environment by reviewing BI Publisher patches required Apply patches as required Provide BI Publisher Administrator Get desktop installation of BI Publisher BI Publisher Toolbar should be available in MS Word after Installation
41
XX_TRX_PRINT.RD F
XX_TRX_PRINT.xml
42
RDF Layout
java.exe oracle.apps.xdo.rdfparser.RTFTemplateGenerator XXXX_TRX_PRINT.xml
43
Template Validation
44
45
Insert XML field in the template Insert Menu -> Field option All the headers and summary level details can be inserted using this feature
46
47
Conditional Formatting
display lines with
48
RTF Template
Preview PDF
49
DataTemplateGenerator creates:
Data Template (XX_TRX_PRINT_template.xml) PLS files for Report PLSQL code: PL/SQL package specification (XX_TRX_PRINTS.pls) PL/SQL package body (XX_TRX_PRINTB.pls)
Data Template
Package Specification
Package Body
50
51
<parameters>section in which parameters are declared in child <parameter> elements; <dataQuery> section in which the SQL queries are defined in child <sqlStatement> elements; <dataTrigger> section in which PLSQL function are defined which are fired when the event occurs <dataStructure> section in which the output XML structure is defined
52
53
54
55
56
57
documents from a batch Dynamic generation based on data Deliver in desired layout and output format Deliver down desired delivery channel Integrated into concurrent processing
Batch Data
Control File
HTML
Templates
58
59
60
This submits XML Publisher Report Bursting Program program which splits current programs XML output, generates documents and delivers them to destination mentioned in Bursting Control File
61
Automated process
62
Register data and template definition metadata and load data template and layout template
63
64
65
User can select a different template from the LOV Then a different language if available Then an output format
66
67
CTC Implementation
Invoice Print Programs converted from Optio to BI Publisher Reports Notifications converted are:
Standard Invoice Prints Dunning Letters Credit Card Notifications (Charge/ Decline/ Refund)
69
Invoice Print Program Changes OPTIO implementation had different RDFs created to support different layouts
XXVS_OPTIO_R_RAXINV.rdf XXVS_OPTIO_R_RAXINV_GEO.rdf XXVS_OPTIO_R_RAXINV_VIP_RETAIL.rdf PLSQL Code for VIP Invoices to send emails without attachment
attachment This is handled through a Setup Data Generation is handled by single RDF, different layouts are handled through RTF templates.
70
Setup Changes
Two new segments at Trx Type DFF level:
XML Template value of the XML Publisher Template used for
71
Setup Changes
XML Template / Attachment DFF at Trx Type
For existing Trx Types, XML Template and Attachment DFF fields updated through a Datafix Any new Trx Type created after Go-Live, BSA must enter appropriate values for these fields
72
In case of failure, can deliver notification to email address setup in XXVS_BURSTING_CONTROL_FILES valueset
Error Notification
73
Printer Issues
PDF files generated from BI Publisher do not print on some printers
raw PDF files generated by BI Publisher are not supported by some printers Metalink Note - 338990.1 explains how third party software can be used to convert PDF files into PS format before sending them to printers. Create Filter for PDFTOPS utitlity in xdodelivery.cfg file and place it under $XDO_TOP/resource directory PDF Documents would be automatically converted to PS format before sending them to printers
74
Printer Issues
CUPS Issues
Connection Timeout: Log file shows oracle.apps.xdo.delivery.DeliveryException: Connection timed out while waiting response from server. Change CUPS configuration - /etc/cups/cupsd.conf - Increase the value of MaxClients (controls the maximum number of simultaneous clients that will be handled ) and TimeOut (timeout before requests time out) Connection Reset: Log file shows java.net.SocketException: Connection reset at java.net.SocketOutputStream.socketWrite CUPS log file shows message E [25/May/2009:03:18:01 -0700] ReadClient() 8 IPP Read Error! Verify CUPS setup Upgrade it to latest CUPS version
75
Printer Issues
Large Batches take long time to Print
Bursting Engine sends one document to printer at a time. Printer will
take time to initialize for each document, buffer it and then finally print it.
Is there a way to send ONE big print-job to the printer? Answer is Yes, but involves customization - Step 1 : Use DocumentProcessor API, generate individual PDF files on filesystem.
- Step 2 : Use PDFDocMerger API to merge PDF files in single PDF file. - Step 3 : If the printer supports PDF format, send merged PDF file to Printer. Else convert the PDF file into PS/ PCL format before sending to printer.
76
RTR Implementation
correct report ordering for Multiple Report Sets correct processing for Spreadsheet/TabDelimited with Display Set correct print styles for reprint
and JA to open the report in Excel if the Format Type is chosen as Excel.
78
allows you to build your own custom reports without programming. Integrating FSG with XML Publisher allows you to use the convenient formatting features of a word processing application to design template layouts for FSG reports. Among the different report formatting options, you can change font characteristics, add graphical images, insert headers or footers, work with an unlimited number of columns, and reorder columns.
79
RTR Development/Migration Procedure (Continued) Generate XML Data Log into Apps with VS US GL POWERUSER Responsibility
Navigate to > Reports > Request > Financial and submit any one of the FSG report by selecting XML as Output Option. Continued
80
RTR Development/Migration Procedure (Continued) Query for the Request ID in the Requests Screen and save the XML Output to a location on your local machine.
Continued
81
RTR Development/Migration Procedure (Continued) Using the MS Word Template Builder Plug in, load the XML Data File by clicking on the Data button and selecting Load XML Data and selecting the xml file that you saved earlier. RTF Template Creation
Continued
82
RTR Development/Migration Procedure (Continued) To insert a table in the report you can use the Table Wizard or Table/Form.
83
RTR Development/Migration Procedure (Continued) To insert a field in the report use the menu: Insert > Field Now you can select a field and double-click it or drag it to the place in the report. Before you can preview the report you have to save the file as a RTFfile.
84
RTR Development/Migration Procedure (Continued) Test the RTF template by using the Preview functionality in the Template Builder plug-in. For a good preview on how to create XMLP Templates please refer the attached document.
XMLPTemplatesByE xample.doc
85
Debug files are generated depending on how the XML Publisher Core engine is invoked
One step publishing method: The Concurrent Request ends with Phase 'Completed' and Status 'Warning' which indicates that the Output Post Processor (OPP) failed to generate an output file.
In such cases the request log file shows a generic error message indicating the the post-processing action has failed:
Continued
86
Troubleshooting Oracle XML Publisher For The Oracle E-Business Suite (Continued)
The actual error returned by the XML Publisher Core engine is captured in the OPP log file. Following are the steps to open the OPP log file: - Login to the application - Responsibility: System Administrator - Function: Concurrent --> Manager --> Administer - Select the Output Post Processor - Click on the Processes button - Select the Concurrent Process which was active during the time that the request ran - Click on the Manager Log button to open the Output Post Processor log file
Continued
87
Troubleshooting Oracle XML Publisher For The Oracle E-Business Suite (Continued)
Continued
88
Troubleshooting Oracle XML Publisher For The Oracle E-Business Suite (Continued) Search for the Request ID in the OPP Log for the actual error message. The error message shows that the XML file generated had some special characters due to which the program has failed.
89
Troubleshooting Oracle XML Publisher For The Oracle E-Business Suite (Continued)
In case of the following error message in the Concurrent Program Log file follow the steps below to fix the issue.
Under System Administrator responsibility. Navigate to: Concurrent/Manager/Administer Select 'Output Post Processor' Click Refresh, the "Actual" and "Target" against the Output Post Processor should show "1 as shown in the screen shot below if not Click on Restart button to restart the process. Continued
Note: If the issue is not fixed even after restarting the process then the Concurent Manager needs to be bounced.
90
Troubleshooting Oracle XML Publisher For The Oracle E-Business Suite (Continued)
91
PTP Implementation
Timeline
Initiative Began in Summer of 2009 Purchasing Objects Converted before 2009 Year End Payables Objects Converted in 2010 ACH Remittance Check Printing Reporting Objects Converted on an Ad Hoc Basis
93
Benefits
Font Color Now Allowed Optio Technology No Longer Needed Multiple Patches Required to be Applied Attachments Inclusion Initially Picked Up Non-Related Attachments
Attachment ID Match Across Attachments Type
Development Issues
94
Scope
ACH Remittance PDF
Benefits
Error Reporting ACH Remittance Program Now Produces PDF Output File with Failed Records and Detail - Prior Process Required AP Review Rejected Emails to Shared Public Folder Single Reprocess Capability AP Now Has the Ability to Send Individual ACH Remittances Based on Error Report and Reprocess Needs Optio Technology No Longer Needed
Development Issues
Initial ACH Remittance Error Report Had Insufficient Detail
95
AP Physical Checks Ability to Save PDF File of All Checks Printed Check Font Stored on the Server
No Longer Required to Ask MIS OPS to Resend Check Font to Local Printers Upon Printer Reboot
Benefits
Optio Technology No Longer Needed DEV Team Does Not Have Access to Physical Printers
Output Differs Across Printers
Development Issues
DEV Team Does Not Have Actual Check Paper Wrapping Lines in the Check Caused Check Layout to Shift Font Issues Number of Invoices Continuing on Multiple Pages
Only One Actual Check Can Output
96
Benefits
Increased Configuration Capabilities via XML Publisher Administrator Report File Type Output Options to the Requestor
Development Issues
Layout Challenge from Existing Presentation Not Always a Straight Forward Mirror Conversion Option Oracle Patch Still Required for Proper XML Report Request Default
97
98
Translation Manager Configuration Manager Font Manager OA Framework Report Viewer Single Step Reporting Reduced processing time, memory footprint and temporary file space
Integration
Performance
99
BI Publisher Benefits
Reduce development and maintenance costs Consolidate reporting solutions Consolidate data sources Functional users build and customize layouts In-house printing and delivery now achievable Increase developer productivity
100
BI Publisher Benefits
Reduce reporting tool training requirements Faster report creation Improve performance Faster data extraction Fewer database hits Layout level formatting
101
102
103
104
Many thanks to voters on Oracle Mix for voting for this presentation on Suggest A Session contest
105
Q&A