Professional Documents
Culture Documents
Copyright © 2017, Oracle and/or its affiliates. All rights reserved. Oracle and Java are registered trademarks of Oracle and/or its affiliates.
Copyright Other and/or
© 2017, Oracle names its
may be trademarks
affiliates. All rightsofreserved.
their respective
| owners.
Proactive Resources for Training, Tools and Social Channels
Get Proactive
Social Channels
Stay informed via:
Oracle Support MOS How To Product Advisor Oracle Support Get Proactive MOS Community here
Essentials Video Series Webcasts Accreditation Portfolio Blogs here
Doc 553747.1 Doc 603505.1 Doc 740966.1 Doc 1583898.1 Doc 432.1 Twitter here
Self-paced
Session playback
Live, interactive
High-level (concepts)
Learning is ongoing. Select and use learning options to meet your needs.
Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal 3
Safe Harbor Statement
The following is intended to outline our general product direction. It is intended for
information purposes only, and may not be incorporated into any contract. It is not a
commitment to deliver any material, code, or functionality, and should not be relied upon
in making purchasing decisions. The development, release, and timing of any features or
functionality described for Oracle’s products remains at the sole discretion of Oracle.
Deploy a customization
1 Customizations
2 Methods to deploy
3 What to customize
4 Demonstration
5 Q&A
1 Customizations
2 Methods to deploy
3 What to customize
4 Demonstration
5 Q&A
Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal 8
Customizations
• User Interface is generated by scripts/CSS
• Documented on the System Administrator’s Guide, Chapter 17
Customizing the Oracle BI Web User Interface
• Skin & style
• ORACLE_HOME/bi/bifoundation/jee/bicustom-template.ear
• Doc ID 2262460.1 (OBIEE 12c: How To Create a New Customization Based
on the Alta Skin?)
Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal 9
Program Agenda
1 Customizations
2 Methods to deploy
3 What to customize
4 Demonstration
5 Q&A
Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal 10
Methods
• bicustom.ear
• Shared Folders (/analyticsRes)
• Never modify the files under the deployment directories
(<DOMAIN_HOME>/servers/bi_server1/tmp/_WL_user/analytics/<hash>/
war/res)
Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal 11
Methods
• Extract bicustom.war from bicustom-template.ear
• Extract the files from bicustom.war
• Edit the files
Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal 12
Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal 13
Methods
• Approach 1: Deploy using bicustom.ear
– Pack the bicustom.war file
– Pack the bicustom.ear file
– Copy the bicustom.ear file to SDD/components/OBIPS
– Deploy the bicustom.ear file using the WLS Administration Console
– Modify the OBIPS component configuration (instanceconfig.xml)
– Restart the OBIPS component
Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal 14
Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal 15
Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal 16
Methods
• Approach 1: Deploy using bicustom.ear
– Pack the bicustom.war file
– Pack the bicustom.ear file
– Copy the bicustom.ear file to SDD/components/OBIPS
– Deploy the bicustom.ear file using the WLS Administration Console
– Modify the OBIPS component configuration (instanceconfig.xml)
– Restart the OBIPS component
Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal 17
Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal 18
Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal 19
Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal 20
Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal 21
Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal 22
Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal 23
Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal 24
Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal 25
Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal 26
Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal 27
Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal 28
Methods
• Approach 1: Deploy using bicustom.ear
– Pack the bicustom.war file
– Pack the bicustom.ear file
– Copy the bicustom.ear file to SDD/components/OBIPS
– Deploy the bicustom.ear file using the WLS Administration Console
– Modify the OBIPS component configuration (instanceconfig.xml)
– Restart the OBIPS component
Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal 29
Methods
instanceconfig.xml
<UI>
<DefaultSkin>your_custom_name</DefaultSkin>
<DefaultStyle>your_custom_name</DefaultStyle>
</UI>
Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal 30
Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal 32
Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal 33
Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal 34
Methods
• Approach 2: Deploy using shared folders
– Deploy the folder as an application using the WLS Administration Console
– Modify the OBIPS component configuration (instanceconfig.xml)
– Restart the OBIPS component
Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal 35
Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal 36
Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal 37
Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal 38
Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal 39
Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal 40
Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal 41
Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal 42
Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal 43
Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal 44
Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal 45
Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal 46
Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal 47
Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal 48
Methods
• Approach 2: Deploy using shared folders
– Deploy the folder as an application using the WLS Administration Console
– Modify the OBIPS component configuration (instanceconfig.xml)
– Restart the OBIPS component
Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal 49
Methods
instanceconfig.xml
<UI>
<DefaultSkin>your_custom_name</DefaultSkin>
<DefaultStyle>your_custom_name</DefaultStyle>
</UI>
<URL>
<CustomerResourcePhysicalPath>your_custom_path</CustomerResourcePhysicalPath>
<CustomerResourceVirtualPath>/analyticsRes/res</CustomerResourceVirtualPath>
</URL>
Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal 50
Methods
• Approach 2: Deploy using shared folders
– Deploy the folder as an application using the WLS Administration Console
– Modify the OBIPS component configuration (instanceconfig.xml)
– Restart the OBIPS component
Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal 51
Program Agenda
1 Customizations
2 Methods to deploy
3 What to customize
4 Demonstration
5 Q&A
Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal 52
Files and folder names
• ./res/filemap.xml
• ./res/s_your_name
• ./res/s_your_name/master/
• ./res/s_your_name/master/master.css
• ./res/s_your_name/master/graph.xml
• ./res/s_your_name/master/custom.css
• ./res/s_your_name/master/*.png & ./res/s_your_name/master/*.gif
Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal 53
./res/filemap.xml
<FileMap>
<!-- The style name should exactly match the name of the folder, including case -->
<Styles Default="s_blafp">
<Hierarchy>s_Skyros / s_Demo</Hierarchy>
<Hierarchy>s_Alta / s_DemoAlta</Hierarchy>
</Styles>
<!-- The style name should exactly match the name of the folder, including case-->
<Skins Default="sk_blafp">
<Hierarchy>sk_Skyros / sk_Demo</Hierarchy>
<Hierarchy>sk_Alta / sk_DemoAlta</Hierarchy>
</Skins>
</FileMap>
Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal 54
./res/s_your_name/master/master.css
/* GENERIC STYLES: BODY, LINKS, HEADINGS ======================================================== */
/* This class applies to all pages and is inherited by all elements on the page. */
body.masterOBIEE
{
font-family: Tahoma, Arial, Helvetica, sans-serif;
font-size: 11px;
color: #000000;
border: 0px none;
margin: 0px;
padding: 0px;
}
…
/* This class applies to hypertext links when the mouse is hovering over them. */
.masterOBIEE a:hover
{
color: #003286;
text-decoration: underline;
}
…
Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal 55
./res/s_your_name/master/custom.css
/** This file is imports master.css (in the same folder as this file) and is deliberately left blank to enable customers to make qui
ck and easy CSS style customizations.
* Customers can use this file to:
* - Add their own CSS classes (which can then be used to format Analyses in Answers etc.)
* - Override OBIEE CSS classes (to affect changes to the UI and reports) without needing to change the main CSS files.
* This file may be overwritten by patch or upgrade processes so we recommend customers follow the instructions in the OBIEE
Admini
stration Guide to create a custom Skin and copy this file to your new Skin.
*/
@import "master.css";
Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal 56
./res/s_your_name/master/graph.xml
…
<!-- Default block populated by BI. For explanation and customization of child elements
please read the documentation following this block -->
<Graph>
<Title horizontalAlignment="CENTER">
<GraphFont fontColor="#0" bold="true"/>
</Title>
<SliceLabel>
<!-- decimalDigitUsed is false here so that non-percentage pie slices do
not pick up this value. The DVTChartProcessor sets decimalDigitUsed
to true if this is a percentage pie slice -->
<ViewFormat decimalDigit="2" decimalDigitUsed="false"/>
</SliceLabel>
</Graph>
…
Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal 57
Product Messages & Custom links
• Custom messages
• Custom links
• SDD/components/OBIPS
Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal 58
Product Messages
• <ORACLE_HOME>/bi/bifoundation/web/msgdb/l_<lang>
• SDD/components/OBIPS/custommessages/l_<lang>
Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal 59
Custom Links
• Enabled on the instanceconfig.xml file
<CustomLinks>
<Enabled>true</Enabled>
<filePath>SDD/components/OBIPS/custommessages/customlinks.xml</filePath
</CustomLinks>
Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal 60
Custom Links
<?xml version="1.0" encoding="utf-8"?>
<customLinks xmlns="com.siebel.analytics.web/customlinks/v1">
<link id="l1" name="OBIEE OTN Page" description="OBIEE on OTN"
src="http://www.oracle.com/technetwork/middleware/index-084205.html"
target="blank" iconSmall="common/info_ena.png">
<locations>
<location name="header" insertBefore="logout" />
</locations>
</link>
</customLinks>
Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal 61
Custom images and icons
• Can be placed anywhere inside your customization
• Retrieved using fmap:<path>/<filename>
Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal 62
Demonstration