8 Using BI Publisher for Custom Reports
The ability to utilize Oracle Business Intelligence Publisher (BI Publisher) for custom reports is available as part of your Merchandising suite service subscription and is the only option available for creating custom reports against the live production database. Other reporting tools can be used, but must be based on other data sources, such as the replicated data in the Retail Data Store (RDS) or the Data Access Schema (DAS).
Accessing BI Publisher
In a SaaS implementation, you will access BI Publisher using a URL like this, where the hostname is replaced with that which is relevant for your implementation:
https://<hostname>/<tenantname>/xmlpserver
In order to create reports, you will need to ensure you have the below privileges assigned to your user ID through IDCS:
-
<tenantId>-BIConsumer
-
<tenantId>-BIContentAuthor
-
<tenantId>-DVConsumer
-
<tenantId>-DVContentAuthor
Creating a BI Publisher Report
BI Publisher supports creating a number of different types of reports, including reports with charts, table-based report, and so on. For details on how to create reports in BI Publisher, see the Oracle Fusion Middleware Report Designer's Guide for Oracle Business Intelligence Publisher, especially Chapter 2 on creating and editing reports.
As you build your reports consider the input parameters that are available based on where the report will be displayed. Details on the available parameters for dashboards and contextual reports for each of the Merchandising solutions are available in the appendix.
Note:
Custom reports in a user's My Folder will not be backed up by Oracle but could be manually backed up by the user. Otherwise, all custom reports should be saved in the Shared Folders/Custom
folder to ensure that they are included in the backup/restoration processes.
Displaying a BI Publisher Report
Once you have created your report you'll need to identify the URL for the report. The basic URL structure will be:
http://<hostname>/<tenantname>/xmlpserver/<ReportDirectory>/<ReportName>.xdo
-
hostname
andtenantname
- will be the hostname and tenant ID for your Merchandising BI Publisher implementation -
xmlpserver
- this is a static string -
ReportDirectory
- folder path to the report -
ReportName.xdo
- the filename you gave the report; if the name has spaces, then use a + between words
You may also specify some BI Publisher formatting parameters for your report. The full list can be found in chapter 2 (Creating and Editing Reports) of the Oracle Fusion Middleware Report Designer's Guide for Oracle Business Intelligence Publisher in the section titled Specifying Parameters in the URL. But, some key ones you may consider to give your reports a similar look and feel to the Merchandising reports are:
-
_xmode
- it's recommended that you set this to 4, which hides the BI Publisher specific banners and parameters - especially for contextual reports -
_xpt
- this should be set to 1 so that the report doesn't launch a new window
Here's an example of the basic URL with some parameters specified, including the order number parameter, which is an input for this report:
https://<hostname>/<tenantname>/xmlpserver/~demouser/Custom/ORDER_CFAS.xdo?_xmode=4&_xf=html&_xpt=1&OrderNo=<Order>
Configuration in Merchandising
Use this URL to configure the report into an existing dashboard or contextual pane as described in the "Dashboards and Reports" section.