返回顶部

添加规则 (公共设施网络)

在本主题中

  1. 摘要
  2. 使用情况
  3. 参数
  4. 环境
  5. 许可信息

摘要

用于向公共设施网络中添加网络规则。

在公共设施网络中创建的所有网络规则均基于资产组和资产类型级别的域网络和结构网络中的类，允许您定义可以连接或关联的要素或对象类型。 这些规则是根据业务管理定义的，并与限制类之间有效关系的要素限制结合使用，以管理网络中资产的正确性。

了解有关要素限制和网络规则的详细信息。

使用情况

  • 必须禁用网络拓扑。

  • 要启用公共设施网络的网络拓扑，必须存在规则。

  • 仅可将规则添加到遵从要素限制的公共设施网络。

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

    • 输入公共设施网络参数值必须来自作为数据库公共设施网络所有者建立的数据库连接。
    • 连接的 ArcGIS Enterprise 门户账户必须为门户公共设施网络所有者。

参数

对话框Python

标注说明数据类型
输入公共设施网络

将添加规则的公共设施网络。

Utility Network; Utility Network Layer
规则类型

指定将创建的规则类型。

  • 交汇点-交汇点连通性—将创建交汇点-交汇点连通性规则以允许点要素或交汇点对象通过连通性关联进行连接。
  • 包含—创建包含规则，其中“自”参数为容器，“至”参数为包含关联中的内容。
  • 结构附件—创建结构附件规则，其中“自”参数为结构要素或对象，“至”参数为结构附件关联中的附件要素或对象。
  • 交汇点-边连通性—将创建交汇点-边连通性规则以允许通过几何重叠（要素位于同一 x,y,z 位置）连接点和线要素，或允许通过连通性关联将边对象与点要素或交汇点对象连接。
  • 边-交汇点-边连通性—将创建边-交汇点-边连通性规则以允许线连接到点要素的任一侧，或允许边对象与另一个线或边对象通过点要素或交汇点对象相连。
String
从表

将包括在规则中的“自”公共设施网络要素类或非空间对象。

结构附件和包含关联规则要求容器或结构网络要素在此参数中。

创建交汇点-边和边-交汇点-边连通性规则时，此参数必须引用交汇点或交汇点对象。

String
自资产组

要应用规则的自表参数值的资产组。

String
自资产类型

要应用规则的自表参数值的资产类型。

String
至表

将包括在规则中的“至”公共设施网络要素类或非空间对象。

结构附件和包含关联规则要求内容或附件网络要素在此参数中。

创建交汇点-边和边-交汇点-边连通性规则时，来自表格参数必须引用交汇点或交汇点对象。

String
至资产组

要应用规则的至表参数值的资产组。

String
至资产类型

要应用规则的至表参数值的资产类型。

String
自终端
(可选)

要应用规则的“自”终端。 这将是从表参数值中的一个终端。 为具有终端的设备或交汇点对象创建连通性规则以连接到另一个网络要素时，必须指定连接自的终端侧，例如变压器上的高压侧终端。

如果资产类型包括终端，则此参数为必填项。 在规则类型参数中指定结构附件或包含关联规则时，它将处于非活动状态。

String
至终端
(可选)

要应用规则的“至”终端。 这将是至表参数值中的一个终端。 为设备或交汇点对象创建连通性规则以连接到另一个具有终端的网络要素时，必须指定连接到的终端侧，例如变压器上的高压侧终端。

如果资产类型包括终端，则此参数为必填项。 如果为结构附件或包含关联规则类型，则将禁用此参数。

String
通过表
(可选)

要应用规则的交汇点公共设施网络要素类或对象。 此参数仅在规则类型参数设置为边-交汇点-边连通性时可用，因为需要三个类来参与边-交汇点-边连通性。

String
通过资产组
(可选)

规则将应用到的通过表参数值的资产组。 此参数仅在规则类型参数设置为边-交汇点-边连通性时可用。

String
通过资产类型
(可选)

规则将应用到的通过表参数值的资产类型。 此参数仅在规则类型参数设置为边-交汇点-边连通性时可用。

String
通过终端
(可选)

要应用规则的通过表参数值的终端。 此参数仅在规则类型参数设置为边-交汇点-边连通性时可用。

String

派生输出

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

更新的公共设施网络。

Utility Network

arcpy.un.AddRule(in_utility_network, rule_type, from_class, from_assetgroup, from_assettype, to_class, to_assetgroup, to_assettype, {from_terminal}, {to_terminal}, {via_class}, {via_assetgroup}, {via_assettype}, {via_terminal})
名称说明数据类型
in_utility_network

将添加规则的公共设施网络。

Utility Network; Utility Network Layer
rule_type

