描述
用于更新与给定 utility network or trace network 相关的一个或多个网络逻辑示意图。
如果逻辑示意图存在“不一致”和“一致”任一情况，则可能需要更新。如果逻辑示意图不一致，则意味着已更改与某些逻辑示意图要素关联的网络元素，并且逻辑示意图已过期。如果已修改与一致的逻辑示意图关联的逻辑示意图模板，则可能需要对该逻辑示意图进行更新。
警告：
如果您具有处于打开状态的编辑会话，则在运行此工具前，必须先保存您的编辑内容。从而确保逻辑示意图可反映对数据库中网络拓扑所做的最新更改。如果保存编辑内容失败，则编辑内容不会反映在逻辑示意图中。
使用方法
在与企业级地理数据库中的公共设施网络或追踪网络数据库连接搭配使用时，系统不支持此工具。您必须使用相关的已发布公共设施网络或追踪网络服务或文件地理数据库中的公共设施网络或追踪网络。
输入网络或网络逻辑示意图图层必须来自文件地理数据库中的公共设施网络或追踪网络，或者公共设施网络或追踪网络服务。
如果输入模板名称和输入逻辑示意图名称参数均已指定，则当具有指定名称的逻辑示意图以不同的模板名称为基础时，该过程将失败。
如果该工具将网络数据元素或图层作为输入时，则其需要更新逻辑示意图名称列表或特定逻辑示意图模板（更新所有相关逻辑示意图）。
默认情况下，该工具仅处理不一致的逻辑示意图。要反映可能影响模板规则和布局定义以及所有相关逻辑示意图（无论是否一致）的更改，请在未选中仅更新不一致图参数的情况下运行此工具。
要在逻辑示意图更新结束时强制重新执行自动布局，您必须选中在已更新的逻辑示意图上重新应用自动布局参数。
在以下情况下，更新逻辑示意图工具将失败：
- 最初用于生成逻辑示意图的网络要素上存在脏区，无论这些脏区是处于可见状态还是聚合状态。
- 与最初用于生成逻辑示意图的网络对象相关的容器网络要素上存在脏区，无论这些脏区是处于可见状态还是聚合状态。
- 更新期间处理的新网络要素上存在脏区。
- 与在更新期间处理的新网络对象相关的容器网络要素上存在脏区。
语法
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 （可选） | 用于指定是仅更新不一致的逻辑示意图（默认）还是更新所有逻辑示意图（无论其一致性状态如何）。
| Boolean |
autolayout_option （可选） | 指定在更新过程中是否将重新应用可在逻辑示意图所基于的模板上配置的自动布局。默认情况下，在模板上指定自动布局时，进行更新过程期间不会重新应用这些布局。
| Boolean |
派生输出
| 名称 | 说明 | 数据类型 |
| out_diagrams | 更新的网络逻辑示意图，utility network or trace network。 | 公共设施网络图层；追踪网络图层；公共设施网络；追踪网络；逻辑示意图图层 |
代码示例
使用 UpdateDiagram 工具基于给定的模板更新所有不一致的逻辑示意图。
import arcpy
input_Network = "https://cezembre.esri.com/server/rest/services/Naperville2_Electric_SQL/FeatureServer/0"
input_TemplateName = "Basic"
arcpy.UpdateDiagram_nd(input_Network, input_TemplateName)环境
许可信息
- Basic: 否
- Standard: 是
- Advanced: 是