Named trace configurations allow you to store complex traces in a utility network for reuse and sharing across an organization using ArcGIS Pro and web maps to be consumed by web and field applications. Introduced with version 2 of the trace network, the use of named trace configurations in an organization simplifies the user experience associated with tracing and allows users to discover information or answer questions using a trace without the need to understand all configuration details.
The following outlines the general workflow to create, share, and work with trace configurations in the trace network:
- Add a new named trace configuration.
- Consume a named trace configuration in ArcGIS Pro.
- Activate a named trace configuration in a map.
- Share a web map containing active named trace configurations.
- Consume named trace configurations in a web map or field application.
- Manage named trace configurations in the network.
Add a named trace configuration
You create a named trace configuration using the Add Trace Configuration tool to name and persist configuration details of a trace in the trace network. A named trace configuration can then be referenced by name or global ID through web maps, field apps, or ArcGIS Pro to perform a trace.
When you add a named trace configuration to a trace network in an enterprise geodatabase, the active portal user account is set as the creator. This is important because it controls access to modify or delete named trace configurations in the network. Existing named trace configurations in a trace network can be viewed on the Trace Network tab on the network's Layer Properties dialog box. To learn more, see Add a trace configuration.
When working with a trace network in a single-user deployment, operating system authentication is used to store the creator of a named trace configuration.
Share named trace configurations
Beginning with ArcGIS Enterprise 10.9, named trace configurations that are added to a trace network in an enterprise deployment can be shared through a web map and consumed by web and field apps. To be included in the map definition of a web map, a named trace configuration must first be set as active for sharing.
The Sharing pane on the Network Options dialog box is used to set named trace configurations as active for sharing. To access the Sharing tab, click the dialog box launcher on the Trace Network tab, to the lower right of the Tools group, and click the Sharing tab.
The Sharing tab lists all of the named trace configurations for the trace network in the current map.
Optionally, check the Active check box next to a named trace configuration on the dialog box. This activates a named trace configuration for sharing and includes it in the web map's map definition. Uncheck the option to deactivate a trace configuration from sharing. This option is unchecked by default when new named trace configurations are added to the trace network.
Consume named trace configurations
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.
The Use Trace Configuration parameter on the Trace tool allows you to specify an existing named trace configuration to be run using the tool. The Trace pane contains a Named Configurations tab that provides a list of named trace configurations in the network that you can select and run from the pane.
Traces run from the Named Configurations tab bypass geoprocessing and do not log geoprocessing history.
Map services can also be used to consume named trace configurations. Beginning with ArcGIS Enterprise 10.9, a named trace configuration in the trace network can be consumed with the ArcGIS REST API through the Trace Network service by global ID.
Work with named trace configurations
Existing named trace configurations in a trace network can be viewed in the Trace Configurations section of the Trace Network tab on the Layer Properties dialog box. The Trace Configurations section includes the name, description, creator, created date, and tags for named trace configurations in the trace network.
Various tools are provided in the Trace Configuration toolset of the Trace Network toolbox to manage and work with trace configurations in the trace network:
- Add Trace Configuration
- Delete Trace Configuration
- Export Trace Configurations
- Import Trace Configurations
When working with a trace network in an enterprise geodatabase, only the portal trace network owner or portal user with the administrator role can modify and delete all trace configurations. Other portal accounts can work with only named trace configurations they create. When working a trace network in a single-user deployment, any user can modify and delete all named trace configurations in the network.
The Delete Trace Configuration tool allows you to delete one or more named trace configurations from a trace network.
Using this tool, a named trace configuration is permanently deleted from a trace network. Deleting a named trace configuration breaks its connection with any web maps where it is referenced.
In scenarios in which a trace configuration needs to be modified to account for a network update or changing condition in the field, you can delete the existing configuration and work through the process to add, share, and overwrite existing web maps with the new named trace configuration. Note that this process will break any existing downstream dependencies on the web map. Alternatively, beginning with ArcGIS Enterprise 10.9, the Alter operation on the Trace Configurations resource in the REST API can be referenced to modify an existing named trace configuration in place. To learn more, see Delete a trace configuration.
The creator value in the .json file is honored during import. Since the portal trace network owner and administrators are the only users who can view and work with all trace configurations in a trace network, it is important to update the creator value as necessary to ensure the proper access to the imported trace configurations in an enterprise geodatabase.