添加终端配置 (公共设施网络)

摘要

用于向现有公共设施网络添加终端配置。

带有终端的网络要素需要约束来定义设备或交汇点对象的内部连通性的有效配置。 此工具可用于向公共设施网络添加新的终端配置，可以使用设置终端配置工具将其分配给资产组或资产类型级别的类。

使用情况

• 通过分配终端配置，可以在设备或交汇点对象上配置终端。 只能向支持终端的各个资产类型分配一个终端配置。

• 要素或对象上的终端具有方向性设置。 终端可以设置为定向（仅允许一个流动方向）或双向（允许两个流向）。

• 最少必须指定 2 个终端，最多可以指定 8 个终端。 终端名称应具有描述性，例如高侧或源侧。

• 对于具有三个或四个终端的要素，可以定义有效路径。 该操作用于处理复杂的开关设备，您需要在这些开关设备中限制终端对之间的流动路径。 例如，在终端名称为 A、B、C 和 D 的四终端设备中，您可能希望允许从 A 流向 B 和 C，但不允许从 A 流到 D。

• 必须禁用网络拓扑。

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

  • 此工具在执行时必须连接到默认版本。
  • 输入公共设施网络参数值必须来自作为数据库公共设施网络所有者建立的数据库连接。
  • 连接的 ArcGIS Enterprise 门户帐户必须为门户公共设施网络所有者。

参数

对话框

标注	说明	数据类型
输入公共设施网络	将添加终端配置的输入公共设施网络。	Utility Network; Utility Network Layer
名称	终端配置的名称。	String
方向性	指定终端配置的方向性。 定向可遍历性模型意味着终端的流动仅有一个方向。 双向可遍历性模型意味着终端允许双向流动。 定向—仅允许一个流向。 双向—允许两个流向。	String
终端 (可选)	每个定向终端的名称和方向流。 最少必须指定 2 个终端，最多可以指定 8 个终端。 每个终端的名称不能超过 32 个字符。 如果方向性参数值为定向，则此参数为必需项。 名称 - 提供终端的名称。 上游 - 指示终端为上游或下游。 选中 - 终端为上游。 未选中 - 终端为下游。	Value Table
终端 (可选)	每个双向终端的名称。 最少必须指定 2 个终端，最多可以指定 8 个终端。 每个终端的名称不能超过 32 个字符。 如果方向性参数值为双向（在 Python 中为 traversability_model = "BIDIRECTIONAL"），则此参数为必需项。	Value Table
有效路径 (可选)	终端配置的有效路径的名称。 对于双向可遍历性，如果存在三个或四个终端，则需要此参数。 如果使用定向可遍历性，则其中一个终端必须为上游，才能具有有效配置。 必须创建有效路径才能指示设备或交汇点对象内要遍历的资源的有效路径。 为每个有效路径提供名称并指定值。 名称 - 有效路径的名称。 值 - 有效路径的值。 全部 - 输入值“全部”以创建一个选项，表示所有路径均有效。 无 - 输入值“无”以创建一个选项，表示所有路径均无效。 终端对 - 输入单个终端对或终端对集合。 输入单个终端对，方法是指定从一个终端到另一个终端的路径，使用连字符分隔，例如，A-B。 输入通过逗号分隔的终端对集合，例如，A-B, A-C。	Value Table
默认路径 (可选)	有效配置的默认路径。 该路径将分配至将此终端配置分配至其资产类型的新要素。 如果未指定有效路径，将使用默认路径全部。 全部—所有路径均有效。 这是默认设置。 无—所有路径均无效。	String

派生输出

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

Python

arcpy.un.AddTerminalConfiguration(in_utility_network, terminal_configuration_name, traversability_model, {terminals_directional}, {terminals_bidirectional}, {valid_paths}, {default_path})

名称	说明	数据类型
in_utility_network	将添加终端配置的输入公共设施网络。	Utility Network; Utility Network Layer
terminal_configuration_name	终端配置的名称。	String
traversability_model	指定终端配置的方向性。 定向可遍历性模型意味着终端的流动仅有一个方向。 双向可遍历性模型意味着终端允许双向流动。 DIRECTIONAL—仅允许一个流向。 BIDIRECTIONAL—允许两个流向。	String
terminals_directional [[name, upstream],...] (可选)	每个定向终端的名称和方向流。 最少必须指定 2 个终端，最多可以指定 8 个终端。 每个终端的名称不能超过 32 个字符。 如果 traversability_model 参数值为 DIRECTIONAL，则此参数为必需项。 Name - 提供终端的名称。 Upstream - 指示终端为上游或下游。 True - 终端为上游。 False - 终端为下游。	Value Table
terminals_bidirectional [[name],...] (可选)	每个双向终端的名称。 最少必须指定 2 个终端，最多可以指定 8 个终端。 每个终端的名称不能超过 32 个字符。 如果方向性参数值为双向（在 Python 中为 traversability_model = "BIDIRECTIONAL"），则此参数为必需项。	Value Table
valid_paths [[Name, [Value]],...] (可选)	终端配置的有效路径的名称。 对于双向可遍历性，如果存在三个或四个终端，则需要此参数。 如果使用定向可遍历性，则其中一个终端必须为上游，才能具有有效配置。 必须创建有效路径才能指示设备或交汇点对象内要遍历的资源的有效路径。 为每个有效路径提供名称并指定值。 名称 - 有效路径的名称。 值 - 有效路径的值。 全部 - 输入值“全部”以创建一个选项，表示所有路径均有效。 无 - 输入值“无”以创建一个选项，表示所有路径均无效。 终端对 - 输入单个终端对或终端对集合。 输入单个终端对，方法是指定从一个终端到另一个终端的路径，使用连字符分隔，例如，A-B。 输入通过逗号分隔的终端对集合，例如，A-B, A-C。	Value Table
default_path (可选)	有效配置的默认路径。 该路径将分配至将此终端配置分配至其资产类型的新要素。 如果未指定有效路径，将使用默认路径 All。 ALL—所有路径均有效。 这是默认设置。 NONE—所有路径均无效。	String

派生输出

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

代码示例

AddTerminalConfiguration 示例 1（Python 窗口）

添加具有三个终端的双向终端配置。

import arcpy
arcpy.AddTerminalConfiguration_un('Electric Utility Network', 'config1', 
                                  'BIDIRECTIONAL', None, 'A;B;C', 
                                  'Top A-B;Bottom A-C', 'Top')

AddTerminalConfiguration 示例 2（Python 窗口）

添加具有三个终端的定向终端配置。

import arcpy
arcpy.AddTerminalConfiguration_un('Electric Utility Network', 'config2', 
                                  'DIRECTIONAL', 'A true;B true;C false', None, 
                                  'Top A-B;Bottom A-C', 'Bottom')

AddTerminalConfiguration 示例 3（Python 窗口）

添加具有三个终端的定向终端配置。 有效路径将使用终端对的集合进行指定。

import arcpy
arcpy.AddTerminalConfiguration_un('Electric Utility Network', 'config3', 
                                  'DIRECTIONAL', 'A true;B false;C false', None, 
                                  "AB A-B;ABAC 'A-B;A-C'", 'AB')

环境

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

许可信息

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