Export Topology Errors (Data Management)

Summary

Exports the errors and exceptions from a geodatabase topology to the target geodatabase. All information associated with the errors and exceptions, such as the features referenced by the error or exception, is exported. Once the errors and exceptions are exported, the feature classes can be accessed using any license level of ArcGIS. The feature classes can be used with the Select Layer By Location tool and can be shared with other users who do not have access to the topology.

Usage

• The default output location is the location of the specified topology.

• The output of the tool consists of three feature classes, one for each supported geometry type of topology error: points, lines, and polygons. The names of each feature class are created by combining a user-defined base name appended with either PointsErrors, LineErrors, or PolygonErrors.

• The default Base Name parameter value for the three output feature classes is the name of the specified topology.

• Three output feature classes are always created, even if there are no topology errors of each geometry type. Use the Get Count tool to determine if any of the feature classes are empty.

• The field collection of the output feature classes is fixed and can only be modified after exporting. Along with the standard geodatabase feature class fields (ObjectID, Shape, and optional shape length and area fields), the following fields are included and contain information regarding each topology error:

  Field name	Type	Description
  OriginObjectClassName	String	Origin Class Name
  OriginObjectID	Integer	Origin Feature's Object ID
  DestinationObjectClassName	String	Destination Class Name
  DestinationObjectID	Integer	Destination Feature's Object ID
  RuleType	String	Description of the rule that was violated, obtained from the esriTopologyRuleType enumeration
  RuleDescription	String	User-friendly description of the rule that was violated. This description is the same as one provided in the Topology Error Inspector.
  IsException	Integer	Indicates if this error is an exception. A value of 1 identifies the error as an exception.

• Starting at ArcGIS Pro 2.6, the input topology layer can be from a topology service if the service is published with ArcGIS Enterprise 10.8.1 or later. If the layer has been added to the Contents pane, you can drag the layer to the Input Topology parameter, or you can provide the URL of the topology layer feature service, for example, https://myserver.mydomain.com/server/rest/services/myTopoService/FeatureServer/0.

Parameters

Dialog

Label	Explanation	Data Type
Input Topology	The topology from which the errors will be exported.	Topology Layer
Output Location	The output workspace in which the feature classes will be created. The default is the workspace where the topology is located. If the input is a topology service, the default will be the default geodatabase for the project.	Feature Dataset; Workspace
Base Name	The name to prefix to each output feature class. This allows you to specify unique output names when running multiple exports to the same workspace. The default is the topology name.	String

Derived Output

Label	Explanation	Data Type
Output point features	Point topology errors.	Feature Class
Output line features	Polyline topology errors.	Feature Class
Output polygon features	Polygon topology errors.	Feature Class

Python

arcpy.management.ExportTopologyErrors(in_topology, out_path, out_basename)

Name	Explanation	Data Type
in_topology	The topology from which the errors will be exported.	Topology Layer
out_path	The output workspace in which the feature classes will be created.	Feature Dataset; Workspace
out_basename	The name to prefix to each output feature class. This allows you to specify unique output names when running multiple exports to the same workspace. The default is the topology name.	String

Derived Output

Name	Explanation	Data Type
out_feature_class_points	Point topology errors.	Feature Class
out_feature_class_lines	Polyline topology errors.	Feature Class
out_feature_class_polygons	Polygon topology errors.	Feature Class

Code sample

ExportTopologyErrors example (stand-alone script)

The following stand-alone script demonstrates how to use the ExportTopologyErrors function.

# Set the necessary product code
import arceditor

# Import arcpy module
import arcpy

# Local variables:
co_topo_FD_Topology = "C:/Testing/topology.gdb/my_topo_FD/my_topo_FD_Topology"

# Process: Export Topology Errors
arcpy.management.ExportTopologyErrors(co_topo_FD_Topology, 
                                      "C:/Testing/topology.gdb/my_topo_FD", 
                                      "my_topo_FD_Topology")

Environments

This tool does not use any geoprocessing environments.