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.
Let the requirement be as below:
- To show a pop-up message when the user enters the URL for BI Launchpad.
- In the log-in screen we need to show some custom message.
Let’s assume that SAP BO BI Platform 4.0 has been installed and configured with default Tomcat web application server.
Here are the steps to achieve the requirement:
- Stop Tomcat in the BO server.
- 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.
- Go to the folder <Tomcat Installation directory>\webapps\BOE\WEB-INF\eclipse\plugins\webpath.InfoView\web.
- Take a backup of the file custom.jsp and keep it in a safe location.
- Create a copy of the file logon.jsp in the same folder and rename it as custom.jsp.
- Open newly created custom.jsp file in notepad for editing.
alert(‘Information: \n Any Report / UserID not used in last 2 months will be cleaned up as part of Regular System maintenance.’);
- Add the custom message you want to display in the login screen just after the line :
<font color=“Mediumblue”>For logon credentials, kindly contact
<a href=mailto:email@example.com“><font color=“red”><span style=“text-decoration:underline;”>Arijit Das</span></font></a>
- Save and close the file.
- Go to folder <Tomcat Installation directory>\webapps\BOE\WEB-INF\internal.
- Take a backup of the file BIlaunchpad.properties and keep it in a safe location.
- Open existing BIlaunchpad.properties file in notepad for editing.
- Change the line
- Save and close the file.
- Start Tomcat from Central Configuration Manager. It will take some time to re-generate the BOE temporary folder which we deleted in step 2.
- Clear browser cache and java temporary files.
- Now open the BI Launchpad URL: http://boserver:port/BOE/BI in the browser.
- First the pop-up message will appear as we configured in step 7.
- 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
Steps 14-19 are again the same as before.
How to do it for BO 4.2 Fiorified Launchpad
Please follow the blog:
Great work Arijit ,
Thank you for sharing..
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
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 thank you for your help.
Helped me very much.
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.
Great entry. Smart and valuable, just what we want on SCN 🙂
Great work Arijit , Thank you for sharing..
good contribution !
i want to show sth. in chinese,but it show messy code, so please help me. thanks advanced!
Can you please explain the issue with some screenshots ?
Great work arjit , Thankyou for sharing 🙂
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?
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.
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 .
Yes. We need to customize that way only because that is supported by SAP.
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.
Better to design your own login screen in this case and redirect the token generated to BO homepage.
thanks for sharing information Arijith .
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 Arijit.. Very good document.it helps me..
Good queastion @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.
How to show the custom meesage after login into BI LaunchPad
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.
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)
Because in BO/Dataservices i cannot do step 3 - folder doesn't exists
Anyone else try to put a password reset link on their webpage?
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 ?
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
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?
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 idea
If it is a static link, then you can easily include it using <a href=...> tag.
Do you know in which file/folder is the Logon on dataservices? to put the code
For DS, I didn't try it. I thought you were asking about BI Launchpad.
Yes Bi Launchapd of Data services
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).
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?
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.
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.
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.
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?
can you share the custom.jsp you created?
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!
Thanks for letting us know and well done!
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?
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.
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.
This will not work in case of sso as you are bypassing the screen to enter login credentials.
Is there any way to get custom pop-up message in case of SSO, before displaying the homepage?
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.
check if it helps:
Customize error messages in OpenDocument URL
Thank you for sharing this info. Did you ever tried adding a customized text for Inforamtion Steward logon page? Could yo please help me.
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.
create a page without alert message and configure url.exit parameter in BIlaunchpad.properties to display the page without alert on logoff.
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.
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 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.
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
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?
Did you manage to do this please ?
I am in the same situation at the moment.
Did you manage to get this in 4.2 SP4?
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!
Thank you Former Member
nice post. How can we achieve this in 4.2 SP4?
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?
For old BI Launchpad login screen, the same trick mentioned for BO 4.1 should work.
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?
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.
I missed that. It is working now.
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
Please tell me the BI Platform version you are using. Are you using the new fiorified launchpad ?
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.
I would suggest to post it as a question.
Just did. Thanks
This worked great on 4.1 to display a notice to users that we were moving to a new link, thanks!