属性によるダイアグラム フィーチャ機能ルールの追加 (Add Diagram Feature Capability By Attribute Rule) (ネットワーク ダイアグラム)

サマリー

ダイアグラム構築プロセス中に、ダイアグラムに現在表示されているダイアグラム フィーチャに特定の機能を割り当てるため、ダイアグラム テンプレートで指定されたルール シーケンスにダイアグラム ルールを追加します。 この機能は、ルール シーケンス内で、後から実行される他のルールによって使用されます。 処理されるダイアグラム フィーチャは、ネットワーク ソース クラスまたはオブジェクト テーブルから、属性を基準に検索されます。

ダイアグラム フィーチャ機能の追加ルールの詳細

注意:

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

注意:

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

使用法

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

  • [入力ネットワーク] パラメーター値は、データベース ユーティリティ ネットワークの所有者またはデータベース トレース ネットワーク所有者として、確立されたデータベース コネクションから取得する必要があります。
  • 接続された ArcGIS Enterprise ポータル アカウントは、ポータル ユーティリティ ネットワークの所有者またはポータル トレース ネットワーク所有者である必要があります。
  • このツールは、パブリックで保護されていないと想定される、デフォルトのバージョンに接続されている必要があります。

• [機能] パラメーターで、[関連する格納器の単純化を防ぐ] オプションまたは [関連する格納器の単純化を許可] オプションを指定して、格納物ダイアグラム フィーチャにフラグを付け、ルール シーケンス内で、後から実行される格納器のルールにより、関連する格納器が単純化されるのを防ぐか、許可します。 これらは、[格納器の単純化ルールを追加 (Add Collapse Container Rule)] ツール、[属性による格納器の単純化ルールを追加 (Add Collapse Container By Attribute Rule)] ツール、または [カテゴリによる格納器の単純化ルールを追加 (Add Collapse Container By Category Rule)] ツールを使用して、設定されるルールです。

• [機能] パラメーターで、[ジャンクションの削減を防ぐ] オプションまたは [ジャンクションの削減を許可] オプションを指定して、ダイアグラム ジャンクションにフラグを付け、ルール シーケンス内で、後から実行されるジャンクションの削減ルールにより、ダイアグラム ジャンクションを廃棄するか、許可するかを指定します。 これらは、[ジャンクションの削減ルールを追加 (dd Reduce Junction Rule)] ツール、[属性によるジャンクションの削減ルールを追加 (Add Reduce Junction By Attribute Rule)] ツール、または [カテゴリによるジャンクションの削減ルールの追加 (Add Reduce Junction By Category Rule)] ツールを使用して、設定されるルールです。

• [機能] パラメーターで [未接続の空の格納器ジャンクションをポリゴンとして保存する] オプションを指定して、ダイアグラム ジャンクションではなくダイアグラム格納器を作成して、未接続の空の格納器ネットワーク ジャンクションまたはジャンクション オブジェクトを表します。 この機能は、格納器ジャンクション ソース クラスまたはオブジェクト テーブルのみに適用されます。

• [機能] パラメーターで [無視して上流トレースを開始] オプションを指定して、ダイアグラム フィーチャにフラグを付け、上流トレースのルール シーケンス内で、後から構成されるすべてのトレース ルールにより、始点として無視されるようします。

• [機能] パラメーターで [無視して下流トレースを開始] オプションを指定して、ダイアグラム フィーチャにフラグを付け、下流トレースのルール シーケンス内で、後から構成されるすべてのトレース ルールにより、始点として無視されるようします。

• ArcGIS Pro 3.4 以降では、結合価 (接続先のダイアグラム ジャンクションの数) に応じてダイアグラム ジャンクションに機能を割り当てることができます。

パラメーター

ダイアログ

