関連付けロールの設定 (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.SetAssociationRole_un("Utility Network", "ElectricDistribution", 
                            "ElectricDistributionAssembly", "Transformer Bank", 
                            "Transformer", "CONTAINER", "RESTRICTED", 10)

環境

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

ライセンス情報

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

関連トピック