SetFieldValues

Sets an array of values for the specified field.

Note: Sub-Relational fields are not supported. These fields are driven by associated Single Relational or Multi-Relational fields, which can be set using this method.

Parameters

Name	Type	Description
`fieldName`	String	The name of the field.
`value`	Array	The array of values to set on the field. If the field is a Combo Box or List Box, the value must match the value of an item already in the list, and is case-sensitive.

Return Value

Result	Value
(none)

Examples

This example sets the array of string values for the field:

SetFieldValues("Numbers", ["one", "two", "three", "four", "five"]);

Comments

SetFieldValues is typically used with Multi-Group, Multi-Relational, Multi-Selection, and Multi-User fields. If this method is used with other field types, it sets the field to the first value in the array.

Before this method can be invoked to populate a searchable Multi-Group, Multi-Relational, Multi-Selection, or Multi-User field, values must be present in the left-hand box on the ListBox control.