サブネットワークの更新 (Update Subnetwork) (ユーティリティ ネットワーク)

サマリー

指定されたサブネットワークの「サブネットワーク テーブル」、「SubnetLine フィーチャクラス」、および「サブネットワーク システム ダイアグラム」のサブネットワーク情報を更新します。

サブネットワーク テーブルでは、このツールを実行すると、関連付けられたサブネットワーク コントローラーのステータスがクリーンに変更されます (「Is dirty 属性」が False に設定されます)。 ツールの操作中に「一貫性の検証での不合格」または「サブネットワーク エラー」が検出されると、関連付けられたサブネットワーク コントローラーのステータスが無効とマーク付けされます (Is dirty 属性が Invalid に設定されます)。 SubnetLine フィーチャクラスでは、新しいサブネットワークのレコードが生成され、削除されたサブネットワークのレコードが削除され、変更されたサブネットワークの形状と情報が更新されます。 また、サブネットワーク フィーチャの特定の属性が作成または更新されます。

層のサブネットワークの更新ポリシーが Is dirty 属性を管理しないように構成されている場合は、サブネットワークの更新操作を使用して、Is deleted 属性が true に設定されているサブネットワーク テーブルから行を削除できます。

サブネットワークの更新方法の詳細

使用法

• エンタープライズ ジオデータベースを操作する場合、次の要件が満たされている必要があります。

  • ユーティリティ ネットワークが、「ブランチ バージョン対応登録」されている必要があります。
  • 入力ユーティリティ ネットワークは、ユーティリティ ネットワーク サービスから取得する必要があります。
  • デフォルト バージョンでサブネットワークの更新操作を使用して、Is dirty 属性を管理しない層のサブネットワーク テーブルから行を削除できます。
  • このツールをデフォルト バージョンに対して実行すると、SubnetLine フィーチャクラスのジオメトリ、サブネットワーク名属性、および伝達されるフィールドが代わりに更新されます。 このツールを指定バージョンに対して実行すると、デフォルトの動作 (イベントなし) によって、このバージョンで編集されたフィーチャとオブジェクトに更新が制限されます。 イベントを使用 (イベントありで動作) するように編集モードを変更することができます。 このオプションは、ジオデータベースの動作を制御し、デフォルト バージョンと指定バージョンの両方のサブネットワーク定義で設定できます。

    [サブネットワークの更新 (Update Subnetwork)] ツールによって使用される編集モードの詳細

  • ライセンス:

    エンタープライズ配置でこのツールを使用するには、アクティブなポータル アカウントは、ArcGIS Advanced Editing ユーザー タイプ エクステンションのライセンスが付与される必要があります。

• このツールは、「サブネットワーク定義」の設定時にダイアグラム テンプレートが指定された場合、ネットワーク ダイアグラムを新しく作成するか、更新されたサブネットワークのネットワーク ダイアグラムを更新します。

• このツールを実行する前に、編集内容をすべて保存しておく必要があります。

• ネットワーク トポロジを「有効化」する必要があります。

• サブネットワーク フィーチャと交差するダーティ エリアが存在してはいけません。

パラメーター

ダイアログ

ラベル	説明	データ タイプ
入力ユーティリティ ネットワーク	サブネットワークが属しているユーティリティ ネットワーク。	Utility Network; Utility Network Layer
ドメイン ネットワーク	サブネットワークが属しているドメイン ネットワーク。	String
層	サブネットワークを含む層。	String
層内のすべてのサブネットワーク (オプション)	層内のすべてのサブネットワークを更新するかどうかを指定します。 層に含まれているサブネットワークのサブセットを更新するには、[サブネットワーク名] パラメーターを使用します。 オン - 層に含まれているすべてのサブネットワークが更新されます。 このオプションは、非同期処理でシステムの UtilityNetworkTools ジオプロセシング サービスを使用してサブネットワークを更新します。 このサービスは、ユーティリティ ネットワークのジオプロセシング タスクで維持され、デフォルトのタイムアウト設定が長くなります。 これがデフォルトです。 オフ - [サブネットワーク名] パラメーターで指定されたサブネットワークだけが更新されます。	Boolean
サブネットワーク名 (オプション)	層から更新されるサブネットワークの名前。 [層内のすべてのサブネットワーク] パラメーターがオンになっている場合、このパラメーターは無視されます。 サブネットワーク テーブルの 1 つの層に 10,000 以上のレコードが含まれている場合、パラメーターの選択リストは設定されず、サブネットワーク名に空のフィールドが指定されます。	String
失敗時に処理を続行 (オプション)	複数のサブネットワークを更新する際、1 つのサブネットワークの更新に失敗した場合に更新処理を停止するかどうかを指定します。 オン - サブネットワークの更新に失敗した場合に、更新処理を停止せずに続行します。 オフ - サブネットワークの更新に失敗した場合に、更新処理を停止します。 これがデフォルトです。	Boolean
条件バリア (オプション)	注意: このパラメーターは、Python でのみ使用できます。	Value Table
関数バリア (オプション)	注意: このパラメーターは、Python でのみ使用できます。	Value Table
バリア フィーチャを含める (オプション)	注意: このパラメーターは、Python でのみ使用できます。	Boolean
通過可能性の適用 (オプション)	適用される通過可能性のタイプを指定します。 通過可能性範囲は、通過可能性がジャンクション、エッジ、またはその両方のいずれに適用されるかを決定します。 たとえば、DEVICESTATUS が Open の場合にトレースを停止するように条件バリアが定義されており、通過可能性範囲がエッジのみに設定されている場合、DEVICESTATUS はジャンクションにしか適用されないため、オープンなデバイスが見つかっても、トレースは停止しません。 つまり、このパラメーターは、トレースで、ジャンクション、エッジ、またはその両方を無視するかどうかを示します。 ジャンクションとエッジの両方—通過可能性は、ジャンクションとエッジの両方に適用されます。 これがデフォルトです。 ジャンクションのみ—通過可能性は、ジャンクションのみに適用されます。 エッジのみ—通過可能性は、エッジのみに適用されます。 注意: このパラメーターは、Python でのみ使用できます。	String
プロパゲーター (オプション)	注意: このパラメーターは、Python でのみ使用できます。	Value Table

