Multi Choice

The Multi Choice control is a drop-down with scrollable checkboxes. It is a reference control which allows you to make one or more selections by selecting the checkbox along with the option. Make your selections with a single click.

 A quick glance to all available and selected options!

Figure: Multi Choice Control

Let's explore the following use-case.

Configure Multi Choice Control

Let's configure Multi Choice Control!

1. Navigate to General tab of Form Designer. Enter all mandatory details required for the Form.
2. In Design Form tab, from the left pane select Controls > Form Controls > Multi Choice.
   Drag and drop this control inside a panel to create a multi choice field. Click Settings icon to view Properties pop-up.

You can view the following tabs for Multi Choice control:

• Properties
• Advance
• Validations
• Appearance
• Security
• Data Source

Properties

This section contains the list of properties using which the Administrator can configure the respective control's name, subtitles etc. To know more about the fields that are available under the Properties section, see Field Description given below.

Figure: Properties

Field Description
This table contains the list of fields and their descriptions that are available under the Properties section: 

Field	Description
General
Title	Specify the name for the Multi Choice control. This name identifies the Multi Choice control in the form. For Example: Email Notification for Incident
Subtitle	Specifies the text which you want to display just beneath the control. You may use it to describe the purpose of the control or the way it should be used etc. For Example: As shown in the following screenshot "Send email notification for incident status update" is the subtitle for the Multi Choice control named "Incident Status Email Notification".  Figure: Subtitle
Sub Title	The subtitle text is useful to give the user a better idea of what kind of information they need to fill in. Sub Title text appears directly beneath the control container. Use it to explain why a piece of information is being requested, address security and privacy concerns, or suggest ways of providing answers.
Informative
Help Text	Displays the information about the UI control in the form.
Rich Text	Select it to enable the text as rich text and interpret as rich text.
Tooltip	The tooltip is displayed when the user hovers the mouse cursor over the control.

Advance 

This section contains the list of validation setups using which the Administrator can configure the respective control as mandatory, based on condition etc. To know more about the fields that are available under the Advance section, see Field Description given below.

Figure: Advance

Field Description
This table contains the list of fields and their descriptions that are available under the Advance section: 

Validations

This section contains the list of validation setups using which the Administrator can configure the respective control as mandatory, based on condition, and so on. To know more about the fields that are available under the Validations section, see Field Description given below.

Figure: Validations

Field Description
This table contains the list of fields and their descriptions that are available under the Validations section:

Field	Description
Title should be	Select one of the following options as per your requirement: Mandatory - Select the Mandatory from the drop-down to make the control as mandatory control. Disabled - Select the Disabled from the drop-down to make the control as disabled control.  Hidden - Select the Hidden from the drop-down to make the control as hidden control.  Editable - Select the Editable from the drop-down to make the control as editable control. Unique - Select the Unique from the drop-down to make the control as unique control.  While configuring below listed controls, Application Designer can impose validation on the field being Unique.  Text Box  Text Area Numeric  Dropdown  Auto Complete  Calendar Note The Mandatory and Unique validations are for Admin Forms to configure the form controls unique or mandatory.
Below Conditions Meet	Select it if you want to display this control based on certain conditions. The following fields are displayed to configure the conditions: Field - Select the field from the drop-down list on which the condition is to be applied. Operator - Select the required operator from the displayed drop-down list. Figure: Validations Use icon to add more conditions.
Every Time	Select it if you want to display this control always without any specific conditions.

Appearance

This section contains the list of validation setups using which the Administrator can configure the respective control as mandatory, based on condition, and so on. To know more about the fields that are available under the Appearance section, see Field Description given below.

Figure: Appearance

Field Description

This table contains the list of fields and their descriptions that are available under the Appearance section:

Field	Description
Label Layout	Select the required label layout position for the text box control. The available options are: Vertical - If selected, the label layout displayed top of the field. NA Horizontal - If selected, the label layout displayed in front of the field. NA Float - If selected, the floating labels move inside the textbox as you enter information. NA
Upload Icon	Icons can be assigned to the selected attribute. On clicking the button, a pop-up displays to browse. Select the required icon.
Icon Position	Specify the position of the icon. It can be either to the left or the right of the control. Left: If selected, the icon is displayed at the left of the attribute name. Right: If selected, the icon is displayed at the right of the attribute name.
First Item	Select what should be the default option to be displayed in the drop-down list. Note: Select None if you do not want any option to be displayed as default option (NA)

Security

This section contains the security measures that can be configured for the respective control.  It will allow you to control the form usage based on the restricted configured access. Configure view and edit permissions at the field level.Figure: Security

For more information on Security tab, refer here.

Data Source

This section contains the list of validation setups using which the Administrator can configure the respective control as mandatory, based on condition, and so on. To know more about the fields that are available under the Data Source section, see Field Description given below.

Figure: Data Source - Table

The following screenshot is displayed if the Data Source is selected as API.

Figure: Data Source - API

The following screenshot is displayed if the Data Source is selected as Manual.

Figure: Data Source - Manual

The following screenshot is displayed if the Data Source is selected as Status.

Figure: Data Source - Status

This section contains the list of fields and their descriptions that are available under the Data Source section. To know more about the fields that are available under the Data Source section, see Field Description.

Field	Description
Data Source	Select one of the following options to select the data source. Available options are as follows: Manual Table API Status
Parent	If selected, the control will take the data from the parent table. For Example: If you create a multi-choice control named State, then the Parent Data Source for this can be Country table.
Is Parent Encrypted ?	If selected, then the Parent field value is encrypted at database level to maintain the security. Example: If Parent field is SSN of a citizen and it needs to be secured at database level, enable Is Parent Encrypted button.
Origin	This field is visible only if Data Source is selected as API. Select the origin for the API request. Available options are as follows: Same Origin - Select it if the API request is from same origin. Cross Origin - Select it if the API request is from different origin. For Example: Scenario I Origin I = https://www.acme.com/222 Origin 2= https://www.acme.com/111 In this case, Origin I and Origin 2 are same Origin. Scenario II Origin I = https://www.acme.com/222 Origin II = https://www.example.com/222 In this case, Origin 1 and Origin 2 are cross Origin.
Type	This field is visible only if Data Source is selected as API. Select the type of the API. Available options are as follows: Get - Select it to fetch data from a specified resource. Post - Select it to send data to update a resource.
Address	This field is visible only if Data Source is selected as API. Specify the API URL.
Parameters	This field is visible only if Data Source is selected as API. Select the Parameters from the drop-down list.
Label Field	Label is the text that appears to the user for that choice. Use short phrases in your choice lists.
Value Field	Value is a string that is stored in the variable when that choice is selected.
Body	This field is visible only if Data Source is selected as API.
Actions	Available actions are as follows: Use it to drag up or down to reorder the labels. Use it to disable a label. Use it to add more labels. Use it to delete any label.