概要
ユーティリティ ネットワーク内にドメイン ネットワークの新しい層を作成します。
層は、同じレベル、名前の制限、およびトポロジ タイプを共有するサブネットワークのコレクションです。層はサブネットワークの管理に必要です。
使用法
ドメイン ネットワークに追加された最初の層のパーティション型の層定義を含むドメイン ネットワークの場合、サブネットワーク名フィールドが追加されます。階層型の層定義を含むドメイン ネットワークの場合、[サブネットワーク フィールド名] パラメーター値を使用してサブネットワーク フィールド名が作成されます。詳細については、「サブネットワーク名」をご参照ください。
階層型の層定義を含むドメイン ネットワークの場合、[層グループ名] は必須パラメーターです。階層型の層定義を含むドメイン ネットワークの場合、[層グループの追加 (Add Tier Group)] ツールを使用して層グループを作成できます。
層は、ユーティリティ ネットワーク フィーチャクラスにデータを追加する前に、追加する必要があります。新しい層を追加する前にデータが追加されると、エラーが発生します。
ネットワーク トポロジを無効化する必要があります。
エンタープライズ ジオデータベースを操作する場合、次の要件が満たされている必要があります。
- [入力ユーティリティ ネットワーク] パラメーター値は、データベース ユーティリティ ネットワークの所有者として、確立されたデータベース接続から取得する必要があります。
- 接続された ArcGIS Enterprise ポータル アカウントは、ポータル ユーティリティ ネットワークの所有者である必要があります。
- このツールは、実行時にデフォルト バージョンに接続する必要があります。
構文
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 です。入力ドメイン ネットワークがパーティション型の層定義を使って作成された場合、トポロジ タイプ パラメーターは必須です。 メモ:トレースまたはサブネットワーク管理の場合、このパラメーターは現在動作に変化をもたらしません。このパラメーターの機能は開発中であり、将来のリリースで適用可能になる予定です。
| String |
tier_group_name (オプション) | 新しい層を追加する既存の層グループ。このパラメーターは、階層型の層定義を含むドメイン ネットワークの場合、必須です。 | String |
subnetwork_field_name (オプション) | この層のサブネットワーク名を格納するフィールドの名前。これはシステムで維持されるフィールドであり、初めて層を層グループに追加した際に作成され、それ以降に追加された層に再利用されます。たとえば、Distribution と Transmission という 2 つの層グループがあるとします。system という名前の層を Distribution グループに追加し、サブネットワーク フィールド名を systemsubnet に指定すると、フィールドが作成されます。次に、system という名前の 2 つ目の層を Transmission グループに追加します。このパラメーターで、systemsubnet フィールドをサブネットワーク フィールド名として使用することが認識されます。階層型の層タイプの場合、このパラメーターは必須です。 | String |
派生した出力
| 名前 | 説明 | データ タイプ |
| out_utility_network | 更新されるユーティリティ ネットワーク。 | ユーティリティ ネットワーク |
コードのサンプル
[DistributionSystem] という名前の階層型ネットワーク内に MESH トポロジ タイプで層を作成します。
import arcpy
arcpy.AddTier_un("Utility Network", "GasDistribution", "Distribution System",
1, "MESH", "Distribution", "System")[MediumVoltage] という名前のパーティション型ネットワーク内に RADIAL トポロジ タイプで層を作成します。
import arcpy
arcpy.AddTier_un("Utility Network", "ElectricDistribution", "Medium Voltage",
1, "RADIAL")環境
ライセンス情報
- Basic: いいえ
- Standard: はい
- Advanced: はい