分析并解决错误

公共设施网络工具箱中的迁移工具集包含三种工具，可为将现有数据迁移到公共设施网络提供简化的流程，以支持基本的编辑和追踪工作流。

分析网络数据工具可评估输入公共设施网络以查找常见类型的拓扑不一致问题，包括自相交线、堆叠点和无效连通性。 该工具生成一个移动地理数据库作为输出，其中包含各种要素类和表，描述在数据中找到的错误类型。 您可以使用这些输出要素类和表了解错误情景并定义针对每种错误类型必须采取的操作。 可以编辑输出“错误解决方案”表并将其用作应用错误解决方案工具的输入来处理错误情景。

了解有关迁移至公共设施网络的详细信息

要求

分析网络数据并查找常见错误类型必须满足以下要求：

• 可启用或禁用网络拓扑。

• 使用企业级地理数据库时，必须满足以下要求：

  • 在使用企业级地理数据库时，输入公共设施网络参数值必须来自以数据库公共设施网络所有者身份建立的数据库连接。

分析网络数据以查找错误

要分析网络数据的常见错误类型，请完成以下步骤：

1. 在分析选项卡上的地理处理组中，单击工具 打开地理处理窗格。

2. 在地理处理窗格中，搜索并选择分析网络数据。

3. 对于输入公共设施网络参数，请指定一个公共设施网络。

   不支持元素服务的公共设施网络。

4. 对于输出位置参数，为包含输出移动地理数据库的文件夹提供路径。

5. 对于输出名称参数，指定输出移动地理数据库的名称。

   默认值为 AnalysisResults。

   将创建一个文件夹，其中包含一个移动地理数据库，其名称是为输出位置参数指定的值。

6. 对于设置默认解决方案操作参数，指定是否将在“错误解决方案”表中填充指定错误类型的默认 Action 属性值。

   该工具填充的任何错误操作值都可以修改。 并非所有错误都有默认错误操作。

   • 选中 - 以下错误类型将使用输出“错误解决方案”表的 Action 字段中的默认解决方案操作填充：

     • 空几何 - 全部删除。

     • 空形状长度 - 从要素类中删除行。

     • 自相交线 - 删除除第一个折点之外的所有折点。

     • 重复折点 - 删除除第一个折点之外的所有折点。

     • 堆叠点 - 删除除第一个顶点之外的所有顶点。

     • 多部分 - 切割。

     • 容差范围内的顶点 - 基于优先级（交汇点 > 端点 > 中点）分配一个锚点，并为所有其他点分配捕捉。

   • 未选中 - 输出“错误解决方案”表中不会使用默认错误操作来填充任何错误类型。 这是默认设置。

   了解有关可用错误操作的详细信息

7. 单击运行。

分析网络数据工具完成并在指定的输出位置创建移动地理数据库。 将使用图层组将“错误汇总”和“错误位置”要素类以及“错误解决方案”表添加到活动地图中。

要素类和表输出

通过分析网络数据工具创建的移动地理数据库包含以下要素类和表：

• ErrorLocations - 描述网络中发现错误的不同位置的点要素类。

• ErrorSummary - 使用多部件要素汇总网络中所有唯一错误组合的多点要素类。

• ErrorRecords - 包含有关每个错误位置处存在的所有要素以及相关错误类型的信息的表。

• ErrorResolution - 描述每组错误的解决方案的表。 这将用作应用错误解决方案工具的输入。

包含移动地理数据库的文件夹还包含一个图层文件 (.lyrx) 和一个 .csv 文件，可用于了解和解决错误：

• 图层组用户符号化在输入公共设施网络内发现的错误。 运行分析网络数据工具时，此图层组的名称将与输出名称参数提供的名称相匹配。 该图层使用移动地理数据库中的其他表和要素类帮助可视化地图中的错误。

• RuleCandidates - 传达可以添加以解决错误的潜在公共设施网络规则的 .csv 文件。

可以使用图层组将输出中的要素类和表与公共设施网络叠加，以提供背景信息并帮助可视化遇到的各种错误。 以下各部分概述了各种输出类及其模式。

错误汇总和错误位置要素类

