ネットワーク トポロジの有効化 (Enable Network Topology) (ユーティリティ ネットワーク)

サマリー

ユーティリティ ネットワークのネットワーク トポロジを有効化します。

このツールは、フィーチャ間の接続性を評価および確立して、ユーティリティ ネットワークのネットワーク トポロジを構築します。 「ネットワーク トポロジ」は、トレースなどの解析操作やネットワーク ダイアグラムに必要となります。 また、ネットワーク トポロジをエラーの検出に使用することもできます。

注意:

ArcGIS Enterprise 10.9.1 以降、エンタープライズ ジオデータベースでユーティリティ ネットワークを操作する場合、UtilityNetworkTools ジオプロセシング サービスを使用して、ネットワーク トポロジの有効化操作が、非同期に処理されるようになりました。 UtilityNetworkTools サービスは、ユーティリティ ネットワークを含むフィーチャ サービスの System フォルダーで事前構成済みです。 このサービスはタイムアウト設定が長く、ユーティリティ ネットワークのジオプロセシング タスク用に予約されています。

ネットワーク トポロジを有効化する方法の詳細

使用法

    注意:

    大規模なユーティリティ ネットワークでネットワーク トポロジを有効化する場合、この操作には時間がかかり、ネットワークのフィーチャ数に応じて、リソースを消費することになります。 処理に対して適切な RAM とディスク容量を確保できるよう、クライアントとデータベースを適宜計画し、サイズを決定してください。

  • 一部のネットワーク構成タスクは、ネットワーク トポロジが初めて有効化される前にのみ実行することができます。 このツールに固有のタスクと必要なネットワーク トポロジ状態については、ユーティリティ ネットワーク管理タスクをご参照ください。

  • すべてのユーティリティ ネットワーク フィーチャクラスに、空間インデックスが必要です。

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

    • [入力ユーティリティ ネットワーク] パラメーターの値をデータベース コネクションから取得する場合は、データベース ユーティリティ ネットワークの所有者として接続を確立する必要があります。

    • 接続された ArcGIS Enterprise ポータル アカウントは、ポータル ユーティリティ ネットワークの所有者である必要があります。
    • このツールを実行するには、デフォルト バージョンに接続する必要があります。
      • デフォルト バージョンに接続されているその他のセッションでは、有効化操作の実行中に、検証操作も有効化操作も実行できません。
    • ユーティリティ ネットワークが、ブランチ バージョン対応登録されています。
    • 高度な設定の [エラーのみを生成] を使用するには、ユーティリティ ネットワークが、バージョン非対応の状態でなければなりません。
    • ライセンス:
      エンタープライズ配置でこのツールを使用するには、アクティブなポータル アカウントは、ArcGIS Advanced Editing ユーザー タイプ エクステンションのライセンスが付与される必要があります。

パラメーター

ラベル説明データ タイプ
入力ユーティリティ ネットワーク

ネットワーク トポロジを有効化するユーティリティ ネットワーク。

Utility Network; Utility Network Layer
エラーの最大数
(オプション)

ネットワーク トポロジの有効化が停止するまでに発生するエラーの最大数。 エラーは、ダーティ エリア サブレイヤーに記録されます。 デフォルト値は 10000 です。

注意:

エラーの最大数の値を大きくすると、トポロジの有効化にかかる時間が長くなります。 デフォルト値の 10000 より大きい値を設定することはお勧めしません。

Long
エラーのみを生成
(オプション)

トポロジが有効化されるのか、それともネットワーク エラーのみが生成されるのかを指定します。

  • オン - ユーティリティ ネットワークは、ネットワーク エラーのみに対して評価されます。 トポロジは有効化されません。 エンタープライズ ジオデータベースを操作している場合、データをバージョン対応登録できません。 これにより、トポロジを有効化する準備ができるまで、ネットワーク内を検査してエラーを修正できます。
  • オフ - トポロジが有効化され、エラーが存在する場合、エラーを含むダーティ エリアが生成されます。 これがデフォルトです。
Boolean

派生した出力

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

更新されたユーティリティ ネットワーク。

Utility Network

arcpy.un.EnableNetworkTopology(in_utility_network, {max_number_of_errors}, {only_generate_errors})
名前説明データ タイプ
in_utility_network

ネットワーク トポロジを有効化するユーティリティ ネットワーク。

Utility Network; Utility Network Layer
max_number_of_errors
(オプション)

ネットワーク トポロジの有効化が停止するまでに発生するエラーの最大数。 エラーは、ダーティ エリア サブレイヤーに記録されます。 デフォルト値は 10000 です。

注意:

エラーの最大数の値を大きくすると、トポロジの有効化にかかる時間が長くなります。 デフォルト値の 10000 より大きい値を設定することはお勧めしません。

Long
only_generate_errors
(オプション)

トポロジが有効化されるのか、それともネットワーク エラーのみが生成されるのかを指定します。

  • ONLY_ERRORSユーティリティ ネットワークは、ネットワーク エラーのみに対して評価されます。 トポロジは有効化されません。 エンタープライズ ジオデータベースを操作している場合、データをバージョン対応登録できません。 これにより、トポロジを有効化する準備ができるまで、ネットワーク内を検査してエラーを修正できます。
  • ENABLE_TOPOトポロジが有効化され、エラーが存在する場合、エラーを含むダーティ エリアが生成されます。 これがデフォルトです。
Boolean

派生した出力

名前説明データ タイプ
out_utility_network

更新されたユーティリティ ネットワーク。

Utility Network

コードのサンプル

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

EnableNetworkTopology 関数を使用して、MyNetwork というユーティリティ ネットワークのネットワーク トポロジを有効化し、エラーの最大数を 500 に設定します。

import arcpy
arcpy.un.EnableNetworkTopology('MyNetwork', 500)
EnableNetworkTopology の例 2 (Python ウィンドウ)

EnableNetworkTopology 関数を使用して、MyNetwork というユーティリティ ネットワークのエラーのみを生成します。

import arcpy
arcpy.un.EnableNetworkTopology('MyNetwork', '', 'ONLY_ERRORS')

環境

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

ライセンス情報

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

関連トピック