Skip To Content

Define a tier

Tiers are used to organize subnetworks into groups within a domain network. A domain network is composed of one or more tiers forming either a hierarchy of tiers or partitioned groups of tiers. A single tier defines a collection of individual subnetworks that all have the same subnetwork definition.

The Add Tier tool is used to define a tier within a domain network.


To define a tier, the following requirements must be met:

  • The network topology must be disabled.
  • The Input Utility Network parameter must be from a database connection established as the database utility network owner.
  • The connected ArcGIS Enterprise portal account must be the portal utility network owner.
  • The name of the tier must be unique within the domain network.
  • The network classes must be empty.

    It is important to perform all of the network configuration prior to appending data into the network classes. If data is appended to network classes prior to adding a new tier, an error will occur and the Add Tier process will fail. This is due to the Add Tier tool attempting to add the subnetworkname field that is non-nullable to the underlying network feature classes.


To define a tier, complete the following steps:

  1. On the Analysis tab, in the Geoprocessing group, click Tools Tools to open the Geoprocessing pane.
  2. In the Geoprocessing pane, search for and select Add Tier.
  3. For the Input Utility Network parameter, choose a utility network.
  4. For the Domain Network parameter, choose the domain network.
  5. For hierarchical domain networks, enter an existing Tier Group Name.

    If the domain network does not have a Tier Group, use the Add Tier Group tool as a prerequisite.

  6. For the Name parameter, specify a name that is unique for the tier within the entire utility network.

    The name must be a unique tier name within the entire utility network and cannot exceed 128 characters. Supported special characters include the following:

    • Hyphen (-)
    • Colon (:)
    • Ampersand (&)
    • Space ( )
    • Hashtag (#)
    • Forward slash (/)
    • Opening parenthesis (()
    • Closing parenthesis ())

  7. Enter a rank for the tier in the Rank parameter.
  8. Specify a Topology Type. Choices are determined by the tier definition for the domain network. Hierarchical domain networks are automatically assigned a Mesh topology type, while partitioned networks can be assigned Mesh or Radial:
    • Mesh—A closed path (loop) with two or more subnetwork controllers
    • Radial—A non-looped path with one or more subnetwork controllers.
  9. For hierarchical domain networks, enter a field value for Subnetwork Field Name. When adding the initial tier group and tiers for the domain network, provide a new subnetwork field name to add for each domain network feature class. When the domain network contains multiple tier groups, existing subnetwork name fields can be reused when adding tiers that represent the same logical aggregation of a sub system of the domain. If using an existing field, the field must be one that was previously added via the Add Tier tool itself. This field will exist within all domain network classes with the following specifications:
    • Type: esriFieldTypeString

    • IsNullable: VARIANT_FALSE

    • DomainFixed: VARIANT_FALSE

    • Length: 2000

    • IsIndexed: true

    • IsUniqueIndex: false

    • IsEditable: VARIANT_FALSE

    • Default value: "Unknown"

  10. Click Run.

The specified domain network now has a new tier. To view the new tier definition, open the properties page for the utility network. Next, set the subnetwork definition for the tier.

In this topic
  1. Requirements
  2. Steps