Get Form Element Items from Features Activity

Description

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.

Usage

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.

Inputs

Features

Required Type: esri.Graphic[] (3.x, 4.x)* The features to be converted to the items collection.

Label

Required 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

Optional 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.

Outputs

items

Type: Lookup<Item> The result items collection.

Properties

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.