“错误位置”和“错误汇总”点要素类提供有关在输入公共设施网络中发现的错误的信息。 “错误汇总”要素类包含多点几何，这些多点几何会聚合“错误位置”要素类中具有相同分析类型和错误代码值的所有同类要素，以按类、资产组和资产类型概述公共设施网络中的不同错误类型。

“错误位置”要素类包含错误中每个位置的点要素。 这允许您查看“错误汇总”多点要素所代表的各个位置。 当选择位置要素时，“错误记录”表中的相关记录也会被选中。

注:

选择“错误位置”要素类中的记录会将源要素类添加到地图（如果尚不存在）并选择相关要素。 此关系将使用源数据的绝对路径。 如果源数据移动，关系也必须更新。

“错误汇总”要素类包含以下属性字段：

字段名	字段别名	描述
OBJECTID	对象 ID	多点错误摘要要素的对象 ID。
ErrorCode	错误代码	汇总错误类型的错误代码。
AnalysisTypes	分析类型	此位置存在的要素类、资产组和资产类型。 这包括错误的要素和重合的要素。 提示： 在选项中，将表选项卡上的行高设置调整为三倍，以提高此字段的可读性。
TypesInError	错误类型	错误要素的要素类、资产组和资产类型。
SourceName	源图层	错误要素的要素类。
AssetGroupName	资产组	错误要素的资产组。
AssetTypeName	资产类型	错误要素的资产类型。
Occurrences	具体值	对于 AnalysisTypes 和 ErrorCode 的每个唯一组合，构成多点几何的“错误位置”要素的数量。
ResolutionKey	解决方案键	用于将“错误汇总”要素类链接到“错误解决方案”表的关系键。 选择“错误汇总”要素类中的多点要素会选择“错误解决方案”表中的相关记录。
Shape	形状	要素位置。

“错误位置”要素类包含以下属性字段：

字段名	字段别名	描述
OBJECTID	对象 ID	公共设施网络中单个错误的对象 ID。
ErrorCode	错误代码	与错误要素相关的错误代码。
AnalysisTypes	分析类型	此位置存在的要素类、资产组和资产类型。 这包括错误的要素和重合的要素。
ResolutionKey	ResolutionKey	用于将“错误位置”要素类链接到“错误解决方案”表的关系键。
SHAPE	形状	要素位置。

错误记录表

“错误记录”表包含与“错误位置”表中每个错误相关的要素的详细信息。 添加到地图的图层组包含来自此表的每个要素类的记录子集，这些要素类包含使用定义查询过滤的错误。 在评估可能导致报告的错误情况的其他要素时，此表很有用。

“错误记录”表包含以下属性字段：

字段名	字段别名	描述
OBJECTID	对象 ID	错误记录的对象 ID。
LocationKey	位置键	错误记录的位置键值。 这与“错误位置”要素类中要素的对象 ID 相对应。
ErrorCode	错误代码	与错误要素相关的错误代码。
AnalysisTypes	分析类型	此位置存在的要素类、资产组和资产类型。 这包括错误的要素和重合的要素。
ClassGroupType	要素类型	关联要素的要素类、资产组和资产类型。
SourceID	源图层	与错误记录关联的要素类。
SourceOID	要素 ID	与错误关联的要素的 对象 ID。

错误解决方案表

“错误解决方案”表是一个可编辑的表，用于定义为解决分析网络数据工具发现的错误而必须采取的校正操作。 然后，修改后的表将用作应用错误解决方案工具的输入，以编辑要素并纠正错误方案。

“错误解决方案”表包含以下列：

