Skip to content
import NamedTraceConfiguration from "@arcgis/core/networks/support/NamedTraceConfiguration.js";
Inheritance:
NamedTraceConfigurationAccessor
Since
ArcGIS Maps SDK for JavaScript 4.20

This class describes a trace configuration object. It contains the necessary properties used to perform a trace, and identifies what the trace should return. Trace configurations can be shared across an organization through a webmap during publishing, and are part of the webmap spec. Named trace configurations improve the user experience associated with tracing, since it allows users to run pre-configured traces without needing to understand every configuration detail. Trace configurations can be added using the Add Trace Configuration gp tool or the REST end point.

See also

Constructors

Constructor

Constructor
Parameters
ParameterTypeDescriptionRequired
properties
See the properties table for a list of all the properties that may be passed into the constructor.

Properties

Any properties can be set, retrieved or listened to. See the Watch for changes topic.

creationDate

autocast Property
Type
Date | null | undefined

The date/time when the trace configuration has been added to the utility network. Trace configurations can be added using the Add Trace configuration gp tool or the REST end point gp tool or the REST end point.

creator

Property
Type
string | null | undefined

The portal user who created the trace configuration. Trace configurations can be added using the Add Trace configuration gp tool or the REST end point.

declaredClass

readonlyinherited Property
Type
string
Inherited from: Accessor

The name of the class. The declared class name is formatted as esri.folder.className.

description

Property
Type
string | null | undefined

Short description of what kind of trace this trace configuration performs.

globalId

Property
Type
string

The globalId (UUID) uniquely identifies a trace configuration. Users can pass this id to a trace to reference the trace configuration to be used by the trace.

minStartingPoints

Property
Type
"none" | "one" | "many" | null | undefined

The minimum number of starting points required to perform a trace with this particular trace configuration. Some trace configurations (e.g. Subnetwork) does not require any starting points because the persisted subnetwork name is used to determine the starting locations. This property can be used to derive a user experience, for instance, hide or show the starting location control if minStartingPoints is none.

resultTypes

Property
Type
ResultType[]

The result types of the trace configuration. The trace can return elements and aggregated geometries of the results. Specifies the expected trace results.

tags

Property
Type
string[]

Labels that help identify and search for a particular trace configuration.

title

Property
Type
string

The title or the name of the trace configuration. Trace configuration names are not unique.

traceConfiguration

autocast Property
Type
TraceConfiguration | null | undefined

The full definition of the trace configuration. Only available when fully loading a utility network.

traceType

Property
Type
TraceType | null | undefined

The trace type defined in this trace configuration.

The path and circuit types is reserved for future use.