描述
更改逻辑示意图模板的属性，例如其名称、如何处理沿输入网络边的折点、是否可存储或扩展相关逻辑示意图、这些逻辑示意图中容器及其内容之间的边距、移除其规则和布局定义，以及将示意图图层定义重置为默认设置。
警告：
该工具为配置和管理工具。
在与企业级地理数据库中的 utility network 搭配使用时，该工具必须由数据库 utility network 所有者通过默认版本的数据库连接来运行。默认版本必须为公开且不受保护。此外，连接的 ArcGIS Enterprise 门户帐户必须为门户 utility network 所有者。从而在实质上形成双因子身份验证。
注：
对于基于输入逻辑示意图模板的任何现有逻辑示意图，更改容器边距的大小或移除逻辑示意图规则和布局定义会导致数据库中的 Consistency 字段值切换为不一致状态。所有这些逻辑示意图都将保持不一致状态，并随附打开一致性警告图标 
，直至对其进行更新为止。
使用方法
系统在使用 utility network 服务时不支持此工具。您必须使用文件地理数据库中的 utility network or trace network 或企业级地理数据库中 utility network 的数据库连接。在使用企业级地理数据库时，必须以数据库 utility network 所有者的身份建立连接。
为输入网络参数指定的网络数据元素必须来自文件地理数据库中的 utility network or trace network 或企业级地理数据库中 utility network 的数据库连接。
此工具支持以下特定逻辑示意图模板属性更改：
- 更改模板的名称
- 设置模板为默认模板
- 移除规则和布局定义
- 将逻辑示意图图层定义重置为默认设置
- 指定处理沿输入网络边的折点的方式
- 定义容器及其内容之间的边距大小
- 禁用这些逻辑示意图的存储功能
- 启用扩展逻辑示意图功能
在逻辑示意图生成时，沿逻辑示意图边初始化顶点并在逻辑示意图显示时进行管理非常耗时。为避免影响性能，请仅在需要时选中保留边上的初始折点参数。例如，如果将模板配置为在生成时执行自动逻辑示意图布局，请为相对主线和部分重叠边逻辑示意图布局选中此参数。其他逻辑示意图布局类型在执行过程中不使用逻辑示意图边上的折点；它们只处理逻辑示意图交汇点位置。
从 ArcGIS Pro 2.6 开始，此工具会为输入逻辑示意图模板系统地初始化默认逻辑示意图图层定义（如果其尚未存在）。
配置模型以设置逻辑示意图模板的新规则和布局定义时，在选中模型开始处的移除逻辑示意图模板规则和布局定义参数的情况下运行更改逻辑示意图模板工具。这将使模型在启动时将模板属性重新初始化为默认值。
语法
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: 是