Available with Standard or Advanced license.
Beginning with ArcGIS Enterprise 10.9, when you publish or consume a service that contains a trace network and related network feature classes, some conditions and restrictions apply. These are dependent on the layers that are present in the map view, how the map service is configured, and where the service will be consumed.
Publish a trace network layer
There are conditions and restrictions for sharing trace network and related feature classes as web layers. Analyzer errors are returned when these rules are broken, to prevent publishing. Additional analyzer warnings alert you if your intention is to consume services using ArcGIS Pro.
- The published feature service automatically includes the Trace Network and Network Diagram services to support trace analysis and network diagrams.
- The federated server for the portal must be ArcGIS Server 10.9 or later.
When the trace network layer is present in the active map view, the applicable conditions and restrictions for sharing are as follows:
- Map layers must be from a database connection established as the database trace network owner.
- The connected ArcGIS Enterprise portal account must be the portal trace network owner.
License:
The active portal account must be licensed with the ArcGIS Trace Network user type extension to create, publish, and work with a trace network in an enterprise geodatabase. - The map layers for the published feature service do not support configurations such as definition queries and hidden fields set using the Visible field property—analyzer errors will be returned if these exist.
- The map must contain all of the trace network layers if the intent is to consume in ArcGIS Pro.
- An analyzer warning will be returned if a subset of trace network layers is provided. This is to warn about issues that will arise when consuming services in ArcGIS Pro that were published with a subset of trace network layers.
- Web layers must reference data from registered data sources; in the Share As Web Layer pane, on the General tab and under Data and Layer Type, ensure that Map Image is selected under Reference registered data.
- Include Feature to have access to the trace network layer, the ability to make edits on the default branch version, or the ability to enable the version management capability.
- Web layer properties for feature access must include the Only allow true curve updates by true curve clients option.
- All network layers must be registered as branch versioned.
- Version Management is an optional supported capability. Review Share branch versioned data to understand the conditions enforced by analyzers for branch versioned datasets.
Publish trace network feature classes without a trace network layer
When sharing network feature classes without the trace network layer, the restrictions are lessened. In this case, you can configure the active map view to include a subset of layers using definition queries, make a subset of fields visible, and so on. This allows an organization to share the services and maps with users who require access to a subset of trace network classes.
When the trace network layer is not present in the active map view, the application conditions and restrictions for sharing are as follows:
- The published feature service will not include the Trace Network or Network Diagram secondary services—performing trace analysis or working with network diagrams will not be supported.
- The map layers being published can support definition queries and hidden fields set using the Visible field property.
- This feature service will behave in the same way as any other feature service. Any edits will still apply trace network behavior behind the service (such as dirty area creation), but dirty areas and error features will not be visible on the map.
- The version management capability is optionally supported.
Workflow examples
To understand these conditions for working with services and the trace network, consider the following examples:
GIS editor workflows
A GIS editor is making edits to correct issues identified with a hydro network. That editor needs to see dirty areas and the error features created by edits. The editor will use a feature service created with all of the data and the trace network layer. The ArcGIS Pro project created for this user would contain the trace network layer and all associated network layers.
GIS analyst workflows
A GIS analyst working with a hydro network needs to perform tracing as well as perform other analysis, and map production. The analyst uses a feature service created with all the data and the trace network layer. The ArcGIS Pro project created for this user would contain the trace network layer and all associated network layers.
In this workflow, the GIS analyst needs permission to the whole feature service.
Web access workflows
Some casual users may use web maps configured for specific tasks and workflows. These web maps will be configured to have a reduced set of layers, possibly definition queries on some layers, and a reduced set of visible fields. When a user only needs to view or query data, the web map can use a feature service without a trace network layer.
If the user needs tracing or network diagrams, the web map will need to use a feature service that includes the trace network service and network diagram service.
Field editor workflows
Field editors may use mobile devices to perform limited edits from inspections. These field editors typically use either Esri mobile apps or runtime apps and usually include web maps configured for the apps. Web maps configured for field editing can have a subset of layers from a trace network with definition queries on layers and a subset of fields made visible.
For simple editing workflows such as inspecting equipment or designated hot spots, the web map can use a feature service without the trace network layer, as it will not be necessary in this workflow to display dirty areas or error features.
More complex field editing workflows may require tracing or network diagrams. The web map for these more advanced workflows will require a feature service with the trace network service and the network diagram service.