BI Tools

Tips and tricks for building information maps, OLAP cubes, reports, and dashboards

BI Admin

Learn your way around a SAS BI installation.

Visual Analytics

Learn your way around the SAS Visual Analytics tool

Coding & Data

Extract, transform, and load your data into the SAS BI toolset

Stored Processes

Create and design stored processes like a rock star

Home » BI Tools

SAS Portal and BI Dashboard: Customizing the Tabs

Submitted by on 2012-09-27 – 9:15 AM

You can customize the SAS Portal and SAS BI Dashboard Web Browser titles in just a few moments. Here’s another branding trick that Kushal Ramani sent to me.  He also sent some these branding tricks for Web Report Studio and SAS Portal.  For this example, you are updating the tab associated with the tool.  I used the word “Fancy” in all of these so I could easily see the changes.

Add Branding to SAS BI Toolset

Updating the JSP Files

Note: I’m using JBoss installed on a Windows7 server with my SAS BI 9.3 installation. All of my paths are based on that environment.  Contact SAS Technical Support if you need help locating the files associated with other environments.

To make changes to the browser tab, you need to update the associated JavaServer Pages (JSP) files that are found in the JBoss directory.  For this example, let’s change the SAS BI Dashboard tab.  We will change the one that appears when the BI Dashboard appears and not the one use when you are editing the dashboard.  If you do not have access to the server, you may need to enlist your SAS Administrator’s help.  Also – this does change it for everyone.   

  1. Stop the Web Application Server (JBoss) from the Windows Services.
  2. Navigate to the C:\jboss-4.2.3.GA\server\SASServer1\deploy_sas directory.

    Here’s the path and file you need change based on what you want to do:

    • Portal Tab 
      • Path: <see step 2>\sas.portal4.3.ear\sas.portal.war\jsp\html\portal
      • File: HeadInclude.jsp
    • Dashboard Builder Window 
      (Called Fancy BI Title in the artwork above)
      • Path: <see step 2>\sas.bidashboard4.3.ear\sas.bidashboard.war\DashboardBuilder
      • File: Index.jsp
    • Dashboard Runtime 
      (Called Fancy Fancy Title in the artwork above)
      • Path: <see step 2>\sas.bidashboard4.3.ear\sas.bidashboard.war\DashboardRuntime
      • File: Index.jsp
  3. Make a copy of the JSP  file and place it in the same directory.  This way you have a back up if you make unintended changes.
  4. Edit the Index.jspfile from the Dashboard Runtime sub-directory. 

    You need to find this line in the code:  <title><%=title%></title> and replace the <%=title%> with what you want it to say, as shown in the following figure.


  5. Save the file.  Repeat steps 4 and 5 for the other files shown in step 3 if desired.
  6. Restart the JBoss service.  
  7. Open BI Dashboard to see your new fancy title.  Boom!


Learn all about SAS BI

You can learn more about SAS Business Intelligence from the "SAS BI Bible." Take a peek inside the Building Business Intelligience with SAS book.

The following two tabs change content below.

Tricia Aanderud

Director of Data Visualization at Zencos Consulting
Tricia Aanderud is a SAS Business Intelligence and Visual Analytics consultant based in Raleigh, NC who works for Zencos Consulting. She has written several books about SAS, presented papers at many SAS conferences, and has been using SAS since 2001. Contact her for assistance with your next project.
Spread the love