You are on page 1of 74

11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

Share 0 More Next Blog»

Oracle BI Solutions
BI Apps (Online Support Available)

Friday, December 28, 2012 Se arch This Blog

Exploring Advanced Features of Oracle BI Publisher

Overview
BI Apps Ce rtifie d Spe cialis t
The Getting Started with Oracle BI Pub lisher OBE covered the regular features such as creating reports from various data sources, and also creating
templates by using BI Publisher Desktop in MS Word. Oracle BI Publisher can also create Master Detail Reports, create reports from multiple data
sources, burst the reports to a file location, and so on. This course provides step-by-step procedures to explore these advanced features of Oracle BI
Publisher.

Scenario

Please download the folder provided with this OBE : My Templates and Files. You will use these files in the examples.
Total Page vie ws
You will be using some of the reports that are similar to the ones you created in the OBE "Getting Started with Oracle Business Intelligence Publisher".
These reports are provided to you in the My Templates and Filesfolder.
It is recommended that you should have completed the OBE mentioned above, installed the required software, and performed the other setup tasks listed 3 9 5 0
in the "Prerequisites" topic. The assumption throughout this course is that you are familiar with the basic user interface and navigation of the Oracle BI
Publisher.

Prerequisites
About Me , I am Kis hore Uppalap
OBIA, BIPublis he r, Hype rion, Info
To complete this tutorial, you should:
Make sure Oracle BI EE 11g is installed

Have access to or have installed Oracle Database 11g with database sample schema, such as OE
Follow
Have access to the BISAMPLEschema that is included with the Sample Application for Oracle Business Intelligence Suite Enterprise Edition Plus.
There are three options for accessing the BISAMPLEschema: View my complete pro

1. If you have already installed version 825 or V107 of the Sample Application, verify that you have access to the BISAMPLEschema and begin the
tutorial.
2. If you are interested in downloading and installing the complete Sample Application, you can access it here on the Oracle Technical Network
(OTN). Please note, however, that only the BISAMPLEschema is required to complete this tutorial. If you want to install only the BISAMPLEschema, Oracle Bus ine s s Inte llige nce App
proceed to option 3.
3. Click here to access the ForOBE.7zfile, which has the 825 version of the BISAMPLEschema and installation instructions. Save ForOBE.7z, unzip, Home
and begin with README FIRST.txt.

Have "demo" and "BISAMPLE"data sources configured. This is covered in "Configuring the Data Sources" in the Getting Started with Oracle BI
Pub lisher OBE. Blog Archive
Create a Learnfolder under My Foldersif you don't have one.
► 2013 (630)
Create a BIPfolder in your local drive D. If the local drive is named differently, then take care while creating the bursting query. This folder is used to
deliver the report to burst to a file location. ▼ 2012 (163)

Download and unzip the file My Templates and Folders.zipavailable with this OBE.
▼ December (151)
Increase the Slider Limit in OBI
Software Requirements
Google Maps Based Backgrou
OBIEE11G
The following is a list of software requirements:
Oracle BI EE 11.1.5 or later must be installed. Master Detail Event in OBIEE 1
Pass multiple...
Oracle Database 11.x version must be installed.
Increase Java heap size for Or
Microsoft Office 2003 or later must be installed.
Builder

