添加层 (公共设施网络)

摘要

在公共设施网络中针对域网络创建新层。

层是共享相同级别、名称限制和拓扑类型的子网集合。层是子网管理的必要选项。

使用情况

• 将为域网络添加子网名称字段，并向域网络添加第一层的分区层定义。对于具有等级层定义的域网络，将使用子网字段名称参数值创建子网字段名称。有关详细信息，请参阅子网名称。

• 对于具有等级层定义的域网络，层组名称是必需参数。可以使用添加层组工具为具有等级层定义的域网络创建层组。

• 在公共设施网络要素类中追加数据之前，应该添加层。如果在添加新层之前追加数据，将出现错误。

• 必须禁用网络拓扑。

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

  • 输入公共设施网络参数值必须来自作为数据库公共设施网络所有者建立的数据库连接。
  • 连接的 ArcGIS Enterprise 门户账户必须为门户公共设施网络所有者。
  • 此工具必须连接到默认版本才能运行。
    • 在启用操作期间，将阻止连接到默认版本的所有其他会话运行验证或启用操作。

参数

对话框

标注	说明	数据类型
输入公共设施网络	包含域网络的公共设施网络，将向该域网络中添加层。	Utility Network; Utility Network Layer
域网络	将要创建该层的域网络。	String
名称	新层的名称。该名称在整个公共设施网络中必须唯一。	String
等级	正在添加的层的等级。最高等级是第 1 级。	Long
拓扑类型 (可选)	指定新层的拓扑类型。具有径向和网格拓扑类型的子网均支持一个或多个子网控制器。如果使用等级层定义创建了输入域网络并且拓扑类型默认为网格，则将在工具对话框上禁用此参数。如果使用分区层定义创建了域网络，则此参数将在下拉列表中列出所有拓扑类型。 对于追踪或子网管理，此参数当前不提供行为差异。此参数的功能正在研发中，且将在未来的版本中适用。 半径—子网将具有径向拓扑类型。 网格—子网将具有网格拓扑类型。这是使用等级层定义创建的层的默认拓扑类型。	String
层组名称 (可选)	将添加新层的现有层组。对于具有等级层定义的域网络，此参数为必需项。	String
子网字段名称 (可选)	将在其中存储该层子网名称的字段名称。该字段为系统维护字段，将在第一次将层添加到层组并重新用于任何附加层时创建该字段。例如，您有两个层组：Distribution 和 Transmission。当您将名为 system 的层添加到 Distribution 组，并将子网字段名称指定为 systemsubnet 时，将创建该字段。接下来，您要将第二个名为 system 的层添加到 Transmission 组。此参数将检测到应将 systemsubnet 字段用作子网字段名称。此参数是等级层类型的必要参数。	String

派生输出

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

Python

arcpy.un.AddTier(in_utility_network, domain_network, name, rank, {topology_type}, {tier_group_name}, {subnetwork_field_name})

名称	说明	数据类型
in_utility_network	包含域网络的公共设施网络，将向该域网络中添加层。	Utility Network; Utility Network Layer
domain_network	将要创建该层的域网络。	String
name	新层的名称。该名称在整个公共设施网络中必须唯一。	String
rank	正在添加的层的等级。最高等级是第 1 级。	Long
topology_type (可选)	指定新层的拓扑类型。具有径向和网格拓扑类型的子网均支持一个或多个子网控制器。如果使用等级层定义创建了输入域网络并且拓扑类型默认为网格，则将在工具对话框上禁用此参数。如果使用等级层定义创建了输入域网络，则默认拓扑类型为 MESH。如果使用分区层定义创建了输入域网络，则需要拓扑类型参数。 注： 对于追踪或子网管理，此参数当前不提供行为差异。此参数的功能正在研发中，且将在未来的版本中适用。 RADIAL—子网将具有径向拓扑类型。 MESH—子网将具有网格拓扑类型。这是使用等级层定义创建的层的默认拓扑类型。	String
tier_group_name (可选)	将添加新层的现有层组。对于具有等级层定义的域网络，此参数为必需项。	String
subnetwork_field_name (可选)	将在其中存储该层子网名称的字段名称。该字段为系统维护字段，将在第一次将层添加到层组并重新用于任何附加层时创建该字段。例如，您有两个层组：Distribution 和 Transmission。当您将名为 system 的层添加到 Distribution 组，并将子网字段名称指定为 systemsubnet 时，将创建该字段。接下来，您要将第二个名为 system 的层添加到 Transmission 组。此参数将检测到应将 systemsubnet 字段用作子网字段名称。此参数是等级层类型的必要参数。	String

派生输出

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

代码示例

AddTier 示例 1（Python 窗口）

使用 MESH 拓扑类型在名为 DistributionSystem 的等级网络中创建层。

import arcpy
arcpy.AddTier_un("Utility Network", "GasDistribution", "Distribution System", 
                 1, "MESH", "Distribution", "System")

AddTier 示例 2（Python 窗口）

使用 RADIAL 拓扑类型在名为 MediumVoltage 的分区网络中创建层。

import arcpy
arcpy.AddTier_un("Utility Network", "ElectricDistribution", "Medium Voltage", 
                 1, "RADIAL")

环境

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

许可信息

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