A utility network is the main component users work with when managing utility and telecom networks in ArcGIS, providing a comprehensive framework of functionality for modeling utility systems such as electric, gas, water, storm water, wastewater, and telecommunications. It is designed to model all of the components that make up your system—such as wires, pipes, valves, zones, devices, and circuits—and allows you to build real-world behavior into the network features you model.
You can create utility networks in ArcGIS Pro and publish them as feature services to your portal's federated ArcGIS Server site that is registered with an enterprise geodatabase. Publishing creates a service with feature access, version management, utility network, and network diagram capabilities enabled on the federated server. Map image layer and feature layer items are created in the portal. Additionally, you can add named trace configurations to utility networks in ArcGIS Pro and share them to your portal through web maps.
Once shared with your portal, you can use utility network web maps and feature layers in Map Viewer to access utility networks, add dirty areas, view associations between network features, and run traces to understand how network assets are connected and operate in the field.
Add utility networks to maps
To add a utility network to a map, complete the following steps:
- Confirm that you are signed in and, if you want to save your changes, that you have privileges to create, update, and delete content.
- In Map Viewer, open a web map containing a utility network or add a feature layer containing a utility network to a new map.
- On the Contents (dark) toolbar, click Map properties
. - In the Utility networks section of the Map properties pane, click Add
to add the utility network to the map.Note:
The utility network does not appear as a layer in the Layers pane in Map Viewer. - To remove the utility network from the map, click Options
next to the utility network and click Remove.
When the utility network is added to the map, you can add dirty areas and view associations.
Add dirty areas
Dirty areas serve as visual markers to track the location of network modifications that are not reflected in the network topology. They can be accessed as a sublayer of the utility network and symbolized in the same way as any other layer.
To add dirty areas to a map, complete the following steps:
- Follow the first four steps of the Add utility networks to maps workflow.
- In the Utility networks section of the Map properties pane, locate the utility network.
- Click Options next to the utility network and choose Add dirty areas.
When this workflow is complete, the dirty areas layer of the utility network is added as a layer to the map. Now, anytime you make modifications to the network, a visual marker is added to the extent of the dirty area. You can validate the network topology in ArcGIS Pro to remove the dirty areas and update the network topology.
View associations
In Map Viewer, you can view connectivity and structural attachment associations between utility network features.
To view associations, complete the following steps:
- Follow the first four steps of the Add utility networks to maps workflow.
- On the Settings (light) toolbar, click Utility network associations.
The Associations window appears on the map.
- Turn on the View associations toggle button and pan and zoom the map to view associations.
Note:
If the map extent contains associations that exceed the maximum allowable associations limit, the Associations window will show a warning prompting you to zoom into a smaller extent. - Click Expand
to reveal the two association options: Connectivity associations and Structural attachment associations.Both association options are turned on by default when you first turn on the View associations toggle button.
- Optionally, turn on or off each association option individually.
Add associations
In Map Viewer, you can add connectivity, containment, or structural attachment between nonspatial and noncoincident network features.
To add an association, complete the following steps:
- Follow the first four steps of the Add utility networks to maps workflow.
- On the Settings (light) toolbar, click Edit
.The Editor pane appears.
- In the Editor pane, under Edit features, click Select and select a feature on the map.
The Edit feature pane appears.
- In the Edit feature pane, choose an association type.
Note:
Association types are only available if you authored a form with association elements for the layer to which the feature belongs. The association types you see depend on the association elements you added to the form.
- Click Add.
- Choose a layer under Available layers.
Optionally, type search terms in the Filter layers field to help you find the layer you want.
Note:
If you do not see any layers, there are no layers with features compatible with the selected feature and association type.
- Select the feature with which you want to establish the association.
Optionally, type search terms in the Filter features field or click Filter options
to build a filter to help you find the feature you want. - Select the desired configuration options and click Add.
Note:
The configuration options you see depend on the type of association you are adding and whether the feature is spatial or nonspatial.
Delete associations
To delete an existing association, complete the following steps:
- Follow the first four steps of the Add utility networks to maps workflow.
- On the Settings (light) toolbar, click Edit .
The Editor pane appears.
- In the Editor pane, click Select under Edit features and select a feature on the map.
The Edit feature pane appears.
- In the Edit feature pane, choose an association type.
Note:
Association types are only available if you authored a form with association elements for the layer to which the feature belongs. The association types you see depend on the association elements you added to the form.
- Select a layer.
Note:
If you do not see any layers, there are no existing associations.
- Select the feature you no longer want to associate with.
Optionally, type search terms in the Filter by feature title field to help you find the feature you want.
- Click Expand next to the Delete button and click Delete association.
Note:
When you click Delete association, only the association is deleted. If you click Delete, both the feature and the association will be deleted.
Build filters
Use the Filter Builder pane to build a filter with one or more conditions, narrowing down available features to make association editing easier.
To build a filter condition using Filter Builder, complete the following steps:
- Follow the first six steps of the Add associations section.
- Click Filter options .
The Filter Builder pane appears.
- In the Conditions group, click Add new.
- Click the field selector and select a field to use for the expression.
- Click the operator selector and select an operator: is, is not, includes, excludes, or contains.
- In the value input box, provide a value to use in the expression.
The value input box varies depending on the field type and the operator. For example, if you selected the is or is not operator, you select from a list of data values in the specified field.
- Optionally, add another expression to the filter by clicking Add new and repeating steps 3 through 6 for each new filter expression.
Tip:
To create a similar expression to the one you created, click Options
on the expression and click Duplicate. Make the necessary changes to the duplicate group. To delete an expression, click Options and click Delete.
- Click Apply to save and apply the filter to the layer.
Tip:
To remove an expression from the filter, click Options and click Delete. To remove all expressions, click Clear.
Trace utility networks
You can run traces on web maps published with a utility network and named trace configurations. Traces can be run based on connectivity or traversability from set input flags, and results are returned as a selection, graphics, or both.
Configure traces
Web maps published with utility networks can include several named trace configurations in their map definition. Before you can run traces, you need to configure the trace options.
To configure traces, complete the following steps:
- In Map Viewer, open a web map containing a utility network and named trace configurations.
- On the Contents (dark) toolbar, click Map properties .
- In the Utility networks section of the Map properties pane, click Add to add the utility network to the map.
Note:
The utility network does not appear as a layer in the Layers pane in Map Viewer. - Click Options next to the utility network and click Configure traces.
- From the list of named trace configurations, select which
configurations to include as trace options when running traces.
Optionally, do any of the following to help you find
configurations:
- Type search terms in the search box.
- Click Sort to sort the list as desired, such as by name or description.
- Click Info next to a configuration to see its details.
Run traces
Once you've configured traces for a utility network, you can run one or more traces concurrently.
To run a trace, complete the following steps:
- On the Settings (light) toolbar, click Utility network trace.
A trace window appears on the map.
- On the Inputs tab, click the Trace types drop-down menu and choose from the named trace configurations you included in the previous section.
You can choose multiple named trace configurations.
- In the Starting points section, do any of the following:
- To add a feature as a starting point, click Add point and select the feature on the map.
- To add a nonspatial object as a starting point, do the following:
- Click Expand and click Add nonspatial object.
- Select a feature on the map.
- Navigate through its associations and find the nonspatial object.
- Click the name of the nonspatial object and click Add nonspatial object.
Note:
You can add multiple starting points.
Note:
To add a nonspatial object as a starting point, the map must have pop-ups configured with one or more association elements.
- If a starting point has multiple terminals, click Expand next to its name and choose one or more terminals from the Select terminals drop-down menu.
- Optionally, in the Barriers section, do any of the following:
- To add a feature as a barrier, click Add point and select the feature on the map.
- To add a nonspatial object as a barrier, do the following:
- Click Expand and click Add nonspatial object.
- Select a feature on the map.
- Navigate through its associations and find the nonspatial object.
- Click the name of the nonspatial object and click Add nonspatial object.
Note:
You can add multiple barriers.
Note:
To add a nonspatial object as a barrier, the map must have pop-ups configured with one or more association elements.
- If a barrier has multiple terminals, click Expand next to its name and choose one or more terminals from the Select terminals drop-down menu.
- Click Run.
When a trace has been run successfully, its results are displayed in the Results tab. The type of result that appears depends on the Result Types parameter specified when adding a named trace configuration to your utility network in ArcGIS Pro.