Creating a Master Detail Report (Creating Detailed Summary Reports) Parent Child Hierarchy in OBIE
Changing Presentation Service
In this topic, you will see a Oracle BI Publisher report having master-detail (parent-child) relationships between two data sets. The topic covers an example Number in OBIE...
that demonstrates creating a new report with the readily available Data Model, which has two data sets: Customers and Orders. This data link (parent-child
relationship) relates the results of multiple queries. This topic covers an example demonstrating the summarized details. This type of report is called a install a Loopback Adapter in W
Master Details report or Summary Details report. You will also use an existing boilerplate template that already includes the required layout grid
components (for example, Report Header/Footer, Name & Address sections, Chart & Table sections).
“INST-08058: A lookup of the a
You will create a new report with the existing Data Model, and use the boilerplate template.
this mach...
Creating a Master Detail Report Error Codes:
This example uses the Data Model Adv OBE - Order Entry.xdm. This topic will cover examining the data sets used by the Data Model, the parameters OPR4ONWY:U9IM8TAC,nQS
defined, and then creating a new report with a layout that is suitable for interactivity. You will create a Master Detail Report similar to the one shown below. 10058,nQS...
This screenshot is edited to show you a flowing view of the entire report. This report uses a Data Model that connects Customers and Orders data, and
OBIEE 11G Pointing to new BIP
links them together to get the detailed report.
and MDS Schem...
Nolog Found In OBIEE11g
Passing Hierarchy values to the
reports OBI...
invalid username/password; log
denied(nQSError: ...

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 1/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

Escape Special Characters in O


insertin...
unable to get file lock, will retry
11G
Conditional Navigation in OBIE
Server state changed to
FORCE_SHUTTING_DOWN
Changing Repository Password
11.1.1.6.6
Multiple Subject Areas in OBIEE
Reset Lost Weblogic Administr
and Passwor...
Database configuration on OBI
Mapviewer
nQSError: 43113 ;nQSError:13
start OPMN services in OBIEE
OBIEE 11G Act as Proxy user F
Step-By-...
OBIEE 11.1.1.6.0 New feature
Complete Funct...
OBIEE 11.1.1.6 New feature Op
Apply and Rese...
Variable Prompt in OBIEE 11G
OBIEE 11G Node Manager as
Service
oracle.xdo.XDOException: Una
saw sess...
11g open doubleclick and open
Repository...
Connection pool is not availabl
initialization...
How to get Month Start Date an
End Date
How to rename My Dashboard
In this example, you will: Event Pooling table (Event Tab
Examine the Data Model (Adv OBE - Order Entry) that is used to create the report the cac...
Create a Master Detail Report by using the Data Model Adv OBE - Order Entry Waterfall Chart in OBIEE11.1.1
Use the boilerplate template to provide flexible layout for the report Freeze Column headers in OBI
1 . Log in to the OBIEE (http://<host>:<port>/analytics) 11g(11.1.1.6.0)
Sub Folders/ Nesting Folders in
11G Answers
Fixing the BAD XML Instance Is
OBIEE 11g
Call HTML file from weblogic Ad
Default Header and Footer for
Report/Analysis in O...
SQL and PL/SQL Forum Discu
BI Publisher Forum
Oracle Bi Apps Forum Discuss
Oracle Bi Forum
PowerCenter - Installation and
Configuration (9.0....
Setting up the Oracle Warehou
Project
Oracle BI Publisher and BI Disc
Integration
Exploring Advanced Features o
Business Int...
Integration of Oracle BI Publish
Oracle Bus...
2 . Click New>>Report on the global header. Installing and Deploying Share
to Oracle...
Migrating an Essbase Applicati
Servers Us...
Migrating an Essbase Applicati
Servers Us...

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 2/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher
Establishing Multiple Instances
as Wind...
Setting Up Multiuser Developm
Environment (MUDE...
Creating and Modeling Aggreg
in OBIEE11g...
Merging/Importing Objects from
Repositor...
Creating Reports in Oracle E-B
Suite Using ...
Creating Corporate Workspace
Creating Hyperion Planning Us
Getting Started with Oracle Bus
Intelligence ...
Launching Smart View from an
Reporting...
Managing Images in the Resou
Manager with Objec...
Displaying Duplicate Member N
Oracle Hyperi...
Displaying Duplicate Member N
Oracle Essbas...
Sending Alerts Using Oracle Bu
Intelligence ...
Working with Oracle Business I
Applicat...
Harvesting Metadata in Hyperio
Documents
Replacing Data Models in Impa
Documents
Cloning and Synchronizing Ora
Requests and D...
Integrating BI Publisher 10.1.3.
Workspace...
Getting Started with Oracle BI P
11g
Creating Analyses and Dashbo
Oracle Business Intelligence Fo
Suite Over...
3 . The Choose Existing Data Model dialog box appears. Navigate to the directory My Folders\Learn, and Creating and Using Action Link
selectAdv OBE - Order Entry Data Model. (This Data Model is available in the My Templates and Actions
Filesfolder. You will need to upload this Data Model to the Learnfolder.)
Creating a BI Publisher Report
HTTP (XML/...
Creating a BI Publisher Report
External W...
Integrating Oracle BI Analyses
Microsoft Offi...
Creating and Developing Custo
Skins, and ...
Integrating Oracle Essbase 11.
Oracle Bu...
Creating a Repository Using th
11g Admi...
Upgrading Oracle Business Inte
from 10g to...
Merging and Importing Objects
Different Repos...
Setting Up a Multiuser Develop
Environment by ...
Click Open.
Exploring Advanced Features o
Publisher...
Creating RTF Templates by Us
4 . The report editor appears when the Adv OBE-Order Entry Data Model is chosen. Observe that the report is Publisher 11g T...
displayed as Untitled, because you are yet to save the report.
Creating Oracle BI EE 11.1.1.5
for Orac...
Federating Essbase and Relat
Oracle B...
Sending Alerts in Oracle BIEE 1

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 3/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher
Using Oracle ...
Getting Started with Oracle BI P
11.1.1.6....
Creating Analyses and Building
Dashboards
Setting Up Usage Tracking in O
11g
Building Maps for Oracle Busin
Intelligence Ana...
Oracle Scorecard and Strategy
Management In OBIEE1...

a. Click Save. Navigate to the Learnfolder and enter Advanced OBE Master Detail Reportin the Name text OBIEE 11.1.1.6 Variables
box. Create a Learnfolder if you don't have one.
Catalogues Unix Zip Command
OBIEE 11g Presentation Cache
Instanceconfig Tags
OBIEE 11G Multimedia Videos
Dashboards
OBIEE 11g Custom HTML And
Detailed Write Back steps in O
11.1.1.6.2
[OBIEE11g] [Error Codes: EY6
Row Limit Setti...
OBIEE 11g Prompt Settings
Changing Default Port Number
11g
OBIEE 11g performance Settin
To apply patch OBIEE 11.1.1.6
11.1.1.6.1
Updating Security GUIDs in OB
Evaluate Function OBIEE 11g E
Nqserror: 75005 Obiee 11g Bi
Error
b. Click Save. This will take you back to the report editor.
Removing Dashboard Links in
Company Logo on OBIEE 11G
OBIEE 11g Home Page Custom
OBIEE Clear Server Cache from
Database Requ...
Oracle BI11g Presentation Ser
Settings
Installing and Configuring BI Co
5 . In the report editor window, click Adv OBE - Order Entry Data Modelto examine the structure of the Data 11.1.1.6
Model, its data sets, and parameters. Take a closer look at each of the features of the Data Model to understand
BI Composer Instance Config S
the master-detail relationship/structure in the data. Also, examine the relationship between the parameters and
binding variables in the SQL queries and the cascading LOVs. This example will demonstrate these sections. Bash Profile for OBIEE 11g
OBIEE Direct Database Reque
OBIEE 11g Auto Start all With W
Services
OBIEE 11g File Locations
OBIEE 11g Generate Reposito
Documentation
OBIEE 11g Start and Stop com
UNIX/LINUX
OBIEE 11g Credential StoreTh
11g Credential...
OBIEE 11.1.1.6 Cant Import Me
Administration...
OBIEE 11G Moving RCU From
Database to Another ...
OBIEE 11.1.1.6.2 BP1 Child Pr
Folders in...
6 . In the Data Model editor, the Data Model is displayed with the defined data sets, list of values, and the OBIEE 11.1.1.6.5 Patch Set Av
parameters. You will take a closer look at each of these in the following steps. Observe that the Default Data
Source for the Data Model is demo. OBIEE 11.1.1.6 UI Customisatio
Note: If your data set is not set properly, (in this example it is demo), you might get an error while viewing the
report. Please refer to the Getting Started OBE to set the demo data source for JDBC. This is one of the
OBIEE 11g Criteria Tab instead
prerequisites for this OBE.
on Edit
OBIEE 10g to 11g Upgrade Pro

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 4/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher
How to generate Metadata dict
OBIEE 11g
BI Publisher Forms Toolbar Off
BI Publisher Config Settings An
Configuring Serve...
Oracle Data Warehouse
Data Warehouse cubes, dimen
Data warehouse concepts
Oracle Warehouse Builder (OW
components & archit...
Create an Oracle Warehouse B
(OWB) workspace...
Defining Source Data Structure
from a SQL ...
Defining Source Data Structure
from an Ora...
Import Source Data Structures
To OWB
(OWB) Install Oracle Warehous
11.2 on Win...
Deinstall Oracle DAC
Oracle DAC Installation
Uninstall Informatica PowerCen
(version ...
.
Informatica Server 8.6.1 Installa
Windows S...
Uninstall OBIEE 11g client
OBIEE 11g client Installation
Oracle 11g Installation on Wind
OBIEE11g RCU Installation
OBIEE architecture 11g
OBIEE 11g Installation on Linux
7 . Click Data Sets>>Orders to observe the defined XML data set, its structure, and the contents. The example Operating Sys...
shows the data set as Orders (SQL type).
OBIEE 11g Installtion On Linux

► November (12)

Labe ls

BI Publisher (19)

DAC (51)

DataWarehouse (4)

Hyperion (27)

Informatica (40)

OBIEE (501)

ODI (3)

Oracle Applications EBS 12.1.3

Oracle Database (14)

OWB (7)

PL/SQL (80)
If you place your curser over the link highlighted in the screenshot above, it will display the element link or join
between the two data sets Orders and Customers.
SQL (51)

Unix/Linux (2)

Trans late

Select Language
Pow ered by Translate

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 5/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher
Popular Pos ts

Creating RTF Templates by Using B


Template Builder for Word
Overview Template Builder is an exte
(2003 or later) that simplifies RTF te
Oracle BI Publisher repo...

OBIEE 11g Creating Analyses and B


11.1.1.6.2
Purpose In this tutorial, you will learn
format, and customize Oracle Busine
analyses and how to crea...
8 . The Element by Expression feature in the Data Model enables you to create complex elements in the report. In
this example, you can see that a "CITY, STATE, and ZIP" element is created by combining the data for City, State,
OBIEE 11g Custom HTM
and Zip. This feature will give more flexibility to your report. Dashboard Prompt Exp
a. In the Data Model editor, select the data set G_1. down values. Ammend
b. Select the CITY_STATE_ZIPelement and click the Actions menu. which is located in the
c. Select the Properties option to open the Expression Editor dialog box. Because this Data Model is a OracleBIData\Web\Con
predesigned one, you will examine the properties for an existing/available element.
OBIEE11g Integration w
configuration
OBIEE11g Integration w
configuration Hi ALL,
can work with many Aut
Providers....

OBIEE - Executing Stored Procedure


Reports – Before Report Triggers an
Temporary Tables
Basically the idea is to execute a sto
before running a report. This stored
basically populate the temp...

Hyperion Essbase Interview Question


Hyperion Essbase Interview Question
the two storage options available in E
are the differences? Ans...

[OBIEE11g] - Command Line Mergin


10g/11g
Problem How to do merge in OBIEE 1
Command Prompt. Solution i. Descr
helpful in OBIEE Merging using comm

[Informatica] -
initialization failed
This is an error caused
configuration of Integra
of Informatica9.0.1
If you are creating an element by expression, you will need to select the "Create Element by Expression" option
Center Reposit...
in the Actions menu for the data set. This will take you to the Add Element Editor dialog box for the selected data
set (in this example, G_1) window. OBIEE 11g Query Logging
To set the query logging level for a u
Oracle BI Administration Tool, select
Identity. The Security Manager di...

OBIEE 11g - supports 2


Vertical and Horizontal
1. Vertical Clustering 2.
Clustering Vertical Clus
server we can add mult
Server, Presenta...

Vis itors m ap

d. In the element editor, examine the relevant Name, Display Name, and Data Type. Observe that the following
Expression is stated:
CITY_STATE_ZIP = concat(concat(concat(G_1.CITY,', '), concat(G_1.STATE_PROVINCE,',
')),G_1.POSTAL_CODE

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 6/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

e. Click OK.
Similarly, you can use these Element by Expression features to combine various other data to create complex
data items in the report. You will see a few more examples of this in the following steps regarding order details.

9 . You can use the Data Model editor to aggregate data at the group or report level. Check the properties for the
element Line_TOTALin the Edit Properties window.

This aggregate function is also used to create CUST_TOTALin the Customers data set. This is done by
draggingLINE_TOTALfrom the Orders data set to the "Drop here for aggregate function" in the Customers data
set. Observe that the the item CUST_TOTALhas Summary as the function. The Expression is: LINE_TOTAL =
PRICE*QUANTITY.

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 7/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

Here are a few examples that illustrate the power and flexibility that the Data Model editor provides.

10 . Click List of Values. Observe the available orders-list and customer-list.

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 8/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

11 . a. Examine the parameters that are defined in the Data Model.

b. Click Return to get back to the report editor.


12 . In the report editor, select Customer Orders > boilerplate template. This will open the layout editor window with
the selected template.

Note: This template is provided to you in the My Templates and Filesfolder. Please upload this template to
your server as well. (File name: Boilerplates.xdoz)
To upload the boilerplate template:
Navigate to Catalog > Shared Folders > Components and click Upload under the More option.

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 9/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

In the Upload window, select the Boilerplates.xdoztemplate that is available to you in the My Templates
and Filesfolder.

Click Upload.
Observe that the uploaded template is displayed in the Shared Folders/Componentsfolder.

This template is available to you in the report editor window, when you have to choose or define a layout for your
report. In this example, the boilerplate template is Customer Orders.

13 . In the layout editor window, the report is displayed with the Customer Orders boilerplate template.
Select the Title grid, and change the title of the report to Customer Orders Summary Report.
Note: Highlight the existing text for the title in the template, and type over it. The title format is maintained.

14 . The template has a repeating section for Customer Name. This is to display orders for more than just one user
(i.e., to allow for All and to multi-select for the Customer Name parameter). The layout grid for Customer Name is
included in the repeating section so that the report can display the customer orders under each customer's
name.

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 10/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

Click Edit (the pencil icon) to select the element to group by in the repeating section. In this example, it
isCUSTOMER_NAME.

If you expand the repeating section, you will see that it contains the element CUSTOMER_NAME.
Click OK or Cancelto return to the layout editor.

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 11/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher
15 . Insert the other details for the customer as shown in the screenshot. Drag the data items from the data set
Customers in the left-side pane in this order.
STREET_ADDRESS

CITY_STATE_ZIP

COUNTRY_NAME

CUST_EMAIL

Observe that the Address section has a simplified field for CITY, STATE, and ZIP. This was created by adding the
element by expression in the Data Model as explained previously. Recall how the element by expression
forCITY_STATE_ZIPwas created and observe how it is useful in creating a report now.

16 . For the Order Details table, drag the data items from Data Source in the left-side pane in the order given below.
Order_ID

FRMTD_Order_Date

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 12/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher
Line_Item_ID

Product_Name

Quantity

Unit Price

Line_Total
Note: As explained previously in the "Data Model" section, the data Line_Totalis created as an element by
expression.

You can format the table display to suit your requirements. In this example, observe that the ORDER_IDdata is
grouped to the left of the column.

Also, observe that the Unit_Price column is defined with Currency format, using the Column > Data Formatting >
Currency option.

You can use either the column indicators to place the data properly inside the layout, or you can also use Table
Properties to set the column width.

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 13/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

17 . You can add a chart to the layout. This example uses the CUST_TOTALitem, which is based on
the Line_Totalsdata item.
Add the data element CUST_TOTALfrom the data source to the Chart table.

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 14/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

Use the Line Totaland Product_Namedata from the data source to create the chart.

18 . Name the layout Orders Summary. Click Save.

19 . Click Interactive Preview > Interactive to preview the layout.

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 15/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

20 . The report is displayed in the Interactive Viewer browser. Close the browser.

Save the layout and click Return to return to the report editor.

21 . In the report editor view, save the report and click View Report.

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 16/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

The report is displayed with the defined layout. The data is displayed based on the criteria you select in the report
view. In this example Alexander Dheeraj is chosen for Customer Name, and All for Order Numbers. The
screenshot is edited to display the wide and flowing screen view in one go.

This concludes the topic "Creating a Master Detail Report."

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 17/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

Creating Reports with Consistent Look and Feel Using Subtemplates

This topic will cover creating a subtemplate, uploading it to the server, and then using it to create a report with consistent look and feel.
In this topic you will learn how to create an RTF subtemplate, and how to use it to generate reports with a common look and feel. For example, add a
company logo to the header section of reports and other documents that you create using Oracle BI Publisher.
Creating an RTF Subtemplate
A subtemplate is a capsule of formatting functionality that is defined once and used multiple times within a single RTF layout template or across multiple
RTF layout template files. Subtemplates can be in either RTF or XSL file format. This topic covers creating a subtemplate in the RTF format.
In this example, you will create an RTF subtemplate, upload it to the Oracle BI Publisher server, and associate it with reports.
1 . Open a blank document in MS Word.

2 . Type (or copy and paste) <?template:Header?>in the body of the document.
Note: Header is the name of the code snippet (template) inside the subtemplate file. You can include multiple
template codes in the same subtemplate.

Press Enter.
3 . Insert the Oracle logo O_signature_clr.giflocated in My Templates and Files. You can use any GIF
image relevant to your company or company logo, too. Remember to copy the .giffile into this folder.
Press Enter.
4 . Enter My Employee Salary Report as the title and center the text. Format the title as you deem appropriate.
Press Enter.

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 18/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

5 . Type (or copy and paste) <?end template?>to close the Header template instructions.
The RTF file should look similar to this:

6 . Save the subtemplate as headerfooter.rtfin the Learnfolder.

7 . a. Type or copy and paste <?template:Footer?>in the body of the document.


Note: Footer is the name of the subtemplate. Consider copying and pasting this code into the template.

b. Type or copy and paste ****Confidential**** and center the text. Format the footer as you deem appropriate.
c. Insert a page number and right-justify the page number.
d. Type or copy and paste <?end template?>to close the Footer template instructions.
The RTF file should look similar to this:

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 19/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

e. Save the subtemplate again.


Next, you will have to upload the subtemplate to the BI Catalog.
8 . a. Log in to the OBIEE (http://<host>:<port>/analytics)
b. Click New > Sub Template from the global header.

9 . Click the ( ) icon.

Upload

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 20/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

10 . a. Select the subtemplate file headerfooter.rtfthat you just created. The example shows the file being
selected from the local folder.

b. Accept the default Template Type, and select English (United States) as the Locale.
c. Click OK.
11 . a. In the template editor window, click Save.

b. Navigate to \Shared Folders\Sample Lite\Published Reporting\Reportsand save your file


asHeader Footer Sub Templateto the Oracle BIEE Catalog. In this example, you are saving the subtemplate
in the same folder that will hold the report in which you will call the subtemplate. If you are saving the
subtemplates in a separate folder, then you must have access permissions between the folder containing the
reports and the one containing the subtemplates.

c. Click OK.

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 21/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

12 . Next, you will modify an existing RTF template (the main template) to call your subtemplate file.
Begin by opening the Manager Financials Report.rtf file. This file is available in the My Templates and
Filesfolder. This folder is made available to you along with the OBE.

13 . The report will look like this:

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 22/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

14 . a. You must have at least two entries to call your subtemplate. These entries are the import and call statements.
Just above the RTVcode field, press Enter twice.
b. On the first line, type or copy and paste <?import:xdoxsl:///Sample Lite/Published
Reporting/Reports/Header Footer Sub Template.xsb?>.
Header Footer Sub Templateis the name of the subtemplate on the Oracle BI Publisher server.

15 . a. Insert a blank header (Insert > Header > Blank).

b. Type or copy and paste the following code:


<?call:Header?>.

16 . Scroll down to the footer area. In the footer area, enter the following code:
<?call:Footer?>.

Close the header and footer.


17 . Save the RTF file as My Financials For Sub Template.rtf in your Learnfolder on your hard drive.

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 23/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

18 . Next, you will create a new report that uses this RTF template. In the OBIEE home, click New > Report.

19 . Select Salary Report Data Modeland click Open.

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 24/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

20 . Click Upload in the report editor. The Upload Template File dialog box appears.

21 . a. Enter My Main RTF in the Name text box.

b. Browse to locate the main template file My Financials For Sub Template.rtf.
c. Select RTF Templateas the Type and English (United States) as the Locale.
d. Click Upload.

22 . The template appears in the report editor. Click Save.

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 25/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

23 . Save the report as My Financials ST Rpt in \Shared Folders\Sample Lite\Publisher


Reporting\Reports.

24 . Click the View Report button.

25 . The report is displayed. This screenshot is altered to fit the contents of the flowing screen in one go.

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 26/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

Digitally Signing and Securing PDF Documents

In this topic, you learn how to add a digital signature and to password-protect PDF documents.
The following two topics are covered:
Configuring PDF security options for a report

Configuring a digital signature and signing PDF output reports

Configuring PDF Security Options


PDF security settings control security options for PDF documents and they can be set at the server level or at the report level.
Server-level PDF security settings apply to all PDF documents that you generate using Oracle BI Publisher.
In this example, you will set PDF security options for a specific report to be published. PDF security settings at the report level are configurable in the
Formatting tab of the Report Properties dialog box.
1 . Log in to the Oracle BIEE.

2 . Select the report that you created in the previous topic "Creating a Master Detail Report." Navigate through Catalog>>My Folders>>Learn>>Adv
OBE - Master Detail Report.
Click Edit.

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 27/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

3 . The selected report is displayed in the report editor. In this example, the report is Adv OBE - Master Detail Report. Click the Properties button.

4 . Select the Formatting tab in the Properties window. Examine the server value settings for PDF Output.
Observe that the values for PDF security are null. At run time, they default to the server value settings.

Click OK or Cancel to get back to the report editor window.

5.

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 28/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

Click the View Report link .

View the report in PDF format by choosing the PDF view as shown in the screenshot.

6 . Click Edit Report to return to the report editor page.

7 . Click the Properties button.

8 . In the Report Properties window, click the Formatting tab to modify the following PDF output settings:
a. Set the following properties to True.
Enable PDF Security

Disable document modification

Disable printing
b. Set a password for opening and modifying PDF output.

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 29/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

Click and click to save the modifications to the report properties.

c. OK Save
9 . Click the View Report button in the report editor window.
This time, Adobe Acrobat prompts you for a password before opening the PDF document. Provide the password that you set in the previous step.

10 . Examine the PDF document permissions. You can observe the security settings for the document by selecting Security Settings to the left of the
document. Verify that they match the PDF security settings that you selected in the previous steps.

Configuring a Digital Signature and Signing PDF Output


Prerequisite
Before completing this part, you must copy the digital ID file JohnSmith.pfx(included with the setup files provided for this OBE in My Templates and
Files) to a folder of your choice in the file system on the server. Oracle BI Publisher server must have access to the location to which you copy this file. In
this example, the file is available at My Templates and Fileson the D drive.
Introduction
Oracle BI Publisher supports digital signatures on Oracle BI Publisher reports delivered in PDF format. Oracle BI Publisher can access your digital ID file
from a central, secure location and, at run time, sign the PDF output with the digital ID.
Before you can implement digital signatures with Oracle BI Publisher reports, you need a digital ID obtained from a public certificate authority or from a
private/internal certificate authority. You must copy the digital ID file to a secure location of the file system on the server that is accessible by the Oracle BI
Publisher server.
In this example, you will learn how to configure Oracle BI Publisher server to use a digital ID file, and how to attach the digital signature to a PDF output

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 30/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher
when you schedule a report.
Registering the Digital ID in the Oracle BI Publisher Administration Page
1 . On the Administration page, under Security Center, click Digital Signature.

2 . a. Enter the path to the digital ID file in the Digital ID File text field. In this example, it is shown as / My Templates and Files/JohnSmith.pfx.
b. Enter oraclein the Password field.

3 . a. Enable the roles that will have the authority to sign documents with this digital ID. Use the shuttle buttons to move Available Roles to the Allowed
Roles list.

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 31/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

b. Click Apply.

4 . The confirmation message is displayed.

Enabling Digital Signature for a Report in Report Properties


After you register a digital ID file, you can use it to sign PDF output documents generated at run time when you schedule reports. The digital signature
verifies the signer's identity and ensures that the document has not been altered after it was signed.
You use the Formatting tab in the Report Properties dialog box to enable digital signatures for reports and to specify the position to place the digital
signature on the completed PDF document. All layouts assigned to the same report share the digital signature properties. This example uses an RTF
template.
1 . In the Catalog, navigate to the report My Folders/Learn/ Adv OBE - Master Detail Report. Click Edit to open the report for editing.

2 . Click Properties and then click the Formatting tab. Scroll to the PDF Digital Signature group of properties. Observe that there is no value set for the
digital signature location.

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 32/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

3 . a. Set the Enable Digital Signature value to True.


b. From the "Signature field location" drop-down menu, select Top Left.

c. Click OK.
4 . On the global header, click New>>Report Job.

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 33/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

5 . a. Select the edited report in the Learnfolder for scheduling.

b. In the Output tab, select the Layout as RTF, and the Output format as PDF. In this example the RTF layout name is Order Summary.

c. Schedule the report by selecting the Frequency as Once and the Run Now option.

d. Submit the job. Provide a name. In this example, the name of the job is Digital Sign. You will get a confirmation message after the successful
submission of the job.

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 34/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

6 . In the Catalog, navigate to My Folders > Learn, select Adv OBE - Master Detail Report. Expand the More menu, and select History.

This will open the Report Job History window with the submitted job name, Digital Sign. Click the report job Digital Sign.

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 35/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

7 . The Report Job Details window is displayed. Click Output1 under the Output and Delivery section. Recall that the output format you have chosen
while scheduling this report is PDF.

8 . The scheduled report in the PDF format is displayed with the newly applied digital signature John Smith.

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 36/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

This concludes the topic on digitally signing a report.

Bursting

Bursting is the process of splitting data into blocks, generating documents for each block, and delivering the documents to one or more destinations.
A single bursting definition provides the instructions for splitting the report data, generating the document, and delivering the output to its specified
destinations.
In this topic, you will learn how to use scheduler diagnostics to check connections, edit the Data Model for bursting a report to a file location, and view the
Job History for the scheduled report.
Reviewing the Scheduler Configuration:
In this subtopic, you will use Oracle BI Publisher's Administration page to review the scheduler configuration.
1 . a. Log in to Oracle BI Publisher and go to the Administration page.

b. On the Administration page, in the System Maintenance section, click Scheduler Configuration to examine the database connection.

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 37/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

2 . a. The Scheduler Configuration page appears. Examine the Database Connection area. It should show the JNDI connection by default.

b. Click Test Connection. A confirmation message appears if the database connection is successfully established.

3 . Click the Scheduler Diagnostics tab. Review the results. The Result area must show “passed” as indicated in the following screenshot.

Scheduling a Report to Burst to a File Location:


In this subtopic, you will edit the existing Data Model, associate it to the Salary report in the available database, and then schedule this report to burst to a
file location on your local hard drive, or the D drive as demonstrated in the example below.
Prerequisite:
You will need to create a folder under your local drive named BIP. This is the folder to which the reports will burst when you schedule the report to burst.

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 38/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher
1 . a. From the Catalog page, navigate to My Folders and select New > Folder.

b. Enter My Bursting Modelas the folder name and click Create.

2 . a. Select this new folder. In the Tasks pane, click Upload.

b. In the Upload dialog box, click Browse.

3 . Navigate to My Templates and Filesand open Salary Report Bursting Data Model.xdmz. This is a
prebuilt Data Model. Click Open.
The My Templates and Filesfolder is made available to you when you start working on the OBE. This is a
prerequisite.

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 39/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

4 . a. Click Upload.

b.The Data Model appears in your new folder.

c. Click Edit to edit the Data Model.

5 . a. The Data Model Editor is opened. Observe that "demo" is selected as the Default Data Source for the Data
Model. This is part of the data source configuration.

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 40/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

b. Click the Bursting node in the Data Model pane. This will open the Bursting pane.

Click the icon in the Bursting pane. The Bursting pane expands and provides an additional

c. add
definition area.

d. Enter the following information in the Bursting panes:

6 . a. In the SQL Query pane below the Query Builder button, copy and paste this code:
select
d.department_name KEY,
'SimpleRTF' TEMPLATE,
'RTF' TEMPLATE_FORMAT,
'en-US' LOCALE,
'PDF' OUTPUT_FORMAT,
'FILE' DEL_CHANNEL,
'D:\BIP' PARAMETER1,
d.department_name || '.pdf' PARAMETER2
from
departments d
b. Your output will be delivered to the folder specified in the bursting model. In this example, it is BIP. Notice that

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 41/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher
the code includes the name of the template (SimpleRTF). The Data Model should look like this:

Here is a brief description of the bursting definition used in the example:


Bursting definition is a component of the Data Model. After you have defined the data sets for the Data Model, you
can set up one or more bursting definitions. When you set up a bursting definition, you define the following:
The Split By element: It is an element from the data that will govern how the data is split. For example, to split
a batch of departments by each invoice, you may use an element called department_name. The data set
must be sorted or grouped by this element.

The Deliver By element: It is the element from the data that will govern how formatting and delivery options
are applied. In this example, it is likely that each department will have delivery criteria determined by
customer, therefore the Deliver By element may also be department_name.

The Delivery Query is a SQL query that you define for Oracle BI Publisher to construct the delivery XML data
file. The query must return the formatting and delivery details. It will also define the path to which the data will
be delivered. In this example it is D:\BIP.
Click to save the Data Model.

c. Save

7 . Click New > Report on the global header.

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 42/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

8 . Select Salary Report Bursting Data Modelfrom your new folder and click Open.

9 . The report editor window is opened. Click Upload.

10 . a. In the Upload Template File dialog box, enter SimpleRTF.


b. Click Browse. Navigate to the My Templates and Filesfolder, select SimpleRTF.rtf, and click Open.
c. Select RTF Template as the Type and English (United States) as the Locale. The dialog box should look like

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 43/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher
this:

d. Click Upload.

11 . a. Click Save and name the report "Salary Report for Bursting" in the My Bursting Modelfolder
underMy Folders.

b. The saved report with the name appears in the report editor window.

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 44/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

12 . a. Click the Properties button. The Report Properties dialog box appears.

b. In the General tab in the Advanced area, select the Enable Bursting check box and ensure that “Bursting 1” is
selected from the drop-down list.
c. Click OK.
Click in the report header.

d. Save

13 . Click New > Report Job to schedule this report with bursting as the output option.

14 . On the General tab, navigate to the My Bursting Model folder and select Salary Report for Bursting.

15 . On the Output tab, select the “Use Bursting Definition to Determine Output & Delivery Destination” check box to
enable bursting. Observe that the other options for output will be hidden when this check box is selected.

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 45/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

16 . On the Schedule tab, select Frequency to report as Once and the Run Now option.

17 . If the Notification tab is disabled in your instance, you don't have to define anything here.
Note: You will be able to use this option only if a delivery channel is set up in your environment. Without a mail
server set up, this option will be disabled. In this example, it is shown as user@localhost.com. You can enter the
email address configured to your mail server.

18 . a. Click Submit.

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 46/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

b. Name the scheduling job as Bursting2File in the Submit Job dialog box, and then click Submit.
19 . a. From the Catalog, select the Salary Report for Burstingreport. Click the Job History link.
The Report Job History for the recent schedule job Bursting2File is listed as successful.

b. Observe that your job has completed successfully. You can click Report Job to view the details.

Expand the Bursting2Filenode in the Output Name column. It will show all the document outputs and related
information like where they are delivered, split-by field, and so on.

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 47/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

20 . Navigate to the BIP folder and review the contents displaying the burst reports at the specified location. In this
example, it is the BIP folder that you have created as part of the prerequisite.

The steps above demonstrated the scheduling of a report to burst to a file location.

Translating Reports

Oracle BI Publisher supports two types of translations. They are:


Catalog translations: This enables you to extract the translatable strings from all objects contained in a selected Catalog folder
into a separate file; this file can then be translated and uploaded back to Oracle BI Publisher and assigned the appropriate language code.

Template translations: There are two methods for template translations.

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 48/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher
(1) A localized template - a separate template file (RTF, PDF, XPT, EXCEL, and so on) in the desired language
(2) An XLIFF file - a file in XML format that includes the translations in the target language of all the text strings included in the "Base" template

Translating reports by using an XLIFF file enables you to extract the translatable strings from a single RTF-based template (including subtemplates
and style templates) or a single Oracle BI Publisher layout template (.xptfile). Use this option when you need only the final report documents
translated. For example, you need to generate translated invoices to send to German and Japanese customers. When you extract the translatable
strings for a catalog or template translation, BI Publisher creates an XLIFF file that contains the strings. This topic covers examining the options for
translating the reports, and creating translation files by using Oracle BI Publisher Enterprise.

Translating by Using a Localized Template


While working on this topic, the assumption is that you already have an RTF file that is translated into French. This template "Balance Letter
French.rtf." is provided with the OBE as an attachment. You will use the Balance Letter.rtftemplate while working on this example. The example
begins with examining the report in the default English template (Balance Letter.rtf). Then you are going to add a French (localized) version of the
RTF template to this report to view the report in French.
1. Log in to Oracle BIEE. (URL: http://localhost:7002/analytics. The host could be different for your instance; please check and make sure you are
logging in to the Oracle BI EE). Use your credentials to log in.
.

2. Navigate to the Balance Letterlocated in \Shared Folders\Sample Lite\Published Reporting\Reports. Click Open.

3. Observe that the report is using the default English RTF template. Assume that you have a French customer to whom you need to send the report in
French only. For this, you need to upload a French RTF template, which can be applied on the same report.

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 49/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

4. Navigate to “My Templates and Files” and open Balance Letter French.rtf. Click OK.

Examine the RTF file. You would need to build this translation file yourself or send it to a third-party vendor for translation.

5. Get back to the Catalog window. Navigate to the Balance Letterlocated in \Shared Folders\Sample Lite\Published Reporting\Reports.
Click Edit.
6. The report editor appears. Click the Properties link for RTF Template (the basic Balance Letter).

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 50/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

7. The template manager window opens. In the Templates table, click the Upload icon.

8. The Upload Template File dialog box appears.

Browse to locate the localized translation file. Navigate to “My Templates and Files” and select Balance Letter French.rtf, and click Open.

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 51/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

9. After selecting the RTF file, select "rtf" as the Template Type and then select French (France) as the Locale.

Click OK.
10. The localized template appears in the Templates table.
You can keep the Default template set to English. You just need to change the Locale to French in the user preferences of the report. Oracle BI
Publisher automatically selects the appropriate template based on the user's locale. If one doesn't exist, then it uses the default (in this case,
English) template.

Click Save and then click Return.


11. On the Oracle BIEE home page, click My Account. The My Account dialog box appears.

12. Click the BI Publisher Preferences tab and change Report Locale to français - France.

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 52/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

Click OK and log out.


13. Log back in to the Oracle BIEE.(URL: http://localhost:7002/analytics)

On the Catalog page, navigate to the previously edited Balance Letter and click Open to run the report.

14. The report appears in your browser window. Observe that the letter content is translated into French. Close the browser window.

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 53/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

15. On the Oracle BIEE home page, change your BI Publisher Preferences back to English.
Click My Account and select the BI Publisher Preferences tab. Change the Locale back to English - United States from français - France.

Click OK.
16. When you run the report again, it will default to the English version.

This concludes the example of translating the report with a localized template.

Translating Reports by Using an XLIFF File


This example shows how to use an XLIFF (.xlf) file for translation. In this example, you will use an XLIFF file that can be used to translate the Balance

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 54/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher
Letter.rtfbase template file from English to German at run time. This file is located in the My Templates and Filesfolder.
XLIFF is the XML Localization Interchange File Format. It is the standard format used by localization providers. When you extract the translatable strings for
a catalog or template translation, Oracle BI Publisher creates an XLIFF file that contains the strings. You can translate these strings or send the file to a
localization provider. You then upload the translated XLIFF file back to the catalog or the individual layout and assign it the appropriate locale.
1. Log in to Oracle BIEE.
Navigate to the Balance Letter located in \Shared Folders\Sample Lite\Published Reporting\Reports. Click Open.

2. The report is displayed. Select the default RTF template.

3. The template editor window displays the Translations table. In the Translations table, click Upload.

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 55/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

4. The Upload Template File dialog box appears. Browse to locate the translation file. Navigate to My Templates and Files, and open Translation
German.xlf.
Select German (Germany) as the Locale.

Click OK.

5. The translation file appears in the Translations table.

6. Click Save and then click Return.

7. a. On the Oracle BIEE home page, click My Account. The My Account dialog box is displayed.

b. Click the BI Publisher Preferences tab and change Report Locale to Deutsch - Deutschland.
c. Click OK.

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 56/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

8. From the Catalog page, navigate to your Balance Letter and click Open to run the report.

9. The report appears in your browser window. Observe that the content is translated into German.

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 57/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

10. Navigate to My Account.


Change the BI Publisher Report Locale back to English - United States.

Click OK.

11. Verify once again that your default language is English by running the Balance Letter report again.

This concludes the example of translating a report with an XLIFF template.

Creating a Data Model with Multiple Data Sets

Oracle BI Publisher enables you to create a report from multiple data sources. This feature is very useful because you can pull the data into a single report
based on multiple data sources. This topic will demonstrate how to create a Data Model with three to four data sets, and use them all to create a
meaningful report.
In the Data Model editor, you combine data from multiple data sets from different data sources, such as SQL, Excel files, Web services, HTTP feeds, and
other applications into a single XML data structure. Data sets can either be unrelated, or a relationship can be established between them using a data link.
In this example, the Data Model is created with four data sets, in which three are SQL data sets, and one is an XLS file.
Creating a Data Model with Multiple Data Sets
1 . Log in to the Oracle BIEE.
Note: The assumption is that you have installed the BISAMPLEschema from Sample Sales as mentioned in the "Prerequisites" section. Make
sure BISAMPLEis set as a Data Source in the Oracle BI Publisher Administration Page.

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 58/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

2 . On the global header, click New, and then click Data Model.

3 . The Data Model Editor is displayed with the Components pane on the left and Work pane on the right. Selecting a component in the left pane will
launch the appropriate fields for the component in the Work area. By default, when you open a data model in the editing mode, it displays the
properties for the data model. Set the properties for this newly created data model now.

4 . Set the properties as given below:


Description: Multiple Data Sets

Default Data Source: Select the BISAMPLEdata source from the list.

XML Output Options: These options define characteristics of the XML data structure. Select the "Include Parameter Tags" option when you want
to use the parameter value in the report.

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 59/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher
XML Tag Display: Upper Case

5 . Click in the data model editor. The Save As dialog box is displayed.

Save

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 60/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

In the Save As dialog box, navigate to the Learnfolder under My Foldersand save it with the name Multiple Foundation Data.
Now, add data sets to this data model.
6 . In the Components pane of the data model editor, click Data Sets.
a. Click New Data Set.

b. Select the data set type from the list to launch the appropriate dialog box. In this example, select SQL Query.

The Create Data Set - SQL dialog box appears.

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 61/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

7 . a. Enter the name for this data set as Q1- BI Server.


b. Select and change the Data Source from the list of values to Oracle BI EE.

c. Click the Query Builder button. The Query Builder window is displayed. The Query Builder has two panes.
They are the Object Selection pane and the Design and Output pane.
The Object Selection pane contains a list of objects from which you can build queries.
Only objects in the current data are displayed. Observe that this example displays Sample Sales Lite objects.

You will need to select the appropriate objects from the Object Selection pane in the left side of the Query Builder.

8 . a. Select the following objects from Sample Sales Lite. The selected objects appear in the Design and Output pane.
Offices

Orders

Base Facts

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 62/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

b. Select the following data items in the displayed objects under the Model tab.
From the Offices object, select the columns Office, Department, Organization, and Company.

From the Orders object, select the columns Order Number and Order Status.

From the Base Facts object, select the columns Revenue, Billed Quantity, Target Revenue, and Target Quantity.
c. Click the Save button in the Query Builder. This will bring you back to the data set editor. Observe that the data selection is listed as SQL Query.

d. Click OK. This will save the data set. The data diagram is displayed for the newly created data set Q1-BI Server as G_1.

9 . a. Click New Data Set to create another data set.

b. Select the data set type from the list to launch the appropriate dialog box. In this example, select SQL Query. The Create Data Set - SQL dialog box
appears.

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 63/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher
c. Enter a name for this data set as Q2-TransDB. Observe that the Data Source for this data set will remain set to the default, BISAMPLE.

d. Click the Query Builder button. The Query Builder window is displayed. Observe that the displayed data tables belong to BISAMPLEdata.

10 . a. Select the following tables from the BISAMPLEdata to get them to the Design and Output pane.
SAMP_PRODUCTS_D

SAMP_REVENUE_F

SAMP_OFFICES_D

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 64/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

b. You can create relationships between these objects by creating a join. A join identifies a relationship between two or more tables. In this example,
you will create joins between the above three objects. You create a join by selecting the Join column adjacent to the column name for the selected
object. The Join column appears to the right of the data type. Create the joins by selecting the following columns:
SAMPL_PRODUCTS_D. PROD_KEY= SAMP_REVENUE_F.PROD_KEY

SAMP_REVENUE_F.OFFICE_KEY=SAMP_OFFICES_D.OFFICE_KEY

c. Select the following columns in these joined objects.


From the SAMP_PRODUCTS_D object, select PROD_DSC, TYPE, LOB, and BRAND.

From the SAMP_REVENUE_F object, select ORDER_NUMBER, REVENUE, UNITS, DISCNT_RATE, ORDER_STATUS, and CURRENCY.

From the SAMP_OFFICES_D object, select COMPANY, ORGANIZATION, DEPARTMENT, and OFFICE_DISC.

d. Click the Save button. This will bring you back to the data set editor. Observe that the selected objects appear in the query.

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 65/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

e. Click OK. This will save the data set. The data diagram is displayed for the newly created data set Q2-TransDB as G_2.

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 66/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

11 . a. Click New Data Set to create another data set.

b. Select SQL Query. The Create Data Set - SQL dialog box appears.
c. Enter the name for this data set as Q3-Actual Sales.
d. The data source for this data set is the same as the Q2 - the default data source BISAMPLE.

12 . a. Enter the SQL query exactly as given below:

select "SAMP_REVENUE_F"."OFFICE_KEY" as "OFFICE_KEY",


"SAMP_REVENUE_F"."PROD_KEY" as "PROD_KEY",
"SAMP_REVENUE_F"."BILL_MTH_KEY" as "BILL_MTH_KEY",
"SAMP_REVENUE_F"."BILL_QTR_KEY" as "BILL_QTR_KEY",
"SAMP_REVENUE_F"."CURRENCY" as "CURRENCY",
sum("SAMP_REVENUE_F"."REVENUE") as "REVENUE",
sum("SAMP_REVENUE_F"."UNITS") as "UNITS",
"SAMP_PRODUCTS_D"."PROD_DSC" as "PROD_DSC",
"SAMP_OFFICES_D"."OFFICE_DSC" as "OFFICE_DSC"
from "BISAMPLE"."SAMP_OFFICES_D" "SAMP_OFFICES_D",
"BISAMPLE"."SAMP_PRODUCTS_D" "SAMP_PRODUCTS_D",
"BISAMPLE"."SAMP_REVENUE_F" "SAMP_REVENUE_F"
where "SAMP_PRODUCTS_D"."PROD_KEY"="SAMP_REVENUE_F"."PROD_KEY"
and "SAMP_OFFICES_D"."OFFICE_KEY"="SAMP_REVENUE_F"."OFFICE_KEY"
group by "SAMP_REVENUE_F"."OFFICE_KEY", "SAMP_REVENUE_F"."PROD_KEY", "SAMP_REVENUE_F"."BILL_MTH_KEY",
"SAMP_REVENUE_F"."BILL_QTR_KEY", "SAMP_REVENUE_F"."CURRENCY", "SAMP_PRODUCTS_D"."PROD_DSC",
"SAMP_OFFICES_D"."OFFICE_DSC"

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 67/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

b. Click OK. The query is processed and a data diagram is displayed for this data set as G_3.

13 . a. Click New Data Set to create a data set from the local Microsoft Excel file.
b. Select the data set type from the list to launch the appropriate dialog. In this example select Microsoft EXCEL File. The Create Data Set - Excel
dialog box appears.

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 68/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

14 . a. Enter a name for this data set as Q4-Target Sales.


b. You will have to select the Data Source where the Excel file resides. In this example, the data resides in a local MS Excel file.

15 . a. You will have to select the option Local to enable the Upload button.
Click the icon .

Upload
b. Browse the file SAMP_TARGETS_BIPDEMO.xls, and then click Upload. This file is available to you in the My Templates and Files folder.

16 . If the Excel file contains multiple sheets or tables, you will have to select the appropriate Sheet Name or Table Name for this data set. In this example,
the Excel file has multiple sheets, and the appropriate sheet name chosen is MNTH_TARGET_SALES.

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 69/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

17 . Click OK. This data set is also added in the Properties pane.

Save the data model.

18 . Link the data sets to define a master-detail (or parent-child) relationship between two data sets. Defining an element-level link enables you to
establish the binding between the elements of the master and detail data sets. You will need to define the individual data links now.
Select the data to be linked, and then click the icon ( ) in the element action menu. In this example, it is OFFICE from the data set G_1.
a. Expand

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 70/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

b. Select the Create Link action.

19 . a. The Create Link window is displayed with the available data for linking.

For this example, select OFFICE_DSC from the data set G_2.
b. Click OK.

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 71/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

20 . A link between OFFICE and OFFICE_DSC for the two data sets G_1 and G_2 is created.

21 . Similarly, you can create links for other data sets to suit your requirements.

This example has the following element-level links between the data sets G_3 and G_4.
G3.Office_Key=G4.Office_key_1

G3.Prod_key=G4.Prod_key_1

G3.Bill_MTH_Key=G4.Bill_MTH_Key_1

22 . Save the data model.

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 72/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

23 . Now you are ready to run the XML output for this data model. Click the XML icon in the global header.

24 . Choose the appropriate number of rows for the display. In this example, it is "five."

Click Run.
25 . You can see the generated XML output.
This concludes the example on creating multiple data sets.

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 73/74
11/14/13 Oracle BI Solutions: Exploring Advanced Features of Oracle BI Publisher

Summary

In this tutorial, you have learned how to:


Create a Master Detail Report

Use subtemplates

Configure advanced security options such as PDF security and digital signatures for reports

Schedule and burst a report to a file location

Translate reports

Create a data model with multiple data sets

Posted by Kishore Uppalapati at 12:28 AM Recommend this on Google

Labels: BI Publisher

Newer Post Home Older Post

Oracle Business Intelligence. Awesome Inc. template. Powered by Blogger.

oraclebisolutions.blogspot.com/2012/12/exploring-advanced-features-of-oracle.html 74/74