Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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 users 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 1: Add a Single Selection Field.

1.1.
Rw ui steps macro
Rw step

Open Add Field panel.

1.2.
Rw step

Add a Single Selection field to the page.

Note: This field will ask the user to choose Investment Objectives for the account.

Info

Information: 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.

1.3.

Rw step

Enter the following values for the field settings:

Adding a Single Selection field with choices

Field

Value

Description

Field Label

Investment Objectives

This is the name of the field that is displayed above the dropdown.

Use label as placeholder

Selected

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).

Display Type

Select

The list of options will be displayed as a dropdown.

Required

Selected

The user will be required to fill in this field.

Choices

value = 1 label = Income

Choices

value = 2 label = Long-Term Growth

Choices

value = 3 label = Short-Term Growth

Step 2: Apply Changes.

2.1.

Rw ui steps macro
Rw step

Click the Apply button at the bottom of the screen to close the Widget Design Screen and apply changes.

2.2.

Rw step

Then click the Save button at the top of the Widget Details Screen to save these changes.

Step 3: Test the Widget.

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