ラベル	説明	データ タイプ
入力ネットワーク	変更するダイアグラム テンプレートを含むユーティリティ ネットワークまたはトレース ネットワーク。	Utility Network; Trace Network
入力ダイアグラム テンプレート	変更するダイアグラム テンプレートの名前。	String
アクティブ	指定したテンプレートに基づくダイアグラムの生成および更新時に、ルールを有効にするかどうかを指定します。 オン - 追加されたルールが、入力テンプレートに基づくダイアグラムの生成および更新時に有効になります。 これがデフォルトです。 オフ - 追加されたルールが、入力テンプレートに基づくダイアグラムの生成または更新時に有効になりません。	Boolean
ネットワーク ソース	特定の機能が割り当てられる、ダイアグラム フィーチャに関連付けられた、フィーチャまたはオブジェクトを参照する、ネットワーク ソース クラスまたはオブジェクト テーブル。	Table; Feature Class
式	指定したネットワーク ソース フィーチャクラスまたはオブジェクト テーブルから、対象のフィーチャまたはオブジェクトを除外するために使用される SQL 式。 SQL 構文の詳細については「ArcGIS で使用されるクエリ式の SQL リファレンス」をご参照ください。	SQL Expression
機能	ルール演算の最後に検索されたダイアグラム フィーチャに割り当てる機能を指定します。 指定された機能は、ルール シーケンス内で、後から実行される他のルールによって使用されます。 関連する格納器の単純化を防ぐ—検索されたすべてのフィーチャにフラグが付けられ、ルール シーケンス内で、後から実行される格納器の単純化ルールにより、関連する格納器が単純化されないようにします。 これがデフォルトです。 関連する格納器の単純化を許可—検索されたすべてのフィーチャにフラグが付けられ、ルール シーケンス内で、後から実行される格納器の単純化ルールにより、関連する格納器が単純化されるようにします。 ジャンクションの削減を防ぐ—検索されたすべてのジャンクションにフラグが付けられ、ルール シーケンス内で、後から実行されるジャンクションの削減ルールにより、削減されないようにします。 ジャンクションの削減を許可—検索されたすべてのジャンクションにフラグが付けられ、ルール シーケンス内で、後から実行されるジャンクションの削減ルールにより、削減されるようにします。 未接続の空の格納器ジャンクションをポリゴンとして保存—格納器が空の場合、検索された未接続の格納器ジャンクションはすべて、ポイント ジオメトリではなくポリゴン ジオメトリとともに保存されます。 無視して上流トレースを開始—検索されたすべてのフィーチャは、上流トレースのルール シーケンス内で、後から構成されるすべてのトレース ルールにより、始点として無視されます。 無視して下流トレースを開始—検索されたすべてのフィーチャは、下流トレースのルール シーケンス内で、後から構成されるすべてのトレース ルールにより、始点として無視されます。	String
説明 (オプション)	ルールの説明。	String
未接続 (オプション)	選択した機能を、未接続のネットワーク ダイアグラム ジャンクションに適用するかどうかを指定します。 オン - 選択した機能を、未接続のネットワーク ダイアグラム ジャンクションに適用します。 これがデフォルトです。 オフ - 選択した機能を、未接続のネットワーク ダイアグラム ジャンクションに適用しません。	Boolean
単一のジャンクションに接続 (オプション)	選択した機能を、単一ジャンクションに接続されているネットワーク ダイアグラム ジャンクションに適用するかどうかを指定します。 オン - 選択した機能を、単一ジャンクションに接続されているネットワーク ダイアグラム ジャンクションに適用します。 これがデフォルトです。 オフ - 選択した機能を、単一ジャンクションに接続されているネットワーク ダイアグラム ジャンクションに適用しません。	Boolean
2 つの異なるジャンクションに接続 (オプション)	選択した機能を、2 つの異なるジャンクションに接続されているネットワーク ダイアグラム ジャンクションに適用するかどうかを指定します。 オン - 選択した機能を、2 つの異なるジャンクションに接続されているネットワーク ダイアグラム ジャンクションに適用します。 これがデフォルトです。 オフ - 選択した機能を、2 つの異なるジャンクションに接続されているネットワーク ダイアグラム ジャンクションに適用しません。	Boolean
3 つ以上の異なるジャンクションに接続 (オプション)	選択した機能を、3 つ以上の異なるジャンクションに接続されているネットワーク ダイアグラム ジャンクションに適用するかどうかを指定します。 オン - 選択した機能を、3 つ以上の異なるジャンクションに接続されているネットワーク ダイアグラム ジャンクションに適用します。 これがデフォルトです。 オフ - 選択した機能を、3 つ以上の異なるジャンクションに接続されているネットワーク ダイアグラム ジャンクションに適用しません。	Boolean

派生した出力

ラベル	説明	データ タイプ
出力ネットワーク	更新されたユーティリティ ネットワークまたはトレース ネットワーク。	Utility Network; Trace Network
出力ダイアグラム テンプレート	ダイアグラム テンプレートの名前。	String

Python

arcpy.nd.AddDiagramFeatureCapabilityByAttributeRule(in_utility_network, template_name, is_active, network_source, where_clause, capability, {description}, {valence_0}, {valence_1}, {valence_2}, {valence_3_plus})

