Edit widget

The Edit widget provides users with feature and record editing capabilities in 2D and 3D. Use the Edit widget with another data-connected widget, such as Table, Feature Info, or Map, to allow users to add, delete, and update features in the source data. The geometry mode supports 2D and 3D editing, including move, scale, rotate geometries, and vertices editing. You can choose which fields to display, organize the fields in collapsible groups with meaningful headings, and provide instructions for editing each field. When connected to a map with a form configured for the selected layer, the widget can display the form (including conditional visibility for fields).

Examples

Use this widget to support app design requirements such as the following:

  • You want users to be able to update the attributes of selected features or records.
  • You want users to be able to modify the shape of a feature in a map or scene from the Map widget.

Usage notes

This widget requires adding editable data. When you add an Edit widget, you must add at least one other widget, such as Table, List, Feature Info, or Map, that uses the same data source. The Edit widget only supports selected features view, so a feature must be selected in the other widget for its data to appear in the Edit widget. To edit geometry, the widget must be connected to a Map widget.

You must configure this widget with one of two edit modes, Attribute only or Geometry and attribute. When you include the widget in an app with Geometry and attribute mode selected, the widget provides users with the following tools and settings:

  • Enable tooltips—Show numerical information while drawing features.
  • Enable snapping—Snapping allows you to create features that connect to each other. The pointer will jump, or snap to, nearby edges, vertices, and other geometric elements. Turn on this setting to enable the following tools (if they are configured in the widget settings):
    • Geometry guides—Allows snapping to the feature being created, and shows smart guides such as 90 degrees and parallel.
    • Feature to feature—Allows snapping to other features.
  • Snapping layers—Choose which editable layers should work with the enabled snapping tools.
  • Edit features—Edit the features of the specified data sources.
  • Create features—Add features to the data sources from the specified Map widget.

When you include the widget in an app with Attribute only mode selected, the widget includes tools for updating and deleting records.

When you include the widget in an app with Geometry and attribute mode selected, the widget supports editing related table records and related feature records. To edit related records for a layer, you must specify a related records element in Map Viewer.

Settings

The Edit widget includes the following settings:

  • Choose an edit mode.
    • Attribute only—Allows users to edit the attributes of the specified data sources (without a Map widget).
    • Geometry and attribute—Allows users to edit the geometries and attributes for features in the data sources from the specified Map widget. You can click the Import all button Import all to add all the map's editable layers or click New editable layer to choose specific layers.
  • Layer configuration—Select the data source to be edited. For each layer, specify the following settings:
    • Label—Type a name for the data source. This name appears in the widget to differentiate records from different sources.
    • Capability—Specify the edit capabilities for the data source.
    • Configure fields—Choose a method for how fields appear in the widget.
      • Use webmap settingsDisplays all editable fields or a form configured in the map (including conditional visibility settings).
      • Customize—Displays the editable fields that you select. (The first 50 fields are automatically selected; click Clear selection to deselect all.) In the subset of selected fields, specify which fields you want users to edit. Organize them by dragging to reorder or combining fields into logical groups. Provide descriptions for each field or group to give context or instructions.
  • Snapping settings—Choose to include the Geometry guides and Feature to feature snapping tools. The following settings are useful if you want to set default snapping settings that the user does not have to reset each time the app loads.
    • Enable by default—Enable the snapping tool by default when the widget loads. This check box appears when you choose to include either of the snapping tools.
    • Choose default snapping layers—Designate layers as snapping layers by default when the widget loads.