Get Form Element Items from Features Activity


The Get Form Element Items from Features activity converts a collection of features into an items collection suitable for use in forms.

This activity is typically used to build items collections that can then be assigned to form elements like Drop Down List, List Box, and Item Picker.


You may have features with attributes you want to use to populate a form item. You could populate an Auto Complete form element with feature data using the Get Form Element Items From Features activity in conjunction with the Set Form Element Items activity.




Type: esri.Graphic[] (3.x, 4.x)*

The features to be converted to the items collection.



Type: String

The name of the feature field used to populate the items' labels or a format string that is used to populate the items' labels.

A format string can contain field placeholders that are replaced by the specified field's value at run time. A field placeholder is represented as the field name surrounded by curly brackets, for example, {STATE}. If the field specified by a placeholder cannot be found, the placeholder is displayed.

Format strings for the Check Group, Radio Group, and Item Picker form elements can also contain Markdown.

As of Workflow 5.30, field names used here are case-insensitive in all client environments except Mobile.

Value Field Name


Type: String

The name of the feature field used to populate the items' values. If not provided, an item's backing feature is used in a DataRef object.

As of Workflow 5.30, this value is case-insensitive in all client environments.

* VertiGIS Studio Workflow uses different versions of Esri's ArcGIS API for JavaScript depending on the type of host application. See Underlying Technologies for information.



Type: Lookup<Item>

The result items collection.


For information about the ID, Display Name, and Description properties, see Properties Common to all Activities.

Supported Environments

Environments capable of running this activity






Experience Builder

Web AppBuilder

Geocortex Viewer for HTML5

Levels of Support:      Full Support      Partial Support      No Support

Connectivity Requirements

This activity works when the device has intermittent connectivity to the network.

Version Information

Supported from: Geocortex Viewer for HTML5 2.9, ArcGIS Web AppBuilder 2.4.