添加按属性设置起点规则 (网络逻辑示意图)

描述

用于将逻辑示意图规则添加至逻辑示意图模板,以将逻辑示意图中当前表示的逻辑示意图要素设置为追踪规则的起点。逻辑示意图要素需要从给定网络源类或对象表进行查询,并可按其属性进行过滤。

了解有关在逻辑示意图中预设起点的详细信息

警告:

该工具为配置和管理工具。

注:

该工具会基于输入逻辑示意图模板影响任何现有逻辑示意图的一致性。所有现有逻辑示意图都将变得不一致,并随附打开一致性警告图标 可能不一致,直至对其进行更新为止。

使用方法

  • 系统在使用公共设施网络或追踪网络服务时不支持此工具。您必须使用文件地理数据库中的公共设施网络或追踪网络,或者企业级地理数据库中公共设施网络或追踪网络的数据库连接。使用企业级地理数据库时,需要满足以下要求:

  • 将模板设置为执行追踪规则时,在逻辑示意图模板中配置起点是有意义的。在添加追踪规则工具之前运行添加按属性设置起点规则工具,将指定的逻辑示意图要素设置为追踪规则的起点。在这种情况下,追踪规则会将指定的起点视为执行的唯一起点,而不是在执行时运行逻辑示意图中表示的所有要素。

  • 如果在基于子网的追踪之前使用“设置起点”规则来配置表示具有终端的网络元素的逻辑示意图要素的起点,则该规则必须指定终端 ID 才能标识追踪的原点。如果没有清楚地标识终端 ID,则基于子网的追踪将不知道预期将哪个终端用作起点。在这种情况下,系统将显示一条错误,指明在指定层之外有多个起点。如果指定了终端 ID,但该 ID 与追踪层的子网控制器不对应,则系统将显示一条错误,指明没有发现任何子网控制器。

  • 如果配置了“设置起点”规则,但逻辑示意图中的所有要素与预期的起点均不对应,则将跳过追踪规则

语法

arcpy.nd.AddSetStartingPointByAttributeRule(in_utility_network, template_name, is_active, network_source, {where_clause}, {junction_terminals}, {description})
参数说明数据类型
in_utility_network

包含要修改的逻辑示意图模板的公共设施网络或追踪网络。

Utility Network; Trace Network
template_name

要修改的逻辑示意图模板的名称。

String
is_active

指定在基于指定模板生成并更新逻辑示意图时,规则是否将处于启用状态。

  • ACTIVE在基于输入模板生成并更新逻辑示意图的过程中,添加的规则将会变为启用状态。这是默认设置。
  • INACTIVE在基于输入模板生成或更新逻辑示意图的过程中,添加的规则将不会变为启用状态。
Boolean
network_source

此网络源类或对象表引用将被设置为起点的要素或对象。

Table; Feature Class
where_clause
(可选)

此 SQL 表达式用于选择指定源类或对象表中要设置为起点的要素或对象子集。有关 SQL 语法的详细信息,请参阅在 ArcGIS 中使用的查询表达式的 SQL 参考

SQL Expression
junction_terminals
[junction_terminals,...]
(可选)

如果网络源类引用具有终端的交汇点,则这些终端 ID 将被视为追踪起点。

终端 ID 均列在网络属性选项卡上的终端配置部分。

配置 where_clausejunction_terminals 参数后,指定的终端必须与所查询的要素或对象相对应;否则,系统将不会设置任何起点。

Long
description
(可选)

规则的描述。

String

派生输出

名称说明数据类型
out_utility_network

已更新的 utility network or trace network。

公共设施网络;追踪网络
out_template_name

逻辑示意图模板的名称。

字符串

代码示例

AddSetStartingPointByAttributeRule 示例(独立脚本)

将“按属性设置起点”规则添加到 MyTemplate1 模板,以在“断路器”配电设备 (ASSETGROUP <> 4) 的“负载”终端 (#3) 上设置起点。这意味着生成的逻辑示意图中断路器上的任何“负载”终端都将被设置为起点。

import arcpy
input_Network = "D:/MyProjectLocation/MyDatabaseConnection.sde/MyDatabase.MAP.Electric/MyDatabase.MAP.Electric"
input_DiagramTemplate = "MyTemplate1"
input_Device = "D:/MyProjectLocation/MyDatabaseConnection.sde/MyDatabase.MAP.Electric/MyDatabase.MAP.ElectricDistributionDevice"
arcpy.AddSetStartingPointByAttributeRule_nd(input_Network, input_DiagramTemplate, 
                                             "ACTIVE", input_Device, 
                                             "ASSETGROUP <> 4", "3")

环境

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

许可信息

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

相关主题