属性による始点の設定ルールを追加 (Add Set Starting Point By Attribute Rule) (ネットワーク ダイアグラム)

サマリー

ダイアグラム テンプレートにダイアグラム ルールを追加して、ダイアグラムに現在表示されているダイアグラム フィーチャをトレース ルールの始点として設定します。 ダイアグラム フィーチャは、指定したネットワーク ソース クラスまたはオブジェクト テーブルから検索され、属性によってフィルタリングできます。

ダイアグラム上の始点の事前設定の詳細

注意:

このツールは構成および管理ツールです。

注意:

このツールは、入力ダイアグラム テンプレートに基づく既存のダイアグラムの一貫性に影響を与えます。 更新されるまで、既存のダイアグラムはすべて一貫性なしになり、一貫性警告アイコン 更新するダイアグラム が表示されます。

使用法

  • このツールは、ユーティリティ ネットワーク サービスまたはトレース ネットワーク サービスを使用する場合、サポートされません。 ファイルまたはモバイル ジオデータベース内のユーティリティ ネットワークまたはトレース ネットワークを使用するか、エンタープライズ ジオデータベース内のユーティリティ ネットワークまたはトレース ネットワークへのデータベース コネクションを使用する必要があります。 エンタープライズ ジオデータベースを操作する場合、次の要件があります。

  • ダイアグラム テンプレート上の始点の構成は、テンプレートがトレース ルールを実行するように設定されている場合に意味があります。 [トレース ルールの追加 (Add Trace Rule)] ツールの前に [属性による始点の設定ルールを追加 (Add Set Starting Point By Attribute Rule)] ツールを実行し、指定したダイアグラム フィーチャをトレース ルールの始点として設定します。 この場合、トレース ルールは、実行時にダイアグラムに表示されているすべてのフィーチャを実行するのではなく、指定された始点だけをトレースを実行するための始点として識別します。

  • 始点の設定ルールをサブネットワークベースのトレースの前に使用し、ターミナルを含むネットワーク エレメントを表すダイアグラム フィーチャ上に始点を構成する場合、ルールで流路の起点を識別するためにターミナル ID を指定する必要があります。 ターミナル ID が明確に識別されない場合、サブネットワークベースのトレースでは、開始されるターミナルを検索できません。 この場合、指定した層の外側に複数の始点がある旨のエラーが表示されます。 ターミナル ID が指定されているものの、トレースされた層のサブネットワーク コントローラーに対応していない場合、サブネットワーク コントローラーが検出されなかった旨のエラーが表示されます。

  • 始点の設定ルールが構成されているものの、想定される始点に対応するフィーチャがダイアグラム内に存在しない場合、トレース ルールはスキップされます。

パラメーター

ラベル説明データ タイプ
入力ネットワーク

変更するダイアグラム テンプレートを含むユーティリティ ネットワークまたはトレース ネットワーク。

Utility Network; Trace Network
入力ダイアグラム テンプレート

変更するダイアグラム テンプレートの名前。

String
アクティブ

指定したテンプレートに基づくダイアグラムの生成および更新時にルールを有効にするかどうかを指定します。

  • オン - 追加されたルールが入力テンプレートに基づくダイアグラムの生成および更新時に有効になります。 これがデフォルトです。
  • オフ - 追加されたルールが入力テンプレートに基づくダイアグラムの生成または更新時に有効になりません。

Boolean
ネットワーク ソース

始点として設定するフィーチャまたはオブジェクトを参照するネットワーク ソース クラスまたはオブジェクト テーブル。

Table; Feature Class
(オプション)

始点として設定する、指定したソース クラスまたはオブジェクト テーブル内のフィーチャまたはオブジェクトのサブセットを選択する SQL 式。 SQL 構文の詳細については、「ArcGIS で使用されるクエリ式への SQL リファレンス」をご参照ください。

SQL Expression
ジャンクション ターミナル
(オプション)

ネットワーク ソース クラスまたはオブジェクト テーブルがターミナルを含むネットワーク ジャンクションを参照している場合にトレースを開始するターミナル ID。

[ネットワーク ソース] パラメーターのジャンクションに対して取得されるすべてのターミナル ID がリストされます。 それらは、[ネットワーク プロパティ] タブの [ターミナル構成] セクションのターミナル ID に対応します。

[式] パラメーターと [ジャンクション ターミナル] パラメーターの両方が構成される場合、指定されるターミナルは検索されるフィーチャまたはオブジェクトに対応している必要があります。対応していない場合、始点が設定されません。

Long
説明
(オプション)

ルールの説明。

String

派生した出力

ラベル説明データ タイプ
出力ネットワーク

更新されたユーティリティ ネットワークまたはトレース ネットワーク。

Utility Network; Trace Network
出力ダイアグラム テンプレート

ダイアグラム テンプレートの名前。

String

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

指定したテンプレートに基づくダイアグラムの生成および更新時にルールを有効にするかどうかを指定します。

  • ACTIVE追加されたルールが入力テンプレートに基づくダイアグラムの生成および更新時に有効になります。 これがデフォルトです。
  • INACTIVE追加されたルールが入力テンプレートに基づくダイアグラムの生成および更新時に有効になりません。
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

更新されたユーティリティ ネットワークまたはトレース ネットワーク。

Utility Network; Trace Network
out_template_name

ダイアグラム テンプレートの名前。

String

コードのサンプル

AddSetStartingPointByAttributeRule の例 (スタンドアロン スクリプト)

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.nd.AddSetStartingPointByAttributeRule(input_Network, input_DiagramTemplate, 
                                             "ACTIVE", input_Device, 
                                             "ASSETGROUP <> 4", "3")

環境

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

ライセンス情報

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

関連トピック