Creating a Single or Multiple Selection Field

Click on Images to Expand Them

One way to define a field with selectable values is to list the values directly as the list of Choices of a Single Selection field or Multiple Selection field. The Single Selection allows to choose only one value from the list, and it can be displayed as a dropdown, list of radio buttons, or formatted buttons. Starting from Connect v4.53, it can also be displayed as a list of large tiles formatted with an Options template. The Multiple Selection allows to choose several values from the list, and it can be displayed as a dropdown, or a list of checkboxes.
The example below, shows how to create an Investment Objectives field. It will be a Single Selection field, with three possible values that will appear in a dropdown list.

	Step	Result
1	Open Add Field panel. Add a Single Selection field to the page. This field will ask the user to choose Investment Objectives for the account. Choices will list the value-label pair for each option. The "value" attribute will map to the corresponding "value" attribute of the meta field in the PDF form. The "label" attribute will be the text displayed to the user. Enter the following values for the field settings:	^{Adding a Single Selection field with choices}
2	Field	Value
3	Field Label	`Investment Objectives` This is the name of the field that is displayed above the dropdown.
4	Use label as placeholder	Selected
5	Meta Field Name	`Owner1.PortfolioObj` This is the unique name for the data held within the field as it will be referenced by other JavaScript code in the widget (the Choices Expressions function defined earlier).
6	Display Type	`Select` The list of options will be displayed as a dropdown.
7	Required	Selected The user will be required to fill in this field.
8	Choices	value = `1` label = `Income`
9	Choices	value = `2` label = `Long-Term Growth`
10	Choices	value = `3` label = `Short-Term Growth`
11	Click Apply button in the bottom of the screen to close the Widget Design Screen and apply changes. Then click Save button in the top of the Widget Details Screen to save these changes.
12	Test the widget by opening the Investment Objectives dropdown. Available options should be: 'Income' 'Long-Term Growth' 'Short-Term Growth'.	^{A Single Selection field with choices}