更改逻辑示意图模板 (网络逻辑示意图)

摘要

更改逻辑示意图模板的属性，例如其名称、如何处理沿输入网络边的折点、是否可存储或扩展相关逻辑示意图、这些逻辑示意图中容器及其内容之间的边距、移除其规则和布局定义，以及将示意图图层定义重置为默认设置。

注：

对于基于输入逻辑示意图模板的任何现有逻辑示意图，更改容器边距的大小或移除逻辑示意图规则和布局定义会导致数据库中的 Consistency 字段值切换为不一致状态。所有这些逻辑示意图都将保持不一致状态，并随附打开一致性警告图标 ，直至对其进行更新为止。

警告：

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

使用情况

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

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

• 为输入网络参数指定的网络数据元素必须来自文件地理数据库中的公共设施网络或追踪网络，或者企业级地理数据库中公共设施网络或追踪网络的数据库连接。

• 此工具支持以下特定逻辑示意图模板属性更改：

  • 更改模板的名称
  • 设置模板为默认模板
  • 移除规则和布局定义
  • 将逻辑示意图图层定义重置为默认设置
  • 指定处理沿输入网络边的折点的方式
  • 定义容器及其内容之间的边距大小
  • 禁用这些逻辑示意图的存储功能
  • 启用扩展逻辑示意图功能

• 在逻辑示意图生成时，沿逻辑示意图边初始化顶点并在逻辑示意图显示时进行管理非常耗时。为避免影响性能，请仅在需要时选中保留边上的初始折点参数。例如，如果将模板配置为在生成时执行自动逻辑示意图布局，请为相对主线和部分重叠边逻辑示意图布局选中此参数。其他逻辑示意图布局类型在执行过程中不使用逻辑示意图边上的折点；它们只处理逻辑示意图交汇点位置。

• 从 ArcGIS Pro 2.6 开始，此工具会为输入逻辑示意图模板系统地初始化默认逻辑示意图图层定义（如果其尚未存在）。

• 配置模型以设置逻辑示意图模板的新规则和布局定义时，在选中模型开始处的移除逻辑示意图模板规则和布局定义参数的情况下运行更改逻辑示意图模板工具。这将使模型在启动时将模板属性重新初始化为默认值。

参数

对话框

标注	说明	数据类型
输入网络	要更改的逻辑示意图模板的 utility network or trace network。	Utility Network; Trace Network
输入逻辑示意图模板	要更改的逻辑示意图模板的名称。	String
新模板名称 (可选)	模板的新名称。	String
默认模板 (可选)	用于指定模板的默认状态。 选中 - 输入逻辑示意图模板将为默认模板。 未选中 - 输入逻辑示意图模板将不会成为默认模板。这是默认设置。 如果未指定模板，则默认模板是生成逻辑示意图时使用的模板。如果未指定其他模板，则其也是使用 utility network or trace network 选项卡组的数据选项卡上的新建逻辑示意图时使用的模板。	Boolean
移除逻辑示意图模板规则及布局定义 (可选)	用于指定是否将移除模板规则和布局定义。 选中 - 将移除与输入逻辑示意图模板相关的规则和布局定义。 未选中 - 将不会移除与输入逻辑示意图模板相关的规则和布局定义。这是默认设置。	Boolean
保留边上的初始折点 (可选)	指定如何在基于模板的逻辑示意图中管理沿 GIS 边的折点。 选中 - 沿 GIS 边显示的所有折点将保留在每个基于模板的网络逻辑示意图中的相关边上。 未选中 - 逻辑示意图边将绘制为其连接交汇点之间的直线。这是默认设置。 注： 为了提高性能质量，请仅在需要时选中此参数。例如，如果将模板配置为在逻辑示意图生成时运行自动布局，则选中此选项将对相对主线和部分重叠边逻辑示意图布局非常有意义。其他逻辑示意图布局在执行时不使用逻辑示意图边几何。	Boolean
容器边距 (可选)	容器和容器边界内所有交汇点的中心之间的最小距离。	Linear Unit
启用逻辑示意图存储 (可选)	指定是否能够存储基于模板的逻辑示意图。 选中 - 能够存储基于模板的逻辑示意图。这是默认设置。 未选中 - 无法存储基于模板的逻辑示意图。	Boolean
启用以扩展逻辑示意图 (可选)	指定是否能够扩展基于模板的逻辑示意图。 选中 - 可以按连通性、可遍历性、包含或附件来扩展基于模板的逻辑示意图。 未选中 - 无法扩展基于模板的逻辑示意图。这是默认设置。	Boolean
说明 (可选)	模板的描述。	String
将逻辑示意图模板图层定义重置为默认值 (可选)	指定是否将逻辑示意图模板图层定义重置为默认值。 选中 - 将与输入逻辑示意图模板相关的示意图图层定义重置为默认值（移除）。 未选中 - 将不会移除与输入逻辑示意图模板相关的逻辑示意图图层定义。这是默认设置。	Boolean

