Skip To Content

Create containment association

Containment associations allow a dense collection of features to be represented by a single feature on the map. This improves visibility in the map view for viewing and editing to promote clean, readable maps. For example, a containment association might include transformers, breakers, and relays inside of a substation.

There are multiple ways to create and manage containment associations between network features.

  • The Modify Modify command launches the Modify Associations pane; this is used to manage containment associations between existing network features.
  • The Enter Containment Enter Containment command is used to enter the containment edit mode to automatically create the containment association when creating content features inside an existing container.
Associations group on the Utility Network Data tab

In this workflow, the Modify Associations pane is used to create or make changes to containment associations for existing network features. In the pane, you select features that will serve as the container and content. The visibility status controls whether or not content features appear in the map when used in conjunction with display filters. By default, new content is set to be hidden unless otherwise specified.

To show or hide containment association content on the map, you can use the Display Content command. The Display Content command is dependent on having a display filter properly configured on the Association status attribute to work. See Control association visibility for more information.


The following are requirements for creating a containment association:


Create a containment association between existing features in a map. An error is returned if there is no rule to support the relationship.

  1. On the ribbon, under Utility Network, click Data.
  2. In the Association group, click Modify Modify.
  3. In the Modify Associations pane, click the Containment tab.
  4. On the Containment tab, click Select a container.
  5. In the map, select the container to which you want to add content.

    Once you have selected the container feature, it appears in the Modify Associations pane along with any existing content.

  6. In the Modify Associations pane, ensure the Add content tool is enabled.
  7. In the map, click the feature or features you want to add as content.

    Once you've clicked a feature, it appears in the Modify Associations pane. The new feature has an asterisk indicating that it is new and has not been saved.

  8. Set the content Visibility check box appropriately.
    • Checked—The content is visible from a map.
    • Unchecked—The content is not visible from a map. This is the default.

    This property will define how the Display Content command interacts with display filters that are configured in the map. See, Control association visibility for information on viewing containment association content features and making changes to the visible status value for containment associations.

  9. Click Apply.

The specified feature or features are set as content in the container. Validate the network topology to incorporate the new association or associations.

In this topic
  1. Requirements
  2. Workflow