Checkboxes, Radio Buttons, and Combo Boxes 

Use

Checkboxes, radio buttons, and combo boxes allow you to make a selection from a set of prescribed options in a creation form.

 

Features

Checkbox

A checkbox can be in two states: Selected (checked) or not selected.

The system writes a value to the referenced schema element or referenced document property depending on whether or not the checkbox is selected. You can reference schema elements or document properties that have the data type Boolean (see Data Types of Schema Elements).

 

Important properties of the checkbox control

Property	Description
Caption	Text displayed next to the checkbox.
Value	Value stored in the referenced schema element or in the referenced document property if the checkbox is selected.
Unchecked Value	Value stored in the referenced schema element or the referenced document property if the checkbox is not selected.

 

Radio Buttons

Radio buttons allow a single option to be selected from a group of options.

You use a single schema element or single document property for a group of radio buttons. You create a reference to this schema element or document property for each radio button. When you save the creation form, the system stores the value of the selected radio button in the XML file or in the document property.

 

Important properties of the radio button control

Property	Description
Caption	Text displayed next to the radio button.
Value	Value stored in the referenced schema element or in the referenced document property if the checkbox is selected.

 

Combo Boxes

A combo box allows you to select an entry from a dropdown list. There are static and dynamic combo boxes.

 

Static combo boxes

A combo box is static in the following cases:

·        It references a schema element

·        It references a document property for which no value set is defined in the configuration

You define list entries in the XML Forms Builder. The system creates three list entries by default. You can use the secondary mouse button to create, change, and delete list entries in the tree view of a control.

Important properties of list entries in a static combo box

Property	Description
Caption	Text displayed in the dropdown list.
Value	Value stored in the referenced schema element or referenced document property if the list entry is selected. Create a separate value for each list entry of a combo box.

 

Dynamic combo boxes

A combo box is dynamic if it references a document property for which a value set is defined in the configuration (System Administration ® System Configuration ® Content Management ® Global Services ® Property Metadata ® Properties ® Parameter Allowed Values).

At runtime (when you open the creation form) the system reads these values from the configuration and displays them in the dropdown list.

 

If you link a combo box for which list entries already exist to a document property with a value set, the system asks whether you want to delete the list entries. We recommend that you accept this suggestion and delete the list entries from the XML Forms Builder. Otherwise inconsistencies could arise between the entries in the XML Forms Builder and the value set in the configuration. This can cause errors when saving.