| 名前 | 説明 | データ タイプ |
in_utility_network | トレースを実行するユーティリティ ネットワーク。 エンタープライズ ジオデータベースを操作する場合、入力ユーティリティ ネットワークは、フィーチャ サービスから取得したものである必要があります。データベース コネクションから取得したユーティリティ ネットワークは、サポートされていません。 | Utility Network; Utility Network Layer |
trace_type | 使用されるトレースのタイプを指定します。 - CONNECTED—1 つ以上の始点で始まり、接続フィーチャに沿って外側に広がる接続トレースが使用されます。 これがデフォルトです。
- SUBNETWORK—1 つ以上の始点で始まり、サブネットワーク範囲を包含するように、接続フィーチャに沿って外側に広がるサブネットワーク トレースが使用されます。
- SUBNETWORK_CONTROLLERS—サブネットワークに関連付けられたサブネットワーク コントローラー上で、ソースとシンクを検索するサブネットワーク コントローラー トレースが使用されます。
- UPSTREAM—ネットワーク内の場所から、上流のフィーチャを検索する上流トレースが使用されます。
- DOWNSTREAM—ネットワーク内の場所から、下流のフィーチャを検索する下流トレースが使用されます。
- LOOPS—接続性に基づいて、始点から外側に広がるループ トレースが使用されます。 ループは、フロー方向があいまいなネットワークのエリアです。
- SHORTEST_PATH—2 つの始点間の最短パスを特定する最短パス トレースが使用されます。
- ISOLATION—ネットワークのエリアを分離するフィーチャを検索する分離トレースが使用されます。
| String |
starting_points (オプション) | トレースの始点を表す 1 つ以上のレコードを含むテーブルまたはフィーチャクラス。 このフィーチャクラスまたはテーブルには、関連付けられているネットワーク フィーチャの情報を格納する FEATUREGLOBALID フィールドが含まれている必要があります。 特定の形式を表示するには、[トレース位置] ウィンドウの [始点] ツールを使用して、始点を作成し、デフォルトのジオデータベースに保存された UN_Temp_Starting_Points フィーチャクラスのスキーマを表示します。 | Feature Layer; Table View |
barriers (オプション) | トレースがそのポイントを通過しないようにするトレースのバリアを表す 1 つ以上のフィーチャを含むテーブルまたはフィーチャクラス。 このフィーチャクラスまたはテーブルには、関連付けられているネットワーク フィーチャの情報を格納する FEATUREGLOBALID フィールドが含まれている必要があります。 特定の形式を表示するには、[トレース位置] ウィンドウの [バリア] ツールを使用して、バリアを作成し、デフォルトのジオデータベースに保存された UN_Temp_Barriers フィーチャクラスのスキーマを表示します。 | Feature Layer; Table View |
domain_network (オプション) | トレースを実行するドメイン ネットワークの名前。 サブネットワーク、サブネットワーク コントローラー、上流、および下流トレース タイプを実行する場合、このパラメーターは必須です。 | String |
tier (オプション) | トレースを開始する層の名前。 サブネットワーク、サブネットワーク コントローラー、上流、および下流トレース タイプを実行する場合、このパラメーターは必須です。 | String |
target_tier (オプション) | 入力層が流れるターゲット層の名前。 上流または下流トレースでこのパラメーターを指定しない場合、開始するサブネットワークの境界に到達すると、トレースは停止します。 このパラメーターを使用すると、このトレースを階層の上方または下方に継続できます。 | String |
subnetwork_name (オプション) | トレースを実行するサブネットワークの名前。 このパラメーターは、サブネットワーク トレース タイプの実行時に使用されます。 サブネットワーク名を指定した場合、starting_points パラメーターは必要ありません。 | String |
shortest_path_network_attribute_name (オプション) | 最短パスを計算するために使用するネットワーク属性。 最短パス トレース タイプを実行すると、形状の長さなど、数値のネットワーク属性を使用して、最短パスが計算されます。 コストに基づくパスと、距離に基づくパスの両方が得られます。 最短パス トレースを実行する場合は、このパラメーターは必須です。 | String |
include_containers (オプション) | 格納器フィーチャをトレース結果に含めるかどうかを指定します。 - INCLUDE_CONTAINERS—格納器フィーチャをトレース結果に含めます。
- EXCLUDE_CONTAINERS—格納器フィーチャをトレース結果に含めません。 これがデフォルトです。
| Boolean |
include_content (オプション) | トレースの結果で、格納器フィーチャの格納物が返されるかどうかを指定します。 - INCLUDE_CONTENT—格納器フィーチャの格納物をトレース結果に含めます。
- EXCLUDE_CONTENT—格納器フィーチャの格納物をトレース結果に含めません。 これがデフォルトです。
| Boolean |
include_structures (オプション) | 構造物フィーチャおよびオブジェクトをトレース結果に含めるかどうかを指定します。 - INCLUDE_STRUCTURES—構造物フィーチャおよびオブジェクトをトレース結果に含めます。
- EXCLUDE_STRUCTURES—構造物フィーチャおよびオブジェクトをトレース結果に含めません。 これがデフォルトです。
| Boolean |
include_barriers (オプション) | 通過可能性バリア フィーチャをトレース結果に含めるかどうかを指定します。 通過可能性バリアは、サブネットワーク定義で事前に設定されている場合でも任意指定です。 このパラメーターは、ターミナルを含むデバイス フィーチャには適用されません。 - INCLUDE_BARRIERS—通過可能性バリア フィーチャをトレース結果に含めます。 これがデフォルトです。
- EXCLUDE_BARRIERS—通過可能性バリア フィーチャをトレース結果に含めません。
| Boolean |
validate_consistency (オプション) | 通過したフィーチャのいずれかでダーティ エリアが発生した場合、エラーを返すかどうかを指定します。 これは、トレースがネットワーク内を一貫したステータスでフィーチャを通過することを保証する唯一の方法です。 ダーティ エリアを削除するには、ネットワーク トポロジを検証します。 - VALIDATE_CONSISTENCY—通過したフィーチャのいずれかでダーティ エリアが発生した場合、トレースがエラーを返します。 これがデフォルトです。
- DO_NOT_VALIDATE_CONSISTENCY—通過したフィーチャのいずれかでダーティ エリアが発生したかどうかに関係なく、トレースが結果を返します。
| Boolean |
condition_barriers [[Name, Operator, Type, Value, Combine Using],...] (オプション) | ネットワーク属性との比較またはカテゴリ文字列のチェックに基づいて、フィーチャに対して通過可能性バリア条件を設定します。 条件バリアでは、ネットワーク属性またはネットワーク カテゴリ、演算子とタイプ、および属性値が使用されます。 たとえば、フィーチャが Open の特定の値と等しい Device Status 属性を持っている場合に、トレースを停止します。 フィーチャがこの条件を満たしている場合、トレースが停止します。 複数の属性を使用している場合、[結合方法] パラメーターを使用して And 条件および Or 条件を定義することができます。
条件バリアの構成は、次のとおりです。 - Name - システム内で定義された任意のネットワーク属性によってフィルターします。
- Operator - 複数の演算子から選択します。
- Type - name パラメーターで指定された値から、特定の値またはネットワーク属性を選択します。
- Value - 演算子の値に基づいて処理を停止させる、入力属性タイプの特定の値を指定します。
- Combine Using - 複数の属性を追加する場合に、この値を設定します。And 条件または Or 条件を使用して、属性を結合することができます。
条件バリアの Operator の値オプションは、次のとおりです。 - IS_EQUAL_TO—属性と値が等しい。
- DOES_NOT_EQUAL—属性と値が等しくありません。
- IS_GREATER_THAN—属性が値より大きい。
- IS_GREATER_THAN_OR_EQUAL_TO—属性が値以上です。
- IS_LESS_THAN—属性が値より小さい。
- IS_LESS_THAN_OR_EQUAL_TO—属性が値以下です。
- INCLUDES_THE_VALUES—値のすべてのビットが、属性内に存在するビット単位の論理積演算 (bitwise AND == value)。
- DOES_NOT_INCLUDE_THE_VALUES—値のすべてのビットが、属性内に存在しないビット単位の論理積演算 (bitwise AND != value)。
- INCLUDES_ANY—値の少なくとも 1 つのビットが、属性内に存在するビット単位の論理積演算 (bitwise AND == True)。
- DOES_NOT_INCLUDE_ANY—値のビットが、属性内に存在しないビット単位の論理積演算 (bitwise AND == False)。
ビット単位の演算子の詳細 条件バリアの Type の値オプションは、次のとおりです。 - SPECIFIC_VALUE—特定の値によってフィルターします。
- NETWORK_ATTRIBUTE—ネットワーク属性によってフィルターします。
条件バリアの Combine Using の値オプションは、次のとおりです。 - AND—条件バリアを結合します。
- OR—いずれかの条件バリアが、満たされている場合に使用します。
複数の式の使用方法の詳細 | Value Table |
function_barriers [[Function, Attribute, Operator, Value, Use Local Values],...] (オプション) | 関数に基づいて、フィーチャに対する通過可能性バリアを設定します。 関数バリアを使用して、始点からトレースが移動できる距離の制限としてそのような設定を行うか、トレースを停止するための最大値を設定することができます。 たとえば、通過した各ラインの長さが、それまでに移動した合計距離に追加されます。 移動した全長が指定された値に達した場合、トレースが停止します。 関数バリアの構成は、次のとおりです。 - Function - 複数の計算関数から選択します。
- Attribute - システム内で定義された任意のネットワーク属性によってフィルターします。
- Operator - 複数の演算子から選択します。
- Value - 検出された時点で、処理を停止させる入力属性タイプの特定の値を指定します。
- Use Local Values - グローバル値ではなく、各方向の値を算出します。たとえば、Shape length の合計値が 4 以上になるとトレースを停止するよう、関数バリアを構成します。 グローバル値を使用すると、2 の値を持つ任意の 2 つのエッジを通過した後に、Shape length の合計が 4 に達するため、トレースが停止します。 ローカル値を使用している場合、通過が分岐点に達すると、分岐に沿った各パスの計算値が、個別に維持されます。 この場合、始点が分岐点に配置されると、各パスに沿ってローカル値が個別に計算され、各パスに沿った合計が 4 に達するまで、トレースが続行します。
関数バリアの Function 値のオプションは、次のとおりです。 - AVERAGE—入力値の平均が計算されます。
- COUNT—フィーチャの数が特定されます。
- MAX—入力値の最大が特定されます。
- MIN—入力値の最小が特定されます。
- ADD—入力値の合計が計算されます。
- SUBTRACT—入力値の差が計算されます。 サブネットワーク コントローラーおよびループ トレース タイプは、減算関数をサポートしていません。
関数バリアの Operator 値のオプションは、次のとおりです。 - IS_EQUAL_TO—関数結果と値が等しい。
- DOES_NOT_EQUAL—関数結果と値が等しくありません。
- IS_GREATER_THAN—関数結果が値より大きい。
- IS_GREATER_THAN_OR_EQUAL_TO—関数結果が値以上です。
- IS_LESS_THAN—関数結果が値より小さい。
- IS_LESS_THAN_OR_EQUAL_TO—関数結果が値以下です。
- INCLUDES_THE_VALUES—値のすべてのビットが、属性内に存在するビット単位の論理積演算 (bitwise AND == value)。
- DOES_NOT_INCLUDE_THE_VALUES—値の一部のビットが、属性内に存在しないビット単位の論理積演算 (bitwise AND != value)。
- INCLUDES_ANY—値の少なくとも 1 つのビットが、属性内に存在するビット単位の論理積演算 (bitwise AND == True)。
- DOES_NOT_INCLUDE_ANY—値のビットが、属性内に存在しないビット単位の論理積演算 (bitwise AND == False)。
ビット単位の演算子の詳細 関数バリアの Use Local Values のオプションは、次のとおりです。 - TRUE—ローカル値が使用されます。 これがデフォルトです。
- FALSE—グローバル値が使用されます。
| Value Table |
traversability_scope (オプション) | 通過可能性をジャンクションに適用するか、エッジに適用するか、その両方に適用するかを指定します。 たとえば、Device Status が Open であり、通過可能性の範囲がエッジのみに設定されている場合に、トレースを停止するように条件バリアを定義すると、トレースでオープン デバイスが検出された場合でも、Device Status は、ジャンクションにしか適用されないため、トレースは停止しません。 つまり、このパラメーターは、トレースで、ジャンクション、エッジ、またはその両方を無視するかどうかを示します。 - BOTH_JUNCTIONS_AND_EDGES—通過可能性は、ジャンクションとエッジの両方に適用されます。 これがデフォルトです。
- JUNCTIONS_ONLY—通過可能性は、ジャンクションのみに適用されます。
- EDGES_ONLY—通過可能性は、エッジのみに適用されます。
| String |
filter_barriers [[Name, Operator, Type, Value, Combine Using],...] (オプション) | いつ特定のカテゴリまたはネットワーク属性のトレースを停止するかを設定します。 たとえば、特定の値と等しいライフ サイクル ステータス属性があるフィーチャで、トレースを停止します。 このパラメーターを使用して、システムに定義されているネットワーク属性の値に基づいて、ターミネーターを設定します。 複数の属性を使用している場合、Combine Using オプションを使用して、And または Or 条件を定義できます。
フィルター バリアの構成は、次のとおりです。 - Name -システム内で定義されたカテゴリまたは任意のネットワーク属性によってフィルターします。
- Operator - 複数の演算子から選択します。
- Type - name パラメーターで指定された値から、特定の値またはネットワーク属性を選択します。
- Value - 演算子の値に基づいて、処理を停止させる入力属性タイプの特定の値を指定します。
- Combine Using - 複数の属性を追加する場合に、この値を設定します。And 条件または Or 条件を使用して、属性を結合することができます。
フィルター バリアの Operator の値オプションは、次のとおりです。 - IS_EQUAL_TO—属性と値が等しい。
- DOES_NOT_EQUAL—属性と値が等しくありません。
- IS_GREATER_THAN—属性が値より大きい。
- IS_GREATER_THAN_OR_EQUAL_TO—属性が値以上です。
- IS_LESS_THAN—属性が値より小さい。
- IS_LESS_THAN_OR_EQUAL_TO—属性が値以下です。
- INCLUDES_THE_VALUES—値のすべてのビットが、属性内に存在するビット単位の論理積演算 (bitwise AND == value)。
- DOES_NOT_INCLUDE_THE_VALUES—値の一部のビットが、属性内に存在しないビット単位の論理積演算 (bitwise AND != value)。
- INCLUDES_ANY—値の少なくとも 1 つのビットが、属性内に存在するビット単位の論理積演算 (bitwise AND == True)。
- DOES_NOT_INLCUDE_ANY—値のビットが、属性内に存在しないビット単位の論理積演算 (bitwise AND == False)。
ビット単位の演算子の詳細 フィルター バリアの Type の値オプションは、次のとおりです。 - SPECIFIC_VALUE—特定の値によってフィルターします。
- NETWORK_ATTRIBUTE—ネットワーク属性によってフィルターします。
フィルター バリアの Combine Using の値オプションは、次のとおりです。 - AND—条件バリアを結合します。
- OR—いずれかの条件バリアが、満たされている場合に使用します。
複数の式の使用方法の詳細 | Value Table |
filter_function_barriers [[Function, Attribute, Operator, Value, Use Local Values],...] (オプション) | 特定のカテゴリのトレース結果をフィルターします。 関数バリアのフィルターの構成は、次のとおりです。 - Function - 複数の計算関数から選択します。
- Attribute - システム内で定義された任意のネットワーク属性によってフィルターします。
- Operator - 複数の演算子から選択します。
- Value - 検出された時点で、処理を停止させる入力属性タイプの特定の値を指定します。
- Use Local Values - 全体的なグローバル値とは対照的に、各方向で値を計算します。 たとえば、関数バリアが、値が 4 以上の場合にトレースが停止する形状の長さの合計を計算するとします。 グローバル値の場合は、値が 2 の 2 つのエッジを通過すると、形状の長さの合計値 4 に到達するため、トレースが停止します。 ローカル値を使用している場合は、各パスに沿ってローカル値が変化するため、トレースが続行します。
関数バリアのフィルターの Function の値オプションは、次のとおりです。 - AVERAGE—入力値の平均が計算されます。
- COUNT—フィーチャの数が特定されます。
- MAX—入力値の最大が特定されます。
- MIN—入力値の最小が特定されます。
- ADD—値の合計が計算されます。
- SUBTRACT—値の差が計算されます。 サブネットワーク コントローラーおよびループ トレース タイプは、減算関数をサポートしていません。
関数バリアのフィルターの Operator の値オプションは、次のとおりです。 - IS_EQUAL_TO—属性と値が等しい。
- DOES_NOT_EQUAL—属性と値が等しくありません。
- IS_GREATER_THAN—属性が値より大きい。
- IS_GREATER_THAN_OR_EQUAL_TO—属性が値以上です。
- IS_LESS_THAN—属性が値より小さい。
- IS_LESS_THAN_OR_EQUAL_TO—属性が値以下です。
- INCLUDES_THE_VALUES—値のすべてのビットが、属性内に存在するビット単位の論理積演算 (bitwise AND == value)。
- DOES_NOT_INCLUDE_THE_VALUES—値の一部のビットが、属性内に存在しないビット単位の論理積演算 (bitwise AND != value)。
- INCLUDES_ANY—値の少なくとも 1 つのビットが、属性内に存在するビット単位の論理積演算 (bitwise AND == True)。
- DOES_NOT_INCLUDE_ANY—値のビットが、属性内に存在しないビット単位の論理積演算 (bitwise AND == False)。
ビット単位の演算子の詳細 関数バリアのフィルターの Use Local Values オプションは、次のとおりです。 - TRUE—ローカル値が使用されます。 これがデフォルトです。
- FALSE—グローバル値が使用されます。
| Value Table |
filter_scope (オプション) | 特定のカテゴリのフィルターをジャンクション、エッジ、その両方のいずれに適用するかを指定します。 たとえば、Device Status が Open であり、通過可能性の範囲がエッジのみに設定されている場合に、トレースを停止するようにフィルター バリアを定義すると、トレースでオープン デバイスが検出された場合でも、Device Status はジャンクションにしか適用されないため、トレースは停止しません。 つまり、このパラメーターは、トレースで、ジャンクション、エッジ、またはその両方を無視するかどうかを示します。 - BOTH_JUNCTIONS_AND_EDGES—フィルターをジャンクションとエッジの両方に適用します。 これがデフォルトです。
- JUNCTIONS_ONLY—フィルターをジャンクションのみに適用します。
- EDGES_ONLY—フィルターをエッジのみに適用します。
| String |
filter_bitset_network_attribute_name (オプション) | bitset によるフィルターに使用するネットワーク属性の名前。 このパラメーターは、上流、下流、およびループ トレース タイプのみに適用できます。 このパラメーターを使用すると、トレースが実世界のシナリオをより細密に反映するように、トレース中に特別なロジックを追加できます。 たとえば、ループ トレースの場合、Phases current ネットワーク属性は、ループが真の電気ループである (ループ全体で同じフェーズに電源が入る) かどうかを判断し、トレース結果の真の電源ループのみを返すことができます。 上流トレースの場合、たとえば、配電網のトレース時に Phases current ネットワーク属性を指定することにより、トレース結果に、すべてのパスではなく、ネットワーク属性で指定された有効なパスのみを含めます。 | String |
filter_nearest (オプション) | K 最近隣内挿アルゴリズムを使用して、所定の距離内の特定のタイプのフィーチャの数を返すかどうかを指定します。 個数、コスト、およびカテゴリやアセット タイプのコレクションを指定できます。 - FILTER_BY_NEAREST—K 最近隣内挿アルゴリズムを使用して、nearest_count、nearest_cost_network_attribute、nearest_categories、または nearest_assets パラメーターで指定された、さまざまなフィーチャを返します。
- DO_NOT_FILTER—K 最近隣内挿アルゴリズムを使用して、結果をフィルターしません。 これがデフォルトです。
| Boolean |
nearest_count (オプション) | filter_nearest を FILTER_BY_NEAREST に設定したときに返されるフィーチャの数。 | Long |
nearest_cost_network_attribute (オプション) | filter_nearest を FILTER_BY_NEAREST に設定したときに、近接性、コスト、または距離の計算に使用される数値のネットワーク属性 (たとえば、形状の長さ)。 | String |
nearest_categories [nearest_categories,...] (オプション) | filter_nearest を FILTER_BY_NEAREST に設定したときに返されるカテゴリ (たとえば、Protective)。 | String |
nearest_assets [nearest_assets,...] (オプション) | filter_nearest を FILTER_BY_NEAREST に設定したときに返されるアセット グループおよびアセット タイプ (たとえば、ElectricDistributionDevice/Transformer/Step Down)。 | String |
functions [[Function, Attribute, Filter Name, Filter Operator, Filter Type, Filter Value],...] (オプション) | トレース結果に適用される計算関数。
関数の構成は、次のとおりです。 - Function - 複数の計算関数から選択します。
- Attribute - システム内で定義された任意のネットワーク属性によってフィルターします。
- Filter Name - 属性名によって、関数の結果をフィルターします。
- Filter Operator - 複数の演算子から選択します。
- Filter Type - 複数のフィルター タイプから選択します。
- Filter Value - 入力フィルター属性の値を指定します。
関数の Function の値オプションは、次のとおりです。 - AVERAGE—入力値の平均が計算されます。
- COUNT—フィーチャの数が特定されます。
- MAX—入力値の最大が特定されます。
- MIN—入力値の最小が特定されます。
- ADD—入力値の合計が計算されます。
- SUBTRACT—入力値の差が計算されます。サブネットワーク コントローラーおよびループ トレース タイプは、減算関数をサポートしていません。
たとえば、始点フィーチャの値が 20 とします。 次のフィーチャは、30 の値を持っています。 MINIMUM 関数を使用している場合、結果は 20、MAXIMUM は 30、ADD は 50、AVERAGE は 25、COUNT は 2、SUBTRACT は -10 になります。 Filter Operator 値のオプションは、次のとおりです。 - IS_EQUAL_TO—属性と値が等しい。
- DOES_NOT_EQUAL—属性と値が等しくありません。
- IS_GREATER_THAN—属性が値より大きい。
- IS_GREATER_THAN_OR_EQUAL_TO—属性が値以上です。
- IS_LESS_THAN—属性が値より小さい。
- IS_LESS_THAN_OR_EQUAL_TO—属性が値以下です。
- INCLUDES_THE_VALUES—値のすべてのビットが、属性内に存在するビット単位の論理積演算 (bitwise AND == value)。
- DOES_NOT_INCLUDE_THE_VALUES—値の一部のビットが、属性内に存在しないビット単位の論理積演算 (bitwise AND != value)。
- INCLUDES_ANY—値の少なくとも 1 つのビットが、属性内に存在するビット単位の論理積演算 (bitwise AND == True)。
- DOES_NOT_INCLUDE_ANY—値のビットが、属性内に存在しないビット単位の論理積演算 (bitwise AND == False)。
ビット単位の演算子の詳細 関数の Filter Type の値オプションは、次のとおりです。 - SPECIFIC_VALUE—特定の値によってフィルターします。
- NETWORK_ATTRIBUTE—ネットワーク属性によってフィルターします。
| Value Table |
propagators [[Attribute, Substitution Attribute, Function, Operator, Value],...] (オプション) | 伝播させるネットワーク属性、およびトレース中に伝播がどのように発生するかを指定します。 伝播されるクラス属性は、サブネットワーク内の他のフィーチャに広められる、サブネットワーク コントローラーの重要な値を示します。 たとえば、配電モデルでは、位相値を伝播することができます。 プロパゲーターの構成は次のとおりです。 - Attribute - システム内で定義された任意のネットワーク属性によってフィルターします。
- Substitution Attribute - bitset ネットワーク属性値の代わりに、代替値を使用します。 代替は、伝達されるネットワーク属性のビット数に基づいてエンコードされます。 代替は、フェーズ内の各ビットから別のマップへのマッピングです。 たとえば、フェーズ AC では、1 つの代替は、ビット A から B、ビット C から NULL へのマッピングです。 この例では、1010 (フェーズ AC) の代替は 0000-0010-0000-0000 (512) です。 代替がマッピングをキャプチャし、マッピングは、フェーズ A から B、フェーズ C から NULL へ行われたのであり、その逆 (すなわち、フェーズ A から NULL、フェーズ C から B) ではないことがわかります。
- Function - 複数の計算関数から選択します。
- Operator - 複数の演算子から選択します。
- Value - 演算子の値に基づいて処理を停止させる、入力属性タイプの特定の値を指定します。
プロパゲーターの Function の値オプションは、次のとおりです。 - PROPAGATED_BITWISE_AND—あるフィーチャの値と次のフィーチャの値が比較されます。
- PROPAGATED_MIN—最小値が特定されます。
- PROPAGATED_MAX—最大値が特定されます。
プロパゲーターの Operator の値オプションは、次のとおりです。 - IS_EQUAL_TO—属性と値が等しい。
- DOES_NOT_EQUAL—属性と値が等しくありません。
- IS_GREATER_THAN—属性が値より大きい。
- IS_GREATER_THAN_OR_EQUAL_TO—属性が値以上です。
- IS_LESS_THAN—属性が値より小さい。
- IS_LESS_THAN_OR_EQUAL_TO—属性が値以下です。
- INCLUDES_THE_VALUES—値のすべてのビットが、属性内に存在するビット単位の論理積演算 (bitwise AND == value)。
- DOES_NOT_INCLUDE_THE_VALUES—値の一部のビットが、属性内に存在しないビット単位の論理積演算 (bitwise AND != value)。
- INCLUDES_ANY—値の少なくとも 1 つのビットが、属性内に存在するビット単位の論理積演算 (bitwise AND == True)。
- DOES_NOT_INCLUDE_ANY—値のビットが、属性内に存在しないビット単位の論理積演算 (bitwise AND == False)。
ビット単位の演算子の詳細 このパラメーターは、Python でのみ使用できます。 | Value Table |
output_assettypes [output_assettypes,...] (オプション) | 結果に含める出力アセット タイプをフィルターします (たとえば、頭上の変圧器のみを返すなど)。 | String |
output_conditions [[Name, Operator, Type, Value, Combine Using],...] (オプション) | ネットワーク属性またはカテゴリに基づいて、返されるフィーチャのタイプです。 たとえば、Tap フィーチャ以外をすべて除外するよう構成されたトレースでは、Tap カテゴリが割り当てられていないトレース済みフィーチャは、結果に含まれません。 Tap 属性が割り当てられているトレース済みフィーチャは、結果選択セットに返されます。 複数の属性を使用している場合、Combine Using オプションを使用して、And または Or 条件を定義できます。
出力条件の構成は、次のとおりです。 - Name - システム内で定義された任意のネットワーク属性によってフィルターします。
- Operator - 複数の演算子から選択します。
- Type - name パラメーターで指定された値から、特定の値またはネットワーク属性を選択します。
- Value - 演算子の値に基づいて、処理を停止させる入力属性タイプの特定の値を指定します。
- Combine Using - 複数の属性を追加する場合に、この値を設定します。And 条件または Or 条件を使用して、属性を結合することができます。
出力条件の Operator の値オプションは、次のとおりです。 - IS_EQUAL_TO—属性と値が等しい。
- DOES_NOT_EQUAL—属性と値が等しくありません。
- IS_GREATER_THAN—属性が値より大きい。
- IS_GREATER_THAN_OR_EQUAL_TO—属性が値以上です。
- IS_LESS_THAN—属性が値より小さい。
- IS_LESS_THAN_OR_EQUAL_TO—属性が値以下です。
- INCLUDES_THE_VALUES—値のすべてのビットが、属性内に存在するビット単位の論理積演算 (bitwise AND == value)。
- DOES_NOT_INCLUDE_THE_VALUES—値の一部のビットが、属性内に存在しないビット単位の論理積演算 (bitwise AND != value)。
- INCLUDES_ANY—値の少なくとも 1 つのビットが、属性内に存在するビット単位の論理積演算 (bitwise AND == True)。
- DOES_NOT_INCLUDE_ANY—値のビットが、属性内に存在しないビット単位の論理積演算 (bitwise AND == False)。
ビット単位の演算子の詳細 出力条件の Type の値オプションは、次のとおりです。 - SPECIFIC_VALUE—特定の値によってフィルターします。
- NETWORK_ATTRIBUTE—ネットワーク属性によってフィルターします。
出力条件の Combine Using の値オプションは、次のとおりです。 - AND—条件を結合します。
- OR—いずれかの条件を満たした場合に使用します。
複数の式の使用方法の詳細 | Value Table |
include_isolated_features (オプション) | 分離フィーチャをトレース結果に含めるかどうかを指定します。 このパラメーターは、分離トレースの実行時にのみ使用されます。 - INCLUDE_ISOLATED_FEATURES—分離フィーチャをトレース結果に含めます。
- EXCLUDE_ISOLATED_FEATURES—分離フィーチャをトレース結果に含めません。 これがデフォルトです。
エンタープライズ ジオデータベースの場合、このパラメーターは ArcGIS Enterprise 10.7 以降を必要とします。 | Boolean |
ignore_barriers_at_starting_points (オプション) | 始点では、トレース構成内のダイナミック バリアを無視するかどうかを指定します。 これは、上流の保護デバイスのトレースを実行し、検出された保護デバイス (バリア) を始点として使用して、その後の上流の保護デバイスを検索する場合に、役立つことがあります。 - IGNORE_BARRIERS_AT_STARTING_POINTS—始点にあるバリアは、トレース内で無視されます。
- DO_NOT_IGNORE_BARRIERS_AT_STARTING_POINTS—始点にあるバリアは、トレース内で無視されません。 これがデフォルトです。
| Boolean |
include_up_to_first_spatial_container (オプション) | 返される格納器を、トレース結果の各ネットワーク エレメントの最初の空間格納器およびそれまで検出した格納器に制限するかどうかを指定します。 所定のネットワーク エレメントで、空間格納器が検出されず、非空間格納器のみがある場合、結果にはすべての非空間格納器が含まれます。 このパラメーターは、include_containers が INCLUDE_CONTAINERS に設定されている場合のみ有効です。 - INCLUDE_UP_TO_FIRST_SPATIAL_CONTAINER—トレース パスに沿って、ネストされた格納の関連付けが検出された場合、結果には最初の空間格納器まで (最初の空間格納器を含む) に遭遇した格納器のみが返されます。 空間格納器がない場合、所定のネットワーク エレメントの結果には、すべての非空間格納器が含まれます。
- DO_NOT_INCLUDE_UP_TO_FIRST_SPATIAL_CONTAINER—すべての格納器が結果に返されます。 これがデフォルトです。
| Boolean |
result_types [result_types,...] (オプション) | トレースから返される結果のタイプを指定します。 - SELECTION—トレース結果は、該当するネットワーク フィーチャの選択セットとして返されます。 これがデフォルトです。
- AGGREGATED_GEOMETRY—トレース結果は、ジオメトリ タイプによって集約され、アクティブなマップのレイヤー内に表示されるマルチパート フィーチャクラスに格納されます。
- CONNECTIVITY—トレース結果は、通過したネットワーク フィーチャの指定した出力 .json ファイルで、接続性グラフとして返されます。 このオプションによって、out_json_file パラメーターが有効になります。
- ELEMENTS—トレース結果は、通過したネットワーク フィーチャの指定した出力 .json ファイルで、フィーチャ ベースの情報として返されます。 このオプションによって、out_json_file パラメーターが有効になります。
- FEATURES—トレース結果は、通過したネットワーク フィーチャの指定した出力 .json ファイルで、フィーチャ ベースの情報として返されます。 このオプションにより、include_geometry、include_domain_description、result_network_attributes、result_fields、および out_json_file パラメーターを使用できるようになりました。
- CONTAINMENT_AND_ATTACHMENT_ASSOCIATIONS—トレース結果は、指定された出力 .json ファイル内の格納および構造物付属物の関連付けを介して関連付けられた、通過したネットワーク フィーチャの関連付け情報として返されます。 このオプションにより、include_domain_description および out_json_file パラメーターを使用できるようになりました。
| String |
selection_type | どのように選択を適用するか、選択が存在する場合にはどうなるかを指定します。 - NEW_SELECTION—結果として得られる選択によって、現在の選択が置換されます。 これがデフォルトです。
- ADD_TO_SELECTION—選択が存在する場合、結果として得られる選択が、現在の選択に追加されます。 選択が存在しない場合は、新しい選択オプションと同じです。
- REMOVE_FROM_SELECTION—結果として得られる選択が、現在の選択から削除されます。 選択が存在しない場合、このオプションは影響を与えません。
- SUBSET_SELECTION—結果として得られる選択が、現在の選択に統合されます。 両方に共通のレコードだけが、選択された状態となります。
- SWITCH_SELECTION—選択結果が切り替えられます。 選択された結果が現在の選択から削除され、選択されなかった結果が現在の選択に追加されます。 選択が存在しない場合は、新しい選択オプションと同じです。
| String |
clear_all_previous_trace_results (オプション) | 集約されたジオメトリを格納するために、選択されたフィーチャクラスの内容を切り捨てるか、追加するかを指定します。 このパラメーターは、集約されたジオメトリの結果タイプのみに適用されます。 - CLEAR_ALL_PREVIOUS_TRACE_RESULTS—集約されたトレース ジオメトリを格納するフィーチャクラスは切り捨てられます。 現在のトレース操作の出力ジオメトリのみが書き込まれます。 これがデフォルトです。
- DO_NOT_CLEAR_ALL_PREVIOUS_TRACE_RESULTS—現在のトレース操作の出力ジオメトリが、集約されたジオメトリを格納するフィーチャクラスに追加されます。
| Boolean |
trace_name (オプション) | トレース操作の名前。 この値は、出力フィーチャクラスの TRACENAME フィールドに格納され、トレース結果の識別に役立ちます。 このパラメーターは、集約されたジオメトリの結果タイプのみに適用されます。 | String |
aggregated_points (オプション) | 集約された結果ジオメトリを含む出力マルチポイント フィーチャクラス。 デフォルトでは、このパラメーターは、Trace_Results_Aggregated_Points というシステムで生成されるフィーチャクラスを使用して設定され、プロジェクトのデフォルト ジオデータベースに格納されます。
このフィーチャクラスが存在しない場合は、自動的に作成されます。 既存のフィーチャクラスも、集約されたジオメトリの格納に使用できます。 デフォルト以外のフィーチャクラスを使用する場合は、TRACENAME という文字列フィールドを含むマルチポイント フィーチャクラスである必要があります。 このパラメーターは、集約されたジオメトリの結果タイプのみに適用されます。
| Feature Class |
aggregated_lines (オプション) | 集約された結果ジオメトリを含む出力ポリライン フィーチャクラス。 デフォルトでは、このパラメーターは、Trace_Results_Aggregated_Lines というシステムで生成されるフィーチャクラスを使用して設定され、プロジェクトのデフォルト ジオデータベースに格納されます。
このフィーチャクラスが存在しない場合は、自動的に作成されます。 既存のフィーチャクラスも、集約されたジオメトリの格納に使用できます。 デフォルト以外のフィーチャクラスを使用する場合は、TRACENAME という文字列フィールドを含むポリライン フィーチャクラスである必要があります。 このパラメーターは、集約されたジオメトリの結果タイプのみに適用されます。
| Feature Class |
aggregated_polygons (オプション) | 集約された結果ジオメトリを含む出力ポリゴン フィーチャクラス。 デフォルトでは、このパラメーターは、Trace_Results_Aggregated_Polygons というシステムで生成されるフィーチャクラスを使用して設定され、プロジェクトのデフォルト ジオデータベースに格納されます。
このフィーチャクラスが存在しない場合は、自動的に作成されます。 既存のフィーチャクラスも、集約されたジオメトリの格納に使用できます。 デフォルト以外のフィーチャクラスを使用する場合は、TRACENAME という文字列フィールドを含むポリゴン フィーチャクラスである必要があります。 このパラメーターは、集約されたジオメトリの結果タイプのみに適用されます。
| Feature Class |
allow_indeterminate_flow (オプション) | フローが、不定のフィーチャをトレースするかどうかを指定します。 このパラメーターは、上流トレース、下流トレース、または分離トレースを実行する場合にのみ適用できます。 - TRACE_INDETERMINATE_FLOW—フローが、不定のフィーチャがトレースされます。 これがデフォルトです。
- IGNORE_INDETERMINATE_FLOW—フローが、不定のフィーチャが通過可能でなくなり、トレースされません。
| Boolean |
validate_locatability (オプション) | トレース中に、通過したオブジェクトの関連付け階層内の必要な格納、付属物、接続性が、いずれも関連付けられていない非空間のジャンクション オブジェクトまたはエッジ オブジェクトが検出された場合に、エラーを返すかどうかを指定します。 このパラメーターにより、トレースまたはサブネットワーク更新操作によって返される非空間オブジェクトを、フィーチャまたは他の配置可能オブジェクトとの関連付けを通じて、配置できるようになります。 - VALIDATE_LOCATABILITY—通過したオブジェクトの関連付け階層内の必要な格納、付属物、接続性が、いずれも関連付けられていない非空間のジャンクション オブジェクトまたはエッジ オブジェクトが検出された場合に、トレースからエラーが返されます。
- DO_NOT_VALIDATE_LOCATABILITY—トレースは、未配置のオブジェクトを確認せず、通過したオブジェクトの関連付け階層に未配置のオブジェクトが存在するかどうかに関係なく、結果を返します。 これがデフォルトです。
| Boolean |
use_trace_config (オプション) | このツールのパラメーターの設定に、既存の指定トレース構成を使用するかどうかを指定します。 - USE_TRACE_CONFIGURATION—既存の指定トレース構成を使用して、トレースのプロパティを定義します。 trace_config_name、starting_points、barriers を除く、すべてのパラメーターが無視されます。
- DO_NOT_USE_TRACE_CONFIGURATION—既存の指定トレース構成を使用して、トレースのプロパティを定義します。 これがデフォルトです。
| Boolean |
trace_config_name (オプション) | 既存の指定トレース構成の名前を使用して、トレースのプロパティを定義します。 このパラメーターは、use_trace_config パラメーターが、USE_TRACE_CONFIGURATION に設定されている場合のみ有効です。 | String |
out_json_file (オプション) | 接続性、エレメント、フィーチャ、または格納および付属物の関連付け結果タイプを使用して、トレース結果を返す際に生成される .json ファイルの名前と場所。 | File |
run_async (オプション) | エンタープライズ ジオデータベースで、ユーティリティ ネットワークを操作するときに、トレース操作を非同期で処理するかどうかを指定します。 - RUN_ASYNCHRONOUSLY—トレース操作を非同期で処理します。
- RUN_SYNCHRONOUSLY—トレース操作を同期的に処理します。 これがデフォルトです。
このパラメーターは、ArcGIS Enterprise 10.9.1 以降を必要とします。 | Boolean |
include_geometry (オプション) | ジオメトリを結果に含めるかどうかを指定します。 - INCLUDE_GEOMETRY—ジオメトリは、結果に含まれます。
- EXCLUDE_GEOMETRY—ジオメトリは、結果に含まれません。 これがデフォルトです。
エンタープライズ ジオデータベースの場合、このパラメーターは、ArcGIS Enterprise 11.1 以降を必要とします。 | Boolean |
include_domain_descriptions (オプション) | ドメインの説明を出力 .json ファイルに含めて、コントローラー、featureElements、接続性、関連付けのドメイン マッピングを伝えるかどうかを指定します。 - INCLUDE_DOMAIN_DESCRIPTIONS—ドメインの説明を結果に含めます。
- EXCLUDE_DOMAIN_DESCRIPTIONS—ドメインの説明を結果に含めません。 これがデフォルトです。
エンタープライズ ジオデータベースの場合、このパラメーターは、ArcGIS Enterprise 11.1 以降を必要とします。 | Boolean |
result_network_attributes [result_network_attributes,...] (オプション) | 結果に含めるネットワーク属性。 エンタープライズ ジオデータベースの場合、このパラメーターは、ArcGIS Enterprise 11.1 以降を必要とします。 | String |
result_fields [[Feature Class, Field Name],...] (オプション) | 結果として返されるフィーチャクラスのフィールド。 フィールドの値は、トレース内のフィーチャの結果で返されます。 エンタープライズ ジオデータベースの場合、このパラメーターは、ArcGIS Enterprise 11.1 以降を必要とします。 | Value Table |
use_digitized_direction (オプション) | 上流と下流のトレース操作で、ラインのデジタイズ方向、関連付けのエッジ オブジェクトの From および To Global ID、Flow direction 属性を使用して、フロー方向を決定するかどうかを指定します。 このパラメーターは、ユーティリティ ネットワーク バージョン 7 以降で使用可能であり、trace_type パラメーターが、UPSTREAM または DOWNSTREAM に設定されている場合にのみ、アクティブになります。 - USE_DIGITIZED_DIRECTION—トレース操作で、ラインのデジタイズ方向、関連付けのエッジ オブジェクトの From および To Global ID、フロー方向属性を使用して、フロー方向が決定されます。 このオプションを使用すると、domain_network、tier、target_tier パラメーターは無視されます。
- IGNORE_DIGITIZED_DIRECTION—トレース操作は、サブネットワーク コントローラーの位置に基づいて、フロー方向を決定します。 これがデフォルトです。
エンタープライズ ジオデータベースの場合、このパラメーターは ArcGIS Enterprise 11.3 以降を必要とします。 | Boolean |
synthesize_geometries (オプション) | トレース操作の一環として、通過した関連付けとエッジ オブジェクトのジオメトリの推測と作成 (合成) を実行するかどうかを指定します。 このパラメーターは、集約されたジオメトリの結果タイプのみに適用されます。 - DO_NOT_SYNTHESIZE_GEOMETRIES—通過した関連付けとエッジ オブジェクトのジオメトリが合成されません。 これがデフォルトです。
- SYNTHESIZE_GEOMETRIES—通過した関連付けとエッジ オブジェクトのジオメトリが推測され、Trace_Results_Aggregated_Lines 出力フィーチャクラス内に作成されます。
エンタープライズ ジオデータベースの場合、このパラメーターは ArcGIS Enterprise 11.3 以降を必要とします。 | Boolean |