Configure IBM Cognos Connection to Use a Custom Welcome Page

You configure IBM® Cognos® Connection to use a custom Welcome page by adding the welcomeURLOverride parameter to the system.xml file located in the c10_location/templates/ps/portal directory.

The welcomeURLOverride parameter overrides the default Welcome page URL. Depending on the location of the custom Welcome page, the URL can be specified as a relative or absolute path.

Note: The path names are case sensitive on UNIX operating system.

If you want to implement a custom Welcome page that is style and locale-sensitive, the page URL must use the exposed replacement parameters for the locale and style. The parameters are %LOCALE% and %STYLE%. When the URL is processed, %LOCALE% is replaced by the product locale, and%STYLE% is replaced by the user's currently selected style.

For example, if the product language is English and the style is Corporate, the welcomeURLOverride parameter is as follows:

<param name=
"welcomeURLOverride">/ibmcognos/my_welcome/%LOCLAE%/%STYLE%/customwel.htm
<param>

When the URL is processed, the %LOCALE% parameter is replaced with en, and the %STYLE% parameter is replaced with Corporate. The URL for this example is as follows:

/ibmcognos/my_welcome/en/Corporate/customwel.htm

If the product locale were set to French and the style to Classic, the URL would be as follows:

/ibmcognos/my_welcome/fr/Classic/customwel.htm

Procedure

From the c10_location/templates/ps/portal directory, open the system.xml file.
Add the welcomeURLOverride parameter to the file, where customwel.htm is the custom Welcome page.
If you use a relative path, the syntax is:
```
<
param name="welcomeURLOverride">/ibmcognos/customwel.htm
</param>
```
If you use an absolute path, the syntax is:
```
<param name="welcomeURLOverride">http://.../customwel.htm
</param>
```
If your Welcome page supports different locales and styles and you use a relative path, the syntax is:
```
<
param name="welcomeURLOverride">
/ibmcognos/my_welcome/%LOCALE%/%STYLE%/customwel.htm
<param>
```
Save and close the system.xml file.
Refresh IBM Cognos Connection.