Add Network Category (Utility Network)

Summary

Adds a network category to an existing utility network.

Categories are used to control analysis at the asset group and asset type levels; for example, you can define whether a particular asset group or asset type is a protective device. You can also define a category type to control how trace analysis is executed; for example, you can specify that a network trace ends at a user-defined category type of ProtectiveDevice.

This tool allows you to add a new network category to a utility network that can be later assigned to a feature class at the asset group or asset type level using the Set Network Category tool.

Usage

• Network categories can later be assigned to a network class for a specific asset group or asset type using the Set Network Category tool.

• When working with an enterprise geodatabase, the connected ArcGIS Enterprise portal account must be the portal utility network owner.

• The network topology must be disabled.

• When working with an enterprise geodatabase, this tool must be connected to the default version when executed.

• When working with an enterprise geodatabase, the Input Utility Network parameter value must be from a database connection established as the database utility network owner.

Parameters

Dialog

Label	Explanation	Data Type
Input Utility Network	The input utility network where the network category will be added.	Utility Network; Utility Network Layer
Category Name	The name of the category to be created.	String

Derived Output

Label	Explanation	Data Type
Updated Utility Network	The updated utility network.	Utility Network

Python

arcpy.un.AddNetworkCategory(in_utility_network, category_name)

Name	Explanation	Data Type
in_utility_network	The input utility network where the network category will be added.	Utility Network; Utility Network Layer
category_name	The name of the category to be created.	String

Derived Output

Name	Explanation	Data Type
out_utility_network	The updated utility network.	Utility Network

Code sample

AddNetworkCategory example (Python window)

Add a category named Protective to the input utility network.

import arcpy
arcpy.AddNetworkCategory_un('Utility Network', 'Protective')

Environments

This tool does not use any geoprocessing environments.

Licensing information

• Basic: No
• Standard: Yes
• Advanced: Yes