Trace configurations

Trace configurations allow you to add and store complex traces in a trace network that can be shared across an organization through web maps and consumed by web and field applications. Introduced with version 2 of the trace network, the use of 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 trace configuration.
  • Activate a trace configuration in a map.
  • Share a web map containing active trace configurations.
  • Consume trace configurations in a web map or field application.
  • Manage trace configurations in the network.

Adding a trace configuration

Trace configurations are created using the Add Trace Configuration tool. Existing trace configurations in a trace network can be viewed on the Trace Network tab of the network's Layer Properties dialog box. To learn more, see Add a trace configuration.

A trace configuration is created using the Add Trace Configuration tool. This provides the ability to name and persist configuration details of a trace in the trace network. Trace configurations 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 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 trace configurations in the network.

Note:

When working with a trace network in a file geodatabase, operating system authentication is used to store the creator of a trace configuration.

Learn more about how to add a trace configuration

Sharing trace configurations

Beginning with ArcGIS Enterprise 10.9, trace configurations that are added to a trace network 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 trace configuration must first be set as active for sharing.

The Sharing pane of the Network Options dialog box is used to set trace configurations as active for sharing. To access the Sharing tab, click the dialog box launcher Launcher on the trace network Data tab, to the lower right of the Tools group, and click the Sharing tab.

The Sharing tab lists all of the trace configurations for the trace network in the current map.

Optionally, check the Active check box next to a trace configuration on the dialog box. This activates a 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 trace configurations are added to the trace network.

Learn more about how to share a web map

Consuming trace configurations

Map services are the primary method through which trace configurations are consumed. Beginning with ArcGIS Enterprise 10.9, a trace configuration in the trace network layer can be consumed with the ArcGIS REST API through the Trace Network service by global ID.

The Trace tool can also consume trace configurations in ArcGIS Pro to define the properties of a trace. This simplifies the user experience associated with tracing and provides consistency through the reuse of common traces in an organization. To learn more, see Load trace configurations.

Working with trace configurations

Existing 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 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 has the ability to modify and delete all trace configurations. Other portal accounts can work with only trace configurations they create. When working with a trace network in a file geodatabase, any user can modify and delete all trace configurations in the network.

The Delete Trace Configuration tool provides the ability to delete one or more trace configurations from a trace network.

Caution:

Using this tool, trace configurations are permanently deleted from a trace network. Deleting a trace configuration breaks its connection with any web maps that reference it.

In scenarios where 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 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 trace configuration in place. To learn more, see Delete a trace configuration.

The Export Trace Configurations and Import Trace Configurations tools provide the ability to export and import one or more trace configurations between geodatabases and trace networks through JSON.

Note:

The creator value in the .json file is honored during import. Since the portal trace network owner is the only user 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.

To learn more, see Export a trace configuration and Import a trace configuration.