WebSphere Commerce EnterpriseWebSphere Commerce Professional

Declaring a control

The layout of the IBM Sales Center dialogs and editors are constructed using configured controls. A configured control is a user interface element that is declared using the controls extension point. The definition of a configured control includes a unique identifier, the type of control, and additional attributes and properties that are specific to the type of control being defined. The control type is used to locate a control factory class that will construct the new configured control. This section explains how to declare a control.

About this task

The definition of a control contains the properties of the control. For example:

<control 
    id="logonUserNameField" 
    type="text" 
    required="true" 
    tooltip="LogonDialog.usernameTooltip" 
    managerType="operatorLogon"> 
<property name="fieldType" value="username"/> 
</control>

Procedure

  1. Create a new plug-in to use for your extensions.
  2. In the plugin.xml, declare the control using the com.ibm.commerce.telesales.widgets.controls extension point.
  3. Declare a composite definition to contain your control. Once a control is declared it must be included in one or more composite definitions before it will appear as part of the user interface.

Results

Note: When a control is constructed, the declared attributes and properties will be passed to the appropriate control factory as determined by the control type. The properties will also be available to the widget manager associated with the use of the control.