Customizing EPM Workspace 11.1.2 Part II


Before I deep dive into the process of Customizing Oracle EPM Workspace (Part II).
A Word of Caution:

The method described here involves changing jsp pages. Check your licensing agreements to see whether this can be customized. 

This post is a follow up to the customization described here.
When I posted Customizing EPM Workspace 11.1.2 Part I, I got a query How to change the heading text that appears in the top bar of the browser?”

My first thought was “Why would someone even think of changing the browser title?”. I tried to reason the question and came up with some scenarios.

Scenario 1
Imagine the situation where you are working on two different workspace instances
  1. Dev Server
  2. Test Server
I don’t think (I’m not aware of a way) there is a way to determine the server name.

One answer could be that “You can look at the splash screen for the url”. However it becomes difficult when there are multiple instances.

Scenario 2
Second answer “Open Workspace using http://servername:port/workspace/index.jsp” then you will always know which server you are in.

However I once worked on a project where we were not allowed to show any urls and we added an additional code to close the splash screen after logging in and then there is absolutely no means to track the url.

I got a good reason to dig up the jsp pages and see whether something can be done to solve this. 🙂
Solution

Inorder to change the title of the Splash page (Launch Application page, the same page which comes up when you use http://servername:port/workspace) we’ve to change launch.jsp page which is located in a war file (workspace.war), which is in an ear file. (workspace.ear).
Location
<Hyp drive>:OracleMiddlewareEPMSystem11R1products
FoundationworkspaceInstallableApps
Open the ear file and then the war file using 7zip, and edit launch.jsp page
Changes

Locate line 5 in launch.jsp page
String rstTitle = ConfigHelper.getApplicationName(application);

and change it to (rstTitle2 is the string that you can use to identify the server)
String rstTitle1 = ConfigHelper.getApplicationName(application);
String rstTitle2 = ” Dev Server”;
String rstTitle = rstTitle1 + rstTitle2;
Save the changes and update the ear and war files.
Inorder to change the title of Workspace Console (page which is launched right after the Splash page, page which is launched when you click on “Launch Application”) we’ve to change index.jsp page which is located in a war file. (bpmui.war)
Location
<Hyp drive>:OracleMiddlewareEPMSystem11R1commonbpmui-common11.1.2.0

Open the war file using 7zip, and edit index.jsp page
Changes
Locate line 26 in index.jsp page
String rstTitle = ConfigHelper.getApplicationName(application);
and change it to (rstTitle2 is the string that you can use to identify the server)

String rstTitle1 = ConfigHelper.getApplicationName(application);
String rstTitle2 = ” Dev Server”;
String rstTitle = rstTitle1 + rstTitle2;
Locate line 157 
String rstWindowName = (rstTitle + “_” + request.getServerName() + “_” + request.getServerPort()).replaceAll(“\W”, “_”);

and change it to
String rstWindowName = (rstTitle1 + “_” + request.getServerName() + “_” + request.getServerPort()).replaceAll(“\W”, “_”);


Workspace Console title and masthead title

 Workspace Splash Head title


line 5 (var used in line 19) of launch.jsp is responsible for this title
Welcome description


line 268 of  launch.jsp is responsible for this
Splash image tool tip

line 260  of launch.jsp is responsible for this title

Even though I won’t recommend this myself, sometimes you’ve to do what you’ve to do.

Read about Customizing EPM Workspace 11.1.2 Part I
Read about Customizing EPM Workspace 11.1.2 Part III


About Celvin Kattookaran

I’m an EPM Consultant, my primary focus is on Hyperion Planning and Essbase. Some of you from Hyperion Support team might recognize me or have seen my support articles, I was with the WebAnalysis Support Team. I'm an Independent Consultant with “Intekgrate Corporation” based out of Aurora office. I’m from God’s Own Country (Kerala, India), lived in all southern states of India, Istanbul and Johannesburg (and of course United States). I’m core gamer :) and an avid reader. I was awarded Oracle ACE Director for my contributions towards EPM community.

Leave a Reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.

0 thoughts on “Customizing EPM Workspace 11.1.2 Part II

  • Abel

    Awesome information, thanks!

    Just one quick note, these changes worked perfectly on our 11.0.2.1 environment. On 11.0.2.2 the index.jsp file was different, having the rstTitle variable on a different line and in two places. Additionally I had to update the index.jsp in both the workspace.war and bpmui.war before I saw the changes take effect.

    Overall not too different and your information helped me work my way through it, thanks again.

  • jul

    Hi,

    nice post but can we expect a customizing workspace 11.2.1 part III ?

    How to include text, links, news, etc on the login page? (by including a small table from another html page on the login page for example?)

    thanks!

  • Anonymous

    Excelent information. Whith your information as help I customized our system so it now plays jingle bells when it starts. This is sure to give my collegues a smile for christmas 🙂

    Excelent site btw

  • Anonymous

    Hey Celvin, great post but wouldn't be more practical to change the colour themes for each enviroment? Let's say Dev is red, test in Amber and leave prod as green?

  • vasanth

    Hi Clevin,

    I tried this in my 11.1.2.3 env but it didn't work and I get the below error. Any thoughts on this?
    ________________________________________________________
    An error occurred. Contact your system administrator. The error message is: "Failed to compile JSP /index.jsp index.jsp:269:27: rstTitle1 cannot be resolved String rstWindowName = (rstTitle1 + "_" + request.getServerName() + "_" + request.getServerPort()).replaceAll("\W", "_"); ^——^ "
    ________________________________________________________