概要
ダイアグラム テンプレートにダイアグラム ルールを追加して、ダイアグラムに現在表示されているダイアグラム フィーチャをトレース ルールの始点として設定します。ダイアグラム フィーチャは、指定したネットワーク ソース クラスまたはオブジェクト テーブルから検索され、属性によってフィルタリングできます。
注意:
このツールは構成および管理ツールです。
メモ:
このツールは、入力ダイアグラム テンプレートに基づく既存のダイアグラムの一貫性に影響を与えます。更新されるまで、既存のダイアグラムはすべて一貫性なしになり、一貫性警告アイコン  が表示されます。
 が表示されます。
使用法
- このツールは、ユーティリティ ネットワーク サービスを使用する場合、サポートされません。ファイル ジオデータベース内のユーティリティ ネットワークまたはトレース ネットワークを使用するか、エンタープライズ ジオデータベース内のユーティリティ ネットワークへのデータベース接続を使用する必要があります。エンタープライズ ジオデータベースを使用している場合は、接続をデータベース ユーティリティ ネットワーク所有者として確立する必要があります。 
- エンタープライズ ジオデータベースのユーティリティ ネットワークにこの操作を行う場合、接続する ArcGIS Enterprise ポータル アカウントはポータル ユーティリティ ネットワークの所有者である必要があります。 
- 入力ネットワーク パラメーターに指定するネットワーク データ エレメントは、ファイル ジオデータベース内のユーティリティ ネットワークまたはトレース ネットワーク、あるいはエンタープライズ ジオデータベース内のユーティリティ ネットワークへのデータベース接続から取得する必要があります。 
- ダイアグラム テンプレート上の始点の構成は、テンプレートがトレース ルールを実行するように設定されている場合に意味があります。[トレース ルールの追加 (Add Trace Rule)] ツールを実行する前に [属性による始点の設定ルールを追加 (Add Set Starting Point By Attribute Rule)] ツールを実行して、指定したダイアグラム フィーチャをトレース ルールの始点に設定します。この場合、トレース ルールは、実行時にダイアグラムに表示されているすべてのフィーチャを実行するのではなく、指定された始点だけを実行のための始点として識別します。 
- 始点の設定ルールをサブネットワークベースのトレースの前に使用し、ターミナルを含むネットワーク エレメントを表すダイアグラム フィーチャ上に始点を構成する場合、ルールで流路の起点を識別するためにターミナル ID を指定する必要があります。ターミナル ID が明確に識別されない場合、サブネットワークベースのトレースでは、開始されるターミナルを判別できません。この場合、指定した層の外側に複数の始点がある旨のエラーが表示されます。ターミナル ID が指定されているものの、トレースされた層のサブネットワーク コントローラーに対応していない場合、サブネットワーク コントローラーが検出されなかった旨のエラーが表示されます。 
- 始点の設定ルールが構成されているものの、想定される始点に対応するフィーチャがダイアグラム内に存在しない場合、トレース ルールはスキップされます。 
構文
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 | ダイアグラム テンプレートの名前。 | 文字列 | 
コードのサンプル
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: はい