Batch Attribute Editor widget

(Added at v1.3)

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

Caution:

If fields sharing the same field name are found across different layers, but have different domains, only one domain can be used.

Caution:

If the map has several layers with subtypes, only the subtype field from one layer is used when editing the attributes for features across these layers. This is a known limitation. Once you select a subtype value description from the drop-down menu, the coded value is stored in the text field since the validation at the REST endpoint will expect a numeric value.

Configure the Batch Attribute Editor widget

This widget can be set to open automatically when an app starts. Hover over the widget and click the Do not open this widget when the app starts button to change the setting to Open this widget automatically when the app starts. (For widgets that you need to add to the app first, you can turn on this option 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. Use this method for use cases such as the following:
     • You want to select a single point, line, or polygon feature to edit on the map.
     • You want to select multiple point, line, and polygon features to be edited by drawing an extent around those features on the map.
   • Select by Feature—Select a feature and update the attributes for all the intersecting features. Use this method for use cases such as the following:
     • You want to edit the attributes for one or multiple point, line, or polygon features, but only if they intersect with a feature you select on the map. For example, you can edit all the address points in a service outage area polygon.
   • Select by Feature & Shared Attribute Values—Select a feature and update the attributes for all the intersecting features that share a common attribute value. Use this method for use cases such as the following:
     • You want to edit the attributes for one or multiple point, line, or polygon features, but only if they intersect with the feature you select on the map and if they share a common attribute value. For example, you can edit all the address points that are both in a service outage area polygon and are a residential address.

   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.

   Note:

   If the Select by Feature & Shared Attribute Values method is chosen, a field must be selected under Query Field for all the layers that have the Update check box checked.

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

Use the Batch Attribute Editor widget

To get started with the Batch Attribute Editor widget, complete the following steps.

1. Click the Batch Attribute Editor button to open the widget.
2. Uncheck the check box for any layer or layers that you do not want to update (all layers are checked by default). To filter the features in the layer, click the Edit tool in the filter column and add an expression.
3. Choose a tool 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 attribute values for the selected features and save.
   • If you select multiple features with different values for a given field, you will see Keep Existing Values as the default value. This will preserve the existing values for that field for each feature.
   • If you select multiple features with different values for a given field, 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 a field value blank will keep the existing values.