按类别添加逻辑示意图要素功能规则 (网络逻辑示意图)

摘要

添加一个逻辑示意图规则以根据网络类别向逻辑示意图要素分配特定的功能。 该分配出现在基于现有模板构建逻辑示意图的过程中。 稍后在规则序列中运行的其他规则将会使用此功能。 将处理的逻辑示意图要素取决于它们是否被标记为特定的网络类别。

了解有关添加逻辑示意图要素功能规则的详细信息

警告：

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

注：

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

注：

此工具仅适用于 Utility Network 版本 7 及更高版本的逻辑示意图模板。

使用情况

• “添加逻辑示意图要素功能”规则在逻辑示意图中表示的网络要素或网络对象上添加特定功能，以便在逻辑示意图构建过程中稍后运行的其他逻辑示意图规则以某种方式处理这些要素。 此工具允许您将添加逻辑示意图要素功能配置为按网络类别运行。 这意味着您可以根据逻辑示意图中表示的网络要素或网络对象是否标记了特定的网络类别，为其配置添加特定的功能。

• 系统在使用 utility network 服务时不支持此工具。 必须使用文件或移动地理数据库中的公共设施网络或企业级地理数据库中公共设施网络的数据库连接。 使用企业级地理数据库时，需要满足以下要求：

  • 输入网络参数值必须来自以数据库公共设施网络所有者身份建立的数据库连接。
  • 连接的 ArcGIS Enterprise 门户账户必须为门户公共设施网络所有者。
  • 该工具必须连接到预期为公开且不受保护的默认版本。

• 指定功能参数的阻止相关容器折叠或允许相关容器折叠选项来标记内容逻辑示意图要素，以允许通过规则序列中稍后执行的“折叠容器”规则折叠其相关容器。 这些为使用添加折叠容器规则和添加按属性折叠容器规则，或添加按类别折叠容器规则工具设置的规则。

• 指定功能参数的阻止减少交汇点或允许减少交汇点选项来标记逻辑示意图交汇点，以通过规则序列中稍后运行的“减少交汇点”规则放弃或允许这些交汇点。 这些为使用添加减少交汇点规则和添加按属性减少交汇点规则或添加按类别减少交汇点规则工具设置的规则。

• 指定功能参数的将未连接的空容器交汇点保存为面选项，创建逻辑示意图容器来表示任何未连接的空容器网络交汇点或交汇点对象，而非逻辑示意图交汇点。 此功能仅适用于容器交汇点源类或对象表。

• 指定功能参数的忽略上游追踪起点选项，标记逻辑示意图要素，使其在后续配置的追踪规则中作为上游追踪的起点被忽略。

• 指定功能参数的忽略下游追踪起点选项，标记逻辑示意图要素，使其在后续配置的追踪规则中作为下游追踪的起点被忽略。

• 从 ArcGIS Pro 3.4 开始，可根据逻辑示意图交汇点的连接数量为其分配功能，即根据其连接的逻辑示意图交汇点数量。

参数

对话框

