層の追加 (Add Tier) (ユーティリティ ネットワーク)

サマリー

ユーティリティ ネットワーク内にドメイン ネットワークの新しい層を作成します。

層は、同じレベル、名前の制限、およびトポロジ タイプを共有するサブネットワークのコレクションです。 層はサブネットワークの管理に必要です。

使用法

• ドメイン ネットワークに追加された最初の層のパーティション型の層定義を含むドメイン ネットワークの場合、サブネットワーク名フィールドが追加されます。 階層型の層定義を含むドメイン ネットワークの場合、[サブネットワーク フィールド名] パラメーター値を使用してサブネットワーク フィールド名が作成されます。 詳細については、「サブネットワーク名」をご参照ください。

• 階層型の層定義を含むドメイン ネットワークの場合、[層グループ名] は必須パラメーターです。 階層型の層定義を含むドメイン ネットワークの場合、[層グループの追加 (Add Tier Group)] ツールを使用して層グループを作成できます。

• 層は、ユーティリティ ネットワーク フィーチャクラスにデータを追加する前に、追加する必要があります。 新しい層を追加する前にデータが追加されると、エラーが発生します。

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

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

  • [入力ユーティリティ ネットワーク] パラメーター値は、「データベース ユーティリティ ネットワークの所有者」として、確立されたデータベース コネクションから取得する必要があります。
  • 接続された ArcGIS Enterprise ポータル アカウントは、ポータル ユーティリティ ネットワークの所有者である必要があります。
  • このツールを実行するには、デフォルト バージョンに接続する必要があります。
    • デフォルト バージョンに接続されているその他のセッションでは、有効化操作の実行中に検証操作も有効化操作も実行できません。

パラメーター

ダイアログ

ラベル	説明	データ タイプ
入力ユーティリティ ネットワーク	層を追加するドメイン ネットワークを含むユーティリティ ネットワーク。	Utility Network; Utility Network Layer
ドメイン ネットワーク	層を作成するドメイン ネットワーク。	String
名前	新しい層の名前。 この名前は、ユーティリティ ネットワーク全体で一意である必要があります。	String
ランク	追加する層のランク。 最高ランクは 1 です。	Long
トポロジ タイプ (オプション)	新しい層のトポロジ タイプを指定します。 放射状トポロジ タイプおよびメッシュ トポロジ タイプを含むサブネットワークは、両方とも 1 つ以上のサブネットワーク コントローラーをサポートします。 入力ドメイン ネットワークが階層型の層定義を使って作成された場合、このパラメーターはツール ダイアログ ボックス上で無効になり、トポロジ タイプがデフォルトでメッシュに設定されます。 ドメイン ネットワークがパーティション型の層定義を使って作成された場合、このパラメーターには、ドロップダウン リストにあるすべてのトポロジ タイプを使用できます。 トレースまたはサブネットワーク管理の場合、このパラメーターは現在動作に変化をもたらしません。 このパラメーターの機能は開発中であり、将来のリリースで適用可能になる予定です。 半径—サブネットワークは、放射状トポロジ タイプを含みます。 メッシュ—サブネットワークは、メッシュ トポロジ タイプを含みます。 これが、階層型の層定義を使って作成された層のデフォルトのトポロジ タイプです。	String
層グループ名 (オプション)	新しい層を追加する既存の層グループ。 このパラメーターは、階層型の層定義を含むドメイン ネットワークの場合、必須です。	String
サブネットワーク フィールド名 (オプション)	この層のサブネットワーク名を格納するフィールドの名前。 これはシステムで維持されるフィールドであり、初めて層を層グループに追加した際に作成され、それ以降に追加された層に再利用されます。 たとえば、Distribution と Transmission という 2 つの層グループがあるとします。 system という名前の層を Distribution グループに追加し、サブネットワーク フィールド名を systemsubnet に指定すると、フィールドが作成されます。 次に、system という名前の 2 つ目の層を Transmission グループに追加します。 このパラメーターで、systemsubnet フィールドをサブネットワーク フィールド名として使用することが認識されます。 階層型の層タイプの場合、このパラメーターは必須です。	String

派生した出力

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

Python

arcpy.un.AddTier(in_utility_network, domain_network, name, rank, {topology_type}, {tier_group_name}, {subnetwork_field_name})

名前	説明	データ タイプ
in_utility_network	層を追加するドメイン ネットワークを含むユーティリティ ネットワーク。	Utility Network; Utility Network Layer
domain_network	層を作成するドメイン ネットワーク。	String
name	新しい層の名前。 この名前は、ユーティリティ ネットワーク全体で一意である必要があります。	String
rank	追加する層のランク。 最高ランクは 1 です。	Long
topology_type (オプション)	新しい層のトポロジ タイプを指定します。 放射状トポロジ タイプおよびメッシュ トポロジ タイプを含むサブネットワークは、両方とも 1 つ以上のサブネットワーク コントローラーをサポートします。 入力ドメイン ネットワークが階層型の層定義を使って作成された場合、このパラメーターはツール ダイアログ ボックス上で無効になり、トポロジ タイプがデフォルトでメッシュに設定されます。 入力ドメイン ネットワークが階層型の層定義を使って作成された場合、デフォルトのトポロジ タイプは MESH です。 入力ドメイン ネットワークがパーティション型の層定義を使って作成された場合、トポロジ タイプ パラメーターは必須です。 注意: トレースまたはサブネットワーク管理の場合、このパラメーターは現在動作に変化をもたらしません。 このパラメーターの機能は開発中であり、将来のリリースで適用可能になる予定です。 RADIAL—サブネットワークは、放射状トポロジ タイプを含みます。 MESH—サブネットワークは、メッシュ トポロジ タイプを含みます。 これが、階層型の層定義を使って作成された層のデフォルトのトポロジ タイプです。	String
tier_group_name (オプション)	新しい層を追加する既存の層グループ。 このパラメーターは、階層型の層定義を含むドメイン ネットワークの場合、必須です。	String
subnetwork_field_name (オプション)	この層のサブネットワーク名を格納するフィールドの名前。 これはシステムで維持されるフィールドであり、初めて層を層グループに追加した際に作成され、それ以降に追加された層に再利用されます。 たとえば、Distribution と Transmission という 2 つの層グループがあるとします。 system という名前の層を Distribution グループに追加し、サブネットワーク フィールド名を systemsubnet に指定すると、フィールドが作成されます。 次に、system という名前の 2 つ目の層を Transmission グループに追加します。 このパラメーターで、systemsubnet フィールドをサブネットワーク フィールド名として使用することが認識されます。 階層型の層タイプの場合、このパラメーターは必須です。	String

派生した出力

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

コードのサンプル

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

DistributionSystem という名前の階層型ネットワーク内に MESH トポロジ タイプで層を作成します。

import arcpy
arcpy.un.AddTier("Utility Network", "GasDistribution", "Distribution System", 
                 1, "MESH", "Distribution", "System")

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

MediumVoltage という名前のパーティション型ネットワーク内に RADIAL トポロジ タイプで層を作成します。

import arcpy
arcpy.un.AddTier("Utility Network", "ElectricDistribution", "Medium Voltage", 
                 1, "RADIAL")

環境

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

ライセンス情報

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