Example - Change the Branding Details in the IBM Cognos Connection Main Header

You can customize the IBM® Cognos® Connection main header by changing the branding details on the left-hand side.

You can change the graphic, the title, and the background color. This change also affects IBM Cognos Viewer, but not IBM Cognos Administration.

The branding details are defined by the OEM parameter in the portal system.xml file. You must modify this file.

Copy the image files that you want to use to the c10_location/webcontent/skins/skin_name/branding directory.

Procedure

  1. Open the system.xml file in an XML editor.

    This file is located in the c10_location/templates/ps/portal directory.

  2. Locate the OEM parameter and add the custom branding details as specified in the following code.

    The sequence in bold font must be repeated for each style in which you want this change to appear.

    <param name="OEM"> 
      <customHeader showContext="true" contextDelimiter="-"> 
       <style styleFolderName="corporate"> 
    <!--Insert well-formedHTMLhere -->
    </style> 
        <style styleFolderName="classic"> 
        </style> 
            ...
      </customHeader> 
    </param>

    Setting the showContext attribute to true adds a report or a page name to the title. The contextDelimiter attribute, which can be represented by any character or sequence of characters, separates the title from the report or page name.

    Here is a code example for this change:

    <customHeader showContext="true" contextDelimiter="-
    ">
      <style styleFolderName="corporate">
       <table style="background-color:#ffffff"> 
        <tr>
         <td><img src="../skins/corporate/branding/my_logo.gif"/> 
         </td><td class="headerTitle" 
         style="padding-right:2px;white-space:nowrap">Mycompany</td> 
        </tr> 
       </table> 
      </style> 
      <style styleFolderName="classic"> 
       <table style="background-color:#cccccc"> 
        <tr>
         <td><img src="../skins/corporate/branding/my_logo.gif"/> 
          </td><td class="headerTitle" 
          style="padding-right:2px;white-space:nowrap">Mycompany
          </td> 
         </tr> 
       </table> 
     </style>
    </customHeader>
  3. Restart the IBM Cognos service.