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 on the widget, which turns it dark green.
- Hover over the widget and click the Configure this widget button to open the configuration properties dialog box.
- 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.
- Select the Set button and provide the task URL for your geoprocessing service.
There are four sections to consider when configuring the Network Trace widget: Project Settings, Input/Output, Summary, and General 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.
- For each input parameter, set the type to flag, barrier, or skip, and specify the Tool Tip and symbol.
- For each output parameter, select any or all of the following:
- 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.
- Skippable—Allow features in this layer to be passed to the skip input parameter.
- CSV—Select the results to export to a .csv file.
- 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.
- For each output parameter, update the symbology by selecting the corresponding symbol.
- Select the Settings button to update the label, Tool Tip, display text, and scale for the output results.
The Summary tab allows you to set summaries on the trace results.
- 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.
- Use the Summary text box for your trace results.
Set additional widget customization options on the General Settings tab.
- Type text to display for the run button.
- 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.
- Add a flag location and, if required, a barrier.
Note:Press the Control key to activate snapping.
- Click Run to start the trace.
The map zooms to the extent and displays the trace results.
- View the summary and the output results.
- Click Save.
Note:Project settings must be configured to save the trace.
- Provide the project name and any additional information in the project attributes pane.
- Click OK to finish saving the results.