An explanation of logos and banner text displayed on the main Service Desk Web Interface

Document ID : KB000010802
Last Modified Date : 14/02/2018
Show Technical Document Details
Introduction:

Consider the following two portions of the Service Desk interface:

Main login page:

org-login.png

Upper left display of the Service Desk web interface.

org-main.png

A common question is how to change the logo and banner text that are circled in red above.

Instructions:

Modifying the banner text:

The simplest way to do this is to go into the CA Service Desk (CA SDM) server's NX.env file.  In the file, you will find a variable @NX_INSTALL_OPTION.  This variable controls the banner text and will affect both the login page and any other pages that would display this text in the upper left corner of the CA SDM interface.

Modifying the graphical logo icons

This is a slightly more complicated answer.  There are two different icon graphic files to consider:

  • circleca.png:  This file appears on all of the pages that you would navigate within the application.

  • CAT_logo_53_trans.png:  This graphic appears only on the Login page

Out of box, these are the graphical specifications of each file

CAT_logo_53_trans.png:
Format:  PNG
Dimensions:  53 x 44 pixels
Other:  Transparent Background

circleca.png
Format:  PNG
Dimensions:  44 x 36 pixels

If you are alright with applying a global change across all parts of CA SDM uniformly, it is a simple manner of creating a custom CAT_logo_53_trans.png and circleca.png file in the CA SDM install's NX_ROOT\site\mods\www\wwwroot\img, then recycling the CA SDM service to apply the changes.

Following these two concepts, we change in the NX.env (located in the CA SDM install directory)

@NX_INSTALL_OPTION=My Company

In the CA SDM install directory's NX_ROOT\site\mods\www\wwwroot\img directory, we add custom versions of the CAT_logo_53_trans.png and circleca.png files.  In this example we modified the originals to have different colored backgrounds (CAT_logo_53_trans.png has a red background, circleca.png has a black background).

We then recycle the CA SDM Services.

The login display now looks like:
mod-login.png

Upon login, this is what the main page looks like:

mod-main.png

If you need a custom graphical image per form:

CAT_logo_53_trans.png is referenced only in the following file:


NX_ROOT\bopcfg\www\htmpl\default\login.htmpl

circleca.png is referenced in the following files:


NX_ROOT\bopcfg\www\htmpl\default\ahdtop.htmpl
NX_ROOT\bopcfg\www\htmpl\default\do_svy.htmpl
NX_ROOT\bopcfg\www\htmpl\default\load_cache.htmpl
NX_ROOT\bopcfg\www\htmpl\default\session_refused.htmpl
NX_ROOT\bopcfg\www\htmpl\default\svy_thanks.htmpl
NX_ROOT\bopcfg\www\htmpl\default\view_svy.htmpl
NX_ROOT\bopcfg\www\htmpl\pda\analyst\pda_logo.htmpl

In any event, you would need to create a custom version of the above files and wherever the given file described above is referenced, replace the reference with your own custom image file, stored in the NX_ROOT\site\mods\www\wwwroot\img directory.

Other graphical elements that include product branding:

The following files, which are highlighted, are files that exist in the NX_ROOT\bopcfg directory and may also be replaced as needed by having custom corresponding files retained in NX_ROOT\site\mods:

calogoHorizontal.png is referenced in files:

NX_ROOT\bopcfg\www\htmpl\default\load_cache.htmpl

ca_logo_h.gif is referenced in files:

NX_ROOT\bopcfg\www\htmpl\default\load_cache.htmpl

ca_logo_pda.gif is referenced in files:

NX_ROOT\bopcfg\www\htmpl\default\load_cache.htmpl

product_banner.png is referenced in files:

NX_ROOT\bopcfg\www\htmpl\default\kt_document_view_simple.htmpl
NX_ROOT\bopcfg\www\htmpl\web\customer\std_header.htmpl
NX_ROOT\bopcfg\www\htmpl\web\employee\std_header.htmpl

Additional Information:

IMPORTANT:  Never copy custom files directly to the NX_ROOT\bopcfg directory.  All custom materials should be placed within NX_ROOT\site\mods.