指定将创建的规则类型。

  • JUNCTION_JUNCTION_CONNECTIVITY—将创建交汇点-交汇点连通性规则以允许点要素或交汇点对象通过连通性关联进行连接。
  • CONTAINMENT—创建包含规则，其中“自”参数为容器，“至”参数为包含关联中的内容。
  • STRUCTURAL_ATTACHMENT—创建结构附件规则，其中“自”参数为结构要素或对象，“至”参数为结构附件关联中的附件要素或对象。
  • JUNCTION_EDGE_CONNECTIVITY—将创建交汇点-边连通性规则以允许通过几何重叠（要素位于同一 x,y,z 位置）连接点和线要素，或允许通过连通性关联将边对象与点要素或交汇点对象连接。
  • EDGE_JUNCTION_EDGE_CONNECTIVITY—将创建边-交汇点-边连通性规则以允许线连接到点要素的任一侧，或允许边对象与另一个线或边对象通过点要素或交汇点对象相连。
String
from_class

将包括在规则中的“自”公共设施网络要素类或非空间对象。

结构附件和包含关联规则要求容器或结构网络要素在此参数中。

创建交汇点-边和边-交汇点-边连通性规则时，此参数必须引用交汇点或交汇点对象。

String
from_assetgroup

要应用规则的 from_class 参数值的资产组。

String
from_assettype

要应用规则的 from_class 参数值的资产类型。

String
to_class

将包括在规则中的“至”公共设施网络要素类或非空间对象。

结构附件和包含关联规则要求内容或附件网络要素在此参数中。

创建交汇点-边和边-交汇点-边连通性规则时，from_class 参数必须引用交汇点或交汇点对象。

String
to_assetgroup

要应用规则的 to_class 参数值的资产组。

String
to_assettype

要应用规则的 to_class 参数值的资产类型。

String
from_terminal
(可选)

要应用规则的“自”终端。 这将是 from_class 参数值中的一个终端。 为具有终端的设备或交汇点对象创建连通性规则以连接到另一个网络要素时，必须指定连接自的终端侧，例如变压器上的高压侧终端。

如果资产类型包括终端，则此参数为必填项。 如果为结构附件或包含规则类型，则将忽略此参数。

String
to_terminal
(可选)

要应用规则的“至”终端。 这将是 to_class 参数值中的一个终端。 为设备或交汇点对象创建连通性规则以连接到另一个具有终端的网络要素时，必须指定连接到的终端侧，例如变压器上的高压侧终端。

如果资产类型包括终端，则此参数为必填项。 如果为结构附件或包含规则类型，则将忽略此参数。

String
via_class
(可选)

要应用规则的交汇点公共设施网络要素类或表。 仅当 rule_type 参数设置为 EDGE_JUNCTION_EDGE_CONNECTIVITY 时才能指定此参数，因为需要三个类才能参与边-交汇点-边连通性。

String
via_assetgroup
(可选)

要应用规则的 via_class 参数值的资产组。 仅可为设置为 EDGE_JUNCTION_EDGE_CONNECTIVITY 的 rule_type 参数值指定该参数。

String
via_assettype
(可选)

要应用规则的 via_class 参数值的资产类型。 仅可为设置为 EDGE_JUNCTION_EDGE_CONNECTIVITY 的 rule_type 参数值指定该参数。

String
via_terminal
(可选)

要应用规则的 via_class 参数值的终端。 仅可为设置为 EDGE_JUNCTION_EDGE_CONNECTIVITY 的 rule_type 参数值指定该参数。

String

派生输出

名称说明数据类型
out_utility_network

更新的公共设施网络。

Utility Network

代码示例

AddRule 示例 1（Python 窗口）

在此示例中，创建了交汇点-交汇点连通性规则，可使断路器负载侧连接到配电网中变压器的高压侧。

import arcpy
arcpy.un.AddRule("Distribution Network", "JUNCTION_JUNCTION_CONNECTIVITY", 
                 "ElectricDistributionDevice", "CircuitBreaker", "Air powered", 
                 "ElectricDistributionLine", "Transformer", "High")
AddRule 示例 2（Python 窗口）

在此示例中，创建了交汇点-边连通性规则，可使断路器负载侧连接到配电网中的中压线。

import arcpy
arcpy.un.AddRule("Utility Network", "JUNCTION_EDGE_CONNECTIVITY", 
                 "ElectricDistributionDevice", "CircuitBreaker", "Air powered", 
                 "ElectricDistributionLine", "Medium Voltage", 
                 "Single Phase Overhead")
AddRule 示例 3（Python 窗口）

此示例脚本创建了包含关联规则，可使交汇点框中包含弯头。

import arcpy
arcpy.un.AddRule("Electric Network", "CONTAINMENT", "StructureJunction", 
                 "JunctionBox", "Junction Box", "ElectricDistributionDevice", 
                 "Fuse", "Underground Single Phase Load Break Elbow")
AddRule 示例 4（Python 窗口）

此示例脚本创建了结构附件关联规则，可将开关附加到电线杆结构中。

import arcpy
arcpy.un.AddRule("Electric Network", "STRUCTURAL_ATTACHMENT", 
                 "StructureJunction", "Pole", "Wood", 
                 "ElectricDistributionDevice", "Switch", 
                 "Overhead Low Voltage Single Phase Disconnect")

环境

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

许可信息

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

相关主题

  • 管理工具集概述
  • 公共设施网络工具箱概览
  • 查找地理处理工具

有关此主题的反馈?

在本主题中
  1. 摘要
  2. 使用情况
  3. 参数
  4. 环境
  5. 许可信息