Web AppBuilder for ArcGIS (Developer Edition)

Network Trace widget

(Added at v2.12)

The Network Trace widget is designed to call and interact with any geoprocessing service. The input should be a point feature or features, and the output can return polygon, polyline, or point features as results. For example this widget can be configured to use a geoprocessing service that traces a geometric network and returns an outage area and affected assets. To learn how to configure this widget to perform an isolation trace on a geometric network, visit the Water Outage template.

Configure the Network Trace widget

This widget can be set to open automatically when an app starts. To enable this feature, click the Open this widget automatically when the app starts button Open this widget automatically when the app starts on the widget, which turns it dark green.

  1. Hover over the widget and click the Configure this widget button Configure this widget to open the configuration properties dialog box.
  2. Optionally click Change widget icon and replace the default icon for this widget with an image of your own.

    A file explorer window appears, allowing you to choose a local image file to use as the widget icon.

  3. Select the Set button and provide the task URL for your geoprocessing service.

Configuration settings

There are four sections to consider when configuring the Network Trace widget: Project Settings, Input/Output, Summary, and General Settings.

Project Settings

The project settings are optional. If you configure these settings, you can save projects in the desired web map layers with the network outage area and input parameters.

The Project Settings options are as follows:

  • Project polygon layer—This polygon layer must have Create, Delete, and Update editing capabilities and include a field called name (a string type field) and a field called globalid (a GlobalID type field).
  • Output parameter name—The output polygon layer or layers from the task URL.
  • Project point layer—This point layer must have Create, Delete, and Update editing capabilities and include a field called inputtype (a string type field) and a field called projectid (a GUID type field).

Input and Output

This tab provides options for configuring the input and output settings for the trace results.

  1. For each input parameter, set the type to flag, barrier, or skip, and specify the Tool Tip and symbol.
  2. For each output parameter, select any or all of the following:
    1. Visible—Select the visible layers in the trace results that are checked. If Visible is not checked, the result layer will show the output parameter as unchecked in the trace result pane.
    2. Skippable—Allow features in this layer to be passed to the skip input parameter.
    3. CSV—Select the results to export to a .csv file.
  3. To save output parameters, select the drop-down arrow under the Save to Layer setting and select the layer.

    Note:
    If the project settings are not configured, the Save to Layer option is unavailable.

  4. For each output parameter, update the symbology by selecting the corresponding symbol.
  5. Select the Settings button Settings to update the label, Tool Tip, display text, and scale for the output results.

Summary

The Summary tab allows you to set summaries on the trace results.

  1. Select an input or output parameter, a field, and an operator to create summary text.

    Note:
    The count operator only requires that an input or output parameter be selected.

  2. Use the Summary text box for your trace results.

General Settings

Set additional widget customization options on the General Settings tab.

  1. Type text to display for the run button.
  2. Select the Zoom option if you want the map to zoom to the trace.

Use the Network Trace Widget

When it's configured, this widget can be used by a water utility to determine an isolation area in the event of a main break. Open the Network Trace widget to display the Input tab and, optionally, the project drop-down arrow if configured.

  1. Add a flag location and, if required, a barrier.

    Note:
    Press the Control key to activate snapping.

    Add a flag to the Network Trace widget

  2. Click Run to start the trace.

    Click run

    The map zooms to the extent and displays the trace results.

  3. View the summary and the output results.

    Project name

  4. Click Save.

    Note:
    Project settings must be configured to save the trace.

    Click OK for the new project

  5. Provide the project name and any additional information in the project attributes pane.
  6. Click OK to finish saving the results.