Find answers to common questions about a utility network.
Also, see the following topics for additional frequently asked questions:
Getting started
General
Usage
- How can I work with a utility network?
- How do I know if the network topology is enabled or disabled?
- How do I edit utility network features?
- What are nonspatial objects?
- How do I locate nonspatial objects?
- How do I identify errors on nonspatial objects?
- Why is a certain command disabled on the Utility Network Data tab?
- Why are there no subnetworks listed in the Find Subnetworks pane?
- After disabling the network topology for a user version, how do I re-enable the topology?
- How can I write custom tools and buttons in the ArcGIS Pro SDK that work with utility networks?
- How can I work with a utility network web service using REST?
Administration
Getting started
Working with either the single-user or multiuser model deployment of the utility network requires an ArcGIS Desktop Standard or ArcGIS Desktop Advanced license.
The multiuser model deployment pattern utilizes a service-based architecture and is configured and deployed using ArcGIS Pro and ArcGIS Enterprise. The utility network is created and configured using a direct database connection in ArcGIS Pro, and is later published to a feature service in Portal for ArcGIS for consumption.
License:
The active portal account must be licensed with the ArcGIS Utility Network user type extension to create, publish, and work with a utility network in an enterprise geodatabase.You can create and configure a utility network using the Utility Network Package Tools to automate the process, or you can configure it manually using core tools. After the initial implementation, you can use these tools to modify the configuration based on changes in the data model.
Learn more about how to create and configure a utility network
General
The network properties contain important information about the configuration and current state of a utility network. The network properties can be accessed from the following locations:
- The properties context menu of a utility network layer via the Contents pane.
- The properties context menu of a utility network dataset from the Catalog pane.
When working with an enterprise geodatabase, the utility network can be accessed via a database connection, or a service via an ArcGIS Enterprise portal. Depending on the desired task, certain tools and commands require a specific data source for the utility network to be used.
- Configuration tasks generally require the utility network to be accessed using a database connection
- Editing tasks require the utility network to be accessed via the service (web feature layer)
It is helpful to consult with the documentation for the specific tool or command for any data source requirements. The following topics are helpful to review as they discuss the required data sources for certain tasks:
The single-user model does not take advantage of versioned editing.
Consider the following when working with an enterprise geodatabase:
- A utility network can be edited in a nonversioned state during the initial configuration phase when accessed directly from a database connection.
- It is required that a utility network be registered as branch versioned to participate in service-based editing workflows and to enable archiving capabilities. The feature dataset must be registered as branch versioned before publishing via a feature service. Optionally, the Version Management capability can be enabled during publishing. This allows users to create and work with isolated branch versions and perform versioning workflows directly from the feature service. It is recommended that a utility network remain in a versioned state to participate in service-based editing and archiving workflows.
Learn more about how to publish and consume services with a utility network
The Utility Network Package Tools include geoprocessing tools to stage, import, and export a utility network. The tools are designed to work with an asset package to create a utility network schema, load sample data, and import and export a utility network.
To learn more, see an overview of the Utility Network Package Tools.
Usage
Once a utility network is configured and deployed, it can be accessed for editing, administration tasks, performing network analytics, subnetwork management tasks, and so on. To learn more, see Work with a utility network.
To check the state of the network topology for a utility network the network properties can be used. The state of the network topology is listed in the Network Topology section.
Learn more about the network properties
To learn about the required network topology state for different operations, see Utility network management tasks.
Consider the following when working with an enterprise geodatabase:
- The utility network is designed for service-based editing. During the initial configuration phase, an ArcGIS Pro client can be used to edit nonversioned network features using data accessed directly from a database connection. This should be reserved for performing quality assurance checks on datasets in preparation for enabling the network topology and publishing.
- A utility network must be registered as branch versioned before publishing.
- After the utility network is registered as versioned and shared using a feature service, you can make edits to the web feature layers directly through the ArcGIS Enterprise portal.
- This can be from an ArcGIS Pro client or from a web application.
- Offline editing workflows are supported for branch versioned datasets that participate in a utility network.
The single-user model does not take advantage of versioned editing. Learn more about locking and concurrency when editing file geodatabases.
Junction and edge objects are nonspatial network objects used to model and work with a large number of real-world features that share a common geographical space, for example, the strands inside of a fiber cable or conductors in an underground duct. This allows organizations to model their network in more detail without the need to create features with shapes for every asset.
To learn more, see Junction and edge objects.
Associations with spatial features are used to determine the location of nonspatial objects on a map. For example, a port modeled as a nonspatial junction object can be associated with a switch device as content in a containment association. The geometry of the switch device is used to define the location of the port.
To learn more, see Locatability.
Errors on nonspatial junction and edge objects can be discovered through dirty areas on the associated spatial features and using the Modify Associations pane.
To learn more, see Access errors.
Certain tools and commands have enabling conditions required to use the command. For example, certain commands are only enabled when working with a specific data source, or the data is required to be in a certain state.
Use the ToolTip to review the enabling condition by hovering over the command that is currently disabled. You can also review the utility network tab topic for the Enabling condition for each command.
The Find Subnetworks pane relies on the SubnetLine feature class and the Subnetworks table to populate subnetworks. If these have not been populated by the update subnetwork operation, no subnetworks will be listed.
To learn more, see Find a subnetwork.
When working with an enterprise geodatabase, it is possible to disable the network topology in a user version. The Enable Network Topology tool requires that the input utility network reference the default version. If the topology is disabled in a user version, the reconcile process can be used to inherit the topology state from the default branch version.
The single-user model does not take advantage of versioned editing.
The utility network concepts doc provides a good overview of the utility network SDK. If you've never written custom code using the ArcGIS Pro SDK, we recommend reading Build your first add-in. The SDK home page provides a full list of available resources.
The utility network and network diagram services are only available for utility networks using the multiuser model that are shared via services. These services also support feature layer access for editing and the version management capability.
The utility network service supports operations such as trace analysis, network topology operations, updating subnetworks, and so on. The network diagram service supports creating diagrams, working with layouts, and so on.
Administration
The multiuser model uses a service-based architecture where two owners control access for administrative tasks. In addition to the database user that creates a utility network, the active portal user account is recorded as the portal utility network owner. When a utility network is created, these owners are determined based on the user accounts for the database connection and active ArcGIS Enterprise portal.
- The database utility network owner is recorded as part of the fully qualified name of the utility network dataset.
- The portal utility network owner is stored as metadata for a utility network. This can be viewed in the network properties when accessed from the Catalog pane using a database connection as the data owner.
If the correct database and portal users are not used for certain configuration tasks, the following errors are received:
- ERROR 002144: The account logged into Portal must be the owner of the utility network to perform this operation.
- ERROR 001400: Only the data owner may execute <value>.
When working with an enterprise geodatabase, there are certain tasks that are reserved for the database and portal utility network owners to perform. These requirements are clearly noted on the individual workflow or geoprocessing tool help pages.
For example, to execute the enable network topology tool, the portal utility network owner must be signed in to the active portal.
To learn more about which tasks require the database and portal utility network owner to perform, see Utility network management tasks.
When working with an enterprise geodatabase, a utility network dataset has two owners that are used to control access for administrative tasks. In addition to the database user that creates a utility network, the active portal user account is recorded as the portal utility network owner. When a utility network is created, these owners are determined based on the user accounts for the database connection and active ArcGIS Enterprise portal.
- The database utility network owner is recorded as part of the fully qualified name of the utility network dataset.
- The portal utility network owner is stored as metadata for a utility network. This can be viewed using the network properties when accessed using a database connection as the data owner.
While the data owner (database user) cannot be updated without re-creating the data, the portal dataset owner can be updated for a utility network. If the existing portal utility network owner leaves the organization, it is necessary to change the portal owner to another user. This user should comply with the same user type and privilege as the original owner. Refer to the Update Portal Dataset Owner tool for more information.