描述
更改逻辑示意图模板的属性，例如其名称、如何处理沿输入网络边的折点、是否可存储或扩展相关逻辑示意图、这些逻辑示意图中容器及其内容之间的边距、移除其规则和布局定义，以及将示意图图层定义重置为默认设置。
注：
对于基于输入逻辑示意图模板的任何现有逻辑示意图，更改容器边距的大小或移除逻辑示意图规则和布局定义会导致数据库中的 Consistency 字段值切换为不一致状态。所有这些逻辑示意图都将保持不一致状态，并随附打开一致性警告图标 
，直至对其进行更新为止。
警告：
该工具为配置和管理工具。
使用方法
系统在使用公共设施网络或追踪网络服务时不支持此工具。您必须使用文件地理数据库中的公共设施网络或追踪网络，或者企业级地理数据库中公共设施网络或追踪网络的数据库连接。使用企业级地理数据库时，需要满足以下要求：
- 输入网络参数值必须来自作为数据库公共设施网络所有者或数据库追踪网络所有者建立的数据库连接。
- 连接的 ArcGIS Enterprise 门户帐户必须为门户公共设施网络所有者或门户追踪网络所有者。
- 该工具必须连接到预期为公开且不受保护的默认版本。
为输入网络参数指定的网络数据元素必须来自文件地理数据库中的公共设施网络或追踪网络，或者企业级地理数据库中公共设施网络或追踪网络的数据库连接。
此工具支持以下特定逻辑示意图模板属性更改：
- 更改模板的名称
- 设置模板为默认模板
- 移除规则和布局定义
- 将逻辑示意图图层定义重置为默认设置
- 指定处理沿输入网络边的折点的方式
- 定义容器及其内容之间的边距大小
- 禁用这些逻辑示意图的存储功能
- 启用扩展逻辑示意图功能
在逻辑示意图生成时，沿逻辑示意图边初始化顶点并在逻辑示意图显示时进行管理非常耗时。为避免影响性能，请仅在需要时选中保留边上的初始折点参数。例如，如果将模板配置为在生成时执行自动逻辑示意图布局，请为相对主线和部分重叠边逻辑示意图布局选中此参数。其他逻辑示意图布局类型在执行过程中不使用逻辑示意图边上的折点；它们只处理逻辑示意图交汇点位置。
从 ArcGIS Pro 2.6 开始，此工具会为输入逻辑示意图模板系统地初始化默认逻辑示意图图层定义（如果其尚未存在）。
配置模型以设置逻辑示意图模板的新规则和布局定义时，在选中模型开始处的移除逻辑示意图模板规则和布局定义参数的情况下运行更改逻辑示意图模板工具。这将使模型在启动时将模板属性重新初始化为默认值。
语法
arcpy.nd.AlterDiagramTemplate(in_utility_network, template_name, {out_name}, {is_default_template}, {are_rules_and_layouts_removed}, {are_vertices_kept}, {container_margin}, {is_diagram_storage_enabled}, {is_diagram_extension_enabled}, {description}, {are_layer_definitions_removed})| 参数 | 说明 | 数据类型 |
in_utility_network | 要更改的逻辑示意图模板的 utility network or trace network。 | Utility Network; Trace Network |
template_name | 要更改的逻辑示意图模板的名称。 | String |
out_name （可选） | 模板的新名称。 | String |
is_default_template （可选） | 用于指定模板的默认状态。
如果未指定模板，则默认模板是生成逻辑示意图时使用的模板。 | Boolean |
are_rules_and_layouts_removed （可选） | 用于指定是否将移除模板规则和布局定义。
| Boolean |
are_vertices_kept （可选） | 指定如何在基于模板的逻辑示意图中管理沿 GIS 边的折点。
| Boolean |
container_margin （可选） | 容器和容器边界内所有交汇点的中心之间的最小距离。 | Linear Unit |
is_diagram_storage_enabled （可选） | 指定是否能够存储基于模板的逻辑示意图。
| Boolean |
is_diagram_extension_enabled （可选） | 指定是否能够扩展基于模板的逻辑示意图。
| Boolean |
description （可选） | 模板的描述。 | String |
are_layer_definitions_removed （可选） | 指定是否将逻辑示意图模板图层定义重置为默认值。
| Boolean |
派生输出
| 名称 | 说明 | 数据类型 |
| out_utility_network | 已更新的 utility network or trace network。 | 公共设施网络；追踪网络 |
| out_template_name | 逻辑示意图模板的名称。 | 字符串 |
代码示例
此示例会增大属于基于 ExpandContainers 模板的逻辑示意图的所有容器的容器边距。
import arcpy
input_Network = "D:/MyProjectLocation/MyDatabaseConnection.sde/MyDatabase.MAP.Electric/MyDatabase.MAP.Electric"
arcpy.AlterDiagramTemplate_nd(input_Network, "ExpandContainers",
"ExpandContainers", "NOT_DEFAULT_TEMPLATE",
"DO_NOT_REMOVE_RULES_AND_LAYOUTS",
"KEEP_VERTICES", "0.3 Meters",
"ENABLE_DIAGRAM_STORAGE",
"DISABLE_DIAGRAM_EXTENSION",
None,
"DO_NOT_REMOVE_LAYER_DEFINITIONS")环境
许可信息
- Basic: 否
- Standard: 是
- Advanced: 是