Replaceable Values in List Options

Replaceable values can be used in list options to populate option labels and values with information entered elsewhere in the form.

For example, you may want a form user to choose a primary contact from a list of contacts. Instead of manually entering every possible contact, you can use replaceable values to include information the user has already entered into the form.

TABLE OF CONTENTS

• Single Replaceable Value
• Multiple Replaceable Values
• Repeatable Set Replaceable Values
• Lists
• Getting Help

Single Replaceable Value

In this example, the form needs to capture the primary contact for an incident. The primary contact may be the Supervisor, Line Manager, or Witness. The Witness's name should appear as one of the available list options.

To do this, add a list option that references the Witness Name element.

The replaceable value format is:

{ELEMENT:<element-name>}

For example:

{ELEMENT:witness_name}

In this example, witness_name is the element name. Whatever the user enters into the Witness Name element will appear as a selectable option in the list.

Multiple Replaceable Values

You can include more than one replaceable value in a list option.

In this example, the Witness Name from the previous example has been split into two elements:

• Witness First Name
• Witness Last Name

To display the full witness name in the Primary Contact list, reference both elements in the list option label and value:

{ELEMENT:witness_first_name} {ELEMENT:witness_last_name}

This ensures the Witness First Name and Witness Last Name entered by the form user appear together as one selectable option.

Repeatable Set Replaceable Values

Replaceable values can also reference elements inside a repeatable set.

In this example, the Witness Name element has been moved into a repeatable set, so the form user can add multiple witnesses. The Primary Contact list can then allow the user to choose from the witnesses entered in the repeatable set.

The replaceable value format for an element inside a repeatable set is:

{ELEMENT:<repeatable-set-name>|<element-name>}

For example:

{ELEMENT:witnesses|witness_name}

In this example, witnesses is the repeatable set name, and witness_name is the element name inside that repeatable set.

Lists

Replaceable values can also be used when list options are pulled from a List.

When configuring replaceable values in a List, make sure the format matches the examples above and that the element names are correct.

Getting Help

If you need any assistance with replaceable values in list options, please reach out through the Report Issue menu or email support@oneblink.io.