更新逻辑示意图 (网络逻辑示意图)

摘要

用于更新与给定 utility network or trace network 相关的一个或多个网络逻辑示意图。

如果逻辑示意图存在“不一致”和“一致”任一情况，则可能需要更新。 如果逻辑示意图不一致，则意味着已更改与某些逻辑示意图要素关联的网络元素，并且逻辑示意图已过期。 如果已修改与一致的逻辑示意图关联的逻辑示意图模板，则可能需要对该逻辑示意图进行更新。

警告：

如果您具有处于打开状态的编辑会话，则在运行此工具前，必须先保存您的编辑内容。 从而确保逻辑示意图可反映对数据库中网络拓扑所做的最新更改。 如果保存编辑内容失败，则编辑内容不会反映在逻辑示意图中。

了解有关更新网络逻辑示意图的详细信息

使用情况

• 在与企业级地理数据库中的公共设施网络或追踪网络数据库连接搭配使用时，系统不支持此工具。 您必须使用相关的已发布公共设施网络或追踪网络服务或文件或移动地理数据库中的公共设施网络或追踪网络。

• 输入网络或网络逻辑示意图图层必须来自文件或移动地理数据库中的公共设施网络或追踪网络，或者公共设施网络或追踪网络服务。

• 如果输入模板名称和输入逻辑示意图名称参数均已指定，则当具有指定名称的逻辑示意图以不同的模板名称为基础时，该过程将失败。

• 如果将网络数据元素或图层用作输入，则该工具需要更新逻辑示意图名称列表或特定逻辑示意图模板（更新所有相关逻辑示意图）。

• 默认情况下，该工具仅处理不一致的逻辑示意图。 要反映可能影响模板规则和布局定义以及所有相关逻辑示意图（无论是否一致）的更改，请在未选中仅更新不一致的逻辑示意图参数的情况下运行此工具。

• 要在逻辑示意图更新结束时重新应用自动布局，您必须选中在已更新的逻辑示意图上重新应用自动布局参数。

• 尝试更新子网系统逻辑示意图将失败，这些逻辑示意图仅由更新子网工具进行维护。

• 在以下情况下，更新逻辑示意图工具将失败：

  • 最初用于生成逻辑示意图的网络要素上存在脏区，无论这些脏区是处于可见状态还是聚合状态。
  • 与最初用于生成逻辑示意图的网络对象相关的容器网络要素上存在脏区，无论这些脏区是处于可见状态还是聚合状态。
  • 更新期间处理的新网络要素上存在脏区。
  • 与在更新期间处理的新网络对象相关的容器网络要素上存在脏区。
  在这些情况下，验证网络拓扑以清除脏区，然后运行该工具。

参数

对话框

标注	说明	数据类型
输入网络或网络逻辑示意图图层	要更新的输入网络逻辑示意图图层或在更新指定输入逻辑示意图名称集时基于的公共设施网络或追踪网络。	Utility Network Layer; Trace Network Layer; Utility Network; Trace Network; Diagram Layer
模板名称 (可选)	要处理的相关逻辑示意图的模板的名称。	String
逻辑示意图名称 (可选)	要处理的逻辑示意图的名称。	String
仅更新不一致图 (可选)	用于指定是仅更新不一致的逻辑示意图（默认）还是更新所有逻辑示意图（无论其一致性状态如何）。 选中 - 仅更新不一致的逻辑示意图。 这是默认设置。 未选中 - 一致和不一致的逻辑示意图均将进行更新。	Boolean
在已更新的图上重新应用自动布局 (可选)	指定在更新过程中是否将重新应用可在逻辑示意图所基于的模板上配置的自动布局。 默认情况下，在模板上指定自动布局时，进行更新过程期间不会重新应用这些布局。 选中 - 在模板上配置的自动布局将在更新过程结束时重新应用于逻辑示意图。 未选中 - 在模板上配置的自动布局均不会在更新过程中重新应用于逻辑示意图。 这是默认设置。	Boolean

派生输出

标注	说明	数据类型
输出网络或网络逻辑示意图图层	更新的网络逻辑示意图、公共设施网络或追踪网络。	Utility Network Layer; Trace Network Layer; Utility Network; Trace Network; Diagram Layer

Python

arcpy.nd.UpdateDiagram(in_diagrams, {template_names}, {diagram_names}, {update_option}, {autolayout_option})

名称	说明	数据类型
in_diagrams	要更新的输入网络逻辑示意图图层或在更新指定输入逻辑示意图名称集时基于的公共设施网络或追踪网络。	Utility Network Layer; Trace Network Layer; Utility Network; Trace Network; Diagram Layer
template_names [templatenames,...] (可选)	要处理的相关逻辑示意图的模板的名称。	String
diagram_names [diagram_names,...] (可选)	要处理的逻辑示意图的名称。	String
update_option (可选)	用于指定是仅更新不一致的逻辑示意图（默认）还是更新所有逻辑示意图（无论其一致性状态如何）。 INCONSISTENT_DIAGRAMS_ONLY—仅更新不一致的逻辑示意图。 这是默认设置。 ALL_SELECTED_DIAGRAMS—一致和不一致的逻辑示意图均将进行更新。	Boolean
autolayout_option (可选)	指定在更新过程中是否将重新应用可在逻辑示意图所基于的模板上配置的自动布局。 默认情况下，在模板上指定自动布局时，进行更新过程期间不会重新应用这些布局。 REAPPLY_AUTOLAYOUT—在模板上配置的自动布局将在更新过程结束时重新应用于逻辑示意图。 DO_NOT_REAPPLY_AUTOLAYOUT—在模板上配置的自动布局均不会在更新过程中重新应用于逻辑示意图。 这是默认设置。	Boolean

派生输出

名称	说明	数据类型
out_diagrams	更新的网络逻辑示意图、公共设施网络或追踪网络。	Utility Network Layer; Trace Network Layer; Utility Network; Trace Network; Diagram Layer

代码示例

UpdateDiagram 示例（Python 窗口）

使用 UpdateDiagram 函数基于给定的模板更新所有不一致的逻辑示意图。

import arcpy

input_Network = "https://cezembre.esri.com/server/rest/services/Naperville2_Electric_SQL/FeatureServer/0"
input_TemplateName = "Basic"
arcpy.nd.UpdateDiagram(input_Network, input_TemplateName)

环境

此工具不使用任何地理处理环境。

许可信息

• Basic: 否
• Standard: 是
• Advanced: 是