启用网络拓扑 (公共设施网络)

摘要

启用公共设施网络的网络拓扑。

该工具评估并建立要素之间的连接，以构建公共设施网络的网络拓扑。 对于追踪和使用网络逻辑示意图等分析操作，需要使用网络拓扑。 还可以启用网络拓扑以查找错误。

注：

从 ArcGIS Enterprise 10.9.1 开始，在使用企业级地理数据库中的公共设施网络时，启用网络拓扑操作将使用 UtilityNetworkTools 地理处理服务进行异步处理。 针对包含公共设施网络的要素服务，将在系统文件夹中对 UtilityNetworkTools 服务进行预配置。 该服务具有更长的超时设置，并且针对公共设施网络地理处理任务保留该服务。

了解有关如何启用网络拓扑的详细信息

使用情况

警告：

在大型公共设施网络上启用网络拓扑时，此操作需要花费一些时间并消耗与网络中要素数量相关的资源。 相应地规划和调整客户端和数据库的大小，以确保操作时有适合进程的 RAM 和磁盘空间。

• 部分网络配置任务仅可在首次启用网络拓扑之前执行。 要了解特定于此工具的任务和所需的网络拓扑状态，请查看公共设施网络管理任务。

• 所有公共设施网络要素类都必须具有空间索引。

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

  • 如果输入公共设施网络参数值来自数据库连接，则必须以数据库公共设施网络所有者身份建立连接。

  • 连接的 ArcGIS Enterprise 门户账户必须为门户公共设施网络所有者。
  • 此工具必须连接到默认版本才能运行。
    • 在启用操作期间，将阻止连接到默认版本的所有其他会话运行验证或启用操作。
  • 公共设施网络必须注册为分支版本。
  • 公共设施网络必须处于非版本化状态才可以使用仅生成错误高级选项。

  • 许可：

    活动门户账户必须被分配 ArcGIS Advanced Editing 用户类型扩展模块，才能在企业级部署中使用此工具。

参数

对话框

标注	说明	数据类型
输入公共设施网络	将启用网络拓扑的公共设施网络。	Utility Network; Utility Network Layer
最大错误数 (可选)	在启用网络拓扑的过程停止之前，将生成最大错误数。 错误将记录在脏区子图层中。 当此参数没有提供值时，可以发现无数个错误。 默认值为 10000。 警告： 提高最大错误数值的同时将增加启用拓扑所需的时间长度。 我们不建议您设置高于默认值 10000 的值。	Long
仅生成错误 (可选)	指定启用拓扑还是仅生成网络错误。 选中 - 将针对网络错误评估公共设施网络。 将不会启用拓扑。 如果要使用企业级地理数据库，则无法将数据注册为版本。 在启用拓扑之前，用于检查并修复网络中的错误。 未选中 - 将启用拓扑，且任何现有错误都将生成包含错误的脏区。 这是默认设置。	Boolean

派生输出

标注	说明	数据类型
更新的公共设施网络	更新的公共设施网络。	Utility Network

Python

arcpy.un.EnableNetworkTopology(in_utility_network, {max_number_of_errors}, {only_generate_errors})

名称	说明	数据类型
in_utility_network	将启用网络拓扑的公共设施网络。	Utility Network; Utility Network Layer
max_number_of_errors (可选)	在启用网络拓扑的过程停止之前，将生成最大错误数。 错误将记录在脏区子图层中。 当此参数没有提供值时，可以发现无数个错误。 默认值为 10000。 警告： 提高最大错误数值的同时将增加启用拓扑所需的时间长度。 我们不建议您设置高于默认值 10000 的值。	Long
only_generate_errors (可选)	指定启用拓扑还是仅生成网络错误。 ONLY_ERRORS—将针对网络错误评估公共设施网络。 将不会启用拓扑。 如果要使用企业级地理数据库，则无法将数据注册为版本。 在启用拓扑之前，用于检查并修复网络中的错误。 ENABLE_TOPO—将启用拓扑，且任何现有错误都将生成包含错误的脏区。 这是默认设置。	Boolean

派生输出

名称	说明	数据类型
out_utility_network	更新的公共设施网络。	Utility Network

代码示例

EnableNetworkTopology 示例 1（Python 窗口）

使用 EnableNetworkTopology 函数启用名为 MyNetwork 的公共设施网络的网络拓扑，并将最大错误数设为 500。

import arcpy
arcpy.un.EnableNetworkTopology('MyNetwork', 500)

EnableNetworkTopology 示例 2（Python 窗口）

使用 EnableNetworkTopology 函数仅针对名为 MyNetwork 的公共设施网络生成错误。

import arcpy
arcpy.un.EnableNetworkTopology('MyNetwork', '', 'ONLY_ERRORS')

环境

此工具不使用任何地理处理环境。

许可信息

• Basic: 否
• Standard: 是
• Advanced: 是