Document 2131220.1 https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-sta...

Steps to Configure OBIEE 12c to Use Custom Style in Dashboards (Doc ID 2131220.1)

In this Document

Abstract
History
Details
References

APPLIES TO:

Business Intelligence Server Enterprise Edition - Version 12.2.1.0.0 and later

Information in this document applies to any platform.

ABSTRACT

This document lists the steps needed to make Dashboards use custom Style (like replacing oracle logo with custom logo, displaying
custom images, etc) in OBIEE 12c.

This document should be used as an addendum to the bookshelf documentation on Modifying the User Interface Styles for Presentation
Services

HISTORY

Document creation

DETAILS

Prerequisites :

1. Install OBIEE 12.2.1.0, then download and apply Patch 22140759 for your respective platform.

2. Use opatch lsinventory to confirm the patch is applied.

Post Apply Patch, you can see the details as:

Interim patches (7) :

Patch 22140759 : applied on Thu Apr 21 17:10:01 PDT 2016

Unique Patch ID: 20016066
Patch description: "One-off"
Created on 8 Apr 2016, 16:42:54 hrs PST8PDT
Bugs fixed:
22140759

Follow these steps to deploy bicustom.ear

Step 1 : Copy ORACLE_HOME/bi/bifoundation/jee/bicustom-template.ear to ORACLE_HOME/user_projects/domains/bi/bidata

/components/OBIPS/bicustom.ear:

Note : Documentation lists this step incorrectly - it states to copy bicustom.ear file to ORACLE_HOME/bi/bifoundation/jee. This is
incorrect - It should be copied over to ORACLE_HOME/user_projects/domains/bi/bidata/components/OBIPS which is the right
location for 12c.

The following documentation bug 23190546 is corrected and updated in the 12.2.1 and higher documentation

1 de 5 04/09/17 12:15
Document 2131220.1 https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-sta...

Step 2 : Make changes to the ear file as per your requirement - for example replace oracle_logo with your custom logo:

Extract the bicustom.war file from the bicustom.ear file.

Extract the files from the bicustom.war file.
Edit the files to create your custom style and save your changes. See Section 17.9.5, "Customizing Your Style" for additional
information. Note that By default, s_Custom extends s_Skyros, which is defined in the filemap.xml file. Please make sure to
update filemap.xml file with the Style folder name as per your environment. Default one is s_Custom.
Update the bicustom.war file with your changes.
Update the bicustom.ear file with your new bicustom.war file.

Note : the default folder name which has the files is s_Custom. This name can be changed to your requirement. In this example the
folder name used was s_SampleAppStyle

Step 3 : Delete existing bicustom.ear deployment if it exists:

-Go To Control, stop all the services and delete the existing bicustom.ear file.

Step 4 : Deploy the bicustom.ear file by selection of the 12C path => ORACLE_HOME/user_projects/domains/bi/bidata/components
/OBIPS:

-Click Lock & Edit.

-Click Install.

Step 5 : Select Install this deployment as an application:

Step 6 : Select bi_server1 as deployment targets:

2 de 5 04/09/17 12:15
Document 2131220.1 https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-sta...

Step 7 : Select the following 12C deployment accessible location:

Step 8 : Click Next and Finish.

Step 9 : Now restart all the services ./stop.sh (meaning re-start from WLS / bi_server1 / all component services).

Step 10 : Go to /console and start the services for deployed bicustom.ear:

Step 11 : After start bicustom should be in Active state.

Step 12 : Now login to the application , open any dashboard or create any dashboard , go to dashboard properties , click on Style , see
that the following SampleAppStyle appeared:

3 de 5 04/09/17 12:15
Document 2131220.1 https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-sta...

Step 13 : Check the dashboard to verify if you see the custom logo, changed banner color, etc.:

The above steps will apply the custom SampleAppStyle to a specific dashboard. If you wish to apply this Style across entire application
so the custom logo,etc are seen in landing page, home page, all dashboards, etc you need to change the DefaultStyle setting in
instanceconfig.xml file as follows:

After this change, restart the services and retest. Screenshot below shows landing page showing custom logo:

4 de 5 04/09/17 12:15
Document 2131220.1 https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-sta...

Note : In order for the custom styles to show up in BI Publisher , add the following line in
[Middleware Home]/user_projects/domains/bi/bidata/components/bipublisher/repository/Admin/Configuration/xmlp-server-config.xml

<property name="THEME_MASTER_CSS_URL" value="/custom/s_skyros/master/master.css"/>

Once xmlp-server-config.xml file is modified to reference the custom style, restart all services and retest.

The bicustom.ear file which has the SampleAppStyle used in this testing has been attached for reference.

REFERENCES

Didn't find what you are looking for?

5 de 5 04/09/17 12:15