Siebel Product Administration Guide > Siebel Configurator UI Properties >

About Predefined UI Properties


Table 14 shows the predefined UI properties that you can use. These UI properties provide commonly desired ways to modify the display of items. You do not need to insert a variable name for these properties into a customizable product Web template. You only need to assign them to the desired item in the Properties view.

Table 14. Predefined UI Properties
Property Name
Value
Description

Excluded

Y

Can only be defined on a relationship or on the product root. Cannot be defined on products within a relationship

When defined on a relationship, prevents all excluded items in the relationship from displaying.

If an item in a relationship is a product with components, does not prevent display of excluded products within that product with components.

When defined on the product root, prevents excluded items from displaying throughout the product.

Hide

 

Y or N

When set to Y for any relationship, product or attribute, this value causes that item to be omitted from the UI selection pages during customization.

This UI property is very useful with class-products. For child products in the class, you can hide portions of the product structure inherited from the class-product. This allows you to define the class-product structure and then tailor its display for each of the child products that inherit the structure.

Can be defined on any part of a customizable product structure, shown on the left-hand side of the tree view that displays in the UI Properties administration view. Acts at the UI level, so if you add this UI property to hide the values that are selected in the existing quotes it does not remove these values from the structure, but only changes the display.

NOTE:  This property hides the item statically, so it remains hidden. You hide products dynamically using a different property, described in Creating Dynamic Siebel Configurator User Interface Controls.

Description

Enter a text string.

Define on relationships only.

Enter the text exactly as it will display to the user.

Image

Images/<filename>

Define on relationships only.

The image displays on the right side of relationship header. The image is displayed full size.

LearnMore

Enter the full URL to the desired location

Use with relationships only. Do not use with component products, resources, attributes, or links.

The words "Learn More" are displayed adjacent to the item and are a hyperlink to the URL you enter.

ProductHeaderImage

Images/<filename>

Define on product root only.

Displays an image of the root product on every selection page. Image displays beneath item header, to the left of item labels. The default image area is 120x120 pixels square. Can only be defined on product root.

FullComputation

Y

When set to Y (Yes) and user makes an attribute selection, Siebel Configurator engine updates the selection state of all the attribute values so that only selectable values are displayed. For example, if one of the values is excluded, it displays unavailable. Can cause performance reduction. This is the default.

When set to N (No), the Siebel Configurator engine does not update the selection state of the other attribute values and displays all the values as selectable. For example, if one of the values is excluded, it does not display unavailable. If user selects an excluded value, they receive a conflict message.

Use this UI property when display of the selection state of attribute values is required.

Define on attributes with LOV domains only.

Resource

Y

Define on attributes only. When this property is set, the attribute value will be treated as engine picked, which works similar to a resource. This property is commonly used when an attribute is used as a counter that will not be changed directly by a user and that will be recalculated every time regardless what previous value or state is.

Default Group

The name of a valid group

This property specifies the default group loaded in the grandchild display.

Grandchild Enabled

Y

Define this property at the appropriate attribute group item level in order to show attributes in line with products in the grandchild display.

Grandchild Type

combo, text, radio

Define this property at the appropriate attribute group item level in order to show attribute in line with products in the grandchild display. This property specifies the type of attribute user-interface control to load.

MultiChildrenPort[N]

 

This property is used by the CP UI service. It lets the UI service know that before presenting a given group or the CP itself, the UI service needs to fetch more details about the user property value and relationship.

You can define this at the root level or at each group level for multiple relationships (Name: MultiChildrenPort, Value: Intrastate, Name: MultiChildrenPort1, Value: USA, Name: MultiChildrenPort2, Value: Canada, Name: MultiChildrenPort3, Value: Extended and so on, where Intrastate, USA, Canada, Extended are relationship names within the CP.

You would need to define this for each CP UI definitions. If you customize the OOTB template and add .swt template code to access child component information (attribute or relationship products) then you should define the root item as a multi children port. This is needed because the UICache used, may not contain the complete information needed for the UI (obsolete or not cached UI information such as accessing all attribute values of all products in the group item).

The disadvantage of using this is that there will be performance penalty if the total relationship domains affected by these user properties are large. If you use this user property several times, remember to give them names such as MultiChildrenPort, MultiChildrenPort1, MultiChildrenPort2 and so on. (You cannot use MultiChildrenPort0.)

MatchNewItemsInSolution

Y

When recustomizing an existing product, it is sometimes possible to remove an item that might be required based on a constraint. This results in the original instance of the item being deleted and a new instance being added (due to the constraint). This result might not always be the desired behavior.

To retain the original instance in this case, set the property MatchNewItemsInSolution to Y on the root customizable product definition.

Grandchild Sequence

An integer greater than 0

This property is used to sort the grandchild attributes for display. Use it with the Grandchild Enabled property.

Configure the UI properties for all attributes with the names Grandchild Sequence and with the values as integers representing the sequence numbers. In the user interface, the attributes are shown in ascending order of the sequence set, using this UI property.

NOTE:  For external images, the image must be stored in the Siebel installation directory in \Public\enu\Images\<filename>, where <filename> is the name of the file.

Siebel Product Administration Guide Copyright © 2010, Oracle and/or its affiliates. All rights reserved. Legal Notices.