Skip to Content
Author's profile photo Arijit Das

How to display custom message in BI Launchpad Login page

In a recent BO upgrade project, I did face a requirement of displaying custom message in BI Launchpad login page. The upgrade happened from BOXI3.1 to BO 4.0. Earlier, they used to edit the logon.jsp file inside InfoViewApp web service folder to display their custom messages. But the same trick did not work in BO 4.0.

In this blog, let me describe how I managed to display a custom message in BI Launchpad login page for SAP BusinessObjects Business Intelligence Platform 4.0 SP6.

Requirement

Let the requirement be as below:

  1. To show a pop-up message when the user enters the URL for BI Launchpad.
  2. In the log-in screen we need to show some custom message.

Assumption

Let’s assume that SAP BO BI Platform 4.0 has been installed and configured with default Tomcat web application server.

Steps

Here are the steps to achieve the requirement:

  1. Stop Tomcat in the BO server.
  2. Delete the folder <Tomcat Installation directory>\work\Catalina\localhost\BOE. This is a temporary folder and will be re-created when tomcat will be started.
  3. Go to the folder <Tomcat Installation directory>\webapps\BOE\WEB-INF\eclipse\plugins\webpath.InfoView\web.
  4. Take a backup of the file custom.jsp and keep it in a safe location.
  5. Create a copy of the file logon.jsp in the same folder and rename it as custom.jsp.
  6. Open newly created custom.jsp file in notepad for editing.
  7. To create a pop-up message, append the following line just before the <title> tag:<scriptlanguage=JavaScript> alert(‘Custom Pop-Up Message’);</script>

    Example

    <script language=JavaScript>

    alert(‘Information: \n Any Report / UserID not used in last 2 months will be cleaned up as part of Regular System maintenance.’);

    </script>

  8. Add the custom message you want to display in the login screen just after the line :

    <divclass=“logonIFrame”>

     

    Example

    <font color=“Mediumblue”>For logon credentials, kindly contact

    <a href=mailto:ari007.cse@gmail.com><font color=“red”><span style=“text-decoration:underline;”>Arijit Das</span></font></a>

    </font>

  9. Save and close the file.
  10. Go to folder <Tomcat Installation directory>\webapps\BOE\WEB-INF\internal.
  11. Take a backup of the file BIlaunchpad.properties and keep it in a safe location.
  12. Open existing BIlaunchpad.properties file in notepad for editing.
  13. Change the line

    redirection.iframe.1.redirectto.url=/logon.jsp

    to

    redirection.iframe.1.redirectto.url=/custom.jsp

  14. Save and close the file.
  15. Start Tomcat from Central Configuration Manager. It will take some time to re-generate the BOE temporary folder which we deleted in step 2.
  16. Clear browser cache and java temporary files.
  17. Now open the BI Launchpad URL: http://boserver:port/BOE/BI in the browser.
  18. First the pop-up message will appear as we configured in step 7.

  19. Once you click OK, the logon screen will appear with custom message that we configured in step 8.

How to do it for BO 4.1

The process is similar for BO 4.1 also but with some minor differences :

 

Steps 1-7 are same as we did for BO 4.0.

 

Step 8: Add the custom message to be displayed just before the tag <h:form>.

Steps 9-12 are again same as before.

Step 13: Change the line

          redirection.iframe.1.redirectto.url=/logon.faces

          to

          redirection.iframe.1.redirectto.url=/custom.faces

 

Steps 14-19 are again the same as before.

 

Changing files directly in tomcat folder should not be considered permanent. Once BOE web service is re-deployed from the original war file, the changes will be gone. So, better is to make changes in the following files and then run wdeploy tool to redeploy BOE web service.

  • <BO Installation Dir>\SAP BusinessObjects Enterprise XI 4.0\warfiles\webapps\BOE\WEB-INF\internal\BIlaunchpad.properties
  • <BO Installation Dir>\SAP BusinessObjects Enterprise XI 4.0\warfiles\webapps\BOE\WEB-INF\eclipse\plugins\com.businessobjects.webpath.InfoView.jar

How to do it for BO 4.2 Fiorified Launchpad

Please follow the blog:

https://blogs.sap.com/2018/02/21/how-to-display-custom-message-in-fiorified-bi-launchpad-login-page/

 

