Import network associations

Large collections of associations can be imported into a utility network from a CSV file using the Import Associations tool.

During the import process, the CSV file is evaluated to ensure the features listed are present in the utility network. The import process also verifies whether a rule exists allowing the associations to connect, contain, or attach. The CSV file can contain one type or a mixture of association types (for example, only containment or containment, connectivity, and structural attachments). Any errors experienced during the import will result in the entire import process being rolled back. Review errors and inspect the CSV file before reattempting the import process.

See Associations for more information on each type of association.


When importing a CSV file with a large number of associations, it is recommended that you temporarily disable the network topology to increase the performance of the tool. Once the associations are imported, enable the network topology again.


To import network associations, the following requirements must be met:

  • The CSV file must be formatted correctly. Refer to the Import Associations tool for the CSV requirements.
  • Rules must exist to support the associations in the CSV file. If a rule is missing, an error will be returned and the entire import process will be rolled back.
  • When working with an enterprise geodatabase, the Input Utility Network parameter must be from a database connection established as the database utility network owner.


To import network associations, 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 Import Associations.
  3. For the Input Utility Network parameter, enter the utility network receiving the associations.
  4. From the Association Type drop-down parameter, choose the type of association to import:
    • All
    • Junction-junction connectivity
    • Containment
    • Attachment
    • Junction-edge connectivity (from side of edge)
    • Junction-edge connectivity (midspan)
    • Junction-edge connectivity (to side of edge)
  5. Specify the name and location of the association CSV file in the Input File parameter.

    See the Import Associations tool help for information on formatting the CSV file.

  6. Click Run to execute the tool.

The specified associations have been added to the selected utility network. If the network topology is disabled, enable it to reflect the associations between features.

In this topic
  1. Requirements
  2. Steps