概要
指定したユーティリティ ネットワークまたはトレース ネットワークに関連する 1 つ以上のネットワーク ダイアグラムを更新します。
ダイアグラムは、不整合時または整合時のいずれかに更新が必要となる場合があります。ダイアグラムが不整合のとき、一部のダイアグラム フィーチャに関連付けられているネットワーク エレメントが変更され、ダイアグラムは古くなっています。整合しているダイアグラムは、それに関連付けられたダイアグラム テンプレートが変更された場合に更新が必要になります。
注意:
編集セッションを開いている場合、このツールを実行する前に編集内容を保存する必要があります。これにより、ダイアグラムはデータベース内のネットワーク トポロジに行われた最新の変更内容を反映するようになります。編集内容を保存できなかった場合、編集内容はダイアグラムに反映されません。
使用法
このツールは、エンタープライズ ジオデータベース内のユーティリティ ネットワークへのデータベース接続を使用している場合には使用できません。関連する公開されたユーティリティ ネットワーク サービス、またはファイル ジオデータベースのユーティリティ ネットワークあるいはトレース ネットワークを使用してください。
入力ネットワークまたはネットワーク ダイアグラム レイヤーは、ファイル ジオデータベース内のユーティリティ ネットワークまたはトレース ネットワーク、あるいはユーティリティ ネットワーク サービスから取得する必要があります。
このツールは、エンタープライズ ジオデータベース内のユーティリティ ネットワークへのデータベース接続を使用している場合には使用できません。関連する公開されたユーティリティ ネットワーク サービス、またはファイル ジオデータベースのユーティリティ ネットワークあるいはトレース ネットワークを使用してください。
[入力テンプレート名] パラメーターと [入力ダイアグラム名] パラメーターの両方が指定されている場合、指定した名前のダイアグラムが別のテンプレート名に基づいていると、処理に失敗します。
ツールがネットワーク データ エレメントまたはレイヤーを入力として受け取った場合、更新するダイアグラム名のリストまたは特定のダイアグラム テンプレート (関連するダイアグラムがすべて更新される) のいずれかが必要です。
デフォルトでは、このツールは矛盾のあるダイアグラムのみ処理します。テンプレートのルールおよびレイアウト定義、その結果関連するダイアグラムすべてに影響を与えた可能性がある変更を反映するには (一貫性があるかどうかに関係なく)、[矛盾のあるダイアグラムのみ更新] パラメーターをオフにした状態で、このツールを実行します。
ダイアグラム更新の終了時に自動レイアウトを強制的に再実行するには、[更新されたダイアグラムに自動レイアウトを再適用] パラメーターをオンにする必要があります。
サブネットワーク システム ダイアグラムの更新を試行すると失敗します。これは、このダイアグラムが [サブネットワークの更新 (Update Subnetwork)] ツールによって排他的に管理されているためです。
次の状況では、[ダイアグラムの更新 (Update Diagram)] ツールが失敗します。
- 表示可能であるか集約されているかにかかわらず、ダイアグラムの生成に最初に使用されたネットワーク フィーチャにダーティ エリアが存在する。
- 表示可能であるか集約されているかにかかわらず、ダイアグラムの生成に最初に使用されたネットワーク オブジェクトに関連した格納器ネットワーク フィーチャにダーティ エリアが存在する。
- 更新中に処理された新しいネットワーク フィーチャにダーティ エリアが存在する。
- 更新中に処理された新しいネットワーク オブジェクトに関連する格納器ネットワーク フィーチャにダーティ エリアが存在する。
構文
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 | 更新されたネットワーク ダイアグラム、ユーティリティ ネットワークまたはトレース ネットワーク。 | ユーティリティ ネットワーク レイヤー、トレース ネットワーク レイヤー、ユーティリティ ネットワーク、トレース ネットワーク、ダイアグラム レイヤー |
コードのサンプル
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: はい