字段名	字段别名	描述
OBJECTID	对象 ID	解决方案记录的对象 ID。
ErrorCode	错误代码	与错误要素相关的错误代码。
AnalysisTypes	分析类型	此位置存在的要素类、资产组和资产类型。 这包括错误的要素和重合的要素。 提示： 在选项中，将表选项卡上的行高设置调整为三倍，以提高此字段的可读性。
ResolutionKey	解决方案键	与“错误汇总”要素类相关的关系键。
GroupPosition	组位置	分析类型组中行的顺序。
ClassGroupType	要素类型	错误要素的要素类、资产组和资产类型。
SourceNames	源图层	与错误记录关联的要素类。
AssetGroupNames	资产组	与错误记录关联的要素的资产组。
AssetTypeNames	资产类型	与错误记录关联的要素的资产类型。
ErrorContext	快捷菜单	指定记录是否引用了错误中的要素或为上下文提供的重合要素。
ErrorAction	操作	解决错误类型需要执行的纠正措施。 选项如下： 什么都不做 - 不采取任何措施来解决错误。 这是默认设置。 更新全部 - 更新该位置处的所有折点或要素。 更新除第一项之外的所有项 - 更新该位置处除第一个之外的所有折点或要素。 删除全部 - 删除该位置处的所有折点或要素。 删除除第一项之外的所有项 - 删除该位置处除第一个之外的所有折点或要素。 创建 - 创建新要素。 选择此操作时，您必须使用 Create/Update type 属性字段指定将创建的要素类型。 锚点 - 将该位置设置为其他折点将捕捉到的锚点。 捕捉 - 通过同一错误位置处的锚点移动该位置的折点以进行捕捉。 剪切 - 在发生错误的折点处剪切线。 了解有关可用错误操作的详细信息
DeltaX	增量 X	应用于点几何或线顶点的 x 坐标的偏移值。 这仅对更新或创建操作有效。
DeltaY	增量 Y	应用于点几何或线顶点的 y 坐标的偏移值。 这仅对更新或创建操作有效。
DeltaZ	增量 Z	应用于点几何或线顶点的 z 坐标的偏移值。 这仅对更新或创建操作有效。
DeltaStep	增量步进	当同一位置存在多个要素时，这将定义应用于每个后续要素的 DeltaX、DeltaY 和 DeltaZ 字段的偏移值。 这仅对更新或创建操作有效。
ActionClassGroupType	创建/更新类型	创建新要素或更新现有要素时要使用的资产组和资产类型。

使用工具找到的错误类型

虽然分析网络数据工具并非用于识别所有错误，但可以在“错误汇总”和“错误位置”要素类以及“错误解决方案”表中的 Error codes 属性字段中发现并返回以下常见的公共设施网络错误类型。 下表概述了工具可能找到的错误代码、相关错误 ID、错误的描述以及可用于解决“错误解决方案”表中错误的操作（如适用）。

注:

并非所有错误类型都有可用的自动化解决方案。

了解有关修复公共设施网络中连通性错误的最佳实践的详细信息

错误代码	关联错误 ID	描述	可用错误操作
空几何	1	网络要素的几何为空。 当线要素的长度为零或接近零时，可能会发生此错误。	全部删除/删除除第一个顶点之外的所有顶点
未知资产组	2	用于资产群组属性的子类型未知。 将要素迁移到未知资产组时会发生此错误。	更新全部
形状长度	5	线要素的长度在容差范围内。 当线要素的长度为零或接近零时，可能会发生此错误。	全部删除/删除除第一个顶点之外的所有顶点
缺失规则	8	无需交汇点-边规则，交汇点与边要素之间也存在连通性。 此错误不考虑交汇点-交汇点、边-交汇点-边、结构附件或包含规则。	N/A
模糊连通性	9	潜在连接有多个可用规则。 如果线的端点处存在多个设备，则也可能会收到此错误。	N/A
缺少交汇点	10	由于不同资产组和资产类型之间连接的线要素没有中间设备或交汇点要素，因此连通性无效。	创建
边连通性策略	13	线的连通性违反其边连通性策略。 例如，仅允许端点连通性的线要素具有中跨的点要素或其他线要素。	N/A
多部分	19	线性网络要素具有多部分几何。	剪切
自相交线	20	线要素环回并在两个折点的交叉点处与自身相交。	剪切 全部删除/删除除第一个顶点之外的所有顶点
复制折点	21	线性网络要素有多个折点存在于相同的 x,y,z 位置或在网络容差范围内。	全部删除/删除除第一个顶点之外的所有顶点
资产类型无效	23	网络要素的资产类型并非其所属资产组所定义的资产类型。 当要素的资产类型值不是资产群组的资产类型域中的有效值时，会发生此错误。	更新全部
资产组无效	23	网络要素的资产群组的值超出子类型的范围，或者子类型无效。 当要素的资产组值不是其类的有效子类型时，会发生此错误。	更新全部
堆叠点	25	两个点或更多点在几何上重合或在网络容差容差内。 例如，服务点和电压调节器具有相同的 x,y,z 坐标。	全部删除/删除除第一个顶点之外的所有顶点
终端无效	36	线要素具有无效的终端。 当线的“自终端 ID”或“至终端 ID”属性对于某个连接的设备无效时，就会发生这种情况。	N/A
子网分流器	37	在两条线的端点处绘制具有子网分流器类别的要素。	N/A
中跨终端设备	38	沿线具有多个终端的设备不能为中跨。 当终端设备绘制在线的中跨时，就会发生这种情况。	N/A
容差范围内的顶点	N/A	来自单独要素的两个或多个折点在数据集的空间容差内，但在拓扑上不重合。	锚点 捕捉

