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 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.

Syntax

arcpy.un.AddTierGroup(in_utility_network, domain_network, name)
ParameterExplanationData 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

NameExplanationData 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

Related topics