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

概要

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

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

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

使用法

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

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

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

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

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

構文

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

更新されるユーティリティ ネットワーク。

ユーティリティ ネットワーク

コードのサンプル

SetAssociationRole (関連付けロールの設定) の例 (Python ウィンドウ)

変圧器アセット タイプの格納器の関連付けロールを設定します。ビューの縮尺が 10、削除ルールが制限に設定されます。

import arcpy
arcpy.SetAssociationRole_un("Utility Network", "ElectricDistribution", 
                            "ElectricDistributionAssembly", "Transformer Bank", 
                            "Transformer", "CONTAINER", "RESTRICTED", 10)

環境

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

ライセンス情報

  • Basic: いいえ
  • Standard: はい
  • Advanced: はい

関連トピック