Trace utility networks

You can use the Trace tool to run traces on web maps published with a utility network and named trace configurations.

Note:

Web maps published with utility networks can include several named trace configurations in their map definition. Before you can run traces, you must configure the trace options.

Examples of common trace applications include the following:

• Run an isolation trace to identify which system valves need to be closed to stop the flow of water and which customers will be affected by the ensuing water outage.
• Run an upstream trace to search for possible contamination source locations in a stormwater system.
• Run a connected trace in a branch version to confirm that newly edited features are connected as expected.
• Run a subnetwork trace to validate whether subnetworks, such as circuits or zones, are defined or edited appropriately.

Run a trace

Once you've configured traces for a utility network, you can use the Trace tool to run one or more traces concurrently.

To run a trace, complete the following steps:

1. Open a map with a utility network in Web Editor.
2. Click Utility Network Tools .

   The map must contain a utility network to access Utility Network Tools.

   The Utility Network toolbar appears in the map.

3. Click Trace .
4. On the Inputs tab, click the Trace types menu and choose from the named trace configurations.

   You can choose multiple named trace configurations.

5. Add starting points by doing the following:
   1. In the Starting points section, click the add button .
   2. Add a starting point to the map.

      The starting point must intersect a feature.

   3. If the starting point has more than one terminal, click Expand next to the feature name.

      If the starting point has only one terminal, proceed to substep e.

   4. Click the Select terminals menu and choose one or more terminals.
   5. Repeat these steps to add more starting points if necessary.
6. Optionally, add barriers by doing the following:
   1. In the Barriers section, click the add button .
   2. Add a barrier to the map.

      The barrier must intersect a feature.

   3. If the barrier has more than one terminal, click Expand next to the feature name.

      If the barrier has only one terminal, proceed to substep e.

   4. Optionally, click the Select terminals menu and choose one or more terminals.
   5. Repeat these steps to add more barriers if necessary.
7. Click Run.

   When a trace has been run successfully, its results are displayed on the Results tab.

   Note:

   Web Editor supports Selection and Aggregated Geometry result types parameters in named trace configurations.

   Learn more about result types parameters

8. Click the right arrow to expand the results.

   You can continue to expand the trace until you reach individual traced records. When you click a record, the map zooms to its location.

9. Click Clear all to exit the trace.

   You are prompted to confirm whether you want to clear the trace results.

10. Click OK to clear the results or Cancel to continue viewing the results.