Add Tier Group (Utility Network)

Summary

Adds a tier group to a domain network in a utility network.

This tool is used to add a new tier group to an existing domain network in a utility network. When a tier group exists, the Add Tier tool can be used to add tiers to the tier group.

Usage

• Tier groups can only be added to domain networks that have a hierarchical tier definition.

• 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, the Input Utility Network parameter value must be from a database connection established as the database utility network owner.

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

Parameters

Dialog

Label	Explanation	Data Type
Input Utility Network	The utility network that contains the domain network where the tier group will be added.	Utility Network; Utility Network Layer
Domain Network	The name of the domain network to which the tier group will be added. Tier groups can only be added to domain networks that have a hierarchical tier definition.	String
Tier Group Name	A unique name for the new tier group. The name can be a maximum of 64 characters in length.	String

Derived Output

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

Python

arcpy.un.AddTierGroup(in_utility_network, domain_network, name)

Name	Explanation	Data Type
in_utility_network	The utility network that contains the domain network where the tier group will be added.	Utility Network; Utility Network Layer
domain_network	The name of the domain network to which the tier group will be added. Tier groups can only be added to domain networks that have a hierarchical tier definition.	String
name	A unique name for the new tier group. The name can be a maximum of 64 characters in length.	String

Derived Output

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

Code sample

AddTierGroup example (Python window)

Add a new tier group named Distribution to the hierarchical domain network named GasDistribution.

import arcpy
arcpy.AddTierGroup_un("Utility Network", "GasDistribution", "Distribution")

Environments

This tool does not use any geoprocessing environments.

Licensing information

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