関連付けロールの設定 (Set Association Role) (ユーティリティー ネットワーク ツール)
サマリー
アセット タイプのレベルでネットワーク フィーチャクラスまたはテーブルに割り当てられた関連付けロールを変更します。
関連付けロールは、特定のネットワーク フィーチャがユーティリティー ネットワークに参加する方法を定義します。 ユーティリティー ネットワークには、システムが提供する構造物および格納器用の既存の関連付けルールがあります。 関連付けを使用してネットワーク フィーチャを格納器または構造物として設定するには、まず関連付けロールを設定する必要があります。 これは、特定のアセット グループおよびアセット タイプのフィーチャクラス レベルまたはオブジェクト レベルで割り当てられます。
関連付けロールの割り当ての設定または変更の詳細
使用法
このツールを使用して、アセット タイプのビューの縮尺および削除ルールを定義または更新できます。
ネットワーク トポロジーを無効化する必要があります。
格納器または構造物の関連付けロールの割り当て解除は、ネットワーク トポロジーが初めて有効化される前にのみ実行することができます。 例と、それらに必要なネットワーク トポロジー状態については、ユーティリティー ネットワーク管理タスクをご参照ください。
エンタープライズ ジオデータベースを操作する場合、接続する ArcGIS Enterprise ポータル アカウントは、ポータル ユーティリティー ネットワークの所有者である必要があります。
エンタープライズ ジオデータベースを操作する場合は、データベース ユーティリティー ネットワークの所有者として確立されたデータベース コネクションから、入力ユーティリティー ネットワーク パラメーターの値を取得する必要があります。
パラメーター
|
ラベル
|
説明
|
データ タイプ
|
|
入力ユーティリティー ネットワーク
|
関連付けロールを設定するアセット タイプを含むユーティリティー ネットワーク。
|
Utility Network; Utility Network Layer
|
|
ドメイン ネットワーク
|
関連付けロールを設定するアセット タイプを含むドメイン ネットワーク。
|
String
|
|
入力テーブル
|
関連付けロールを設定するユーティリティー ネットワーク フィーチャクラスまたはテーブル。
|
String
|
|
アセット グループ
|
アセット タイプを含むアセット グループ。
|
String
|
|
アセット タイプ
|
関連付けロールを設定するアセット タイプ。
|
String
|
|
ロール タイプ
|
アセット タイプに割り当てられる関連付けロールのタイプを指定します。
格納器—格納器関連付けロール タイプが割り当てられます。 このロール タイプのフィーチャまたはオブジェクトには、他のフィーチャまたはオブジェクトを格納物として含めることができます。
構造物—構造物関連付けロール タイプが割り当てられます。 このロール タイプのフィーチャまたはオブジェクトには、他のフィーチャまたはオブジェクトを付属させることができます。
なし—ロール タイプは割り当てられません。 このフィーチャまたはオブジェクトは、格納器でも構造物でもなく、他の構造物に接続するフィーチャまたはオブジェクトです。
|
String
|
|
削除ルール
|
ネットワーク フィーチャの削除ルールを指定します。これにより、格納器または構造物を削除する際に、格納物または付属物ネットワーク フィーチャを管理する方法が定義されます。 削除ルールは、格納器と構造物の両方の関連付けロールに適用されます。
カスケード—格納器または構造物を削除すると、すべての格納物または付属物ネットワーク フィーチャが削除されます。
なし—格納器または構造物が削除されたときに、その格納物または付属物ネットワーク フィーチャは削除されるのではなく、格納または構造物付属物の関連付けから除去されます。
制限—格納物または付属物ネットワーク フィーチャが存在する場合に、格納器または構造物を削除しようとすると、エラーが返されます。 格納物または付属物ネットワーク フィーチャは、格納器または構造物を削除する前に解除しておく必要があります。
|
String
|
|
ビューの縮尺
(オプション)
|
格納器に参加しているフィーチャを編集する格納モードに入る縮尺。 たとえば、ビューの縮尺を 5 に設定した場合、格納器フィーチャの格納モードに入ると、縮尺は 1:5 になります。 単位は、ユーティリティー ネットワーク レイヤー プロパティ ウィンドウの ソース タブに示されるユーティリティー ネットワーク単位に基づきます。 このパラメーターは、ジャンクションおよびエッジ オブジェクトに適用されません。
|
Double
|
|
格納物の分割
(オプション)
|
格納器フィーチャが分割される際に、格納器の関連する格納物を分割するかどうかを指定します。 このパラメーターは、関連付けロールが格納器である場合にのみ有効であり、ライン フィーチャのみに適用可能です。
オン—格納器フィーチャが分割される際に、格納器の格納物を分割します。 平行な格納物ライン フィーチャが見つかると、格納物も分割され、各セクションは最も近い格納器フィーチャに包含されます。 格納物ラインが平行でない場合、格納物はそれに最も近い格納器フィーチャに包含されます。 格納物が非空間ジャンクション オブジェクトの場合は、各格納器フィーチャが格納物としてジャンクション オブジェクトを含むよう、格納物が複製されます。 格納物が非空間エッジ オブジェクトの場合は、各格納器フィーチャが格納物としてエッジ オブジェクトを含むよう、格納物が分割されます。
オフ—格納器フィーチャが分割される際に、格納器の格納物を分割しません。 平行な格納物ライン フィーチャが見つかると、格納物は格納器フィーチャの両方のセクションに包含されます。 格納物ラインが平行でない場合、格納物はそれに最も近い格納器フィーチャに包含されます。 非空間ジャンクション オブジェクト格納物を操作中、格納物はより大きい格納器に格納されます。 非空間エッジ オブジェクト格納物を操作中、格納物は、両方の親の格納器の格納物として維持されます。 これがデフォルトです。
|
Boolean
|
派生した出力
|
ラベル
|
説明
|
データ タイプ
|
|
更新されたユーティリティー ネットワーク
|
更新されたユーティリティー ネットワーク。
|
Utility Network
|
arcpy.un.SetAssociationRole(in_utility_network, domain_network, featureclass, assetgroup, assettype, association_role_type, association_deletion_semantics, {view_scale}, {split_content})
|
名前
|
説明
|
データ タイプ
|
|
in_utility_network
|
関連付けロールを設定するアセット タイプを含むユーティリティー ネットワーク。
|
Utility Network; Utility Network Layer
|
|
domain_network
|
関連付けロールを設定するアセット タイプを含むドメイン ネットワーク。
|
String
|
|
featureclass
|
関連付けロールを設定するユーティリティー ネットワーク フィーチャクラスまたはテーブル。
|
String
|
|
assetgroup
|
アセット タイプを含むアセット グループ。
|
String
|
|
assettype
|
関連付けロールを設定するアセット タイプ。
|
String
|
|
association_role_type
|
アセット タイプに割り当てられる関連付けロールのタイプを指定します。
CONTAINER—格納器関連付けロール タイプが割り当てられます。 このロール タイプのフィーチャまたはオブジェクトには、他のフィーチャまたはオブジェクトを格納物として含めることができます。
STRUCTURE—構造物関連付けロール タイプが割り当てられます。 このロール タイプのフィーチャまたはオブジェクトには、他のフィーチャまたはオブジェクトを付属させることができます。
NONE—ロール タイプは割り当てられません。 このフィーチャまたはオブジェクトは、格納器でも構造物でもなく、他の構造物に接続するフィーチャまたはオブジェクトです。
|
String
|
|
association_deletion_semantics
|
ネットワーク フィーチャの削除ルールを指定します。これにより、格納器または構造物を削除する際に、格納物または付属物ネットワーク フィーチャを管理する方法が定義されます。 削除ルールは、格納器と構造物の両方の関連付けロールに適用されます。
CASCADE—格納器または構造物を削除すると、すべての格納物または付属物ネットワーク フィーチャが削除されます。
SET_TO_NONE—格納器または構造物が削除されたときに、その格納物または付属物ネットワーク フィーチャは削除されるのではなく、格納または構造物付属物の関連付けから除去されます。
RESTRICTED—格納物または付属物ネットワーク フィーチャが存在する場合に、格納器または構造物を削除しようとすると、エラーが返されます。 格納物または付属物ネットワーク フィーチャは、格納器または構造物を削除する前に解除しておく必要があります。
|
String
|
|
view_scale
(オプション)
|
格納器に参加しているフィーチャを編集する格納モードに入る縮尺。 たとえば、ビューの縮尺を 5 に設定した場合、格納器フィーチャの格納モードに入ると、縮尺は 1:5 になります。 単位は、ユーティリティー ネットワーク レイヤー プロパティ ウィンドウの ソース タブに示されるユーティリティー ネットワーク単位に基づきます。 このパラメーターは、ジャンクションおよびエッジ オブジェクトに適用されません。
|
Double
|
|
split_content
(オプション)
|
格納器フィーチャが分割される際に、格納器の関連する格納物を分割するかどうかを指定します。 このパラメーターは、関連付けロールが格納器である場合にのみ有効であり、ライン フィーチャのみに適用可能です。
SPLIT—格納器フィーチャが分割される際に、格納器の格納物を分割します。 平行な格納物ライン フィーチャが見つかると、格納物も分割され、各セクションは最も近い格納器フィーチャに包含されます。 格納物ラインが平行でない場合、格納物はそれに最も近い格納器フィーチャに包含されます。 格納物が非空間ジャンクション オブジェクトの場合は、各格納器フィーチャが格納物としてジャンクション オブジェクトを含むよう、格納物が複製されます。 格納物が非空間エッジ オブジェクトの場合は、各格納器フィーチャが格納物としてエッジ オブジェクトを含むよう、格納物が分割されます。
DO_NOT_SPLIT—格納器フィーチャが分割される際に、格納器の格納物を分割しません。 平行な格納物ライン フィーチャが見つかると、格納物は格納器フィーチャの両方のセクションに包含されます。 格納物ラインが平行でない場合、格納物はそれに最も近い格納器フィーチャに包含されます。 非空間ジャンクション オブジェクト格納物を操作中、格納物はより大きい格納器に格納されます。 非空間エッジ オブジェクト格納物を操作中、格納物は、両方の親の格納器の格納物として維持されます。 これがデフォルトです。
|
Boolean
|
派生した出力
|
名前
|
説明
|
データ タイプ
|
|
out_utility_network
|
更新されたユーティリティー ネットワーク。
|
Utility Network
|
コードのサンプル
SetAssociationRole の例 (Python ウィンドウ)
変圧器アセット タイプの格納器の関連付けロールを設定します。 ビューの縮尺が 10、削除ルールが制限に設定されます。
import arcpy
arcpy.un.SetAssociationRole("Utility Network", "ElectricDistribution",
"ElectricDistributionAssembly", "Transformer Bank",
"Transformer", "CONTAINER", "RESTRICTED", 10)
環境
このツールは、ジオプロセシング環境を一切使用しません。
ライセンス情報
- Basic: いいえ
- Standard: はい
- Advanced: はい