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

概要

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

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

注意:

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

メモ:

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

使用法

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

  • ダイアグラム テンプレート上の始点の構成は、テンプレートがトレース ルールを実行するように設定されている場合に意味があります。[トレース ルールの追加 (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

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

  • 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

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

ユーティリティ ネットワーク、トレース ネットワーク
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.AddSetStartingPointByAttributeRule_nd(input_Network, input_DiagramTemplate, 
                                             "ACTIVE", input_Device, 
                                             "ASSETGROUP <> 4", "3")

環境

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

ライセンス情報

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

関連トピック