Oracle Business Intelligence Publisher (BI Publisher) is a strategic enterprise reporting product that provides the ability to create and manage highly formatted reports from a wide range of data sources. You can design the layout of your BI Publisher reports using Microsoft Word or Adobe Acrobat then create the reports from different types of data sources.
Oracle Enterprise Manager Cloud Control is integrated with BI Publisher. Oracle recommends using BI Publisher to create reports for Enterprise Manager Cloud Control 12c and later. BI Publisher includes the Data Model Editor, which is a graphical user interface for building data models within the BI Publisher interface, and the Layout Editor, which is a design tool that enables you to create report layouts within BI Publisher.
This chapter includes the following topics:
Before you start to develop a BI Publisher report, you should take advantage of the training and reference resources available from Oracle:
Getting Started with Oracle BI Publisher 11g
https://apex.oracle.com/pls/apex/f?p=44785:24:0::NO:24:P24_CONTENT_ID,P24_PREV_PAGE:5081,29
Oracle BI Publisher on Oracle Technology Network (OTN)
http://www.oracle.com/technetwork/middleware/bi-publisher/overview/index.html
Oracle BI Publisher blog
http://blogs.oracle.com/xmlpublisher/
Oracle BI Publishing Consulting blog
http://bipconsulting.blogspot.com/
The EMREPOS data source is available from the BI Publisher server configured for use with Enterprise Manager reports. The EMREPOS data source connects to the MGMT_VIEW account in the Management Repository and establishes the proper security context (VPD) for the Enterprise Manager user logged on to BI Publisher.
As a security measure, BI Publisher reports that use the EMREPOS data source have read-only access to the public MGMT$VIEW and GC$ views, and not to the underlying Enterprise Manager tables. This model also supports sharing report queries with Enterprise Manager users who might want to use the Enterprise Manager-provided reports as a basis for their own reports.
By default the reports and data models in the Enterprise Manager Cloud Control folder are read only. Develop your own reports in your local folders and then have a BI Publisher system administrator put the finished reports in a shared folder, outside of the Enterprise Manager Cloud Control folder.
To develop a BI Publisher report:
To deploy BI Publisher reports from a plug-in to a BI Publisher web application:
Create a metadata file that adheres to the following schema:
emcore/source/oracle/sysman/emSDK/ip/bipublisherreport/BIPublisherReport.xsd
The following is an example of a report metadata file:
<?xml version = '1.0' encoding = 'UTF-8' ?> <BIPublisherReports xmlns="http://www.example.com/DataCenter/BIPublisherReport"> <ReportFile relativePath="emreports" fileName="tvmlrb104a.jar"/> <ReportFile relativePath="emreports" fileName="tvmlrb104b.jar"/> </BIPublisherReports>
Stage the BI Publisher reports, which are ZIP files with the extension .xdoz (report definition) or .xdmz (report data model, that is, SQL) into one or more JAR files. These files are referenced in the previous metadata file.
The $ORACLE_HOME/sysman/jlib/emreports.jar
file provides an example.
$ unzip -l emreports.jar Archive: emreports.jar Label: EMGC_MAIN_LINUX_110220 Length Date Time Name --------- ---------- ----- ---- 0 02-20-2011 23:08 META-INF/ 71 02-20-2011 23:08 META-INF/MANIFEST.MF 0 02-20-2011 23:08 bipublisherreports/ 0 02-20-2011 23:08 bipublisherreports/EM Datamodels/ 4776 02-20-2011 23:08 bipublisherreports/EM Datamodels/Usage Trend Report.xdmz 4854 02-20-2011 23:08 bipublisherreports/EM Datamodels/Usage Summary Report.xdmz 5008 02-20-2011 23:08 bipublisherreports/EM Datamodels/Charge Trend Report.xdmz 7344 02-20-2011 23:08 bipublisherreports/EM Datamodels/Consolidation Reports.xdmz 5043 02-20-2011 23:08 bipublisherreports/EM Datamodels/Charge Summary Report.xdmz 0 02-20-2011 23:08 bipublisherreports/Chargeback/ 52291 02-20-2011 23:08 bipublisherreports/Chargeback/Charge Trend Report.xdoz 66994 02-20-2011 23:08 bipublisherreports/Chargeback/Charge Summary Report.xdoz 26505 02-20-2011 23:08 bipublisherreports/Chargeback/Usage Trend Report.xdoz 112150 02-20-2011 23:08 bipublisherreports/Chargeback/Usage Summary Report.xdoz 0 02-20-2011 23:08 bipublisherreports/Consolidation Planner/ 50114 02-20-2011 23:08 bipublisherreports/Consolidation Planner/Consolidation Reports.xdoz --------- ------- 335150 16 files
Create your plug-in JAR files.
The first directory in each JAR file must be bipublisherreports
. All of the data models for the reports must be in the same subdirectory, EM_Datamodels
, just under the bipublisherreports
directory. For example:
The plug-in, which contains all of the metadata files and BI Publisher report JAR files is installed dynamically (for metadata Plug-ins) using the plug-in environment.
The BI Publisher report JAR files are placed in a subdirectory of the metadata/bipublisherreport
directory and referenced in the metadata file (emreports).
The BI Publisher reports for both platform and plug-ins are deployed to a BI Publisher web application (either at plug-in installation time or sometime later when BI Publisher is installed).
Plug-in reports are deployed when BI Publisher is integrated with Enterprise Manager using the configureBIP script or sometime later using one of the following EMCLI verbs:
* emcli setup_bipublisher
(see Help for usage details)
* emcli deploy_bipublisher_reports[-force]
This last verb deploys the EM System reports (and optionally Extensibility Development Kit plug-in loaded reports) to a previously setup EM to BI Publisher relationship (using setup_bipublisher). It can also be used to upload a reports JAR file (located on the Oracle Management Server (OMS) filesystem). The operation will not overwrite existing BI Publisher reports in the EM Reports folder unless -force
is used in the command.
The following options are available:
For example, the syntax for the emct plug-in is:
emcli deploy_bipublisher_reports -pluginid=oracle.sysman.emct -pluginversion=12.1.0.0.0
Note:
Do not use overlapping folders from different JAR files and PLATFORM JAR files. Doing this causes reports from the different JAR files to be placed in the same BI Publisher folder. If the same report name is referenced in multiple JAR files, there is no way of knowing which one will be deployed last.