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
- Dev Server
- 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
Fantastic! Thanks Celvin. It did the job.
BR
Paulo
🙂 good to hear that Paulo…more to come as PART III
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.
Thanks Abel. Good to hear that it helped you.
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!
Hi clevin,
I am trying to change the copy right disclaimer in the login page. Can you please help with it.
-Pmenon
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
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?
Hello,
Have you got the solution to include hyperlinks in the login page ?
Thank you in advance,
Abhishek
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", "_"); ^——^ "
________________________________________________________
Did you define rstitle1 as shown above?