Bookshelf Home | Contents | Index | Search | PDF

Product Administration Guide > Customizable Product Web Templates >

Modifying the Display Name of the Customizable Product

---

This section explains how to modify the customizable product name in the base theme. The base theme defines the basic page container within which the product theme displays. The base theme includes a header that contains the customizable product name that is stored in the Siebel database. You can define a UI property that changes the name of the customizable product or adds artwork or other formatting.

To change the name of the customizable product in a base theme, you insert a variable in the base theme Web template. This variable tells the Web Engine to get the item name from a defined UI property rather than using the customizable product name.

Here is the process for changing the display name of the customizable product:

Create a new base theme template. You do this by saving a copy of the base theme template. Then you insert a variable name in the new template.
Assign the new base theme template to the customizable product.
Define a UI property for the customizable product. This value is what displays in the selection pages.

Create a New Base Theme Template

You must create a new Web template to customize the display name of the customizable product. You do this by copying an existing base theme template. Then you insert a UI property variable into the copy. Finally, you assign the new Web template as the base theme for the customizable product

To insert a UI property variable into a base theme Web template, you must locate the swe:control element that governs the display of the customizable product name. The base themes have the same basic layout:

The first <Table> tag creates the page container. Additional <Table> tags stack one on top of another to partition the page vertically.
There are no swe:for-each loops in the template.
Near the top of the file, refer to the first <table> tag. Within the table definition, locate the "Product Title" comment. Below the comment locate the first swe:control element.
One of the attributes of this element is CfgFieldName = "CxObjName".
Replace CxObjName with the name of the UI Property variable. The name must be preceded with a period (.). For example: ".NewProductName".

To create a new base theme template

Navigate to Product Administration.
Select and lock the desired customizable product.
In the Work Space record, click the select button in the Base Theme field and open the dialog box.
In the Pick UI Style dialog box, write down the filename of the base theme.

The filename is shown in the Template field. The filename ends in .swt.

Open the Web template in a text editor and save it to a new filename.

The Web templates are located in <install-dir>\webtempl (NT path syntax), where <install-dir> is the path to the Siebel installation directory. The new filename must end in .swt.

In the new template, locate the swe.control element containing the CfgFieldName= "CxObjName" attribute.
Replace "CxObjName" with a UI property variable name and save the file.

The variable name must begin with a period (.). For example: ".NewProductName". Verify that the variable name is enclosed in quotes.

Assign the New Base Theme Template

To assign the new base theme template to the customizable product, you first add the template to the Pick UI Style dialog box. Then you select it as the base theme.

To assign the new base theme template to the customizable product

In the customizable product Work Space record, click the select button in the Base Theme field and open the dialog box.

The Pick UI Style dialog box appears.

In the dialog box, click New and fill out the form for adding a new template and click OK.
Name: Enter a descriptive name. For example: Modified Base Theme.
Template: Enter the filename of the template you created.
Description (Optional): Enter a brief description of the template.
In the Pick UI Style dialog box, click the template you added and click OK.

This assigns the new base theme template to the customizable product.

Define a UI Property for the Customizable Product

The last step is to define a UI property for all the customizable product.

To define a UI property for the customizable product

Open the Customizable Product Show menu and choose User Interface Property Designer.
The User Interface Property Designer view appears.
In the box displaying the contents of the customizable product, click the name of the customizable product. It is the first item listed.
In Item Display Properties, click New.

A new record appears.

Fill out the record.
Name. Enter the name of the UI property variable you entered in the base theme template. Do not include the period (.) that begins the name.
Value. Enter the customizable product name you want to display. Include any HTML formatting needed.
Save the new record.
Open the Item Display Properties menu and click Validate.

This starts a configuration session. Verify that the customizable product display name is correct.

Bookshelf Home | Contents | Index | Search | PDF