Association roles define how certain features participate in a utility network. A utility network has existing system-provided association roles for structures and containers. For features to be set as containers or structures using associations, it is necessary to first set an association role. This is assigned at the feature class level for specific asset groups and asset types. The Set Association Role tool is used to assign the following system-provided association roles:
- Container—Allows features to act as a container to other features
- Structure—Allows features to act as a structure to which other features can be attached
There are additional parameters that can be defined or modified with this tool. These parameters will vary depending on the Role Type specified:
- View Scale—Container only
- Split Policy—Container only
- Deletion Semantics—Container and Structure
To learn more, see Associations.
To set or modify an association role assignment, the following requirements must be met:
- The network topology must be disabled.
- 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.
- Unassigning CONTAINER or STRUCTURE association roles can only be performed prior to the network topology being enabled for the first time.
To set or modify an association role assignment, 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 select Set Association Role.
- For the Input Utility Network parameter, specify a utility network.
- For the Domain Network parameter, enter a domain network.
- For the Feature Class parameter, enter a feature class.
- For the Asset Group parameter, enter an asset group.
- For the Asset Type parameter, enter the asset type you want to assign the association role to.
- For the Role Type parameter, specify the type of role to assign to the asset type: Container, Structure, or None.
Any existing association roles that are assigned will be populated.
- If you chose Container for the Role Type in the previous step, choose the appropriate settings for Deletion Semantics, View Scale, and Split Policy:
- For the Deletion Semantics parameter, specify the deletion semantics to be used for features that participate in the association role. Set to None, Cascade, or Restricted.
- For the View Scale parameter, specify the scale at which to enter into containment mode for features participating in the association role. For example, setting the scale to 5 means that when you enter into containment mode for that feature, the scale on the map will be 1:5. Units are based on the utility network units on the Source tab of the utility network layer properties.
- If the input Feature Class is the Structure Line class, an option is available for Split Policy. This specifies whether content features will be split when the container is split. Set the Split Content option:
- Unchecked—When a container feature is split, its content features will not be split.
- Checked—When a container feature is split, its content features will be split.
- If you chose Structure for the Role Type, specify the appropriate setting for Deletion Semantics to be used for features that participate in the association role:
- Click Run.
The association role is set or changed based on the options used within the tool.