My Blog

Replacing the Home page within OBIEE

by Paul Cannon on 7th October 2014 5 comments

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:

RTHP1

With something like this:

RTHP2

As well as being the first page the users see when they log in 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>

RTHP3

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:

RTHP4

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)};

RTHP5

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"

RTHP6

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).

Enjoy!

 

 

 

Paul CannonReplacing the Home page within OBIEE

5 comments

Join the conversation
  • Sampad Mohapatra - 20th January 2015 reply

    Hi Paul,

    Thanks for the informative blog. I actually stumbled upon it while searching for another solution. Perhaps you can help me.

    In my project, the requirement is to set the page after login page as home page.
    That is, when a user logs in he is redirected to the home page despite the choice selected in \”My Account\”. As far as I can see all solutions enumerated make use of PORTALPATH variable and setting default as the first page or in ur case a redirect to ur custom page(which needs homepage to be selected in \”My Accounts\”).

    If you can think of a way to solve my issue please reply.

  • Víctor Herreros - 15th February 2017 reply

    Hi,

    Thanks a million for this info, but I have one question. It seems you are redirecting the home page to some kind of content inside the shared folders of OBIEE:

    location.href = ‘../analytics/saw.dll?dashboard&PortalPath=%2Fshared%2FWelcome%2F_portal%2FWelcome to BI’

    But what if you want to redirect the home page to some custom-made web page, e.g., an HTML file? Where to deposit it and how to call it from the redirect command? Is there any specific directory inside OBIEE file system or can you upload such HTML file to the OBIEE web catalog?

    Thanks again!

    Víctor Herreros - 2nd March 2017 reply

    Just responding to myself: You have to deploy a custom OBIEE folder (see https://gianniceresa.com/2016/12/deploy-custom-folder-obiee-12c-analyticsres/) so you can deposit there all your new HTML web pages and then call one of the web pages indside that folder from the location.href value.

    One valid example of value is:

    window.location.href=”../OBIEEwelcome/SIDIWelcome.html”

    being ‘OBIEEwelcome’ the name of the deployed directory and ‘SIDIWelcome.html’ the name of one web page phisicallly inside that directory.

    Thanks again!

  • Tarang Jain - 17th April 2017 reply

    Nice post, i have one query, thought you may give me some guidance.
    in OBIEE 12c in title view , i want to configure the help url, now when i am giving fmap:/abc.htm and after clicking on
    the ? in title view , i am getting new webpage with below url:

    http://hostname:9502/analytics/Missing_/CCO2.htm

    I want to know where this Missing_ folder needs to be created for this url to work.

    Regards,
    Tarang Jain

    Paul Cannon - 19th April 2017 reply

    Hi Tarang,

    the place to put it is:

    /user_projects/domains/bi/servers/bi_server1/tmp/_WL_user/analytics/za01ic/war

    note the za01ic may be different – search for the _WL_user/analytics directory and look under there. As this is an awful place to have working files I usually create a directory somewhere else and create a symbolic link from this directory:

    mkdir /u01/app/urlfiles (or whatever you want to call it)
    cd /user_projects/domains/bi/servers/bi_server1/tmp/_WL_user/analytics/za01ic/war
    ln -s /u01/app/urlfiles urlfiles

    then place your files in /u01/app/urlfiles

    and the URL to access then becomes http://hostname:9502/analytics/urlfiles/CCO2.htm

    hope that helps

    Paul.

Join the conversation