启用公共设施网络的网络拓扑。
对于追踪和网络逻辑示意图等分析操作，需要使用网络拓扑。 还可以启用网络拓扑以查找错误。
从 ArcGIS Enterprise 10.9.1 开始，在使用企业级地理数据库中的公共设施网络时，启用网络拓扑操作将使用 UtilityNetworkTools 地理处理服务进行异步处理。 针对包含公共设施网络的要素服务，将在系统文件夹中对 UtilityNetworkTools 服务进行预配置。 该服务具有更长的超时设置，并且针对公共设施网络地理处理任务保留该服务。
在大型公共设施网络上启用网络拓扑时，此操作需要花费一些时间并消耗与网络中要素数量相关的资源。 相应地规划和调整客户端和数据库的大小，以确保操作时有适合进程的 RAM 和磁盘空间。
部分网络配置任务仅可在首次启用网络拓扑之前执行。 要了解特定于此工具的任务和所需的网络拓扑状态，请查看公共设施网络管理任务。
所有公共设施网络要素类都必须具有空间索引。
使用企业级地理数据库时，需要满足以下要求：
如果输入公共设施网络参数值来自数据库连接，则必须以数据库公共设施网络所有者身份建立连接。
| 标注 | 说明 | 数据类型 |
输入公共设施网络 | 将启用网络拓扑的公共设施网络。 | Utility Network; Utility Network Layer |
最大错误数 (可选) | 在启用网络拓扑的过程停止之前，将生成最大错误数。 错误将记录在脏区子图层中。 默认值为 10000。 警告：提高最大错误数值的同时将增加启用拓扑所需的时间长度。 我们不建议您设置高于默认值 10000 的值。 | Long |
仅生成错误 (可选) | 指定启用拓扑还是仅生成网络错误。
| Boolean |
| 标注 | 说明 | 数据类型 |
| 更新的公共设施网络 | 更新的公共设施网络。 | Utility Network |
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 (可选) | 指定启用拓扑还是仅生成网络错误。
| Boolean |
| 名称 | 说明 | 数据类型 |
| out_utility_network | 更新的公共设施网络。 | Utility Network |
使用 EnableNetworkTopology 函数启用名为 MyNetwork 的公共设施网络的网络拓扑，并将最大错误数设为 500。
import arcpy
arcpy.un.EnableNetworkTopology('MyNetwork', 500)使用 EnableNetworkTopology 函数仅针对名为 MyNetwork 的公共设施网络生成错误。
import arcpy
arcpy.un.EnableNetworkTopology('MyNetwork', '', 'ONLY_ERRORS')