Choice - Multiple
Use the Choice - Multiple form control to allow users to make one or more selections from multiple options you have defined.
Note: You can arrange up to four of this control on a single row in the form.
Section | Setting | Description |
---|---|---|
(unlabeled) | Title |
Field name displayed on the published form. |
Customize |
Switch toggle to Yes to enable customization of the variable Name of the form control. |
|
Name |
(This field becomes configurable only when you switch the Customize toggle to Yes.) Customizes the name of the variable A placeholder that stores changes each time the workflow runs, such as the information entered in a form, or the name of a file. You can also create variables to store information you use in the workflow, such as an email address. for the field. If the name is not customized, the Title will be used as the variable name. |
|
Connected to |
Connect to a SharePoint column. Only SharePoint columns of the same type as the selected control are available in the drop-down list. When connected, data entered via that field in the form is entered in the selected SharePoint column. What is a SharePoint column?
When you open Nintex Forms for a new SharePoint list, the form designer automatically creates form fields for the equivalent SharePoint columns in your list. The SharePoint columns are displayed in the designer when you open it. If you want to delete them from or add them to your form, you can do so under the SharePoint Columns controls. |
|
Display type |
Displays the user-selectable options using the selected type:
|
|
Options |
Options to display on the form. Click in this field, and then click Insert to launch the Formula builder where you can create and then insert a data variable with applied formulas, a collection, or a collection of objects. Or, enter each option in a new line. You can include commas in the options, if required (for example, Melbourne, Victoria can be one option). You can also include pipes/vertical bars "|" to define the options and their values (for example, Choice 1 | 1234 can be one option where Choice 1 is the option's label and 1234 is the option's value). You can also add Rules to create business logic to pre-select options based on the option's value. This can help users more quickly complete forms and ensure data integrity before the form is submitted. When using rules with options, enter the options manually on the Rules tab and ensure that the options entered are identical to the options entered in the control. |
|
Default value |
The value that automatically populates the field when the form loads. Click in this field, and then click Insert to launch the Formula builder where you can create variables with applied formulas. The calculated value becomes the default value. |
|
Option configuration | Option label |
(Displays when you insert a data variable with a collection in the Options field.) Displays selected option data to the form viewer. |
Option value |
(Displays when you insert a data variable with a collection in the Options field.) Sends the corresponding selected value back to the workflow. |
|
Filter out duplicate options |
Switch toggle to Yes to filter options by value regardless of their label. When this is enabled, if there are duplicate options, only the first option is displayed in the form. The filtered options may change due to dynamic data. |
|
Allow a fill-in option |
(Displays when the display type is a checkbox.) Switch toggle to Yes to add "Other" option to enable users to type a custom option. |
|
Display 'Please select' |
(Displays when the display type is a drop-down list.) Switch toggle to Yes to display the 'Please select' text in the drop-down list. |
|
Alignment |
Orientation (Vertical, Horizontal) for display of the list of user-selectable options. |
|
Option range validation |
Switch toggle to Yes to add a Minimum value, Maximum value, and Custom validation message for the options. With range validation, you can control how many options a user can select. |
|
Minimum value |
(Displays when the Option range validation is Yes.) Type the minimum number of options the user can select. |
|
Maximum value |
(Displays when the Option range validation is Yes.) Type the maximum number of options the user can select. |
|
Custom validation message |
(Displays when the Option range validation is Yes.) Type a customized validation message that will appear if the user selects options outside of the minimum and maximum value range. If you do not type a message, a default one will display. |
|
Required |
Mandates entry of a value before the form can be submitted. |
|
Custom required message |
(Displays when you select Yes in Required.) The validation text which displays below the field when a value is not entered into the field and the user attempts to change page or submit the form. |
|
Visible |
Shows the field on the published form when loaded. |
|
Read-only |
Displays the field on the published form but does not allow user input. |
|
Description |
Helper text displayed below the field on the published form. |
|
Tooltip |
The message which appears when users hover their cursor or touch the information icon beside the Choice - Multiple control in the form. |
|
Shrink | Reduces the width of the Multiple choice control in a row of other form controls. | |
Expand | Increases the width of the Multiple choice control in a row of other form controls. | |
Styling | CSS class |
Add a CSS class to apply a style to this form control. You can create the CSS class in the CSS code editor in form styles. Enter one class name or multiple class names separated by a space. For more information, see Add a custom CSS to individual controls. Note: The CSS Class field is available only if the Custom CSS setting is enabled in Nintex Automation Cloud Form settings. |
Border color |
Border color to apply to the field. To select a color, click the color box and use the color picker to specify the color you want. You can click on the color map to select the color or enter the Hex code. To revert back to the global style, click Reset to global style. |
|
Control Fill |
The color to fill the inside of the field. To select a color, click the color box and use the color picker to specify the color you want. You can click on the color map to select the color or enter the Hex code. To revert back to the global style, click Reset to global style. |
|
Control input color |
The font color of the input in the field. To select a color, click the color box and use the color picker to specify the color you want. You can click on the color map to select the color or enter the Hex code. To revert back to the global style, click Reset to global style. |