Note:
For Utility Network Version 3 and earlier, see Error features.
Errors are generated by the system when a network feature in a utility network is in violation of established rules and restrictions. When an error is discovered, a dirty area is created to encompass the feature's geometry. Errors can be corrected by making edits to the feature geometry, attribute values, network rules, or subnetwork definition. The next time the network topology is enabled or validated, the features with errors are evaluated.
Dirty areas that have associated errors will remain until the error situation is corrected. You can resolve these by making edits to the network feature or by performing configuration changes to allow the error condition. Making configuration changes requires you to disable the network topology.
For more information on error situations and solutions, see the Utility network error IDs section below.
Symbolizing errors
The dirty areas sublayer is used to display errors in a utility network and can be reviewed using pop-ups and the Error Inspector pane. The Contents pane is used to access this sublayer after adding a utility network to an active map view.
Attributes of the dirty area allow you to adjust the symbology and run queries to highlight information on a map, for example, the feature class the error is associated with or the type of error encountered. Information about the specific cause of the error can be identified using the symbology of the dirty area sublayer.
The dirty areas sublayer is symbolized using the Status field to indicate how it was created.
Note:
Information about errors is stored and accessed differently depending on the utility network version used. To learn more, see View errors.
A dirty area is created for network features with errors after enabling or validating the network topology. One or more errors can exist for a feature. These are represented by a single dirty area. The Modify Associations pane is used to display associations that are in error. Associations in error are displayed with an orange indicator next to the associated feature or object in the pane.
Error creation
Errors can result from enabling a network topology, validating a network topology, or updating a subnetwork. Errors can be created for a variety of reasons, from identifying empty geometries and invalid connectivity to discovering incorrect asset types in a subnetwork. For a full list of error situations and solutions, see the Utility network error IDs section below.
Rules supporting connectivity are checked when the network topology is validated or enabled. Therefore, after a network topology is validated or enabled, errors appear for any network features that violate feature restrictions or network rules.
Rules controlling associations are checked when you create or import an association, as well as when a network topology is enabled or validated. Errors are not created for associations when they are created or imported; instead, an error is returned in the tool or pane. Errors are created for associations when a network topology is enabled or validated.
Errors can also be discovered during the initial configuration of a utility network. This is done for the purpose of correcting network errors in data before publishing. You can complete this process before registering the data as versioned by using the Only generate errors option in the Enable Network Topology tool. See Enable a network topology for more information.
Examples of errors
In the example below, a point feature has been placed geometrically coincident to a line feature. There is no rule to allow the two asset types to connect. When the network topology is validated or enabled, errors are generated. In this example, since no rule exists, an error is created for the point and line feature. In addition, the network features are not connected in the network topology.
Another example of a situation that violates restrictions of a utility network is coincident features that create ambiguity with regard to connectivity. These are cases in which there are three or more coincident features, and connectivity rules allow any of them to be connected. For example, a dead end and a riser are located at the same endpoint on a medium-voltage line. There are two connectivity rules: one to allow the medium-voltage line to connect to the dead end and one for the line to connect to the riser. Since there are two possibilities, the utility network tracks this as an error. The utility network will not exhibit random behavior in terms of which feature is connected to which other feature. It will, however, tell you where you need to make that decision by flagging the features with errors.
In the example below, there are two types of network point features (riser and dead end) that do not allow geometric coincidence. Two additional errors will be created to track this violation for the point features.
Utility network error IDs
Modified network features are evaluated when the network topology is validated or enabled. If these modifications violate restrictions or network rules, or create any other invalid situation, errors are produced.
Errors created for utility network features are organized in the following sections based on the operation that caused the error:
Enable and validate network topology errors
The following errors result from enabling a network topology or validating a network topology. The table below lists details about the error including the situation that produces it, suggested actions for resolving it, and the network feature type it can be associated with.
In the Solution column, Option 1 is often the most useful and has the least impact. However, some options depend on other factors, so the first option may not be the best for your particular case. Some options are flagged with (Admin), as they require the network topology to be disabled. Examples of this are adding a domain network, assigning terminal configurations, and changing the edge connectivity policy for a network feature at the asset group and asset type levels.
| Error ID | Description and situation | Solution | Feature type |
|---|---|---|---|
0 | Wrong data type. The field has an invalid data type. A field has been assigned the wrong data type. For example, an integer data type for the field was expected instead of a string data type. | Option 1: Correct the data type for the field. | Point, Line, Junction Object, Edge Object |
1 | The geometry for the network feature is empty. | Option 1: Inspect the Network Source ID and Feature GUID of the dirty area to identify the associated feature in error. Delete and re-create the feature. A dirty area is created in the lower left corner of the Service Territory extent for each feature with empty geometry. After corrections are made, ensure all dirty areas are validated. | Point or Line |
2 | Subtype is unknown. For example, the Asset Group attribute for a network feature has a value of Unknown. | Option 1: Update the asset group attribute to a value other than Unknown. | Point or Line |
5 | Line feature has length within tolerance. The length of a linear network feature is too short and fits within the network tolerance. For example, the network tolerance is 1 meter and a line in the network is 90 centimeters. | Option 1: Adjust the length of the line feature. Option 2: Consider use of a connectivity association or nonspatial edge object to model the network feature. Option 3: Adjust the network tolerance. (Admin) | Line |
6 | Geometry error—Could not locate the vertex along the line feature. The network topology cannot get the list of vertices associated with a linear network feature. | Option 1: Revalidate the network topology. Option 2: Delete the vertex, validate the network topology, and create another vertex if needed. | Line |
8 | Invalid connectivity—No junction-edge or edge-junction-edge connectivity rule exists. There is no junction-edge rule to support the connectivity between a point and a line, for example, there is no rule to allow a low-voltage line to connect to the high side of a circuit breaker, or for a system valve to connect with a water service line. | Option 1: Review the rules in network properties and change the asset group and asset type of the point or line feature to satisfy an existing junction-edge connectivity rule. Option 2: Add a rule to allow connectivity between the origin and destination features. (Admin) | Point, Line, Junction Object, Edge Object |
9 | Invalid connectivity—More than one junction-edge or edge-junction-edge connectivity rule is applicable. This is an ambiguous situation in which more than one rule exists that allows a line to connect to a device feature. It is also possible to receive this error if more than one device exists at the endpoint of a line. For example, a medium-voltage line is connected to a circuit breaker with junction-edge rules that allow the medium-voltage line to connect to either the source or load side of the circuit breaker. Until the terminal connectivity is established, there will be ambiguous connectivity. | Option 1: Use the Modify Terminal Connections pane to specify which terminal on the device the line connects to. Option 2: Ensure that only a single rule exists to allow connectivity between the edge and feature terminal. (Admin) | Point and Line |
10 | Invalid connectivity—Edge features with different asset group and asset type attributes cannot connect. When two edge features share an endpoint and do not have an intermediate junction, they must be from the same asset group and asset type to establish connectivity in the network topology. For example, a medium-voltage/overhead single-phase line and a medium-voltage/overhead three-phase line are snapped together. | Option 1: Modify the asset group and asset type attributes of the edge features to match. For example, if the asset type for one feature is incorrect, modify it to match the other. Option 2: Insert a valid junction feature to connect the two edge features. There must be a supporting edge-junction-edge rule to support these features. | Line |
13 | Invalid connectivity—Edge Connectivity Policy for feature or object does not support AnyVertex. A linear feature that only allows endpoint connectivity has a point or another line feature placed midspan. For example, a tap is snapped to a midspan vertex on a lateral with an edge connectivity policy of end vertex. This does not honor the edge connectivity policy for the line. | Option 1: Relocate the feature to a vertex that honors the line edge connectivity policy. Option 2: Delete the point or line feature. Option 3: Change the edge connectivity policy for the feature. (Admin) | Point and Line |
17 | No containment rule. There is no containment rule to support the containment association between the two nonspatial objects. There is no containment rule to support the containment association between the two objects. This error can occur when a containment association rule is deleted and the object still participates in a containment association that the rule supported. This error can also occur if the asset group or asset type attributes for the object are modified and there are no supporting rules. | Option 1: Review the rules for allowable containment associations in the network properties and modify the object's attributes. Option 2: Create a containment association rule to support the relationship. (Admin) | Junction Object and Edge Object |
18 | No structural attachment rule. There is no structural attachment rule to support the structural attachment association between two objects. This error can occur when a structural attachment association rule is deleted and the object still participates in a structural attachment association that the rule supported. This error can also occur if the asset group or asset type attributes for the object are modified and there are no supporting rules. | Option 1: Review the rules for allowable containment associations in the network properties and modify the object's attributes. Option 2: Create a containment association rule to support the relationship. (Admin) | Junction Object and Edge Object |
19 | A linear network feature is multipart. Multipart features are not allowed. For example, this could be a multipart transmission pipe. | Option 1: Modify the feature so it is not multipart. Option 2: Delete the line and re-create it. | Line |
20 | Self-intersecting line. This can occur in cases in which a linear network feature loops back and overlaps itself at the intersection of two vertices. For example, a valid looped pipe has missing z-values. | Option 1: Place a vertex on each line segment at the point of intersection. Adjust the z-value for each vertex to add vertical space between the lines. Option 2: Split the line into single features. | Line |
21 | Duplicate vertices. A linear network feature has multiple vertices existing in the same x,y,z location or within the network tolerance. For example, a gravity pipe has missing z-values. This may also be encountered in cases where a line has fewer than two vertices. | Option 1: Offset one of the vertices (x and y or z). Option 2: Delete one of the vertices. | Line |
23 | A network feature has an asset type other than the defined asset types for the asset group it belongs to. For example, a pole has a padmounted asset type. Padmounted is not an asset type defined for the Poles asset group. | Option 1: Fix the asset type for that feature. | Point, Line, Junction Object, Edge Object |
25 | Stacked point features. Two or more points are geometrically coincident. For example, a service point and a voltage regulator have the same x,y,z coordinates. Some features cannot exist in the same location, while others can. For more information, see Coincident features. | Option 1: Offset one of the points (x and y or z). Option 2: Delete one of the points. | Point |
31 | Association record is referencing an invalid from or to globalid. The association record (connectivity, containment, or structural attachment) references an invalid from or to GlobalID. An association record persists the from and to GlobalID values of objects participating in the association in the FROMGLOBALID and TOGLOBALID fields of the association record. If either of these fields references a value that is not present, an error is reported. | Option 1: To resolve the association error, locate and delete the remaining feature that participates in the association. The feature can be re-created with a new GlobalID. | Point or Junction Object |
32 | Error setting weight values. This occurs when the attribute has an inline network attribute assigned and the value exceeds the max value for the reserved bits in the network topology. This is determined by the coded value domain used to create the inline network attribute. | Change the attribute value to fall within the range of allowable values for the coded value domain. Review the attribute values for the network feature in the dirty areas table. Inspect attribute fields that have an inline network attribute assigned to determine the specific attribute to edit. The Attributes and Assignments section of the network properties includes details about which network attributes are inline and the domain associated with the network attribute. Assignments list the field that the network attribute is assigned. Explore the Domains view for the allowed coded values. | Point |
34 | Feature in unsupported containment relationship. There is no containment rule to support the containment association between the two features. This error can occur when a containment association rule is deleted and the feature still participates in a containment association that the rule supported or when the asset group or asset type attributes for the feature are modified and there are no supporting rules. This can also be encountered in situations in which a point feature is content of more than one container feature. | Option 1: Review the rules for allowable containment associations in the network properties and modify the feature's attributes. Option 2: Create a containment association rule to support the relationship. (Admin) | Point and Line |
35 | Feature in unsupported structural attachment relationship. There is no structural attachment rule to support the structural attachment association between two features. This error can occur when a structural attachment association rule is deleted and the feature still participates in a structural attachment association that the rule supported. This error can also occur if the asset group or asset type attributes for the feature are modified and there are no supporting rules. | Option 1: Review the rules for allowable structural attachment associations in the network properties and modify the feature's attributes. Option 2: Create a structural attachment association rule to support the relationship. (Admin) | Point and Line |
36 | The line feature has an invalid terminal. An error is encountered when the line feature has a value (other than None or Single Terminal) for the From Terminal or To Terminal fields, and one of the following applies:
| If you delete, move, or reclassify a device with terminals, the line it was connected to will still have attributes that reference the terminal from the previous device. If the To device terminal or From device terminal attribute on the line feature is populated with an invalid terminal ID, the Terminal drop-down menu will display a value of Invalid. The steps below can be used to resolve various scenarios that display this error. If the device at the line's endpoint doesn't support terminals, you have these options:
If there is no device at the endpoint of the line, you have these options:
If the device supports terminals but the From Terminal or To Terminal device terminal value on the line is not a valid value for the terminal configuration, you have these options:
| Point and Line |
37 | A feature with the Subnetwork Tap category must be coincident with one midspan vertex. An error is encountered when subnetwork tap features have the following unsupported conditions:
| Edit the line and tap features to ensure the tap feature is midspan to exactly one line feature. | Point and Line |
38 | Devices with multiple terminals cannot be midspan. An error is encountered when a device with terminals (terminal configuration) is connected to a line midspan. Even though the line feature supports midspan connections (Any Vertex Edge Connectivity), features with terminals should not be midspan. | If you place a device with terminals on a line without splitting it first, you may receive this error. Option 1: Split the line at the location where the device connects to the line. Option 2: Relocate the device feature to a vertex at the endpoint of the line. Option 3: Replace the midspan device feature with a feature that does not have a terminal configuration. Note:For options 1 and 2, you will need to use the Modify Terminal Connections pane to connect the lines to the correct terminals on the device. | Point and Line |
39 | Point feature has invalid terminal configuration. The device feature has an invalid value for the Terminal configuration attribute. This is used to store the valid path for the device feature. | Inspect and edit the Terminal configuration attribute for the specific feature in error. Option 1: Modify the path assigned to the feature using the Modify Terminal Path pane. Option 2: While it is recommended that you use the Modify Terminal Path pane, you can also manually edit the Terminal configuration attribute using the Attributes pane to point to a valid path. Tip:Use the network properties to find the valid paths for the feature by determining the Terminal Configuration Name for the specific asset group and asset type, and inspect the Terminal Configurations section for Valid Paths. | Point |
43 | Self-intersecting edge object. A from/to junction object for an edge object references the same feature. | Modify the junction-edge connectivity association for the edge object so that the associated from and to junction objects are unique. | Edge Object |
44 | Stacked junction objects. | Option 1: Modify the connectivity association so that only a single junction object exists at the location. Option 2: Delete one of the junction objects. | Junction Object |
46 | Validate has discovered system inconsistencies. System inconsistencies that intersect the validation extent were discovered while validating the network topology and could not be cleaned. | Revalidate the impacted dirty areas in the validation extent to clean the errors. | Point, Line, Polygon, Junction Object, Edge Object |
next to the device with the invalid terminal connection to remove connectivity and click Update subnetwork errors
The following errors result from updating a subnetwork in a utility network. When an error is created during the update subnetwork operation, the subnetwork status for the all subnetwork controllers in the Subnetworks table and the associated row in the SubnetLine feature class are changed to Invalid for the modified subnetwork. The table below lists details about each error including the situation that produces the error, the suggested action for resolving it, and the feature type for which the error is generated.
In the Solution column, Option 1 is often the most useful and has the least impact. However, some options depend on other factors, so the first option may not be the best for your particular case. Some options are flagged with (Admin), as they require the network topology be disabled. Examples are adding a domain network, assigning terminal configurations, and changing the edge connectivity policy for a feature at the asset group and asset type levels.
| Error ID | Description and situation | Solution | Feature type |
|---|---|---|---|
24 | Invalid line feature was discovered during update subnetwork. An invalid line feature exists based on the Valid Lines value for the tier. For example, the subnetwork definition for subnetworks in a medium-voltage tier does not allow low-voltage lines. Lines created with asset groups and asset types not defined in the Valid Lines parameter for the tier are flagged during the Update Subnetwork process. | Option 1: Update the asset group and asset type attribute for the line feature to comply with the Valid Lines parameter value for the tier's subnetwork definition. Refer to the network properties to review the Tiers subsection of the specific domain network. Option 2: Make adjustments to the subnetwork definition to include the line or device features by adding their corresponding asset group and asset type as Valid Lines. (Admin) Option 3: Disconnect or break traversability to the line. | Line |
26 | Invalid device feature was discovered during update subnetwork. An invalid device feature exists based on the Valid Devices values defined for the tier. For example, the subnetwork definition for subnetworks in a medium-voltage tier does not allow service points. Devices created with asset groups and asset types not defined in the Valid Devices parameter for the tier are flagged during the Update Subnetwork process. | Option 1: Disconnect or break traversability to the points. Option 2: Update the asset group and asset type attribute for the device feature to comply with the Valid Devices parameter value for the tier's subnetwork definition. Refer to the network properties to review the Tiers subsection of the specific domain network. Option 3: Make adjustments to the subnetwork definition to include the line or device features by adding their corresponding asset group and asset type as Valid Devices. (Admin) | Point |
27 | Invalid parent subnetwork discovered during update subnetwork. An invalid parent subnetwork from a subnetwork controller is discovered during update subnetwork. This can occur for hierarchical domain networks if geometric coincidence was used to establish connectivity to a subnetwork that is not the direct parent. For hierarchical domain networks, subnetworks must have parent subnetworks that are of a higher rank by a value of 1. For example, in a gas network, the isolation zone (tier rank of 3) is directly connected to the system zone (tier rank of 1) instead of the pressure zone (tier rank of 2). Note:This error is generated only with Utility Network Version 1. | Option 1: Ensure your subnetworks are correctly configured within their tier rank. Subnetworks must have a parent subnetwork that is of a higher tier rank by a value of 1. To learn more, see Tier rank. Option 2: If the connectivity is incorrect, correct it. For example, connect the value to the pressure zone first. | Point |
28 | Disjoint subnetwork discovered during update subnetwork. A disjoint subnetwork was discovered in a tier that does not support this type. Updating the subnetwork will create errors for subnetwork controllers if the subnetwork is disjoint and the Support Disjoint Subnetwork property is set to False for the subnetwork definition of the tier. | Option 1: Review the network properties for the specific tier and ensure that all subnetwork controllers that have the same subnetwork name are traversable to each other to prevent disjoint subnetworks. A subnetwork trace can be used to determine traversability. Option 2: Enable support for disjoint subnetworks in the subnetwork definition. (Admin) | Point |
29 | Inconsistent subnetwork name on multiple subnetwork controllers in the same subnetwork discovered during update subnetwork. A subnetwork controller feature was found with an inconsistent subnetwork name when updating the subnetwork. This occurs when multiple subnetwork controllers are traversable to one another but do not have the same subnetwork name. For example, a mesh subnetwork named BPDJ_20 has four subnetwork controllers; one has A_26 instead of BPDJ_20 listed for the Subnetwork Name attribute. | Option 1: If the subnetwork name for the subnetwork controller is wrong, rename it using the Modify Subnetwork Controller pane.
Option 2: If the features connected to each controller are different subnetworks and should be isolated from each other, you will need to determine why they are connected and update your data so they are isolated from each other. Option 3: If the subnetwork controller should not be defining the subnetwork, break traversability by disconnecting this controller from the rest of the subnetwork features. | Point |
30 | Inconsistent parent subnetwork name on multiple parent subnetwork controllers in the same subnetwork discovered during update subnetwork. A subnetwork controller feature was found with an inconsistent parent subnetwork name when updating a set of subnetworks for a hierarchical domain network. This occurs when multiple subnetwork controllers define a parent subnetwork and one is found with a different subnetwork name. | Option 1: If the subnetwork name for the subnetwork controller is wrong, rename it using the Modify Subnetwork Controller pane. Option 2: If the subnetwork controller should not be defining the subnetwork, break traversability by disconnecting this controller from the rest of the subnetwork features. | Point |
33 | Inconsistent controller asset group/asset type. The asset group or asset type of subnetwork controller has been modified. The asset group and asset type for subnetwork controller features cannot be modified. This is to ensure the terminal configuration that is assigned to a specific asset group and asset type for device features stays consistent with what is being stored for the subnetwork controller. | Option 1: Change the asset group and asset type back to the original value for the subnetwork controller. Option 2: To safely make edits to the asset group and asset type fields of a subnetwork controller, disable the subnetwork controller from the device feature before making edits to these attributes. | Point |
40 | Invalid junction feature was discovered during update subnetwork. An invalid junction feature exists based on the Valid Junctions value for the tier. Junctions created with asset groups and asset types not defined in the Valid Junctions parameter for the tier are flagged during the Update Subnetwork process. View the errors for invalid features and inspect the asset group and asset type. Also review the network properties for the utility network. Under Tiers, in the Valid Junctions column, review the asset groups and asset types that have been defined. | Option 1: Change the asset group and asset type for the junction feature to comply with the Valid Junctions parameter value for the tier's subnetwork definition. Refer to the network properties to review the Tiers subsection of the specific domain network. Option 2: Change the subnetwork definition for the tier to include additional Valid Junctions. See Set or modify the subnetwork definition for more information. | Point |
41 | Invalid junction object was discovered during update subnetwork. An invalid junction object exists based on the Valid Junction Objects value for the tier. Junction objects created with asset groups and asset types not defined in the Valid Junction Objects parameter for the tier are flagged during the Update Subnetwork process. View any errors for invalid objects and inspect the asset group and asset type. Also review the network properties for the utility network. Under Tiers, in the Valid Junction Objects column, review the asset groups and asset types that have been defined. | Option 1: Change the asset group and asset type of the invalid object to comply with the Valid Junction Objects parameter value for the tier's subnetwork definition. Refer to the network properties to review the Tiers subsection of the specific domain network. Option 2: Change the subnetwork definition for the tier to include additional Valid Junction Objects. See Set or modify the subnetwork definition for more information. | Junction Object |
42 | Invalid edge object was discovered during update subnetwork. An invalid edge object exists based on the Valid Edge Objects value for the tier. Edge objects created with asset groups and asset types not defined in the Valid Edge Objects parameter for the tier are flagged during the Update Subnetwork process. View any errors for invalid objects and inspect the asset group and asset type. Also review the network properties for the utility network. Under Tiers, in the Valid Edge Objects column, review the asset groups and asset types that have been defined. | Option 1: Change the asset group and asset type of the invalid object to comply with the Valid Edge Objects parameter value for the tier's subnetwork definition. Refer to the network properties to review the Tiers subsection of the specific domain network. Option 2: Change the subnetwork definition for the tier to include additional Valid Edge Objects. See Set or modify the subnetwork definition for more information. | Edge Object |
47 | Invalid subnetwork connectivity, multiple controllers from different tiers found. Multiple subnetwork controllers were found associated with different tiers. This occurs when multiple subnetwork controllers are traversable to one another but do not have the same tier assigned. | Option 1: If the tier associated with the subnetwork controller is wrong, modify the subnetwork controller by updating the role and recreating the controller with the correct tier. Option 2: If the subnetworks should be isolated, you will need to determine why they are connected and update your data so they are isolated from each other. | Point, Junction Object |