Sun Java logo     Previous      Contents      Index      Next     

Sun logo
Sun Java System Communications Express 6 2004Q2 Customization Guide 

Chapter 9
Customizing Communications Express for a Specific Domain

Communications Express allows you to customize all the three components namely Mail, Calendar and Address Book for a specific domain. The sections contained in this chapter are,

Customizing Calendar for a Specific Domain

Customizing Calendar for a Specific Domain

The default user options that will be used for a first-time user can be configured on a per-domain basis. This means that it can exist under each domain directory. All these option values can be configured in the file.

When the user customizes a common component, then the changes will be reflected in all corresponding parent views.

Calendar can be configured and customized at two levels namely,

a) Configuring Domain Preferences

The default domain preferences for Communications Express are stored in the which is located in <domain-dir>/domain directory. If you need to set separate preferences for each domain, you need to do the following.

  1. Create a directory with the name same as the domain name in <domain-dir>/domain directory
  2. Copy file from <domain-dir>/domain directory to the newly created directory and make the required edits.
  3. Restart the web server to apply changes

b) Changing the skin under themes at the domain level

  1. Create a directory with the name same as the domain name in <domain-dir>/domain directory.
  2. Copy file from <domain-dir>/domain directory to the newly created directory and make the following change uwc-user-attr-sunUCTheme=<name of the theme>
  3. Restart the web server to apply the changes

Customizing Mail for a Specific Domain

This section describes how to customize the Communications Express client interface for each domain.

To add or change a new domain name, open the default.html file

Code Example 9-1 shows the default code before changing or adding a new domain name.

Code Example 9-1  Default code before addition or modification of a new domain name

<<select name="server">> <option>

<option value="">&lt;-- Select Here --&gt;</option>


Code Example 9-2 shows the change in code to change the domain to

Code Example 9-2  Code for Changing Domains from domain to


<option value=""> </option>

Code Example 9-3 shows how to add domain along with

Code Example 9-3  Adding the domain with


<option value=""> </option>

You can perform the following tasks to customize the client interface:

Table 9-2  Linking Multiple Domains to few distinct brands




// default interface


// customized interface for brand 1

html/ ->

// default interface

Domain From URL

The server listens to all IP addresses and presents a customized interface before the authentication occurs. The server does this by looking at the URL and determines if it contains a known domain and presents the per domain Login screen for the domain.

For example, for the per domain Login screen:, the server presents the page from the location: html/

In this case a user does not have to suffix @domain to the username to login.

Customizing Address Book for a Specific Domain and a Locale

In address book, all UI related source files (xml/xsl) are located under <uwcinstall>/WEB-INF/ui/html/abs directory by default. To customize the UI for a domain, follow these steps.

  1. Create a directory with a domain name, (e.g. under <uwcinstall>/WEB-INF/ui/html.
  2. Copy all files from <uwcinstall>/WEB-INF/ui/html/abs to<uwcinstall>/WEB-INF/ui/html/<domain>.
  3. Make the required changes in XSL files as explained in the previous sections.

Although all images are located under <uwcinstall>/absimx by default, you may create a directory with a domain name (e.g. <uwcinstall/absimx/ under it and include the icons that are customizable under the newly created domain directory. Also ensure that the path reference to the newly created directory is updated in <uwcinstall>/WEB-INF/ui/html/<domain> search-images.xsl and commonimages.xsl.

Previous      Contents      Index      Next     

Copyright 2004 Sun Microsystems, Inc. All rights reserved.