派生输出

标注	说明	数据类型
输出网络	已更新的 utility network or trace network。	公共设施网络；追踪网络
输出逻辑示意图模板	逻辑示意图模板的名称。	字符串

Python

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 (可选)	用于指定模板的默认状态。 DEFAULT_TEMPLATE—输入逻辑示意图模板将为默认模板。 NOT_DEFAULT_TEMPLATE—输入逻辑示意图模板将不会成为默认模板。这是默认设置。 如果未指定模板，则默认模板是生成逻辑示意图时使用的模板。	Boolean
are_rules_and_layouts_removed (可选)	用于指定是否将移除模板规则和布局定义。 REMOVE_RULES_AND_LAYOUTS—将移除与输入逻辑示意图模板相关的规则和布局定义。 DO_NOT_REMOVE_RULES_AND_LAYOUTS—将不会移除与输入逻辑示意图模板相关的规则和布局定义。这是默认设置。	Boolean
are_vertices_kept (可选)	指定如何在基于模板的逻辑示意图中管理沿 GIS 边的折点。 KEEP_VERTICES—沿 GIS 边显示的所有折点将保留在每个基于该模板的网络逻辑示意图中的相关边上。 DO_NOT_KEEP_VERTICES—逻辑示意图边将绘制为其连接交汇点之间的直线。这是默认设置。 注： 为了提高性能质量，请仅在需要时使用 KEEP_VERTICES 选项。例如，如果您的模板配置为在逻辑示意图生成时运行自动布局，则 KEEP_VERTICES 选项将对相对主线和部分重叠边逻辑示意图布局非常有意义。其他逻辑示意图布局在执行时不使用逻辑示意图边几何。	Boolean
container_margin (可选)	容器和容器边界内所有交汇点的中心之间的最小距离。	Linear Unit
is_diagram_storage_enabled (可选)	指定是否能够存储基于模板的逻辑示意图。 ENABLE_DIAGRAM_STORAGE—能够存储基于模板的逻辑示意图。这是默认设置。 DISABLE_DIAGRAM_STORAGE—无法存储基于模板的逻辑示意图。	Boolean
is_diagram_extension_enabled (可选)	指定是否能够扩展基于模板的逻辑示意图。 ENABLE_DIAGRAM_EXTENSION—可以按连通性、可遍历性、包含或附件来扩展基于模板的逻辑示意图。 DISABLE_DIAGRAM_EXTENSION—无法扩展基于模板的逻辑示意图。这是默认设置。	Boolean
description (可选)	模板的描述。	String
are_layer_definitions_removed (可选)	指定是否将逻辑示意图模板图层定义重置为默认值。 REMOVE_LAYER_DEFINITIONS—将与输入逻辑示意图模板相关的示意图图层定义重置为默认值（移除）。 DO_NOT_REMOVE_LAYER_DEFINITIONS—将不会移除与输入逻辑示意图模板相关的逻辑示意图图层定义。这是默认设置。	Boolean

派生输出

名称	说明	数据类型
out_utility_network	已更新的 utility network or trace network。	公共设施网络；追踪网络
out_template_name	逻辑示意图模板的名称。	字符串

代码示例

AlterDiagramTemplate 示例（Python 窗口）

此示例会增大属于基于 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: 是