派生した出力

ラベル	説明	データ タイプ
更新されたユーティリティ ネットワーク	更新されたユーティリティ ネットワーク。	Utility Network

Python

arcpy.un.UpdateSubnetwork(in_utility_network, domain_network, tier, {all_subnetworks_in_tier}, {subnetwork_name}, {continue_on_failure}, {condition_barriers}, {function_barriers}, {include_barriers}, {traversability_scope}, {propagators})

名前	説明	データ タイプ
in_utility_network	サブネットワークが属しているユーティリティ ネットワーク。	Utility Network; Utility Network Layer
domain_network	サブネットワークが属しているドメイン ネットワーク。	String
tier	サブネットワークを含む層。	String
all_subnetworks_in_tier (オプション)	層内のすべてのサブネットワークを更新するかどうかを指定します。 層に含まれているサブネットワークのサブセットを更新するには、subnetwork_name パラメーターを使用します。 ALL_SUBNETWORKS_IN_TIER—層内のすべてのサブネットワークが更新されます。 このオプションは、非同期処理でシステムの UtilityNetworkTools ジオプロセシング サービスを使用してサブネットワークを更新します。 このサービスは、ユーティリティ ネットワークのジオプロセシング タスクで維持され、デフォルトのタイムアウト設定が長くなります。 これがデフォルトです。 SPECIFIC_SUBNETWORK—subnetwork_name パラメーターで指定されたサブネットワークだけが更新されます。	Boolean
subnetwork_name (オプション)	層から更新されるサブネットワークの名前。 all_subnetworks_in_tier パラメーターが ALL_SUBNETWORKS_IN_TIER に設定されている場合、このパラメーターは無視されます。	String
continue_on_failure (オプション)	複数のサブネットワークを更新する際、1 つのサブネットワークの更新に失敗した場合に更新処理を停止するかどうかを指定します。 CONTINUE_ON_FAILURE—サブネットワークの更新に失敗した場合に、更新処理を停止せずに続行します。 STOP_ON_FAILURE—サブネットワークの更新に失敗した場合に、更新処理を停止します。 これがデフォルトです。	Boolean
condition_barriers [[Name, Operator, Type, Value, Combine Using],...] (オプション)	ネットワーク属性との比較またはカテゴリ文字列のチェックに基づいて、フィーチャに対して通過可能性バリア条件を設定します。 条件バリアでは、ネットワーク属性またはネットワーク カテゴリ、演算子とタイプ、および属性値が使用されます。 たとえば、フィーチャが Open の特定の値と等しい Device Status 属性を持っている場合に、トレースを停止します。 フィーチャがこの条件を満たしている場合、トレースが停止します。 複数の属性を使用している場合、[結合方法] パラメーターを使用して And 条件および Or 条件を定義することができます。 条件バリアの構成は、次のとおりです。 Name - システム内で定義された任意のネットワーク属性によってフィルターするか、カテゴリを指定してネットワーク カテゴリを使用します。 Operator - 複数の演算子から選択します。 Type - バリアとして機能する Name パラメーターの値のタイプとして Specific value または Network attribute を指定します。 Name パラメーターが Category である場合、Type パラメーターを Specific value に設定する必要があります。 Value - 演算子の値に基づいて、処理を停止させる入力属性またはカテゴリの特定の値を指定します。 Combine Using - 複数の条件を追加する場合に、この値を設定します。And 条件または Or 条件を使用して、条件を結合することができます。 条件バリア Operator の値は次のとおりです。 IS_EQUAL_TO—属性と値が等しい。 DOES_NOT_EQUAL—属性と値が等しくありません。 IS_GREATER_THAN—属性が値より大きい。 IS_GREATER_THAN_OR_EQUAL_TO—属性が値以上です。 IS_LESS_THAN—属性が値より小さい。 IS_LESS_THAN_OR_EQUAL_TO—属性が値以下です。 INCLUDES_THE_VALUES—値のすべてのビットが、属性内に存在するビット単位の論理積演算 (bitwise AND == value)。 DOES_NOT_INCLUDE_THE_VALUES—値の一部のビットが、属性内に存在しないビット単位の論理積演算 (bitwise AND != value)。 INCLUDES_ANY—値の少なくとも 1 つのビットが、属性内に存在するビット単位の論理積演算 (bitwise AND == True)。 DOES_NOT_INCLUDE_ANY—値のビットが、属性内に存在しないビット単位の論理積演算 (bitwise AND == False)。 条件バリアの type のオプションは次のとおりです。 SPECIFIC_VALUE—特定の値またはネットワーク カテゴリによってフィルターします。 NETWORK_ATTRIBUTE—ネットワーク属性によってフィルターします。 Combine Using の値は次のとおりです。 AND—条件バリアを結合します。 OR—いずれかの条件バリアが、満たされている場合に使用します。 複数の式の使用方法の詳細	Value Table
function_barriers [[Function, Attribute, Operator, Value, Use Local Values],...] (オプション)	関数に基づいて、フィーチャに対する通過可能性バリアを設定します。 関数バリアを使用して、始点からトレースが移動できる距離の制限としてそのような設定を行うか、トレースを停止するための最大値を設定することができます。 たとえば、通過した各ラインの長さが、それまでに移動した合計距離に追加されます。 移動した全長が指定された値に達した場合、トレースが停止します。 関数バリアの構成は、次のとおりです。 Function - さまざまな演算関数から選択します。 Attribute - システム内で定義された任意のネットワーク属性によってフィルターします。 Operator - 複数の異なる演算子から選択します。 Value - 検出された場合に、処理を停止させる入力属性タイプの特定の値を設定します。 Use Local Values - 全体的なグローバル値とは対照的に、各方向で値を計算します。 たとえば、Shape length の合計を計算している関数バリアで、値が 4 以上になったときにトレースが終了する場合に使用します。 グローバル値の場合は、値が 2 の 2 つのエッジを通過すると、形状の長さの合計値 4 にすでに到達するため、トレースが停止します。 ローカル値を使用している場合は、各パスに沿ってローカル値が変化するため、トレースが続行します。 TRUE—ローカル値が使用されます。 FALSE—グローバル値が使用されます。 これがデフォルトです。 関数バリアの [function] のオプションは次のとおりです。 AVERAGE—入力値の平均が計算されます。 COUNT—フィーチャの数が特定されます。 MAX—入力値の最大が特定されます。 MIN—入力値の最小が特定されます。 ADD—入力値の合計が計算されます。 SUBTRACT—入力値の差が計算されます。サブネットワーク コントローラーおよびループ トレース タイプは、減算関数をサポートしていません。 たとえば、始点フィーチャの値が 20 とします。 次のフィーチャは、30 の値を持っています。 最小関数を使用すると、結果が 20、最大が 30、追加が 50、平均が 25、個数が 2、減算が -10 になります。 関数バリアの operator 値のオプションは、次のとおりです。 IS_EQUAL_TO—属性と値が等しい。 DOES_NOT_EQUAL—属性と値が等しくありません。 IS_GREATER_THAN—属性が値より大きい。 IS_GREATER_THAN_OR_EQUAL_TO—属性が値以上です。 IS_LESS_THAN—属性が値より小さい。 IS_LESS_THAN_OR_EQUAL_TO—属性が値以下です。 INCLUDES_THE_VALUES—値のすべてのビットが、属性内に存在するビット単位の論理積演算 (bitwise AND == value)。 DOES_NOT_INCLUDE_THE_VALUES—値の一部のビットが、属性内に存在しないビット単位の論理積演算 (bitwise AND != value)。 INCLUDES_ANY—値の少なくとも 1 つのビットが、属性内に存在するビット単位の論理積演算 (bitwise AND == True)。 DOES_NOT_INCLUDE_ANY—値のビットが、属性内に存在しないビット単位の論理積演算 (bitwise AND == False)。	Value Table
include_barriers (オプション)	通過可能性バリア フィーチャがトレース結果に含まれるかどうかを指定します。 通過可能性バリアは、サブネットワーク定義で事前に設定されている場合でも任意指定です。 INCLUDE_BARRIERS—通過可能性バリアをトレース結果に含めます。 これがデフォルトです。 EXCLUDE_BARRIERS—通過可能性バリアをトレース結果に含めません。	Boolean
traversability_scope (オプション)	適用される通過可能性のタイプを指定します。 通過可能性範囲は、通過可能性がジャンクション、エッジ、またはその両方のいずれに適用されるかを決定します。 たとえば、DEVICESTATUS が Open の場合にトレースを停止するように条件バリアが定義されており、通過可能性範囲がエッジのみに設定されている場合、DEVICESTATUS はジャンクションにしか適用されないため、オープンなデバイスが見つかっても、トレースは停止しません。 つまり、このパラメーターは、トレースで、ジャンクション、エッジ、またはその両方を無視するかどうかを示します。 BOTH_JUNCTIONS_AND_EDGES—通過可能性は、ジャンクションとエッジの両方に適用されます。 これがデフォルトです。 JUNCTIONS_ONLY—通過可能性は、ジャンクションのみに適用されます。 EDGES_ONLY—通過可能性は、エッジのみに適用されます。	String
propagators [[Attribute, Substitution Attribute, Function, Operator, Value],...] (オプション)	伝播させるネットワーク属性、およびトレース中に伝播がどのように発生するかを指定します。 伝播されるクラス属性は、サブネットワーク内の他のフィーチャに広められる、サブネットワーク コントローラーの重要な値を示します。 たとえば、配電モデルでは、位相値を伝播することができます。 プロパゲーターの構成は次のとおりです。 Attribute - システム内で定義された任意のネットワーク属性によってフィルターします。 Substitution Attribute - bitset ネットワーク属性値の代わりに、代替値を使用します。 代替は、伝達されるネットワーク属性のビット数に基づいてエンコードされます。 代替は、フェーズ内の各ビットから別のマップへのマッピングです。 たとえば、フェーズ AC では、1 つの代替は、ビット A から B、ビット C から NULL へのマッピングです。 この例では、1010 (フェーズ AC) の代替は 0000-0010-0000-0000 (512) です。 代替がマッピングをキャプチャし、マッピングは、フェーズ A から B、フェーズ C から NULL へ行われたのであり、その逆 (すなわち、フェーズ A から NULL、フェーズ C から B) ではないことがわかります。 Function - 複数の計算関数から選択します。 Operator - 複数の演算子から選択します。 Value - 演算子の値に基づいて処理を停止させる、入力属性タイプの特定の値を指定します。 プロパゲーターの function の値オプションは、次のとおりです。 PROPAGATED_BITWISE_AND—あるフィーチャの値と次のフィーチャの値を比較します。 PROPAGATED_MIN—最小値を取得します。 PROPAGATED_MAX—最大値を取得します。 プロパゲーターの operator の値オプションは、次のとおりです。 IS_EQUAL_TO—属性と値が等しい。 DOES_NOT_EQUAL—属性と値が等しくありません。 IS_GREATER_THAN—属性が値より大きい。 IS_GREATER_THAN_OR_EQUAL_TO—属性が値以上です。 IS_LESS_THAN—属性が値より小さい。 IS_LESS_THAN_OR_EQUAL_TO—属性が値以下です。 INCLUDES_THE_VALUES—値のすべてのビットが、属性内に存在するビット単位の論理積演算 (bitwise AND == value)。 DOES_NOT_INCLUDE_THE_VALUES—値の一部のビットが、属性内に存在しないビット単位の論理積演算 (bitwise AND != value)。 INCLUDES_ANY—値の少なくとも 1 つのビットが、属性内に存在するビット単位の論理積演算 (bitwise AND == True)。 DOES_NOT_INCLUDE_ANY—値のビットが、属性内に存在しないビット単位の論理積演算 (bitwise AND == False)。	Value Table

派生した出力

名前	説明	データ タイプ
out_utility_network	更新されたユーティリティ ネットワーク。	Utility Network

コードのサンプル

UpdateSubnetwork の例 1 (Python ウィンドウ)

RMT004 という名前のサブネットワークを更新します。

import arcpy
arcpy.un.UpdateSubnetwork("Utility Network", "ElectricDistribution", 
                          "Medium Voltage", "SPECIFIC_SUBNETWORK", "RMT004", 
                          "CONTINUE_ON_FAILURE")

UpdateSubnetwork の例 2 (Python ウィンドウ)

Medium Voltage 層に含まれているサブネットワークをすべて更新します。

import arcpy
arcpy.un.UpdateSubnetwork("Utility Network", "ElectricDistribution", 
                          "Medium Voltage", "ALL")

環境

このツールは、ジオプロセシング環境を使用しません。

ライセンス情報

• Basic: No
• Standard: Yes
• Advanced: Yes