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.

Implementation of this activity is different between TypeScript and .NET versions. The TypeScript version uses a "DataRef" wrapper around the feature, while the .NET version puts the feature directly in the value. When using this activity in VertiGIS Studio Mobileor VertiGIS Studio Web, you must use the .NET example below.

For example, to read the contents of one of the features selected in an item picker:
TypeScript: =$form1.state.itemPicker1.value.items[0]["GlobalID"]
.NET: =$form1.state.itemPicker1.value.items[0].value.attributes["GlobalID"]



Type: Lookup<Item>

The result items collection.


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

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.