| Info | ||
|---|---|---|
| ||
This routine is available starting with Power Scripts 3Scripts™ v3.0.2 version and above(server) and above. |
| Info | ||
|---|---|---|
| ||
Please note that this routine can only be used with: Select List (single choice), Select List (multiple choices), Checkboxes, Radiobuttons custom fields. If you wish to use this kind of functionality with Select List (cascading), consider using a custom cascading select field found in this tutorial: Create custom cascading select field. |
Syntax
lfAllowSelectOptions(field, options[, triggerChange])
Description
| Excerpt |
|---|
| Restricts the list of given options of the field a field's selectable values to the list of options given as a parameter of the routine. |
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| field | Stringstring | Yes | Field to restrict options for |
| options | Stringstring[] | Yes | List of remaining options |
| triggerChange | Boolean | No | If set to "true", it triggers the change event on the field when a routine is used |
Example - restricting users to select certain values in the field options
The following code example restricts anything but "Major" and "Minor" from the options of the standard Priority field.
| Code Block |
|---|
lfAllowSelectOptions("priority", {"MajorMedium", "MinorHigh"});
//where field = "priority" and options = "MajorMedium" and "MinorHigh" |
If you want to trigger the change event on the field when using the lfAllowSelectOptions routine, you can use the optional triggerChange parameter set to true:
| Code Block |
|---|
lfAllowSelectOptions("customfield_10000", {"option1", "option2"}, true);
//where field = "customfield_10000" of type select list, options = "option1" and "option2" and triggerChange = true |
...