Network rules control which types of features can be connected to or associated with other types of features. Rules are evaluated to confirm that features are connected or associated correctly. There are five types of rules: junction-junction connectivity, junction-edge connectivity, edge-junction-edge connectivity, containment, and structural attachment.
Network rules can be added one at a time using the Add Rule tool, or imported in bulk using the Import Rules tool. Using the Import Rules tool, the rules are imported from a CSV file. The CSV file can contain several types of rules (for example, containment, junction-junction connectivity, and structural attachment). During the import, any rules in the CSV file that already exist in the utility network are skipped. Any errors encountered will result in a failure of the import and report the line number and column of the CSV file causing the failure.
When importing rules, an asterisk (*) can be used in the CSV file for the asset type and terminal (when applicable) columns. During the import, the asterisk applies the same logic to create new rules as selecting ALL for asset type and terminal parameters when using the Add Rule tool. This will add multiple rules to the utility network by using the existing schema for the network feature class or table for existing asset types and terminals.
Note:
It is recommended that you use a text editor to edit the rule CSV files. Excel can be used to view, but not edit or save, rule CSV files because export filters apply undesired formatting such as extra quotation marks.Requirements
To import network rules, the following requirements must be met:
- The network topology must be disabled.
- Rules cannot be imported to override existing system-maintained feature restrictions.
- When working with an enterprise geodatabase, ensure the following:
- 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.
Import network rules from a CSV file
To import network rules, complete the following steps:
- On the Analysis tab, in the Geoprocessing group, click Tools
to open the Geoprocessing pane. - In the Geoprocessing pane, search for and click Import Rules.
- In the Input Utility Network parameter, specify the utility network receiving the rules.
- For the Rule Type drop-down list, choose the type of rule to import.
Choose All to import all the rule types from the CSV file.
- Specify the name and location of the rules in the Input File parameter.Refer to the Import Rules tool help for the format of the CSV file.
- Click Run.
The rules from the input CSV file have been imported into the utility network. Enable the network topology to allow the system to validate features against the rules.
See View network rules for detailed steps for accessing information within the network properties.
Tip:
When working with an enterprise geodatabase, network rules are managed through a database connection to the default branch version. The utility network service should be stopped before you add or delete a network rule. Changes are acknowledged after the service and ArcGIS Pro session have been restarted. Updates to the utility network rules are not reflected in existing named versions until a reconcile operation is performed.