标注	说明	数据类型
输入网络	包含要修改的逻辑示意图模板的公共设施网络。	Utility Network
输入逻辑示意图模板	要修改的逻辑示意图模板名称	String
激活	指定在基于指定模板生成并更新逻辑示意图时，规则是否将处于激活状态。 选中 - 在基于输入模板生成并更新逻辑示意图的过程中，添加的规则将会变为激活状态。 这是默认设置。 未选中 - 在基于输入模板生成或更新逻辑示意图的过程中，添加的规则将不会变为激活状态。	Boolean
规则实施	指明如何处理标记为指定网络类别的网络要素或网络对象。 排除类别—标记为指定类别的网络要素或网络对象将不会被处理，而其他网络要素和网络对象则会被处理。 这是默认设置。 包含类别—处理标记为指定类别的网络要素或网络对象。	String
类别	将排除或包括的网络类别取决于规则实施参数值。 如果规则实施参数设置为包括类别，则必须指定一个或多个网络类别。 指定的功能将分配给与网络要素相关的任何逻辑示意图要素以及标记了指定网络类别的网络对象。 如果规则实施参数设置为排除类别，则指定的功能将分配给与网络要素相关的任何逻辑示意图要素和未标记指定网络类别的网络对象。	String
功能	指定规则操作结束时将分配给按类别筛选出的逻辑示意图要素的功能。 稍后在规则序列中运行的其他规则将会使用指定的功能。 阻止相关容器折叠—按类别筛选出的所有要素都将被标记，以阻止其父容器被规则序列中稍后运行的“折叠容器”规则折叠。 这是默认设置。 允许相关容器折叠—按类别筛选出的所有要素都将被标记，以允许其父容器被规则序列中稍后运行的“折叠容器”规则折叠。 阻止减少交汇点—系统将标记所有按类别筛选出的交汇点，以阻止在规则序列中稍后运行的任何“减少交汇点”规则减少这些交汇点。 允许减少交汇点—系统将标记所有按类别筛选出的交汇点，以允许在规则序列中稍后运行的任何“减少交汇点”规则减少这些交汇点。 将未连接的空容器交汇点保存为面—如果容器为空，所有查询到的未连接容器交汇点将以面几何形式保存，而非点几何形式。 忽略上游追踪起点—所有查询到的要素将在后续配置的追踪规则中作为上游追踪的起点被忽略。 忽略下游追踪起点—所有查询到的要素将在后续配置的追踪规则中作为下游追踪的起点被忽略。	String
描述 (可选)	规则的描述。	String
未连接 (可选)	指定选定功能是否适用于未连接的网络逻辑示意图交汇点。 选中 - 选定的功能将适用于未连接的网络逻辑示意图交汇点。 这是默认设置。 未选中 - 选定的功能将不适用于未连接的网络逻辑示意图交汇点。	Boolean
已连接到单个交汇点 (可选)	指定选定功能是否适用于连接到单个交汇点的网络逻辑示意图交汇点。 选中 - 选定功能将适用于连接到单个交汇点的网络逻辑示意图交汇点。 这是默认设置。 未选中 - 选定功能将不适用于连接到单个交汇点的网络逻辑示意图交汇点。	Boolean
已连接到两个不同的交汇点 (可选)	指定选定功能是否适用于连接到两个不同交汇点的网络逻辑示意图交汇点。 选中 - 选定功能将适用于连接到两个不同交汇点的网络逻辑示意图交汇点。 这是默认设置。 未选中 - 选定功能将不适用于连接到两个不同交汇点的网络逻辑示意图交汇点。	Boolean
已连接到三个或更多不同的交汇点 (可选)	指定选定功能是否适用于连接到三个或更多不同的交汇点的网络逻辑示意图交汇点。 选中 - 选定功能将适用于连接到三个或更多不同的交汇点的网络逻辑示意图交汇点。 这是默认设置。 未选中 - 选定功能将不适用于连接到三个或更多不同的交汇点的网络逻辑示意图交汇点。	Boolean

派生输出

标注	说明	数据类型
输出网络	更新的公共设施网络。	Utility Network
输出逻辑示意图模板	逻辑示意图模板的名称。	String

Python

arcpy.nd.AddDiagramFeatureCapabilityByCategoryRule(in_utility_network, template_name, is_active, inverse_category_selection, category, capability, {description}, {valence_0}, {valence_1}, {valence_2}, {valence_3_plus})

