EPM Workspace customization – Part I (11.1.2.4.

xx)
Customizing EPM WORKSPACE in 11.1.2.4 version onwards is little tricky compare to older versions as Oracle
has changed few of folder structures. War/EAR files are being re-deployed if any changes are made to them
after restart of services.

Why do we need to Customize workspace?

Many of customers demand to add company’s logo in Hyperion Workspace or sometimes requests for change
in background color to differentiate in personalized environments.

Most of the customers usually have SSO which allows us to use same AD credentials in all environments say
Development, Test, Quality, disaster and Production. In these cases, to avoid any human errors, we can
differentiate Oracle environments by changing colors. By doing so, you can easily identify that on which
environment you are working on.

What should we consider before performing changes?

Though it’s not a difficult job to perform these type of changes whereas we should always make sure to check
for oracle licensing, if your licensing agreement with Oracle allows you to make these changes or not?

If we face any product related issues due to customization, oracle will not provide its support for that module.
So, it’s important to take backups at each stage.

What all can we customize?

 Change customer logo in main Hyperion workspace landing page

 Change background color on workspace page.
 Add environment name in upper menu
 Update Title bar color, text and font size

 Change customer logo in main Hyperion workspace landing page

1. Go to first foundation server and STOP EPM services on foundation server

2. Create TEMP folder in another location, say E:\HyperionCustom\LOGO
3. Copy logon_panel.gif from below path to TEMP folder.

<EPM_HOME>\user_projects\domains\EPMSystem\servers\FoundationServices0\tmp\_WL_user\WORKS
PACE_11.1.2.0\340u89\war\bpmstatic\themes\theme_skyros\images_global

4. Open and edit logon_panel.gif from TEMP folder

5. Add required LOGO or environment name in gif file.
6. Rename gif file
to logon_panel_old.gif in <EPM_HOME>\user_projects\domains\EPMSystem\servers\FoundationServices0
\ tmp\_WL_user\WORKSPACE_11.1.2.0\340u89\war\bpmstatic\themes\theme_skyros\images_global
7. Copy logon_panel.gif file from TEMP folder to images_global folder.
8. Restart foundation services (EPM START will also work).
9. Perform all above steps on other foundation servers.

10. That’s it, when you open your workspace now it will be copyrighted with your logo

EPM Workspace customization – Part II

Change background color on workspace page

Change Workspace Background color for different environment(s)

1. Go to first foundation server and STOP EPM services on foundation server

2. Create TEMP folder in another location, say E:\HyperionCustom\Color
3. Navigate
to <EPM_HOME>\user_projects\domains\EPMSystem\servers\FoundationServices0\tmp\servers\Foundat
ionServices0\tmp\_WL_user\WORKSPACE_11.1.2.0\340u89\war\bpmstatic\thirdparty\bindows\html\the
mes\Skyros\images
4. Copy below files to TEMP folder
 m_bg_global-rtl.gif
 m_bg_global.gif
 decor_box_rich_t_s_medium-rtl.gif
 decor_box_rich_t_s_medium.gif
 Backup above 4 files and change to required color.

1. Change above .gif files in TEMP folder to required color. Say Orange for development environment, GREEN
for verification and so on.
2. Backup all above files in *\thirdparty\bindows\html\themes\Skyros\images Say <filename_old>.gif
3. Copy files from TEMP folder to images folder.
4. Restart foundation services (EPM START will also work).
5. Perform all above steps on other foundation servers.

6. Welcome to new look for workspace

EPM Workspace customization – Part III

Title bar Changes

Since Oracle EPM 11.1.2.4 there is a black title bar containing Oracle’s logo and product description, which is
always visible

We can perform below cosmetic changes to title bar:

 Add Environment name

 Increase font size
 Change color of title bar
1. Go to first foundation server and STOP EPM services on foundation server
2. Create TEMP folder in another location, say E:\HyperionCustom\titlebar
3. Copy Index.jsp and Theme.css to TEMP folder

Index.jsp –
<EPM_HOME>\user_projects\domains\EPMSystem\servers\FoundationServices0\tmp\servers\Foundatio
nServices0\tmp\_WL_user\WORKSPACE_11.1.2.0\340u89\war

Theme.css
:<EPM_HOME>\user_projects\domains\EPMSystem\servers\FoundationServices0\tmp\servers\Foundatio
nServices0\tmp\_WL_user\WORKSPACE_11.1.2.0\340u89\war\bpmstatic\thirdparty\bindows\html\them
es\Skyros

4. Take backup of both index and theme.css files.

Add Environment Name in Title Text

1. Open index.jsp from TEMP folder in notepad++.

Search for below text

 String rstTitle = ConfigHelper.getApplicationName(application);

2. Replace above text with below text

// String rstTitle = ConfigHelper.getApplicationName(application);

String rstTitle = “EPM Workspace, VERIFICATION Environment”;

3. You can add any other text such as “Oracle EPM – <Customer Name> <Environment name>”
4. Save file.

Change Title bar color

1. Open theme.css from TEMP folder in notepad++
2. Find the CSS class “.mastheadTitle” and change the property value for “background-color:” to the required
color. Few of color-hex codes are:

