WebSphere Commerce EnterpriseWebSphere Commerce Professional

controlFactories

The com.ibm.commerce.telesales.widgets.controlFactories extension point is used to declare control factories for use in the IBM Sales Center user interface. Control factories are responsible for interpreting control declarations and constructing new configured control instances.

Identifier:

com.ibm.commerce.telesales.widgets.controlFactories

Description:

The com.ibm.commerce.telesales.widgets.controlFactories extension point is used to declare control factories for use in the IBM Sales Center user interface. Control factories are responsible for interpreting control declarations and constructing new configured control instances.

Configuration Markup:

<!ELEMENT extension ( controlFactory+)>

<!ATTLIST extension

point CDATA #REQUIRED

id CDATA #IMPLIED

name CDATA #IMPLIED>

  • point - The fully qualified identifier of the target extension point.
  • id - An optional identifier for the target extension point.
  • name - An optional name for the extension instance.

<!ELEMENT controlFactory EMPTY>

<!ATTLIST controlFactory

id CDATA #REQUIRED

factoryClass CDATA #REQUIRED

controlType CDATA #REQUIRED>

This element is used to describe configured control factories.

  • id - Unique identifier for this control factory declaration. Use this identifier to refer to this control factory.
  • factoryClass - The factory class must have a default (no-argument) constructor, and must implement interface com.ibm.commerce.telesales.widgets.controls.IControlDescriptorFactory.
  • controlType - Control type. Control declarations that specify this type will be delegated to this control factory. Refer to the type attribute of the com.ibm.commerce.telesales.widgets.controls extension point.

Examples:


   
 <extension point=
 "com.ibm.commerce.telesales.widgets.controlFactories"
 >
      
 <controlFactory id=
 "com.ibm.commerce.telesales.widgets.readOnlyTextControlFactory"
 
                     factoryClass=
 "com.ibm.commerce.telesales.widgets.controls.ReadOnlyTextControlDescriptorFactory"
 
                     controlType=
 "readOnlyText"
 />
      
 <controlFactory id=
 "com.ibm.commerce.telesales.widgets.textControlFactory"
 
                     factoryClass=
 "com.ibm.commerce.telesales.widgets.controls.TextControlDescriptorFactory"
 
                     controlType=
 "text"
 />
      
 <controlFactory id=
 "com.ibm.commerce.telesales.widgets.labelControlFactory"
 
                     factoryClass=
 "com.ibm.commerce.telesales.widgets.controls.LabelControlDescriptorFactory"
 
                     controlType=
 "label"
 />
      
 <controlFactory id=
 "com.ibm.commerce.telesales.widgets.requiredLabelControlFactory"
 
                     factoryClass=
 "com.ibm.commerce.telesales.widgets.controls.RequiredLabelControlDescriptorFactory"
 
                     controlType=
 "requiredLabel"
 />
      
 <controlFactory id=
 "com.ibm.commerce.telesales.widgets.comboControlFactory"
 
                     factoryClass=
 "com.ibm.commerce.telesales.widgets.controls.ComboControlDescriptorFactory"
 
                     controlType=
 "combo"
 />
      
 <controlFactory id=
 "com.ibm.commerce.telesales.widgets.buttonControlFactory"
 
                     factoryClass=
 "com.ibm.commerce.telesales.widgets.controls.PushButtonControlDescriptorFactory"
 
                     controlType=
 "pushButton"
 />
      
 <controlFactory id=
 "com.ibm.commerce.telesales.widgets.checkBoxControlFactory"
 
                     factoryClass=
 "com.ibm.commerce.telesales.widgets.controls.CheckBoxControlDescriptorFactory"
 
                     controlType=
 "checkBox"
 />
      
 <controlFactory id=
 "com.ibm.commerce.telesales.widgets.radioButtonControlFactory"
 
                     factoryClass=
 "com.ibm.commerce.telesales.widgets.controls.RadioButtonControlDescriptorFactory"
 
                     controlType=
 "radioButton"
 />
   
 </extension>

API Information:

Control factories must implement

com.ibm.commerce.telesales.widgets.controls.IControlDescriptorFactory

and create concrete instances of classes that subclass

com.ibm.commerce.telesales.widgets.controls.ControlDescriptor

.

Supplied Implementation:

Control factories with the following types have been defined in the

com.ibm.commerce.telesales.widgets

plug-in. Refer to the Javadoc documentation for the implementation class to learn more about the behavior and supported properties.

  • label - creates label controls.
  • requiredLabel - creates required label controls. Required labels should be used when one or more of the fields being labeled is not optional.
  • readOnlyText - creates read only text field.
  • text - creates a text entry field.
  • textarea - creates a multi-line text entry field.
  • combo - creates a drop down combo box.
  • list - creates a list box.
  • pushButton - creates a push button.
  • radioButton - creates a radio button.
  • checkBox - creates a check box.
  • table - creates a table.
  • tableTree - creates a table tree.
  • tableList - creates a table list.
  • composite - creates a composite.
  • group - creates a group composite.
  • scrolledComposite - creates a scrolled composite.
  • expandableComposite - creates an expandable composite.
  • tabFolder - creates a tab folder.
  • separator - creates a separator control.