Choice Control

1. Create a view.
2. Drag the control onto the canvas. You can find the control in the Input section of the Toolbox.
3. Add a data source to your control. To do this, configure the Type under the Data Source of the Properties.
4. Specify which type of display you want. To do this, configure the Display Type in the Display section of the Properties.
5. Configure the rest of the properties as necessary.
6. Run the view.

If you have a field that can be used in a drop-down list, check box list or radio button list, you can drag the field into the Choice control to bypass step 3 above.

Configuring a Data Source for the Control

When you click on the ellipsis next to Data Source > Type in the control's Properties, the Configure Data Source page opens. You can use a SmartObject or a static list of values.

Field	Description
Use a static list of values in the control	You can create a static list of items for the control. These values are stored as text in the K2 database. Select the option and then click the ellipsis next to List Items to configure your static list.
List Items	Click the ellipsis next to List Items to configure the list of static values for the control.
Use a SmartObject as data source	Select this option if you want to use a SmartObject as the data source.
SmartObject	Select the SmartObject that you want to use to populate the control. Click the ellipsis next to SmartObject to select the SmartObject.
Method	The method that you want to use to populate the control.
Value	The SmartObject property that you want to use as the value in the control.
Cache the data	Select this option if you want to cache the data which allows for client side filtering when used offline.
Default Value	The default SmartObject value to be used.
Show items from the selected SmartObject	Select this option if you want to show items from the parent SmartObject.
Display	The SmartObject property to display.
Show items from an associated SmartObject	Select this option if you want to show items from an associated SmartObject in the control.
Lookup SmartObject	An optional SmartObject that you want to use as the source of the display values. Click on the ellipsis to select the SmartObject.
Lookup Method	The method that you want to use to executed on the lookup SmartObject when retrieving the display values.
Source Join Property	The SmartObject property on the original SmartObject that is used to join the original SmartObject with the Lookup SmartObject.
Lookup Join Property	The SmartObject property on the lookup SmartObject that is used to join the original SmartObject with the Lookup SmartObject.
Display	The SmartObject property to display. Select the item by clicking on the ellipsis.
Filter the data according to another control's value	Select this option if you want to filter the data according to another control's value.
Parent Control	Specify the control to use to filter the data.
Parent Join Property	The SmartObject property on the parent control that is used to filter the data.
Child Join Property	The SmartObject property on the current control that is used to filter the data.

Choice Control items per row or column

Use the Stacked by and No. of items Properties to specify the amount of rows or columns to display. When you select to stack by rows, the first row starts from left to right until the number of items per row is reached, and then a new row is created. When you stack by columns, the first column starts from top to bottom until the number of items per column is reached, and then a new column is created. You can find these properties in the Settings section:

The image below shows an example of stacking three items per row using the Check Box List type:

The image below shows an example of stacking three items per column using the Check Box List type:

You can find the control in the Input section of the Toolbox.

The control interacts with other controls through rules. When you bind properties between different controls, you can use the data to populate properties or set values. Use the following examples for when to use the control with other controls through rules:

• Populate a list control with data: You can populate the control if its data source is a SmartObject
• Set a control’s properties: You can configure the settable properties of the control with this action
• Show/Hide: The Visible property allows you to show or hide the control through rules
• Enable/Disable: The Enabled property allows you to enable or disable the control through rules
• Data Transfer: You can transfer data from items listed in the context browser to the control

The following events are available on the control:
Rule Events:

• When [control] is Changed: This event executes when the control is set to a new value that is different from the previous value. You can use this event to trigger actions when the control is changed, for example when the option is changed, then set the properties of another control.
• When [control] is Initializing: While you can see this event in the Rule Designer, it has been deprecated. Instead use the When the View/Form Initialize event.
• When [control] is Populated: This event executes each time the control is loaded. You can execute a rule condition or action when the control loads such as set focus to the control.
• When [control] is Set: This event executes each time the control is set to any value regardless of if the previous value is the same. You can use this for updating cascading controls.

• You can use either static values or SmartObject list results
• You must always specify a delimiter because the control saves and loads a delimited list of values
• Avoid using this control when you have complex data scenarios because there is no Key value in the Data Source setup, so associating these values with other data may not work as expected