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