Delete Rule (Utility Network)

Summary

Permanently deletes a rule from a utility network.

Caution should be taken when deleting rules that support existing features in a utility network. Existing features that rely on deleted rules are marked with error features when the network topology is re-enabled to indicate there is no rule to support the relationship.

Usage

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

Parameters

Dialog

Label	Explanation	Data Type
Input Utility Network	The utility network for which the rule will be removed.	Utility Network; Utility Network Layer
Rule Type	The type of rule being deleted. All—Delete all rules. Junction-junction connectivity—Delete a junction-junction connectivity association rule. Containment—Delete a containment association rule. Structural attachment—Delete a structural attachment association rule. Junction-edge connectivity—Delete a junction-edge connectivity rule. Edge-junction-edge connectivity—Delete an edge-junction-edge connectivity rule.	String
Rules	Specifies which rule to remove. This includes the rule ID and the description of the rule. Note: You can find the rule ID by browsing the Rules section of the Network Properties, which is available on the Layer Properties dialog box.	String

Derived Output

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

Python

arcpy.un.DeleteRule(in_utility_network, rule_type, rule_desc)

Name	Explanation	Data Type
in_utility_network	The utility network for which the rule will be removed.	Utility Network; Utility Network Layer
rule_type	The type of rule being deleted. ALL—Delete all rules. JUNCTION_JUNCTION_CONNECTIVITY—Delete a junction-junction connectivity association rule. CONTAINMENT—Delete a containment association rule. STRUCTURAL_ATTACHMENT—Delete a structural attachment association rule. JUNCTION_EDGE_CONNECTIVITY—Delete a junction-edge connectivity rule. EDGE_JUNCTION_EDGE_CONNECTIVITY—Delete an edge-junction-edge connectivity rule.	String
rule_desc	Specifies which rule to remove. This includes the rule ID and the description of the rule. Note: You can find the rule ID by browsing the Rules section of the Network Properties, which is available on the Layer Properties dialog box.	String

Derived Output

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

Code sample

DeleteRule example (Python window)

Delete a junction-junction connectivity association rule that allows a service point to connect to the load side of a circuit breaker in an electric network.

import arcpy
arcpy.DeleteRule_un("Electric Network", "JUNCTION_JUNCTION_CONNECTIVITY", 
                    "2: From[ElectricDistributionDevice.ServicePoint] From[ElectricDistributionDevice.CircuitBreaker.Load]")

DeleteRule example 2 (Python window)

Delete a junction-edge connectivity rule that allows a low-voltage line to connect to the load side of a circuit breaker in an electric network.

import arcpy
arcpy.DeleteRule_un("Electric Network", "JUNCTION_EDGE_CONNECTIVITY", 
                    "72: From[ElectricDistributionLine.LowVoltage] From[ElectricDistributionDevice.CircuitBreaker.Load]")

DeleteRule example 3 (Python window)

Delete an association rule that was allowing a transformer to be contained in a junction box.

import arcpy
arcpy.DeleteRule_un("Electric Network", "CONTAINMENT", 
                    "153: From[StructureJunction.JunctionBox] To[ElectricDistributionDevice.Transformer]")

DeleteRule example 4 (Python window)

Delete a structural attachment association rule that was allowing a service point to be attached to a pole.

import arcpy
arcpy.DeleteRule_un("Electric Network", "STRUCTURAL_ATTACHMENT", 
                    "126: From[StructureJunction.Pole] To[ElectricDistributionDevice.ServicePoint]")

Environments

This tool does not use any geoprocessing environments.

Licensing information

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