名称	说明	数据类型
in_utility_network	包含要修改的逻辑示意图模板的公共设施网络。	Utility Network
template_name	要修改的逻辑示意图模板名称	String
is_active	指定在基于指定模板生成并更新逻辑示意图时，规则是否将处于启用状态。 ACTIVE—在基于输入模板生成并更新逻辑示意图的过程中，添加的规则将会变为启用状态。 这是默认设置。 INACTIVE—在基于输入模板生成或更新逻辑示意图的过程中，添加的规则将不会变为启用状态。	Boolean
inverse_category_selection	指明如何处理标记为指定网络类别的网络要素或网络对象。 EXCLUDE_CATEGORIES—标记为指定类别的网络要素或网络对象将不会被处理，而其他网络要素和网络对象则会被处理。 这是默认设置。 INCLUDE_CATEGORIES—处理标记为指定类别的网络要素或网络对象。	String
category [category,...]	将排除或包括的网络类别取决于 inverse_category_selection 参数值。 如果 inverse_category_selection 参数设置为 INCLUDE_CATEGORIES，则必须指定一个或多个网络类别。 指定的功能将分配给与网络要素相关的任何逻辑示意图要素以及标记了指定网络类别的网络对象。 如果 inverse_category_selection 参数设置为 EXCLUDE_CATEGORIES，则指定的功能将分配给与网络要素相关的任何逻辑示意图要素和未标记指定网络类别的网络对象。	String
capability	指定规则操作结束时将分配给按类别筛选出的逻辑示意图要素的功能。 稍后在规则序列中运行的其他规则将会使用指定的功能。 PREVENT_TO_COLLAPSE_CONTAINER—按类别筛选出的所有要素都将被标记，以阻止其父容器被规则序列中稍后运行的“折叠容器”规则折叠。 这是默认设置。 ALLOW_TO_COLLAPSE_CONTAINER—按类别筛选出的所有要素都将被标记，以允许其父容器被规则序列中稍后运行的“折叠容器”规则折叠。 PREVENT_TO_REDUCE_JUNCTION—系统将标记所有按类别筛选出的交汇点，以阻止在规则序列中稍后运行的任何“减少交汇点”规则减少这些交汇点。 ALLOW_TO_REDUCE_JUNCTION—系统将标记所有按类别筛选出的交汇点，以允许在规则序列中稍后运行的任何“减少交汇点”规则减少这些交汇点。 SAVE_EMPTY_CONTAINER_AS_POLYGON_IF_UNCONNECTED—如果容器为空，所有查询到的未连接容器交汇点将以面几何形式保存，而非点几何形式。 IGNORED_STARTING_POINT_FOR_UPSTREAM_TRACE—所有查询到的要素将在后续配置的追踪规则中作为上游追踪的起点被忽略。 IGNORED_STARTING_POINT_FOR_DOWNSTREAM_TRACE—所有查询到的要素将在后续配置的追踪规则中作为下游追踪的起点被忽略。	String
description (可选)	规则的描述。	String
valence_0 (可选)	指定选定功能是否适用于未连接的网络逻辑示意图交汇点。 APPLY—选定的功能将适用于未连接的网络逻辑示意图交汇点。 这是默认设置。 DO_NOT_APPLY—选定的功能将不适用于未连接的网络逻辑示意图交汇点。	Boolean
valence_1 (可选)	指定选定功能是否适用于连接到单个交汇点的网络逻辑示意图交汇点。 APPLY—选定功能将适用于连接到单个交汇点的网络逻辑示意图交汇点。 这是默认设置。 DO_NOT_APPLY—选定功能将不适用于连接到单个交汇点的网络逻辑示意图交汇点。	Boolean
valence_2 (可选)	指定选定功能是否适用于连接到两个不同交汇点的网络逻辑示意图交汇点。 APPLY—选定功能将适用于连接到两个不同交汇点的网络逻辑示意图交汇点。 这是默认设置。 DO_NOT_APPLY—选定功能将不适用于连接到两个不同交汇点的网络逻辑示意图交汇点。	Boolean
valence_3_plus (可选)	指定选定功能是否适用于连接到三个或更多不同的交汇点的网络逻辑示意图交汇点。 APPLY—选定功能将适用于连接到三个或更多不同的交汇点的网络逻辑示意图交汇点。 这是默认设置。 DO_NOT_APPLY—选定功能将不适用于连接到三个或更多不同的交汇点的网络逻辑示意图交汇点。	Boolean

派生输出

名称	说明	数据类型
out_utility_network	更新的公共设施网络。	Utility Network
out_template_name	逻辑示意图模板的名称。	String

代码示例

AddDiagramFeatureCapabilityByCategoryRule 示例（独立脚本）

将“逻辑示意图要素功能”规则添加到 MyTemplate1 模板以标记所有子网控制器，从而阻止其容器稍后折叠。 由于子网络控制器网络类别存在并分配给网络中的所有子网络控制器，因此还可以运行 AddDiagramFeatureCapabilityByCategoryRule 函数来标记所有子网络控制器，以防止其父容器折叠。

import arcpy
input_Network = 'D:/MyProjectLocation/MyDatabaseConnection.sde/MyDatabase.MAP.Electric/MyDatabase.MAP.Electric'
input_NetworkCategory = 'Subnetwork Controller'
input_DiagramTemplate = 'MyTemplate1'

arcpy.nd.AddDiagramFeatureCapabilityByCategoryRule(
    input_Network, input_DiagramTemplate, 'ACTIVE', 'INCLUDE_CATEGORIES',
    input_NetworkCategory, 'PREVENT_TO_COLLAPSE_CONTAINER')

环境

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

许可信息

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