関連付けロールの設定 (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: No
  • Standard: Yes
  • Advanced: Yes

関連トピック