Dark Green #31b305

Dark Orange #ff7f00

3. Repeat this step for CSS class “.mastheadBody”. Make sure both classes have the same color hex code.

4. Save theme.css file.

Change Title Text Font size

1. Edit theme.css from TEMP folder in notepad++
2. Find the class “.bi-label” and change the property value “font-size:” to “12px”. Add the following property and
value “padding-left: 12px;”.
Save the file and close it.

Copy theme.css and index.jsp to respective folders.

Start “Oracle Hyperion Foundation Services – Managed Server (epmsystem1)”.

Perform all above steps on other foundation servers.

https://docs.oracle.com/cd/E57185_01/EPMWA/ch02s09.html

Customizing the Logon Page in EPM Workspace

You can customize the logon page to add a proprietary disclaimer. This allows a company to broadcast this to
all users when logging in to EPM Workspace. This information is displayed below the Copyright information.

To customize the logon page in EPM Workspace:

1. Stop all services.

2. Backup EPM_ORACLE_HOME/common/bpmui-common/11.1.2.0/bpmui.jar.
3. Using an unarchiving utility, extract the contents of EPM_ORACLE_HOME/common/bpmui-
common/11.1.2.0/bpmui.jar into a <temp directory>.
4. Edit file <temp directory>/com/hyperion/bpm/Resources_en.properties.
5. Search for the property bpm.logonCopyright.
6. Modify the text to the right of the equal sign (=). Use \n to get a new line.
7. Save your changes.
8. Repeat Step 4 through step 7 for all the other Resources_xx.properties files for other locales.
9. Jar the contents of <temp directory> to EPM_ORACLE_HOME/common/bpmui-
common/11.1.2.0/bpmui.jar.
10. Start all services.
11. Clear the browser cache.

https://docs.oracle.com/cd/E57185_01/EPMWA/ch02s10.html

Customizing the Help Menu in EPM Workspace

You can update the menu text, redirect, or hide the Technical Support and EPM Documentation links located
under the Help menu.

To redirect Technical Support and EPM Documentation links:

 1. Follow instructions on how to Extract a file in the EPM Workspace Web Application.
2. Backup the file <temp directory>/war/conf/WkspConfig.jsp.
3. Edit the file <temp directory>/war/conf/WkspConfig.jsp.
4. Search for the module tag with id set to wksp.mode.
5. Modify the attributes below to the new URL:

For Technical Support, modify helpTechSupportUri=http://www.oracle.com/support/index.html.

For EPM Documentation link, modify

helpNetworkUri="http://www.oracle.com/technology/documentation/epm.html”.

6. Search for the module tag with id set to wksp.logon.

7. Modify the attributes below to the new URL:

For Technical Support link, modify

helpTechSupportUri=http://www.oracle.com/support/index.html.

For EPM Documentation link, modify

helpNetworkUri=http://www.oracle.com/technology/documentation/epm.html.

8. Save your changes and continue with Repackage a file inside the Workspace Web Application.

Note: helpTechSupportUri is the URL invoked for the menu item Help, then Technical Support. helpNetworkUri is the URL in

To update the menu text for Technical Support and EPM Documentation links, you need to
modify bpm_en.js in two locations, EPM Workspace Web application and on the Web Server which serves the
static pages. Do the following:

1. Backup file EPM_ORACLE_HOME/common/epmstatic/wspace/resources/bpm_en.js.

2. Edit file EPM_ORACLE_HOME/common/epmstatic/wspace/resources/bpm_en.js.
3. Search for the key MItemHelpTechSupport.
4. Edit the text Technical Support\ns.

\ns represents the menu mnemonic s. You can omit or put in your own.

5. Search for the key MItemHelpNetwork.

6. Edit the text EPM Documentation\ne.

\ne represents the menu mnemonic e. You can omit or put in your own.

7. Save your changes.

8. Repeat step 1 through step 6 for all the other bpm_xx.js files for other locales.
9. Clear your browser cache.

Note: You do not need to restart the Oracle Hyperion Enterprise Performance Management Workspace Applic

To remove the Technical Support and EPM Documentation links, do the following:
1. Follow instructions on how to Extract a file in the EPM Workspace Web Application.
2. Backup the file <temp directory>/war/conf/WkspConfig.jsp.
3. Edit the file <temp directory>/war/conf/WkspConfig.jsp.
4. Search for the module tag with id set to wksp.mode.
5. Delete the following attributes to remove the link.

For Technical Support link, delete

helpTechSupportUri=http://www.oracle.com/support/index.html.

For EPM Documentation link, delete

helpNetworkUri=http://www.oracle.com/technology/documentation/epm.html.

6. Search for the module tag with id set to wksp.logon.

7. Delete the following attributes to remove the link

For Technical Support link, delete

helpTechSupportUri=http://www.oracle.com/support/index.html.

For EPM Documentation link, delete

helpNetworkUri=http://www.oracle.com/technology/documentation/epm.html.

8. Save your changes and continue with Repackage a file inside the Workspace Web Application.