Assigned Tags

      77 Comments
      You must be Logged on to comment or reply to a post.
      Author's profile photo Sateesh Kumar Bukkisham
      Sateesh Kumar Bukkisham

      Great work Arijit ,

      Thank you for sharing..

      Author's profile photo Former Member
      Former Member

      Arijit Hi

      I have one problem, I did same  example your , my initial page is ok. But when I loggin and after logout  I dont see the same page, I am seeing  old pagei

      Author's profile photo Arijit Das
      Arijit Das
      Blog Post Author

      Hi Alberto,

      Do you want to get the login page back when logged out ?

      If yes, follow the steps below:

      1. Stop Tomcat

      2. Copy the file BIlaunchpad.properties from <Tomcat Installation Dir>\webapps\BOE\WEB-INF\config\default to <Tomcat Installation Dir>\webapps\BOE\WEB-INF\config\custom

      3. Configure the exit URL in the new properties file. There is a parameter url.exit in the properties file. Configure it as url.exit=http://server:port/BOE/BI

      4. Start Tomcat

      -Arijit

      Author's profile photo Former Member
      Former Member

      Arijit thank you for your help.

      Helped me very much.

      Author's profile photo Former Member
      Former Member

      Hello Arijit,

      First of all thank you so much for sharing useful information for customization.

      I am using BO 4.1.As mentioned by you, I added some text on login page of BI Launchpad and it's working fine.

      After that I followed the steps mentioned by you to Alberto but when I logoff the BI Launchpad screen just show a white window (kind of hang up). The error message says "Invalid argument : logoff.do".

      The bottom line is I am not able to get back to login page with csutomizations done after logging off though I can see customizations when opening BI Launchpad.

      Please advise.

      Thanks,

      Akhil

      Author's profile photo William MARCY
      William MARCY

      Great entry. Smart and valuable, just what we want on SCN 🙂

      Keep sharing.

      Regards,

      Author's profile photo Former Member
      Former Member

      Thank You.

      Author's profile photo Former Member
      Former Member

      Great work Arijit , Thank you for sharing..

      Author's profile photo Former Member
      Former Member

      good contribution !

      Thansk !!!

      Regards

      Author's profile photo Former Member
      Former Member

      i want to show sth. in chinese,but it show messy code, so please help me. thanks advanced!

      Author's profile photo Arijit Das
      Arijit Das
      Blog Post Author

      Can you please explain the issue with some screenshots ?

      Author's profile photo Former Member
      Former Member

      Great work arjit , Thankyou for sharing 🙂

      Author's profile photo Hafeez Rasheed
      Hafeez Rasheed

      Hi Arijit,

      I followed your blog and added a custom message in BI launch pad login page.

      Thanks for the same.

      I would like to know whether we can add such customizations (other than changing colors,logos etc) like we can do for Login page by altering  logon.jsp file.

      eg: adding hyperlinks, custom messages in BI launch pad HOME page.

      Do we have access to jsp files for these pages as well?

      Regards

      HH

      Author's profile photo Arijit Das
      Arijit Das
      Blog Post Author

      Do you want to customize the home page after login ?

      It is recommended to use the OEM customization tool in that case, which allows us to control colors, fonts, logo etc by using our own css and custom images. Adding additional elements is not possible with this tool though.

      Author's profile photo Hafeez Rasheed
      Hafeez Rasheed

      Are you referring to the CUSTOMIZE.CSS file included in the infoviewbranding.jar?

      I have already modified the background and border colors, logos etc by altering CUSTOMIZE.CSS file .

      Author's profile photo Arijit Das
      Arijit Das
      Blog Post Author

      Yes. We need to customize that way only because that is supported by SAP.

      Author's profile photo Former Member
      Former Member

      Hi Arijit,

      Is it possible to change login form style, like increase the height and width of username and password fields?

      Just for testing I have removed <h:form.. </h:form> and tested then I don't see logon fields on screen, so what does this form and from where this form is coming.

      Please let me know your thoughts on this.

      Thanks,

      Mani

      Author's profile photo Arijit Das
      Arijit Das
      Blog Post Author

      Better to design your own login screen in this case and redirect the token generated to BO homepage.

      Author's profile photo Former Member
      Former Member

      Thanks Arijit..

      Author's profile photo Former Member
      Former Member

      thanks for sharing  information Arijith .

      Author's profile photo Sohel Ahmed Syed
      Sohel Ahmed Syed

      Thanks a lot for sharing this Arjit.

      I need to know how can i dispaly an image in the logon.jsp file. We are using Tomcat with Vintella SSO, while SSO is happening the browser is struck on logon.faces for few seconds and a blank screen shows utill it logs in completely. I want to eliminate this by showing some image on the browser screen while SSO is happening.

      I am sure there are lot of others who would be interested in such solution, any inputs on this would be of great help.

      Thanks,

      Sohel

      Author's profile photo Former Member
      Former Member

      Thanks Arijit.. Very good document.it helps me..

      Good queastion @Sohel Ahmed Syed

      Author's profile photo Sohel Ahmed Syed
      Sohel Ahmed Syed

      Thanks JRK  rather I think there should be such such functionality available by default. In most of the enterprise web applications you will see some loading or welcome message while its authenticating instead of just a blank screen. I think we should submit this as an idea.

      Author's profile photo Mantu Sahu
      Mantu Sahu

      Hi Arijit,

      How to show the custom meesage after login into BI LaunchPad

      Author's profile photo Arijit Das
      Arijit Das
      Blog Post Author

      It is recommended to use OEM Customization tool for any customization in the BI Launchpad UI after login. But I doubt if showing a custom message there is possible.

      Author's profile photo Former Member
      Former Member

      And i presume it's athe same place i can add a link to do a reset password (like on my BOBJ system - who's connect to a ECC system) - i've did the same thing for Dataservices, its connected to ECC and i want to add a link to do a reset password

      Thanks for the help, really appreciated (see attach)bi_launchpad.JPG

      Author's profile photo Former Member
      Former Member

      Because in BO/Dataservices i cannot do step 3 - folder doesn't exists

      thanks

      Author's profile photo Former Member
      Former Member

      Anyone else try to put a password reset link on their webpage?

      thanks

      Author's profile photo Arijit Das
      Arijit Das
      Blog Post Author

      for a password reset, the user has to be authenticated first, and after login, the user can change password from preferences. Do you want a "Forgot Password ?" kind of link ?

      Author's profile photo Former Member
      Former Member

      Yes kinda like on my print screen - some users dont log into ABAP systems, only BOBJ / BODS so they have to call it to get a password reset / password change.  We want to provide a password reset link that is connect with the ABAP backend for expired password.  Its already in place in our BOBJ systems

      Author's profile photo Former Member
      Former Member

      David,

      I'm not from the SAP BW side of things, I'm a traditional BusinessObjects person. Is the change password link in SAP a static url? If so, could you not just recreate it on your BO page with standard "a href" hyperlink syntax?

      Author's profile photo Former Member
      Former Member

      Yes its a netweaver link: http://website.com/sap/bc/gui/sap/its/webgui?sap-client=100 / I will try - sometimes we are to close from the tree..i guess a simple Href link could work yes /   Thanks for the ideareset_link.JPG

      Author's profile photo Arijit Das
      Arijit Das
      Blog Post Author

      If it is a static link, then you can easily include it using <a href=...> tag.

      Author's profile photo Former Member
      Former Member

      Do you know in which file/folder is the Logon on dataservices? to put the code

      thanks

      Author's profile photo Arijit Das
      Arijit Das
      Blog Post Author

      For DS, I didn't try it. I thought you were asking about BI Launchpad.

      Author's profile photo Former Member
      Former Member

      Yes Bi Launchapd of Data servicesbo1.JPG

      Author's profile photo Former Member
      Former Member

      Hi Arijit,

      Thanks for sharing!!!

      we have a BO 4.1 and the users access their reports through an Enterprise Portal so, there is SSO between the two servers, but every time the user click the menu for a BO report there is a blank page for about 4 seconds which as I can see is the time that takes openDocment .faces to load, I think this is the logon part (am I wrong), the question: is there any way to reduce this 4 seconds? if not, is there any way to display another page, not a blank one, for example a page with an image of a clock (o something like that).


      Regards

      Diego

      Author's profile photo Former Member
      Former Member

      I've been trying to get this working for the past few days; nothing I do seems to work.  I've tried all of the steps above with no success.  We use Active Directory and are automatically logged into Launch Pad when we hit our url, e.g., https://servername:port/BOE/BI/.  We do not receive a warning message, nor do I see any changes to the logon screen when I click the logout button from Launchpad.  Any ideas?

      Author's profile photo Former Member
      Former Member

      A great idea and very useful. I may investigate further to see if I can integrate this with the data warehouse load to create a popup message warning about a load failure.

      Author's profile photo Former Member
      Former Member

      Hi Mark

      I have a very similar requirement. If a new report has been published client wants a Pop up on login screen. Please let me know if you have done anything on the load failure. I can probably do the same thing . Unfortunately i have very limited knowledge of Java to do any changes like this. Also Since the changes are not static it will be difficult to redeploy the BO Portal (by stopping tomcat) so frequently.

      Cheers

      Sanjit

      Author's profile photo Former Member
      Former Member

      I've not tried it yet, real world projects have got in the way. I would be trying it on 3.1 if I do get the chance but there's nothing to stop you using php or similar to check the warehouse.

      Author's profile photo Former Member
      Former Member

      Hello Arijit,

      We are on BI 4.1 and I tried the steps (1 -19) you provided and restarted tomcat and I do not see the popup message. What am I doing wrong?

      Thx Rupa

      Author's profile photo Arijit Das
      Arijit Das
      Blog Post Author

      can you share the custom.jsp you created?

      Author's profile photo Former Member
      Former Member

      Hi Arijit,

      I figured it out. Instead of updating redirection.iframe.1, I updated under redirection.iframe.2. I am seeing the pop up now and it works nice. Thanks!

      Author's profile photo Former Member
      Former Member

      Thanks for letting us know and well done!

      Author's profile photo Former Member
      Former Member

      Hi Arijit,

      Also in your step # 12 (Open existing BIlaunchpad.properties file in notepad for editing which is under <Tomcat Installation directory>\webapps\BOE\WEB-INF\internal),

      I see in this dir there is a readme file that says: DO NOT MODIFY FILES IN THIS FOLDER! These files are part of the internal configuration of the BOE web app and may NOT be modified by the end user admin.)

      Is it okay to modify this file here?

      Thanks!

      Author's profile photo Arijit Das
      Arijit Das
      Blog Post Author

      Actually this method of customization is not supported by SAP. This is just a workaround. For me, it did cause no issue. If you do so, always keep a backup.

      Author's profile photo Pradeep Prakash
      Pradeep Prakash

      Hi Arijit,

      Thanks for sharing this. I tried the same steps and seems like this is not working for me. Is this because we have a SSO enabled, anyone who go to the URL is directly taken to the launch pad.

      My question :

      1. Is there any way we can display this custom message in the launch pad landing page.

      2. or a pop up once the user is logged in.

      Thanks

      Pradeep Prakash

      Author's profile photo Arijit Das
      Arijit Das
      Blog Post Author

      This will not work in case of sso as you are bypassing the screen to enter login credentials.

      Author's profile photo Former Member
      Former Member

      Hi Arijit,

      Is there any way to get custom pop-up message in case of SSO, before displaying the homepage?

      Thanks,

      Preethi

      Author's profile photo Former Member
      Former Member

      Hello Arjit,

      Very useful post..!!! Excellent..

      I am also having kind of same requirement, where I want to modify default error msg.

      My scenario is as follows:

      1. In my dashboard I have used Tab control having 3 tabs.

      2. Each tab contain URL button which navigates to other dashboard.

      3. Few users having one access to 1st tab. i.e. only one dashboard.

      From CMC I explicitly removed view access to  that dashboard.

      4. Now when user click on URL button it navigates to error page showing error as:

      "An error occurred: Could not find the document."

      5. I want to modify this error.

      Can u plz ut some light on this.

      Regards,

      Pallavi.

      Author's profile photo Arijit Das
      Arijit Das
      Blog Post Author
      Author's profile photo Former Member
      Former Member

      Hi Arijit,

      Thank you for sharing this info. Did you ever tried adding a customized text for Inforamtion Steward logon page? Could yo please help me.

      Kind Regards,

      Mahesh

      Author's profile photo Swapnil Yavalkar
      Swapnil Yavalkar

      Hi Arijit Das,

      I have implemented this successfully, however after logging out from BILaunchpad it again loads the same alert. Is there a way to stop getting this alert message after logging out from BILaunchpad? Its BI4.2 SP02 version.

      Thanks in advance.

      ~Swapnil

      Author's profile photo Arijit Das
      Arijit Das
      Blog Post Author

      create a page without alert message and configure url.exit parameter in BIlaunchpad.properties to display the page without alert on logoff.

      Author's profile photo Former Member
      Former Member

      Hi Arijit,

      Thanks for sharing this post, I have successfully implemented this in tomcat but how to update the BOE war file which we have to deploy on weblogic.

      when I go to below location, I don't see custom.jsp or logon.jsp files

      <BO Installation Dir>\SAP BusinessObjects Enterprise XI 4.1\warfiles\webapps\BOE\WEB-INF\eclipse\plugins\com.businessobjects.webpath.InfoView.jar

      Could you please help me.

      Thank you

      Uday

      Author's profile photo Former Member
      Former Member

      Hi Arjit,

      This is useful article, thank you, with SSO this alert message is not poping up , can you help me  who to custom alert with SSO.

      thanks

      Snigdha

      Author's profile photo Hemalatha Komaragiri
      Hemalatha Komaragiri

      Hi Arjit,

      Thanks for this article, very useful. I have implemented your workaround in BI Launchpad 4.2 version and it works fine.

      Now the problem is i have to do the same custom message on Opendocument login page, when i tried the same steps it doesn't work. can you please advise the steps to update the custom message on Opendocument login page, this is quiet urgent request will appreciate your prompt response.

      Thanks
      Hema

      Author's profile photo Arijit Das
      Arijit Das
      Blog Post Author

      I never tried to customize the opendocument entry point. Will try it and update if I am successful.
      However, are you aware of the issue with login using OpenDocument entry point ? If not, check this: https://ideas.sap.com/D32580

      Author's profile photo Former Member
      Former Member

      Hello,

      I want to be able to change the text on the Logon Page

      "Enter your user information, and click "Log On".
      If you are unsure of your account information, contact your system administrator."

      This used to be possible with BOE XI 3.1 using the PlatformResources_en.properties within the PlatformServices_en.jar file located at E:\Tomcat7\webapps\PlatformServices\WEB-INF\lib

      Any thoughts for BI 4.2?

      Also, I'm reading through the http://help.sap.com/businessobject/product_guides/sbo42/en/sbo42_bi_custom_en.pdf Guide. It's not clear to me if the Customization described has to be done BEFORE the installation only?

      Author's profile photo Former Member
      Former Member

      Hi Mingthingla,

      Did you manage to do this please ?

      I am in the same situation at the moment.

       

      Regards,

      Steven Farrugia

      Author's profile photo Sreedhar Konduri
      Sreedhar Konduri

      Hi,

      Did you manage to get this in 4.2 SP4?

      Thanks

      Author's profile photo Former Member
      Former Member

      Hi Arijit Das, Your post was really helpful, when I am trying to redirect /BOE/BI to custom message.

      Thank you so much for sharing your knowledge!

      Author's profile photo Arijit Das
      Arijit Das
      Blog Post Author

      Thank you Former Member

       

      Author's profile photo Sreedhar Konduri
      Sreedhar Konduri

      Hi Arijit,

      nice post. How can we achieve this in 4.2 SP4?

       

      Thanks

       

      Author's profile photo Arijit Das
      Arijit Das
      Blog Post Author

      Try this:

      https://blogs.sap.com/2018/02/21/how-to-display-custom-message-in-fiorified-bi-launchpad-login-page/

      Author's profile photo Sreedhar Konduri
      Sreedhar Konduri

      Thanks Arijit.

      though we are on 4.2 SP4, we may not using the fiori launchpad. we might stick with old launchpad. In that case, Do you know which files need to be modified?

      Thanks

       

      Author's profile photo Arijit Das
      Arijit Das
      Blog Post Author

      For old BI Launchpad login screen, the same trick mentioned for BO 4.1 should work.

      Author's profile photo Sreedhar Konduri
      Sreedhar Konduri

      Hi Arijit,

      I'm not able to find the <divclass=“logonIFrame”> (# 8) in the copied logon.jsp.

      Please let me know if it is different in 4.2?

      Thanks

       

       

       

      Author's profile photo Arijit Das
      Arijit Das
      Blog Post Author

      You are following the steps for BO 4.0.  For 4.1 & 4.2 you need to search for <h:form>.

      I the last section of this blog, I already described the differences for BO 4.1.

      Author's profile photo Sreedhar Konduri
      Sreedhar Konduri

      Thanks Arijit.

      I missed that. It is working now.

       

      Author's profile photo Gaurav Singh
      Gaurav Singh

      Thanks for the post. This helps a lot.

       

      Is it possible to customize the error message user get during logon? For example if I enter a wrong password it shows

      Account information not recognized: Enterprise authentication could not log you on. Please make sure your logon information is correct. (FWB 00008)
      We want to change that to show a phone number and email address where users can reach out. Any idea?

       

      Author's profile photo Arijit Das
      Arijit Das
      Blog Post Author

      Please tell me the BI Platform version you are using. Are you using the new fiorified launchpad ?

      Author's profile photo Gaurav Singh
      Gaurav Singh

      Its 4.2 SP4 Patch 7 but we are not using fiori yet. But we will in near future so I will appreciate if you can help with both.

      Author's profile photo Arijit Das
      Arijit Das
      Blog Post Author

      I would suggest to post it as a question.

      Author's profile photo Gaurav Singh
      Gaurav Singh

      Just did. Thanks

      Author's profile photo Matthew Erb
      Matthew Erb

      This worked great on 4.1 to display a notice to users that we were moving to a new link, thanks!