概要
ダイアグラム テンプレートにダイアグラム ルールを追加して、ダイアグラムに現在表示されているダイアグラム フィーチャをトレース ルールの始点として設定します。ダイアグラム フィーチャは、指定したネットワーク ソース クラスまたはオブジェクト テーブルから検索され、属性によってフィルタリングできます。
注意:
このツールは構成および管理ツールです。
メモ:
このツールは、入力ダイアグラム テンプレートに基づく既存のダイアグラムの一貫性に影響を与えます。更新されるまで、既存のダイアグラムはすべて一貫性なしになり、一貫性警告アイコン 
が表示されます。
使用法
このツールは、ユーティリティ ネットワーク サービスまたはトレース ネットワーク サービスを使用する場合、サポートされません。ファイル ジオデータベース内のユーティリティ ネットワークまたはトレース ネットワークを使用するか、エンタープライズ ジオデータベース内のユーティリティ ネットワークまたはトレース ネットワークへのデータベース接続を使用する必要があります。エンタープライズ ジオデータベースを操作する場合、次の要件があります。
- [入力ネットワーク] パラメーター値は、データベース ユーティリティ ネットワークの所有者またはデータベース トレース ネットワーク所有者として、確立されたデータベース接続から取得する必要があります。
- 接続された ArcGIS Enterprise ポータル アカウントは、ポータル ユーティリティ ネットワークの所有者またはポータル トレース ネットワーク所有者である必要があります。
- このツールは、パブリックで保護されていないと想定される、デフォルトのバージョンに接続されている必要があります。
ダイアグラム テンプレート上の始点の構成は、テンプレートがトレース ルールを実行するように設定されている場合に意味があります。[トレース ルールの追加 (Add Trace Rule)] ツールを実行する前に [属性による始点の設定ルールを追加 (Add Set Starting Point By Attribute Rule)] ツールを実行して、指定したダイアグラム フィーチャをトレース ルールの始点に設定します。この場合、トレース ルールは、実行時にダイアグラムに表示されているすべてのフィーチャを実行するのではなく、指定された始点だけを実行のための始点として識別します。
始点の設定ルールをサブネットワークベースのトレースの前に使用し、ターミナルを含むネットワーク エレメントを表すダイアグラム フィーチャ上に始点を構成する場合、ルールで流路の起点を識別するためにターミナル ID を指定する必要があります。ターミナル ID が明確に識別されない場合、サブネットワークベースのトレースでは、開始されるターミナルを判別できません。この場合、指定した層の外側に複数の始点がある旨のエラーが表示されます。ターミナル ID が指定されているものの、トレースされた層のサブネットワーク コントローラーに対応していない場合、サブネットワーク コントローラーが検出されなかった旨のエラーが表示されます。
始点の設定ルールが構成されているものの、想定される始点に対応するフィーチャがダイアグラム内に存在しない場合、トレース ルールはスキップされます。
構文
arcpy.nd.AddSetStartingPointByAttributeRule(in_utility_network, template_name, is_active, network_source, {where_clause}, {junction_terminals}, {description})| パラメーター | 説明 | データ タイプ |
in_utility_network | 変更するダイアグラム テンプレートを含むユーティリティ ネットワークまたはトレース ネットワーク。 | Utility Network; Trace Network |
template_name | 変更するダイアグラム テンプレートの名前。 | String |
is_active | 指定したテンプレートに基づくダイアグラムの生成および更新時にルールを有効にするかどうかを指定します。
| Boolean |
network_source | 始点として設定するフィーチャまたはオブジェクトを参照するネットワーク ソース クラスまたはオブジェクト テーブル。 | Table; Feature Class |
where_clause (オプション) | 始点として設定する、指定したソース クラスまたはオブジェクト テーブル内のフィーチャまたはオブジェクトのサブセットを選択する SQL 式。SQL 構文の詳細については、「ArcGIS で使用されるクエリ式への SQL リファレンス」をご参照ください。 | SQL Expression |
junction_terminals [junction_terminals,...] (オプション) | ネットワーク ソース クラスまたはオブジェクト テーブルがターミナルを含むジャンクションを参照している場合にトレースを開始するターミナル ID。 すべてのターミナル ID は、[ネットワーク プロパティ] タブの [ターミナル構成] セクションにリストされます。 where_clause パラメーターと junction_terminals パラメーターの両方が構成される場合、指定されるターミナルは検索されるフィーチャまたはオブジェクトに対応している必要があります。対応していない場合、始点が設定されません。 | Long |
description (オプション) | ルールの説明。 | String |
派生した出力
| 名前 | 説明 | データ タイプ |
| out_utility_network | 更新されたユーティリティ ネットワークまたはトレース ネットワーク。 | ユーティリティ ネットワーク、トレース ネットワーク |
| out_template_name | ダイアグラム テンプレートの名前。 | String |
コードのサンプル
MyTemplate1 テンプレートに属性による始点の設定ルールを追加して、回路遮断器配電デバイス (ASSETGROUP <> 4) の負荷ターミナル (#3) に始点を設定します。つまり、生成されたダイアグラム内の回路遮断器の負荷ターミナルが、始点として設定されます。
import arcpy
input_Network = "D:/MyProjectLocation/MyDatabaseConnection.sde/MyDatabase.MAP.Electric/MyDatabase.MAP.Electric"
input_DiagramTemplate = "MyTemplate1"
input_Device = "D:/MyProjectLocation/MyDatabaseConnection.sde/MyDatabase.MAP.Electric/MyDatabase.MAP.ElectricDistributionDevice"
arcpy.AddSetStartingPointByAttributeRule_nd(input_Network, input_DiagramTemplate,
"ACTIVE", input_Device,
"ASSETGROUP <> 4", "3")環境
ライセンス情報
- Basic: いいえ
- Standard: はい
- Advanced: はい