Tuesday 7 October 2014

Replacing the Home page within OBIEE



Replacing the Home page within OBIEE with a more friendly “Welcome to the BI System” is becoming a more popular thing to do - many of our clients now have this:

Replacing:



With something like this:

 

As well as being the first page the users see when they login, we also change the ‘Home’ link in the dashboard menu bar to point to this page as well, so the users can quickly return to it at any time.

The standard method of changing the login page for users is to use the PORTALPATH repository variable, but with some recent patches there have been problems with this so we’ve come up with an alternative method using an HTML redirect within the home page itself.

Changing the Home link is a common task and there are other blogs around which show how to do this, but I’ve included it below as well.




Changing the login page

Our new method of doing this is to use standard HTML code and embed a redirect within the home page. This home page still exists, but the redirect just prevents the users from seeing it.

To do this you need to edit the bieehome.htm file.

There are two possible locations for this. The main location is under:

<obiee_home>/Oracle_BI1/bifoundation/web/msgdb/pages/bieehome

However you may have already copied this to the OracleBIPresentationServicesComponent directories if you’ve made other customisations:

<obiee_home>/obiee/instances/instance1/bifoundation/OracleBIPresentationServicesComponent/coreapplication_obips1/msgdb/pages/bieehome

Take a backup copy of the file bieehome.htm then edit it.

Search for the line:

<body class="HTMLBody">

and beneath it add the following 8 lines, replacing the URL with the appropriate URL for your welcome page  - copy from the browser address bar and replace everything to the left of /analytics with two dots (..)

<p align="center"> </p>
<script type="text/javascript">
Redirect();
function Redirect()
{
  location.href = '../analytics/saw.dll?dashboard&PortalPath=%2Fshared%2FWelcome%2F_portal%2FWelcome to BI';
}
</script>



save the file.

This will come into effect after OBIEE is restarted, which we’ll do later.

Change the 'Home' link

Now we need to change the Home link in the dashboard menu bar:



For this we need to edit a javascript file, header.js

This can be found in the directory:

<obiee_home>/user_projects/domains/bifoundation_domain/servers/bi_server1/tmp/_WL_user/analytics_11.1.1/7dezjl/war/res/b_Mozilla

Take a backup copy of it first then edit it.  You need to be careful now, this script in this file is quite complex and the syntax needs to be perfect for it to work. The code is also all on one line, so it’s not that easy to see where you are.

Search for the string:
saw.header.NavBar.prototype.onHome=function(b,a){saw.header.openURL(saw.commandToURL("bieehome"),a)};




Now replace the code between the curly brackets:

saw.header.openURL(saw.commandToURL("bieehome"),a)

With this below, again replacing the URL with the correct one for your welcome page, but in this case only from saw.dll onwards:

window.location.href="saw.dll?dashboard&PortalPath=%2Fshared%2FWelcome%2F_portal%2FWelcome to BI"



Save the file.

Restart OBIEE

Perform a restart of the OBIEE services - either from the Enterprise Manager console or a full restart using your normal process.

Now when you login your welcome page will be displayed by default and the Home link will always return to it.

This is of course just the default login page. It can still be overridden by users who choose alternative starting page in their preferences or who access OBIEE via a URL which includes a specific portalpath reference.

For the record, this blog was written using OBIEE version 11.1.1.7.140415 (Build 140403.1046 64-bit).




4 comments:


  1. Nice information. Our institute Is the Leading online institute in Hyderabad, India to provide obiee online trainings with the real time experts and certified professionals. alot OBIEE Online Training.

    ReplyDelete
  2. Thanks for sharing this valuable information to our vision. You have posted a trust worthy blog keep sharing.
    Informatica training in Hyderabad

    ReplyDelete
  3. Now that I have changed the bieehome.htm and changed the location ref , the changes are reflecting fine for all users. But when I login to obiee and want to modify my account and set my starting page as old obiee home ( by clicking on default or homepage and saving ) this does not work , instead I come back to the same page which I mentioned in location ref in bieehome.htm . Is there a way out ?

    ReplyDelete

  4. Great Article. As I read the blog I felt a tug on the heartstrings. it exhibits how much effort has been put into this.
    IEEE Projects for CSE in Big Data

    Spring Framework Corporate TRaining

    Final Year Project Centers in Chennai

    JavaScript Training in Chennai

    ReplyDelete