NOTE: The techniques described here also work with SAP BusinessObjects Business Intelligence 4.2.
SAP BusinessObjects Business Intelligence 4.1 went into general availability on August 29, 2013 (see related EV Technologies article, SAP BusinessObjects BI 4.1 Now in General Availability). In addition to combining fixes from previous releases and introducing new features and platform support, there were some minor changes in how the BI Launchpad can be customized. I’ll walk through the changes in the properties file in this article and address the CSS customization features introduced in SAP BusinessObjects BI 4.0 Support Pack 4 in a future article.
Apache Tomcat 7
The first thing to notice about SAP BusinessObjects Business Intelligence 4.1 is that it installs Apache Tomcat 7 as the default web application server in place of Apache Tomcat 6 (SAP BusinessObjects BI 4.2 uses Tomcat 8). For upgrades to earlier versions, the installer will leave the Apache 6 files at
C:\Program Files (x86)\SAP BusinessObjects\Tomcat6 and install Apache Tomcat 7 in the adjacent
C:\Program Files (x86)\SAP BusinessObjects\tomcat.
Starting with BI 4.0, SAP uses properties files that can be easily changed using a text editor instead of the XML files used by XI 3.1. These files can be preserved during patch updates by following some simple steps.
The default location for properties files is the
C:\Program Files (x86)\SAP BusinessObjects\tomcat\webapps\BOE\WEB-INF\config\default directory. To modify properties from their defaults, copy the desired properties file from the default directory to the adjacent custom directory, which is
C:\Program Files (x86)\SAP BusinessObjects\tomcat\webapps\BOE\WEB-INF\config\custom. To make sure your changes are preserved and not lost the next time the WAR files are deployed (typically during patch upgrades), be sure to follow SAP Note 1615492 and copy the custom files to
SAP BusinessObjects Enterprise XI 4.0\warfiles\webapps\BOE\WEB-INF\config.
Customizing the BI Launchpad Login Page
The new BI 4.1 BI Launch Pad login has been streamlined in appearance from earlier versions. Long-time fans of the BusinessObjects brand will notice that the SAP BusinessObjects logo has disappeared in favor of the SAP logo (see related article, First Impressions of SAP BusinessObjects 4.1). In fact, the only mention of “BusinessObjects” is in a text string that we’re about to customize.
In addition to the existing
app.name.greeting properties from previous releases, BI 4.1 introduces a new property,
app.custom.product.name. It’s left unspecified but currently defaults to SAP BusinessObjects, which appears on the first line of the logon screen. The
app.name.short parameter is also unspecified but defaults to BI Launch pad. The
app.name property is not used on the login screen but instead is used for the <TITLE> of all interior pages of the BI Launch pad.
To customize the properties file, do not modify the original but instead copy it to adjacent directory
C:\Program Files (x86)\SAP Business Objects\tomcat\webapps\BOE\WEB-INF\config\custom. I’ve shown the modifications below.After restarting Apache Tomcat, I can see the result of my customizations.
Once I log in, I can see the effect of the
The rest of the customizations such as system name and authentication type are identical to previous versions.
Adding or changing Favicons
If you want to dress up your users’ browser with a favicon, overwrite the standard Tomcat favicon.ico file with your own at
<INSTALLDIR>/tomcat/webapps/ROOT then restart Tomcat.
There are unique icons for the BI Launchpad, Central Management Console (CMC), and Explorer. I like to replace the BI Launchpad and Explorer favicons. I prefer to leave the CMC favicon as-is, as only a few people see it and it’s easier to find when multiple browser tabs are in use.
Place new InfoView.ico in
C:Program Files (x86)\SAP BusinessObjects\tomcat\webapps\BOE\WEB-INF\eclips\plugins\webpath.InfoViewwebimages. Place new explorer.ico in
C:Program Files (x86)\SAP BusinessObjects\tomcat\webapps\explorer.
Be sure to clear Tomcat cache
C:\Program Files (x86)\SAP BusinessObjects\tomcat\work\Catalina\localhost before restarting.
NOTE: The favicon can now be set as part of the BI Launch Pad branding kit. See Christina Obry’s article Branding and Theming of BI launch pad for details.
Changing the Default Web Intelligence Paper Size
When SAP BusinessObjects Business Intelligence 4.1 is initially installed, the default page size is A4. This international standard (see Wikipedia) is used nearly around the world but is not the same as the standard Letter size used in the United States and Canada.
Prior to BI 4.0, the default paper size was set in a file named defaultconfig.xml. But BI 4.x no longer uses this file to define default paper size. Instead, Web Intelligence now derives attributes like page size, header size, footer size, and margins from a Cascading Style Sheet (CSS), not the old XML configuration file. The procedure for changing the default paper size from A4 to Letter can be found on this article I wrote for the EV Technologies blog.
NOTE: Existing reports will still have the page size set when the document was saved; however, this modification will change the default page size setting for all new documents.
SAP BusinessObjects Business Intelligence 4.1 Launch Pad Default Preferences
So that explains the mechanics of customization. But how to use it practically? Use the upgrade as an opportunity to educate your customers about your brand (see related article, Business Intelligence Branding). Don’t lose sleep over retraining users that the InfoView portal has been renamed as the BI Launch pad. Or wondering if and when SAP will finally pull the plug on the BusinessObjects brand.
I’m sure I’ll have more to share about BI 4.1 as I begin working daily with the new release. And I hope to write soon about using the CSS customization features recently introduced in BI 4.0 SP4. In the meantime, Christine Obry has provided some great information on the SAP Community Network and you can find the links below.
- Christina Obry from SAP has written some excellent tutorials on the SAP Community Network, including some new capabilities added inBI4SP4 and higher:
- How to display custom message in BI Launchpad Login page by Arijit Das on SAP Community Network (added 10/15/2015)
- SAP BusinessObjects BI Customization Guide for BI4.1 SAP Help Portal
- Changing the Web Intelligence 4.0/4.1 Default Paper Size on the EV Technologies blog
- SAP Note 1757730 and SAP Note 1733830 working with BILaunchpad.properties
- SAP Note 1586824 or SAP Note 1659690 Two different approaches for adding company logo to BI Launchpad login page (requires S-ID)
- SAP KB 1821519 – Setting default system and authentication type for Web Intelligence Rich Client
- Using SAP BusinessObjects BI 4.0? Check out an older version of this article written specifically for that release.
- Using SAP BusinessObjects Enterprise XI 3.1? Check out an older version of this article written specifically for that release.
- SAP KB 1218598 – Support policy on customizing SAP BusinessObjects InfoView, BI Launch Pad, and other applications (added 11/25/2014)
- SAP KB 1586824 – How to create a custom JSP logon page for SAP BusinessObjects BI4 (added 01/05/2015)