名前	説明	データ タイプ
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
capability	ルール演算の最後に検索されたダイアグラム フィーチャに割り当てる機能を指定します。 指定された機能は、ルール シーケンス内で、後から実行される他のルールによって使用されます。 PREVENT_TO_COLLAPSE_CONTAINER—検索されたすべてのフィーチャにフラグが付けられ、ルール シーケンス内で、後から実行される格納器の単純化ルールにより、関連する格納器が単純化されないようにします。 これがデフォルトです。 ALLOW_TO_COLLAPSE_CONTAINER—検索されたすべてのフィーチャにフラグが付けられ、ルール シーケンス内で、後から実行される格納器の単純化ルールにより、関連する格納器が単純化されるようにします。 PREVENT_TO_REDUCE_JUNCTION—検索されたすべてのジャンクションにフラグが付けられ、ルール シーケンス内で、後から実行されるジャンクションの削減ルールにより、削減されないようにします。 ALLOW_TO_REDUCE_JUNCTION—検索されたすべてのジャンクションにフラグが付けられ、ルール シーケンス内で、後から実行されるジャンクションの削減ルールにより、削減されるようにします。 SAVE_EMPTY_CONTAINER_AS_POLYGON_IF_UNCONNECTED—格納器が空の場合、検索された未接続の格納器ジャンクションはすべて、ポイント ジオメトリではなくポリゴン ジオメトリとともに保存されます。 IGNORED_STARTING_POINT_FOR_UPSTREAM_TRACE—検索されたすべてのフィーチャは、上流トレースのルール シーケンス内で、後から構成されるすべてのトレース ルールにより、始点として無視されます。 IGNORED_STARTING_POINT_FOR_DOWNSTREAM_TRACE—検索されたすべてのフィーチャは、下流トレースのルール シーケンス内で、後から構成されるすべてのトレース ルールにより、始点として無視されます。	String
description (オプション)	ルールの説明。	String
valence_0 (オプション)	選択した機能を、未接続のネットワーク ダイアグラム ジャンクションに適用するかどうかを指定します。 APPLY—選択した機能を、未接続のネットワーク ダイアグラム ジャンクションに適用します。 これがデフォルトです。 DO_NOT_APPLY—選択した機能を、未接続のネットワーク ダイアグラム ジャンクションに適用しません。	Boolean
valence_1 (オプション)	選択した機能を、単一ジャンクションに接続されているネットワーク ダイアグラム ジャンクションに適用するかどうかを指定します。 APPLY—選択した機能を、単一ジャンクションに接続されているネットワーク ダイアグラム ジャンクションに適用します。 これがデフォルトです。 DO_NOT_APPLY—選択した機能を、単一ジャンクションに接続されているネットワーク ダイアグラム ジャンクションに適用しません。	Boolean
valence_2 (オプション)	選択した機能を、2 つの異なるジャンクションに接続されているネットワーク ダイアグラム ジャンクションに適用するかどうかを指定します。 APPLY—選択した機能を、2 つの異なるジャンクションに接続されているネットワーク ダイアグラム ジャンクションに適用します。 これがデフォルトです。 DO_NOT_APPLY—選択した機能を、2 つの異なるジャンクションに接続されているネットワーク ダイアグラム ジャンクションに適用しません。	Boolean
valence_3_plus (オプション)	選択した機能を、3 つ以上の異なるジャンクションに接続されているネットワーク ダイアグラム ジャンクションに適用するかどうかを指定します。 APPLY—選択した機能を、3 つ以上の異なるジャンクションに接続されているネットワーク ダイアグラム ジャンクションに適用します。 これがデフォルトです。 DO_NOT_APPLY—選択した機能を、3 つ以上の異なるジャンクションに接続されているネットワーク ダイアグラム ジャンクションに適用しません。	Boolean

派生した出力

名前	説明	データ タイプ
out_utility_network	更新されたユーティリティ ネットワークまたはトレース ネットワーク。	Utility Network; Trace Network
out_template_name	ダイアグラム テンプレートの名前。	String

コードのサンプル

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

MyTemplate1 テンプレートにダイアグラム フィーチャ機能ルールを追加し、すべてのスイッチにフラグを付けて、格納器が後から単純化されないようにします。

import arcpy
input_Network = "D:/MyProjectLocation/MyDatabaseConnection.sde/MyDatabase.MAP.Electric/MyDatabase.MAP.Electric"
input_DistributionDevice = "D:/MyProjectLocation/MyDatabaseConnection.sde/MyDatabase.MAP.Electric/MyDatabase.MAP.ElectricDistributionDevice"

input_DiagramTemplate = "MyTemplate1"

arcpy.nd.AddDiagramFeatureCapabilityByAttributeRule(
    input_Network, input_DiagramTemplate, 'ACTIVE', 
    input_DistributionDevice, 'ASSETGROUP=14', "PREVENT_TO_COLLAPSE_CONTAINER")

環境

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

ライセンス情報

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