将逻辑示意图规则添加到示意图模板指定的规则序列中，以便在构建示意图期间自动折叠与容器相关的所有内容。可基于其属性通过 SQL 查询对含待折叠内容的容器进行识别。
该工具为配置和管理工具。
该工具会基于输入逻辑示意图模板影响任何现有逻辑示意图的一致性。 所有现有逻辑示意图都将变得不一致，并随附打开一致性警告图标 
，直至对其进行更新为止。
系统在使用公共设施网络或追踪网络服务时不支持此工具。 您必须使用文件或移动地理数据库中的公共设施网络或追踪网络，或者企业级地理数据库中公共设施网络或追踪网络的数据库连接。 使用企业级地理数据库时，需要满足以下要求：
折叠容器规则可用于简化逻辑示意图，方法是折叠逻辑示意图中可能存在的所有与容器相关的内容。
可通过此工具将折叠容器规则配置为按属性运行。这意味着，您可以根据其属性过滤要折叠的容器元素，以此对特定容器类或对象表的逻辑示意图要素进行折叠。
| 标注 | 说明 | 数据类型 |
输入网络 | 包含要修改的逻辑示意图模板的公共设施网络或追踪网络。 | Utility Network; Trace Network |
输入逻辑示意图模板 | 要修改的逻辑示意图模板名称 | String |
激活 | 指定在基于指定模板生成并更新逻辑示意图时，规则是否将处于激活状态。
| Boolean |
容器源
| 引用容器的容器源类或对象表，执行折叠容器规则期间要折叠该容器的内容。 | Table; Feature Class |
表达式
(可选) | 用于选择此源类或对象表中容器子集的 SQL 表达式，将在生成的逻辑示意图中折叠其内容。有关 SQL 语法的详细信息，请参阅在 ArcGIS 中使用的查询表达式的 SQL 参考。 | SQL Expression |
描述 (可选) | 规则的描述。 | String |
聚合重新连接的边
(可选) | 用于指定规则是否将聚合重新连接到已折叠容器交汇点的边。
| Boolean |
| 标注 | 说明 | 数据类型 |
| 输出网络 | 已更新的 utility network or trace network。 | 公共设施网络；追踪网络 |
| 输出逻辑示意图模板 | 逻辑示意图模板的名称。 | 字符串 |
arcpy.nd.AddCollapseContainerByAttributeRule(in_utility_network, template_name, is_active, container_source, {where_clause}, {description}, {reconnected_edges_option})| 名称 | 说明 | 数据类型 |
in_utility_network | 包含要修改的逻辑示意图模板的公共设施网络或追踪网络。 | Utility Network; Trace Network |
template_name | 要修改的逻辑示意图模板名称 | String |
is_active | 指定在基于指定模板生成并更新逻辑示意图时，规则是否将处于启用状态。
| Boolean |
container_source | 引用容器的容器源类或对象表，执行折叠容器规则期间要折叠该容器的内容。 | Table; Feature Class |
where_clause (可选) | 用于选择此源类或对象表中容器子集的 SQL 表达式，将在生成的逻辑示意图中折叠其内容。有关 SQL 语法的详细信息，请参阅在 ArcGIS 中使用的查询表达式的 SQL 参考。 | SQL Expression |
description (可选) | 规则的描述。 | String |
reconnected_edges_option (可选) | 用于指定规则是否将聚合重新连接到已折叠交汇点的边。
| Boolean |
| 名称 | 说明 | 数据类型 |
| out_utility_network | 已更新的 utility network or trace network。 | 公共设施网络；追踪网络 |
| out_template_name | 逻辑示意图模板的名称。 | 字符串 |
将按属性折叠容器规则添加到 MyTemplate1 模板，以在生成的逻辑示意图中折叠非变电站 ASSETGROUP<>8 的所有结构交汇点容器中的内容。这意味着将折叠生成的逻辑示意图中除变电站 ASSETGROUP<>8 以外的所有结构设备容器。
import arcpy
input_Network = "D:/MyProjectLocation/MyDatabaseConnection.sde/MyDatabase.MAP.Electric/MyDatabase.MAP.Electric"
input_DiagramTemplate = "MyTemplate1"
input_StructureDeviceToCollapse = "D:/MyProjectLocation/MyDatabaseConnection.sde/MyDatabase.MAP.Electric/MyDatabase.MAP.StructureJunction"
arcpy.AddCollapseContainerByAttributeRule_nd(input_Network, input_DiagramTemplate,
"ACTIVE", input_StructureDeviceToCollapse,
"ASSETGROUP <> 8", '', 'AGGREGATE_RECONNECTED_EDGES'