Associations enable the modeling of connectivity, containment, and structural attachment between nonspatial and non-coincident network features.
The utility network has the following types of associations:
Associations are created using the Modify Associations pane, the Import Associations tool, or through an attribute rule. Each type of association has its own type of network rule that can be created to ensure data quality by restricting the types of network features that can be associated. These rules are enforced when creating associations using the Modify Associations pane and during import. If a rule does not exist to support an association, the Import Associations tool fails.
Work with associations
You can work with associations in various ways in ArcGIS Pro depending on your workflow.
You can use the Modify Associations pane to create, select, modify, and delete associations between network features. This pane checks association rules to ensure the selected features or objects can connect, attach, or participate in containment.
- You can use the Select Associated Data command for selected features or objects in the Attributes pane to select and work with associated network features.
Modify Associations pane
The Modify Associations pane is used to create, select, modify, and delete associations between network features. This pane is used to check association rules to ensure the selected features or objects can connect, attach, or participate in containment. You can create network rules to allow associations to be established between network features as long as utility network feature restrictions are honored.
The Modify Associations pane provides the following tools to work with and manage associations between network features:
Add features —Use this command to select one or more features on the map to populate Active Item.
Load selected—Use this command to populate the Active Item drop-down menu with a selection on the map or from the attribute table.
Active Item—This drop-down menu enables you to specify the target feature or object to work with when multiple items are selected or loaded to the pane.
Modify Associations Menu —This drop-down menu provides access to additional options to work with and manage associations in the pane. See the Modify Associations menu section below for additional details.
Association tabs—Three tabs at the top of the pane allow you to switch between association types for the network feature set as the active item. The number of associations for each type is displayed by an indicator next to the Connectivity, Containment, and Attachment tabs. Some tabs may not be visible depending on the active item selected.
Sections—Each association tab contains multiple sections that can be expanded or collapsed to work with associations for the active item. Certain sections may not be visible depending on the active item selected.
Add features to section —Use this command to select one or more features on the map to populate the specified section.
Add selected—Use this command to populate the specified section from a selection on the map or from attribute tables.
Modify Associations menu
Additional options are accessible from the Modify Associations Menu to work with and manage associations in the pane:
- Remove All Associations—Marks all associations for the network feature in Active Item across all three association tabs to be deleted.
- Remove Connectivity Associations—Marks all connectivity associations for Active Item to be deleted.
- Remove Containment Associations—Marks all containment associations for Active Item to be deleted.
- Remove Attachment Associations—Marks all attachment associations for Active Item to be deleted.
- Select All Associated Records—Creates a selection of all records with associations to Active Item.
- Expand All—Expands all sections across all three of the association tabs.
- Collapse All—Collapses all sections across all three of the association tabs.
- Refresh—Refreshes the pane to display the existing associations for Active Item. This option allows you to refresh the pane following validation or to revert changes that have not been applied in the pane such as the creation of associations or those marked for deletion.
- Clear—Clears the Modify Associations pane of the active item and all associated network features.
Use the Attributes pane to select associated data
The Attributes pane contains a Select Associated Data command that exposes a list of valid association types for the selected feature or object that can be used for selection of associated data. Valid association types are determined by the Association status attribute of the selected feature or object. The selection created by the Select Associated Data command is added to the current selection in the Attributes pane .
Learn more about how to view and edit utility network feature and object attributes
The following options are available on the Select Associated Data command:
- All—Select all associated features or objects.
- Connectivity—Select network features with connectivity associations to the selected feature or object.
- Contained In —Select the container associated with the selected content feature or object.
- Contains—Select content features associated with the selected container.
- Attached To—Select structure features or objects associated with the selected item through a structural attachment association.
- Attachments—Select attached features or objects associated with a selected structure through a structural attachment association.
You can use the Select Associated Data command for an individual network feature in the pane's selection tree view or perform a bulk selection of associated data by right-clicking the layer to select associated data for all selected network features.
Note:Selections are organized by layer in the pane and can contain multiple items. When a large selection of features or objects is present in the Attributes pane and the layer is right-clicked, the Select Associated Data command will display all association types, whether or not valid associations are present for the selection.
You can select associated features and objects for the selected items in the Attributes pane by doing the following:
- On the Edit tab, in the Selection group, click Attributes .
- Select features or objects in the network to be added to the pane.
- Click the Selection tab.
- Click the Select tool to select features in the map.
Alternatively, create a selection in the attribute table.
- Select associated data for the selected items.
- Right-click the feature or object to select associated data for the specific network feature.
- Right-click the layer to perform a bulk selection of associated data for all selected network features in the layer.
- Right-click the layer or selected feature or object.
A context menu containing various commands to work with the selection is displayed.
- Click the Select Associated Data command to display valid association types for the selected network features.
- Select an association type from the list.
Associated data for the selected item is added to the selection in the Attributes pane .
All network features in a utility network have an attribute called Association status. This attribute indicates the type of association a feature or object participates in, the role the network feature plays in the association relationship, and any properties that are set, for example, visible content. This attribute is used to control the visibility of associations in the map and to determine the valid association types for the selected feature or object in the Attributes pane .
See Association status attribute for details.
Associations do not have attributes or a Shape field, and they do not support relationship classes or join tables. Associations are internally managed in a system-maintained table. Although associations do not have a Shape field, you can view them using one the following workflows:
- Click the Modify Associations pane to interactively view associated network features. For example, by clicking the Containment tab and selecting a container feature on a map, you can see features that are content. Connectivity associations will also show terminals for associated features if they exist.
- Create a network diagram to visualize the associations in a diagram view.
- Click the View Associations button to view connectivity or structural attachment associations on the map.
- Click the View Content drop-down menu to show or hide containment association content. This enables or disables display filters configured using the association status attribute to turn content feature display on and off based on their visibility property.
See Control association visibility for more information about viewing associations.
Structural attachment and containment associations require that an appropriate association role be assigned to the feature classes and tables that represent network features that serve as structures or containers. Use the Set Association Role tool to designate the specific association role type along with additional properties. The Role Type of Structure or Container is assigned to a network class that will serve as a structure in a structural attachment association or a container in a containment association using specific asset groups and asset types. An association role must be set before creating structural attachment and containment rules.
Once an association role is assigned, features and objects from the network classes with supporting network rules can be included in an association as long as they have supporting network rules.
- Container—All network classes in the structure and domain networks can have the container role assigned and serve as a container.
- Structure—In structure networks, the following network classes can have the structure role assigned and serve as a structure: structure junction, structure line, structure boundary, structure junction object, and structure edge object.
To review the valid structural attachment and containment relationships permitted, see Feature restrictions.
To determine whether a feature class or table has an association role set, review the Network Properties tab for the utility network. From here, expand the appropriate domain or structure network and inspect the Association Role column for specific asset groups and asset types.
Review the section below for additional properties that are set for association roles.
Deletion Semantics, View Scale, and Container Split Policy
Additional properties can be defined with the Set Association Role tool. The properties are applicable to specific association roles and will vary depending on the specified Role Type.
The following list outlines additional association role properties and whether they apply to a container or structure:
- View Scale—Container only
- Deletion Semantics—Container and structure
- Container Split Policy—Container only (structure line feature class)
The View Scale property is specific to the container role. It determines what map scale to set when you enter containment mode, for example, 1:100. This property does not apply to junction and edge objects.
The Deletion Semantics properties apply to both the container and structure association roles. They determine how child features are handled when the parent feature is deleted. For example, if a pole structure is deleted, the deletion semantics control how attachments are impacted. For containment associations, when the container is deleted, the deletion semantics control how content features are impacted.
There are three types of deletion semantics:
- Restricted—If content or attachment features exist, an error is returned when attempting to delete the container or structure. The content or attachment features must be removed before deleting the container or structure.
- Cascade—When a container or structure is deleted, its content or attachment features are also deleted.
- Set to none—When a container or structure is deleted, its content or attachment features are not deleted; instead, it is removed from the containment or structural attachment association.
The Container Split Policy property is specific to the Container association role and only set for structure line feature classes. It is used to determine how content is treated when a container feature is split. The options for the container split policy are Do Not Split Content (default) or Split Content. If using a split policy of Do Not Split Content, a new container feature is created from the split operation and content is not split. The content feature is maintained as content to both parent containers. With the policy of Split Content, content features are also split and properly associated with the new container features created during the split operation.
To learn more, see Set or modify an association role assignment.