Batch Attribute Editor widget

The Batch Attribute Editor widget allows you to select features—either related features, based on another layer, or by sketching in a shape—and update common attributes at the same time. For example, an operations manager can use the Batch Attribute Editor widget to select assets (features) that need to be inspected and assign these features to a specific field crew.

Caution:

If the same field from different layers has a different domain, only one domain will be shown and used.

Caution:

If the map has several subtypes, only the subtype field in the REST endpoint is used and not all of them. This is a known limitation. Once you select the description from the drop-down menu, the coded value is stored in the text field since the validation on it is expecting a numeric value.

Configuring the Batch Attribute Editor widget

This widget can be set to open automatically when an app starts. Click the Do not open this widget when the app starts button on the widget to turn on the option to open the widget automatically. (For widgets you need to add to the app first, you can make this setting after configuring the widget.)

1. Hover over the widget and click the Configure this widget button to open the configuration window.

   Note:

   If you need to add the widget to the app first, click a widget placeholder on the Widget tab. In the Choose Widget window that opens, select the widget and click OK.

2. Optionally click the Change widget icon button and replace it with your own image.
   A file explorer window appears, allowing you to choose a local image file to use as the widget icon.
3. On the Define Selection Type tab, choose one of the following methods to select the features to update:
   • Select by Area—Use a shape and sketch it on the map to select features. Define which drawing tools to allow for the selection.
   • Select by Feature—Select a feature and update the attributes for all the intersecting features.
   • Select by Feature & Shared Attribute Values—Select a feature and update the attributes for all features that share a common attribute value.

     Note:

     A value for Query Field needs to be defined for all the layers to be updated in the Define Layers to Update tab.

   The widget supports these three methods to generate a selected set of records to update. You can only choose one of the methods. If you require more than one of these methods, create a new instance of the widget.

4. Click the Define Layers to Update tab, select the layer or layers to be updated, and update the highlighted symbol for each layer.
5. Click the Define Fields to Update tab and select the common fields to be updated.

   Note:

   If you check more than one layer in the Define Layers to Update table, only the common editable fields are available to update. The fields are only listed if they are set as editable in the layer's pop-up configuration in the web map.

6. To customize the widget description, update the Text to display at the top of the widget text box.

   Caution:

   If you configured the app prior to version 10.8.1 and used custom XSS for this content, you may need to modify it to ensure that it appears as expected now because XSS filters have since been implemented for improved security.

7. Click OK to save and close the Batch Attribute Editor widget configuration.

Using the Batch Attribute Editor widget

1. Click the widget icon to open the Batch Attribute Editor widget.
2. Select the layer or layers to be updated. To filter the features in the layer, click the Edit tool in the filter column and add an expression.
3. Choose a tool or a feature to draw on the map (this is based on your configuration of the widget) and select the features to be updated.
4. Define the new value for the selected features and save.
   • If you select more than one feature with different values, you will see Keep Existing Values as the default.
   • If you select more than one feature with different values and the field has a domain, the drop-down list will show all the domain values. In the list, the existing values used by the features are underlined.

   • To update data to NULL, select No Value in the drop-down list. Leaving the field blank will keep existing values of the features.