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 Map widget 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 Interact with a Map widget. When you include the widget in an app with Interact with a Map widget mode selected, the widget provides users with the following tools and settings:

• Enable tooltips—Show numerical information while drawing features. You can press Tab while drawing to type in values for segment lengths, angles, and elevation.

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

The Edit features and Create features sections appear at run time if you turn on certain capabilities in the widget's settings. However, if you are a user with elevated privileges, such as the organization administrator or app owner, both sections appear regardless of capability settings.

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 Interact with a Map widget 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.

Editing privileges

Editing privileges depend on where you access the Edit widget and your account type.

The following rules apply for all users accessing the Edit widget in the builder environment:

• You can import all feature layers regardless of whether the layers are set to editable in their service-level settings.
• If a layer is noneditable, it is added in a read-only state and you can only choose display fields from the layer.

The following privileges apply to users accessing the Edit widget in an app at run time:

• Organization administrators, app owners, and members of shared update groups have full editing capabilities, meaning they can override any service-level configurations.
• Users with fullEdit privileges cannot override service-level configurations to edit records, but can override service-level configurations to add, delete, and update geometry for records.
• All other users have editing privileges that adhere to service-level configurations and account privileges.

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.
  • Interact with a Map widget—Allows users to edit the geometries and attributes for features in the data sources from the specified Map widget. All layers from the Map widget are automatically synced to the Edit widget. If you only want to connect specific map layers to the widget, you can click the Select layers button to open the Select layers panel and turn on Customize layers.

  Layers appear in the settings panel, either in a list or in a drop-down list under each listed map.

• 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. The capabilities that you turn on here affect whether the Create features and Edit features sections appear in the widget panel at run time.

    • The Create features section appears when you turn on Add records for at least one data source.
    • The Edit features section appears when you turn on Delete records or Update records for at least one data source.

  • ** Configure fields**—Choose a method for how fields appear in the widget.

    • Use webmap settings—Displays 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.

  • Choose a mode for the snapping tools.

    • Prescriptive mode—Set predefined snapping settings that are unchangeable at run time.
    • Flexible mode—Set default snapping settings that the user can change at run time.

  • Enable by default—Enable the snapping tool by default when the widget loads. This check box appears under each snapping tool when you choose to include either of the tools in Flexible mode.

  • Choose default snapping layers—Designate layers as snapping layers by default when the widget loads.

• General (Attribute only mode)—Optionally, provide users with a description of how to use the widget and enter a message that appears when there is no valid selection.

• General (Interact with a Map widget mode)—You can turn on the following tools and capabilities:

  • Tooltip—Include the Enable tooltips option in the widget panel at run time.

    • Enable by default—Have the Enable tooltips option be turned on by default when the widget first loads.

  • Template filter—Include the Filter types search box in the widget panel at run time. This tool allows users to search by name for features that they want to edit to draw.

  • Related records—Allow users to edit related table records.

  • Runtime data editing—Allow users with the appropriate editing privileges to edit data added to the app at run time with the Add Data widget. Users can edit run time data added from search or by URL. Layers must be added to the same Map widget that is connected to the Edit widget.

  • Display vertices while editing—Show vertices for selected line and polygon features. Users can drag, add, and delete vertices.

Interaction options

The Edit widget can be the target of the Edit data action, which you can configure in the settings of other widgets.

Data actions add buttons to a widget's user interface for performing data processing tasks. When you configure a widget, such as a Map widget, to have the Edit data action, you can select a feature on the map and click Edit to open an Edit widget and start editing the feature. The target Edit widget must be in a Widget Controller widget and must be connected to the same data source as the source widget. The following widgets support the Edit data action:

• Feature Info widget
• List widget
• Map widget
• Near Me widget
• Select widget
• Table widget