Run a named trace configuration

Named trace configurations created in a utility network can be consumed in ArcGIS Pro through the Trace geoprocessing tool or by using the Named Configurations tab in the Trace pane. The use of named trace configurations in ArcGIS Pro simplifies the user experience associated with tracing and provides consistency through the reuse of common traces in an organization.

Requirements

• The Input Utility Network parameter value must be version 5 or later.

• When working with an enterprise geodatabase, the input utility network must be from a utility network service.

Run a named trace configuration using the Trace geoprocessing tool

Follow these steps to load and run a named trace configuration using the Trace geoprocessing tool:

1. On the Analysis tab, in the Geoprocessing group, click Tools to open the Geoprocessing pane.
2. In the Geoprocessing pane, search for and select Trace.
3. For Input Utility Network, specify a utility network.
4. For Use Trace Configuration, check the check box to specify a named trace configuration.

   Enabling the Use Trace Configuration check box displays the Trace Configuration Name parameter and hides all other parameters except Starting Points, Barriers, and Run in asynchronous mode on the server.

5. For Trace Configuration Name, choose a named trace configuration from the list provided. When working with an enterprise geodatabase, you can also supply the global ID for a named trace configuration from the traceConfigurations resource in the REST API.

   When a named trace configuration using the aggregated geometry result type option is chosen, additional optional parameters are displayed to configure the output: Clear All Previous Trace Results, Trace Name, Aggregated Points, Aggregated Lines, and Aggregated Polygons.

6. Click Run.

Run a named trace configuration from the Trace pane

Follow these steps to access and run a named trace configuration from the Trace pane:

1. On the Utility Network tab, in the Tools group, click Trace to open the Trace pane.
2. In the Trace pane, confirm that the Named Configurations tab is active.

   You can set the active tab in the pane to Starting Points or Barriers if you need to set trace locations.

3. Choose a named trace configuration from the list displayed in the pane.

   Use the ToolTip to review the description of the named trace configuration by hovering over the item in the list. You can click Refresh to update the list when changing the active map, adding, or deleting a named trace configuration.

   When a named trace configuration using the aggregated geometry result type option is chosen, additional optional parameters are displayed to configure the output: Clear All Previous Trace Results, Trace Name, Aggregated Points, Aggregated Lines, and Aggregated Polygons. Named trace configurations using the aggregated geometry result type are designated with an ellipsis in the list.

4. Click Run.

A trace operation is run using the selected named trace configuration. Traces run from the Named Configurations tab bypass geoprocessing and do not log geoprocessing history.