Add Rule (Utility Network)

This ArcGIS 2.8 documentation has been archived and is no longer updated. Content and links may be outdated. See the latest documentation.

Summary

Adds a rule to a utility network.

All rules created within a utility network are based on network classes at the asset group and asset type levels and can be used to control some behaviors in the utility network.

Usage

  • The network topology must be disabled.

  • The following requirements must be met when working with an enterprise geodatabase:

Parameters

LabelExplanationData Type
Input Utility Network

The utility network for which the rule will be added.

Utility Network; Utility Network Layer
Rule Type

The type of rule to be created.

  • Junction-junction connectivityCreates a junction-junction connectivity rule allowing two point features to connect via a connectivity association (features are offset geometrically).
  • ContainmentCreates a containment rule where the from parameters are the container and the to parameters are the contents in a containment association.
  • Structural attachmentCreates a structural attachment rule where the from parameters are the structure features and the to parameters are the attachment features in a structural attachment association.
  • Junction-edge connectivityCreates an edge-junction connectivity rule allowing edge and junction features to connect via geometric coincidence (features are at the same x,y,z location).
  • Edge-junction-edge connectivityCreates an edge-junction-edge connectivity rule allowing a edge to connect to either side of a junction feature.
String
From Table

The from utility network feature class or table that will be included in the rule.

Structural attachment and containment association rules require that the container or structure feature be in this parameter.

Ordering is irrelevant for the junction-junction, junction-edge, and edge-junction-edge connectivity rules.

String
From Asset Group

An asset group for the From Table to which the rule will apply.

String
From Asset Type

An asset type for the From Table to which the rule will apply.

String
To Table

The to utility network feature class or table that will be included in the rule.

Structural attachment and containment associations rules require that the content or attachment feature be in this parameter.

Ordering is irrelevant for the junction-junction, junction-edge, and edge-junction-edge connectivity rules.

String
To Asset Group

An asset group for the To Table to which the rule will apply.

String
To Asset Type

An asset type for the To Table to which the rule will apply.

String
From Terminal
(Optional)

The from terminal to which the rule will apply. This will be a terminal in the From Table. When creating a connectivity rule for feature with terminals to connect to another feature, the terminal side to connect from must be specified, for example, the high-side terminal on a transformer.

This parameter is required if the asset type has terminals. It is disabled when the structural attachment or containment association rule is specified in the Rule Type parameter.

String
To Terminal
(Optional)

The to terminal to which the rule will apply. This will be a terminal in the To Table. When creating a connectivity rule for feature to connect to another feature with terminals, the terminal side to connect to must be specified, for example, the low-side terminal on a transformer.

This parameter is required if the asset type has terminals. It is disabled for structural attachment or containment association rule types.

String
Via Table
(Optional)

The junction utility network feature class or table to which the rule will apply. This parameter is available only when edge-junction-edge connectivity is selected for the Rule Type parameter, since three feature classes or tables are required to participate in edge-junction-edge connectivity.

String
Via Asset Group
(Optional)

An asset group of the Via Table to which the rule will apply. This parameter is available only when edge-junction-edge connectivity is selected for the Rule Type parameter.

String
Via Asset Type
(Optional)

An asset type of the Via Table to which the rule will apply. This parameter is available only when edge-junction-edge connectivity is selected for the Rule Type parameter

String
Via Terminal
(Optional)

The terminal from the Via Table to which the rule will apply. This parameter is available only when edge-junction-edge connectivity is selected for the Rule Type parameter.

String

Derived Output

LabelExplanationData Type
Updated Utility Network

The updated utility network.

Utility Network

Environments

This tool does not use any geoprocessing environments.

Licensing information

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

Related topics