可用错误操作

下表介绍了可用于使用该工具解决错误的操作

操作	描述
创建	创建新要素。 选择此操作后，必须使用 Create/Update type 字段指定要素的类型。
更新全部 更新除第一项之外的所有项	更新相应的折点或要素。 如果有多个要素与修复关联，则可以选择更新所有要素或更新除第一个要素之外的所有。 此操作还可用于使用 DeltaX、DeltaY、DeltaZ 和 DeltaStep 字段更新要素的位置。 当有多个重合要素时，请为 DeltaStep 属性指定一个值，以确保每个要素都从前一个要素偏移。 要素的资产组或资产类型也可以使用 Create/Update type 字段进行更改。
全部删除 删除除第一项之外的所有项	删除相应的折点或要素。 如果有多个要素与修复关联，则可以选择删除所有要素或折点，或者删除除第一个要素或折点之外的所有。
锚点 捕捉	锚点和捕捉操作用于解决“容差范围内的顶点”错误。 “锚点”操作可将一个这单或要素定义为锚点位置，而“捕捉”可将另一个折点或要素捕捉到锚点位置。
剪切	在发生错误的折点处剪切线。 用于处理自交线时，将缩短现有线要素，并为剩余几何创建新线要素。 用于处理多部分几何时，此操作将创建具有与原始要素匹配的属性值的单部分要素。

定义错误解决方案操作

“错误解决方案”表用于定义为解决分析网络数据工具发现的各种错误而必须采取的校正操作。

例如，要定义解决自交线错误所需的操作，请完成以下步骤：

1. 将公共设施网络和所有关联类添加到活动地图。

2. 添加图层组（.lyrx 文件），其中包含“错误汇总”要素类、“错误位置”要素类、“错误记录”表和“错误解决方案”表。

   默认情况下，此文件位于运行分析网络数据工具时在输出名称参数中指定的文件夹中。

3. 在内容窗格中右键单击错误汇总要素类，然后单击属性。

   将打开“错误汇总”要素类的属性表。

4. 识别具有自相交线错误代码的记录，然后选择该行。

   “错误解决方案”表中的“错误汇总”多点要素和相关行被选中。

5. 右键单击“错误汇总”属性表中选定的行，然后单击缩放至。

   缩放地图以显示与错误相关的所有摘要记录。

   您可以单独查看每个摘要要素，以便使用关联的“错误位置”要素和“错误记录”表更好地了解错误。

6. 右键单击内容窗格中的错误解决方案表，然后单击打开。

   “错误解决方案”表的属性表随即打开。

7. 在“错误解决方案”表中，使用显示所选记录来过滤表。

8. 对于所选记录，识别上下文值为错误的记录并查看操作属性值。

   如果在运行分析网络数据工具时选中了设置默认解决方案操作参数，则会为字段指定默认解决方案操作删除除第一项之外的所有项。 如果不是，请从字段的下拉列表中选择此值。 此操作会导致应用错误解决方案工具删除相交位置处线的所有折点（第一个折点除外）。

9. 在功能区的管理编辑内容组中，单击保存以保存编辑内容。

已经针对分析网络数据工具找到的错误定义了解决方案操作。 您可以使用“错误解决方案”表作为应用错误解决方案工具的输入来编辑公共设施网络数据并解决错误。

了解有关如何应用错误解决方案的详细信息