関連付けロールの設定 (Set Association Role) (ユーティリティ ネットワーク)

サマリー

アセット タイプのレベルでネットワーク フィーチャクラスまたはテーブルに割り当てられた関連付けロールを変更します。

関連付けロールは、特定のネットワーク フィーチャがユーティリティ ネットワークに参加する方法を定義します。 ユーティリティ ネットワークには、システムが提供する構造物および格納器用の既存の関連付けロールがあります。 関連付けを使用してネットワーク フィーチャを格納器または構造物として設定するには、まず「関連付けロール」を設定する必要があります。 これは、特定のアセット グループおよびアセット タイプのフィーチャクラス レベルまたはオブジェクト レベルで割り当てられます。

関連付けロールの割り当ての設定または変更の詳細

使用法

• このツールを使用して、アセット タイプのビューの縮尺および削除ルールを定義または更新できます。

• ネットワーク トポロジが、無効化されている必要があります。

• 格納器または構造物の関連付けロールの割り当て解除は、ネットワーク トポロジが初めて有効化される前にのみ実行することができます。 他の例とそれらに必要なネットワーク トポロジ状態については、「ユーティリティ ネットワーク管理タスク」をご参照ください。

• エンタープライズ ジオデータベースを操作する場合、接続する ArcGIS Enterprise ポータル アカウントがポータル ユーティリティ ネットワークの所有者である必要があります。

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

パラメーター

ダイアログ

ラベル	説明	データ タイプ
入力ユーティリティ ネットワーク	関連付けロールを設定するアセット タイプを含むユーティリティ ネットワーク。	Utility Network; Utility Network Layer
ドメイン ネットワーク	関連付けロールを設定するアセット タイプを含むドメイン ネットワーク。	String
入力テーブル	関連付けロールを設定するユーティリティ ネットワーク フィーチャクラスまたはテーブル。	String
アセット グループ	アセット タイプを含むアセット グループ。	String
アセット タイプ	関連付けロールを設定するアセット タイプ。	String
ロール タイプ	アセット タイプに割り当てられる関連付けロールのタイプを指定します。 格納器—格納器関連付けロール タイプが割り当てられます。 このロール タイプのフィーチャまたはオブジェクトには、他のフィーチャまたはオブジェクトを格納物として含めることができます。 構造物—構造物関連付けロール タイプが割り当てられます。 このロール タイプのフィーチャまたはオブジェクトには、他のフィーチャまたはオブジェクトを付属させることができます。 なし—ロール タイプは割り当てられません。 このフィーチャまたはオブジェクトは、格納器でも構造物でもなく、他の構造物に接続するフィーチャまたはオブジェクトです。	String
削除ルール	ネットワーク フィーチャの削除ルールを指定します。これにより、格納器または構造物を削除する際に、格納物または付属物ネットワーク フィーチャを管理する方法が定義されます。 削除ルールは、格納器と構造物の両方の関連付けロールに適用されます。 カスケード—格納器または構造物を削除すると、すべての格納物または付属物ネットワーク フィーチャが削除されます。 なし—格納器または構造物を削除した場合、その格納物または付属物ネットワーク フィーチャは削除されるのではなく、格納または構造物付属物の関連付けから解除されます。 制限—格納物または付属物ネットワーク フィーチャが存在する場合に、格納器または構造物を削除しようとすると、エラーが返されます。 格納物または付属物ネットワーク フィーチャは、格納器または構造物を削除する前に解除しておく必要があります。	String
ビューの縮尺 (オプション)	格納器に参加しているフィーチャを編集する格納モードに入る縮尺。 たとえば、ビューの縮尺を 5 に設定した場合、格納器フィーチャの格納モードに入ると、縮尺は 1:5 になります。 単位は、ユーティリティ ネットワーク レイヤー プロパティ ウィンドウの [ソース] タブに示されるユーティリティ ネットワーク単位に基づきます。 このパラメーターはジャンクションおよびエッジ オブジェクトに適用されません。	Double
格納物の分割 (オプション)	格納器フィーチャが分割される際に、格納器の関連する格納物を分割するかどうかを指定します。 このパラメーターは、関連付けロールが格納器である場合にのみ有効であり、ライン フィーチャのみに適用可能です。 オン - 格納器フィーチャが分割される際に、格納器の格納物を分割します。 平行な格納物ライン フィーチャが見つかると、格納物も分割され、各セクションは最も近い格納器フィーチャに包含されます。 格納物ラインが平行でない場合、格納物はそれに最も近い格納器フィーチャに包含されます。 格納物が非空間ジャンクション オブジェクトの場合は、各格納器フィーチャが格納物としてジャンクション オブジェクトを含むよう、格納物が複製されます。 格納物が非空間エッジ オブジェクトの場合は、各格納器フィーチャが格納物としてエッジ オブジェクトを含むよう、格納物が分割されます。 オフ - 格納器フィーチャが分割される際に、格納器の格納物を分割しません。 平行な格納物ライン フィーチャが見つかると、格納物は格納器フィーチャの両方のセクションに包含されます。 格納物ラインが平行でない場合、格納物はそれに最も近い格納器フィーチャに包含されます。 非空間ジャンクション オブジェクト格納物を操作中、格納物はより大きい格納器に格納されます。 非空間エッジ オブジェクト格納物を操作中、格納物は、両方の親の格納器の格納物として維持されます。 これがデフォルトです。	Boolean

派生した出力

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

Python

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: No
• Standard: Yes
• Advanced: Yes