Imports connectivity, containment, and structural attachment associations from a comma-separated values (.csv) file into an existing utility network.
Associations must be imported from a single .csv file.
The information in the .csv file is stored in the following format: ASSOCIATIONTYPE, FROMFEATURECLASS, FROMASSETGROUP, FROMASSETTYPE, FROMGLOBALID, FROMTERMINAL, TOFEATURECLASS, TOASSETGROUP, TOASSETTYPE, TOGLOBALID, TOTERMINAL, ISCONTENTVISIBLE.
Column Description Example
The type of association.
JUNCTION_JUNCTION_CONNECTIVITY, CONTAINMENT, STRUCTURAL_ATTACHMENT
The feature class participating in the association.
ElectricDistributionDevice, ElectricDistributionAssembly, StructureDevice
The asset group of the feature.
Transformer, Fuse, Elbow
The asset type of the feature.
Streetlight, Attachment, Single-phase padmounted
The global ID of the feature.
The terminal participating in the association. This is only applicable to junction-junction associations.
Single Terminal, Load, Source
A Boolean flag indicating whether the content is visible. This is only applicable to structural attachment and containment associations.
Associations must be in a comma-separated values (.csv) file.
Features listed in the .csv file must exist in the utility network.
Features listed in the .csv file must have supporting rules.
This tool can be used in conjunction with the Export Associations tool.
If an error occurs during the import, for example, a missing rule, the entire import process will be rolled back. Review the errors and inspect the .csv file before re-attempting to import the associations.
The connected ArcGIS Enterprise portal account must be the portal utility network owner.
The input utility network must be from a database connection established as the database utility network owner.
ImportAssociations(in_utility_network, association_type, csv_file)
The utility network receiving the associations.
|Utility Network; Utility Network Layer|
The type of associations to import.
The .csv file containing the associations to import.
The updated utility network.
This sample script imports all types of associations into a utility network called GridNetwork.
import arcpy arcpy.ImportAssociations_un("GridNetwork", "ALL", "C:\\Temp\\AllAssociations.csv")
This sample script imports junction-junction connectivity associations into a utility network called GridNetwork.
import arcpy arcpy.ImportAssociations_un("GridNetwork", "JUNCTION_JUNCTION_CONNECTIVITY", "C:\\Temp\\JJconnectivity.csv")
This sample script imports containment associations into a utility network called GridNetwork.
import arcpy arcpy.ImportAssociations_un("GridNetwork", "CONTAINMENT", "C:\\Temp\\Containment.csv")
This sample script imports structural attachment associations into a utility network called GridNetwork.
import arcpy arcpy.ImportAssociations_un("GridNetwork", "STRUCTURAL_ATTACHMENT", "C:\\Temp\\StructuralAttachment.csv")
- Basic: No
- Standard: Yes
- Advanced: Yes