描述
用于将逻辑示意图规则添加至逻辑示意图模板，以将逻辑示意图中当前表示的逻辑示意图要素设置为追踪规则的起点。逻辑示意图要素需要从给定网络源类或对象表进行查询，并可按其属性进行过滤。
警告：
该工具为配置和管理工具。
注：
该工具会基于输入逻辑示意图模板影响任何现有逻辑示意图的一致性。所有现有逻辑示意图都将变得不一致，并随附打开一致性警告图标 
，直至对其进行更新为止。
使用方法
系统在使用公共设施网络或追踪网络服务时不支持此工具。您必须使用文件地理数据库中的公共设施网络或追踪网络，或者企业级地理数据库中公共设施网络或追踪网络的数据库连接。使用企业级地理数据库时，需要满足以下要求：
- 输入网络参数值必须来自作为数据库公共设施网络所有者或数据库追踪网络所有者建立的数据库连接。
- 连接的 ArcGIS Enterprise 门户帐户必须为门户公共设施网络所有者或门户追踪网络所有者。
- 该工具必须连接到预期为公开且不受保护的默认版本。
将模板设置为执行追踪规则时，在逻辑示意图模板中配置起点是有意义的。在添加追踪规则工具之前运行添加按属性设置起点规则工具，将指定的逻辑示意图要素设置为追踪规则的起点。在这种情况下，追踪规则会将指定的起点视为执行的唯一起点，而不是在执行时运行逻辑示意图中表示的所有要素。
如果在基于子网的追踪之前使用“设置起点”规则来配置表示具有终端的网络元素的逻辑示意图要素的起点，则该规则必须指定终端 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 | 指定在基于指定模板生成并更新逻辑示意图时，规则是否将处于启用状态。
| Boolean |
network_source | 此网络源类或对象表引用将被设置为起点的要素或对象。 | Table; Feature Class |
where_clause （可选） | 此 SQL 表达式用于选择指定源类或对象表中要设置为起点的要素或对象子集。有关 SQL 语法的详细信息，请参阅在 ArcGIS 中使用的查询表达式的 SQL 参考。 | SQL Expression |
junction_terminals [junction_terminals,...] （可选） | 如果网络源类引用具有终端的交汇点，则这些终端 ID 将被视为追踪起点。 终端 ID 均列在网络属性选项卡上的终端配置部分。 配置 where_clause 和 junction_terminals 参数后，指定的终端必须与所查询的要素或对象相对应；否则，系统将不会设置任何起点。 | Long |
description （可选） | 规则的描述。 | String |
派生输出
| 名称 | 说明 | 数据类型 |
| out_utility_network | 已更新的 utility network or trace network。 | 公共设施网络；追踪网络 |
| out_template_name | 逻辑示意图模板的名称。 | 字符串 |
代码示例
将“按属性设置起点”规则添加到 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: 是