トレース (ユーティリティー ネットワーク ツール)

サマリー

指定した始点から、接続性または通過可能性に基づいて、ユーティリティー ネットワークのネットワーク フィーチャを返します。

ユーティリティー ネットワーク トレース機能を使用すると、ネットワーク内の経路を解析できます。 通過可能性は、構成要件を満たす接続されたフィーチャ、または関連付けられたフィーチャによって確立された経路を指します。

デフォルトでは、トレース結果は選択として返され、ライン フィーチャ全体が含まれています。 始点、停止点、バリアなど、エッジに沿って配置されたトレース位置を基準とした部分的なフィーチャの結果を返すには、結果タイプ パラメーターを 集約されたジオメトリー に設定します。 エッジ オブジェクトに沿った中間部分に配置されているトレース位置を使用すると、エッジ オブジェクトが線形フィーチャの格納物である場合に、 ジオメトリーの合成 パラメーターを使用して、部分的なジオメトリーを返すことができます。

集約されたジオメトリー オプションにより、エッジに沿って配置された始点は、ミッドスパンでの接続性または端点を持つ前のジャンクションのエッジ エレメントを返します。 バリア フィーチャを含める パラメーターがオンで、エッジに沿ってバリアを配置した場合、トレースは、ミッドスパン接続性がある次のジャンクション、またはラインの終点が検出されると停止します。 バリア フィーチャを含める パラメーターがオフの場合、トレースは、ミッドスパン接続性がある前のジャンクション、または前のラインの終点が検出されると停止します。

その後、トレースの結果、生成される選択セットまたは出力フィーチャクラスを、別のマップやネットワークのダイアグラム ビューに反映するか、別のツールまたはトレースの入力として使用できます。

ユーティリティー ネットワークのトレースの詳細

使用法

• ネットワーク トポロジーが、有効化されている必要があります。 トレース ツールは、ネットワーク トポロジーに依存しているため、ダーティー エリアがトレースされた場合、トレースの結果が正確ではない可能性があります。 トレース対象エリアのネットワーク トポロジーは、ネットワークに加えられた最新の変更または更新を反映するよう、検証する必要があります。

• エンタープライズ ジオデータベースを操作する場合は、入力ユーティリティー ネットワークが、ユーティリティー ネットワーク サービスである必要があります。

• Python を通じて トレース ツールを使用してトラディショナル ドメイン ネットワーク上でサブネットワークベースのトレースを実行する場合、入力層のサブネットワーク トレース構成は自動的に適用されないため、手動で指定する必要があります。

• バリアのフィルター、関数バリアのフィルター、関数、および出力条件の日付フィールドに割り当てられたネットワーク属性を操作する場合は、日付値を yyyy-mm-dd hh:mm:ss として書式設定します (例: 2020-10-12 18:45:31)。

パラメーター

• Dialog
• Python

ラベル	説明	データ タイプ
入力ユーティリティー ネットワーク	トレースを実行するユーティリティー ネットワーク。 エンタープライズ ジオデータベースを操作する場合、入力ユーティリティー ネットワークは、フィーチャ サービスから取得したものである必要があります。データベース コネクションから取得したユーティリティー ネットワークは、サポートされていません。	Utility Network; Utility Network Layer
トレース タイプ	使用されるトレースのタイプを指定します。 接続—1 つ以上の始点で始まり、接続フィーチャに沿って外側に広がる接続トレースが使用されます。 これがデフォルトです。 サブネットワーク—1 つ以上の始点で始まり、サブネットワーク範囲を包含するように外側に広がるサブネットワーク トレースが使用されます。 このオプションは、トラディショナル ドメイン ネットワークでのみサポートされています。 サブネットワーク コントローラー—サブネットワークに関連付けられたサブネットワーク コントローラー上にソースとシンクを配置するサブネットワーク コントローラー トレースが使用されます。 このオプションは、トラディショナル ドメイン ネットワークでのみサポートされています。 上流—ネットワーク内の場所から上流のフィーチャを検索する上流解析トレースが使用されます。 このオプションは、 デジタイズ方向を使用 パラメーターがオンでない限り、トラディショナル ドメイン ネットワークでのみサポートされています。 下流—ネットワーク内の場所から下流のフィーチャを検索する下流解析トレースが使用されます。 このオプションは、 デジタイズ方向を使用 パラメーターがオンでない限り、トラディショナル ドメイン ネットワークでのみサポートされています。 ループ—接続性に基づいて、始点から外側に広がるループ トレースが使用されます。 ループは、フロー方向があいまいなネットワークのエリアです。 最短パス—2 つの始点間の最短パスを特定する最短パス トレースが使用されます。 レガシー: 最短パス トレース タイプは ArcGIS Pro 3.7 および ArcGIS Enterprise 12.1 で非推奨になりました。 最短パス トレースは次回のメジャー リリースまで機能してオプションとして使用できますが、最短パスを返すにはパス トレースを使用することをおすすめします。 パス トレースは、最短パスの結果を返す同じ機能を提供するとともに、ネットワーク内のパスを見つけるための追加機能も提供します。 分離—ネットワークのエリアを分離するフィーチャを検出する分離トレースが使用されます。 このオプションは、トラディショナル ドメイン ネットワークでのみサポートされています。 パス—1 つ以上の開始位置と停止位置の間の有効なパス、または指定した始点と停止点の間の最短パスを識別するパス トレースが使用されます。 回路—回路の開始位置または所定の始点から始まり、物理回路と仮想回路の両方の回路定義とパス情報を返す回路トレースが使用されます。 このオプションは、通信ドメイン ネットワークでのみサポートされています。	String
始点 (オプション)	トレース ウィンドウの 開始 タブを使用して作成されるフィーチャ レイヤー、またはトレースの始点を表す 1 つ以上のレコードを含むテーブルまたはフィーチャクラス。 このフィーチャクラスまたはテーブルには、関連付けられているネットワーク フィーチャの情報を格納する FEATUREGLOBALID フィールドが含まれている必要があります。 デフォルトでは、プロジェクトのデフォルト ジオデータベースの UN_Temp_Starting_Points フィーチャクラスが使用されます。	Feature Layer; Table View
バリア (オプション)	トレース ウィンドウの バリア タブを使用して作成されたフィーチャ レイヤー、またはトレースがそのポイントを通過しないようにするバリアを表すレコードが含まれているテーブルまたはフィーチャクラス。 このフィーチャクラスまたはテーブルには、関連付けられているネットワーク フィーチャの情報を格納する FEATUREGLOBALID フィールドが含まれている必要があります。 デフォルトでは、プロジェクトのデフォルト ジオデータベースの UN_Temp_Barriers フィーチャクラスが使用されます。	Feature Layer; Table View
ドメイン ネットワーク (オプション)	トレースを実行するドメイン ネットワークの名前。 サブネットワーク、サブネットワーク コントローラー、上流解析、下流解析、回路トレース タイプを実行する場合は、このパラメーターが必要です。	String
層 (オプション)	トレースを開始する、トラディショナル ドメイン ネットワーク内の層の名前。 サブネットワーク、サブネットワーク コントローラー、上流、および下流トレース タイプを実行する場合、このパラメーターは必須です。	String
ターゲット層 (オプション)	方向トレースで入力層が流れる、トラディショナル ドメイン ネットワーク内のターゲット層の名前。 上流または下流トレースでこのパラメーターを指定しない場合、開始するサブネットワークの境界に到達すると、トレースは停止します。 このパラメーターを使用すると、このトレースを階層の上方または下方に継続できます。	String
サブネットワーク名 (オプション)	トレースを実行する、トラディショナル ドメイン ネットワーク内のサブネットワークの名前。 このパラメーターは、サブネットワーク トレース タイプの実行時に使用されます。 このパラメーターは、 始点 パラメーターを使用しない場合に必要です。 サブネットワーク テーブルの 1 つの層に 10,000 以上のレコードが含まれている場合、パラメーターの選択リストは設定されず、サブネットワーク名に空のフィールドが指定されます。	String
最短パス ネットワーク属性名 (オプション)	パスまたは最短パス トレース タイプを使用して最短パスを計算するために使用するネットワーク属性。 shape length など、数値のネットワーク属性を使用して、最短パスが計算されます。 コストに基づくパスと、距離に基づくパスの両方が得られます。 このパラメーターはパス トレースではオプションですが、最短パス トレースを実行するときは必須です。	String
格納器を含める (オプション)	格納器フィーチャをトレース結果に含めるかどうかを指定します。 オン—格納器フィーチャをトレース結果に含めます。 オフ—格納器フィーチャをトレース結果に含めません。 これがデフォルトです。	Boolean
格納物を含める (オプション)	トレースの結果で、格納器フィーチャの格納物が返されるかどうかを指定します。 オン—格納器フィーチャの格納物をトレース結果に含めます。 オフ—格納器フィーチャの格納物をトレース結果に含めません。 これがデフォルトです。	Boolean
構造物を含める (オプション)	構造物フィーチャおよびオブジェクトをトレース結果に含めるかどうかを指定します。 オン—構造物フィーチャおよびオブジェクトをトレース結果に含めます。 オフ—構造物フィーチャおよびオブジェクトをトレース結果に含めません。 これがデフォルトです。	Boolean
バリア フィーチャを含める (オプション)	通過可能性バリア フィーチャが、トレース結果に含まれるかどうかを指定します。 通過可能性バリアは、サブネットワーク定義内で設定済みである場合でもオプションです。 このパラメーターは、ターミナルを含むデバイス フィーチャには適用されません。 オン—通過可能性バリア フィーチャをトレース結果に含めます。 これがデフォルトです。 オフ—通過可能性バリア フィーチャをトレース結果に含めません。	Boolean
一貫性の検証 (オプション)	通過したフィーチャのいずれかでダーティー エリアが発生した場合、エラーを返すかどうかを指定します。 これは、トレースがネットワーク内を一貫したステータスでフィーチャを通過することを保証する唯一の方法です。 ダーティー エリアを削除するには、ネットワーク トポロジーを検証します。 オン—通過したフィーチャのいずれかでダーティー エリアが発生した場合、トレースがエラーを返します。 これがデフォルトです。 オフ—通過したフィーチャのいずれかでダーティー エリアが発生したかどうかに関係なく、トレースが結果を返します。	Boolean
条件バリア (オプション)	ネットワーク属性との比較またはカテゴリー文字列のチェックに基づいて、フィーチャに対して通過可能性バリア条件を設定します。 条件バリアでは、ネットワーク属性またはネットワーク カテゴリー、演算子とタイプ、および属性値が使用されます。 たとえば、フィーチャが Open の特定の値に等しい Device Status 属性を持っている場合に、トレースを停止します。 フィーチャがこの条件を満たしている場合、トレースが停止します。 複数の属性を使用している場合、 結合方法 パラメーターを使用して、And または Or 条件を定義できます。 複数の式の使用方法の詳細 値テーブル列: 名前—ネットワーク属性名によるフィルター。 演算子—演算子によるフィルター。 等しい—属性と値が等しい。 等しくない—属性と値が等しくありません。 より大きい—属性が値より大きい。 以上—属性が値以上です。 より小さい—属性が値より小さい。 以下—属性が値以下です。 値を含む (ビット単位の論理積が値と等しい)—値のすべてのビットが、属性内に存在するビット単位の論理積演算 (bitwise AND == value)。 値を含まない (ビット単位の論理積が値と等しくない)—値の一部のビットが、属性内に存在しないビット単位の論理積演算 (bitwise AND != value)。 任意の値を含む (ビット単位の論理積が True と等しい)—値の少なくとも 1 つのビットが、属性内に存在するビット単位の論理積演算 (bitwise AND == True)。 値を含まない (ビット単位の論理積が False と等しい)—値のビットが、属性内に存在しないビット単位の論理積演算 (bitwise AND == False)。 タイプ—特定の種類によるフィルター。 特定の値—特定の値またはネットワーク カテゴリーによってフィルターします。 ネットワーク属性—ネットワーク属性によるフィルター。 値—特定の値によるフィルター。 変換方法の結合—このパラメーターを使用して複数の条件バリアを結合します。 And—条件バリアを結合します。 Or—いずれかの条件バリアが満たされた場合に使用します。	Value Table
関数バリア (オプション)	関数に基づいて、フィーチャに対する通過可能性バリアを設定します。 関数バリアを使用して、始点からトレースが移動できる距離の制限としてそのような設定を行うか、トレースを停止するための最大値を設定することができます。 たとえば、通過した各ラインの長さが、それまでに移動した合計距離に追加されます。 移動した全長が指定された値に達した場合、トレースが停止します。 値テーブル列: 関数—関数によるフィルター。 最小—最小の入力値を特定します。 最大—最大の入力値を特定します。 平均—入力値の平均値を計算します。 個数—フィーチャ数を特定します。 加算—入力値の合計を計算します。 減算—入力値の差を計算します。 サブネットワーク コントローラーおよびループ トレース タイプは、減算関数をサポートしていません。 属性—ネットワーク属性によるフィルター。 演算子—演算子によるフィルター。 等しい—関数結果と値が等しい。 等しくない—関数結果と値が等しくない。 より大きい—関数結果が値より大きい。 以上—関数結果が値以上。 より小さい—関数結果が値未満。 以下—関数結果が値以下。 値を含む (ビット単位の論理積が値と等しい)—値のすべてのビットが、属性内に存在するビット単位の論理積演算 (bitwise AND == value)。 値を含まない (ビット単位の論理積が値と等しくない)—値の一部のビットが、属性内に存在しないビット単位の論理積演算 (bitwise AND != value)。 任意の値を含む (ビット単位の論理積が True と等しい)—値の少なくとも 1 つのビットが、属性内に存在するビット単位の論理積演算 (bitwise AND == True)。 値を含まない (ビット単位の論理積が False と等しい)—値のビットが、属性内に存在しないビット単位の論理積演算 (bitwise AND == False)。 値—特定の値によるフィルター。 ローカル値の使用—グローバル変数ではなくローカル変数を使用するブール値。	Value Table
通過可能性の適用 (オプション)	通過可能性をジャンクションに適用するか、エッジに適用するか、その両方に適用するかを指定します。 たとえば、Device Status が Open であり、通過可能性の範囲がエッジのみに設定されている場合に、トレースを停止するように条件バリアを定義すると、トレースでオープン デバイスが検出された場合でも、Device Status は、ジャンクションにしか適用されないため、トレースは停止しません。 言い換えると、このパラメーターは、ジャンクション、エッジ、またはその両方を無視するかどうかをトレースに指示します。 ジャンクションとエッジの両方—通過可能性は、ジャンクションとエッジの両方に適用されます。 これがデフォルトです。 ジャンクションのみ—通過可能性は、ジャンクションのみに適用されます。 エッジのみ—通過可能性は、エッジのみに適用されます。	String
フィルター バリア (オプション)	いつ特定のカテゴリーまたはネットワーク属性のトレースを停止するかを指定します。 たとえば、特定の値と等しいライフ サイクル ステータス属性があるフィーチャで、トレースを停止します。 このパラメーターを使用して、システムに定義されているネットワーク属性の値に基づいて、ターミネーターを設定します。 複数の属性を使用している場合、 結合方法 オプションを使用して、And または Or 条件を定義できます。 複数の式の使用方法の詳細 値テーブル列: 名前—ネットワーク属性名によるフィルター。 演算子—演算子によるフィルター。 等しい—属性と値が等しい。 等しくない—属性と値が等しくありません。 より大きい—属性が値より大きい。 以上—属性が値以上です。 より小さい—属性が値より小さい。 以下—属性が値以下です。 値を含む (ビット単位の論理積が値と等しい)—値のすべてのビットが、属性内に存在するビット単位の論理積演算 (bitwise AND == value)。 値を含まない (ビット単位の論理積が値と等しくない)—値の一部のビットが、属性内に存在しないビット単位の論理積演算 (bitwise AND != value)。 任意の値を含む (ビット単位の論理積が True と等しい)—値の少なくとも 1 つのビットが、属性内に存在するビット単位の論理積演算 (bitwise AND == True)。 値を含まない (ビット単位の論理積が False と等しい)—値のビットが、属性内に存在しないビット単位の論理積演算 (bitwise AND == False)。 タイプ—特定の種類によるフィルター。 特定の値—特定の値によるフィルター。 ネットワーク属性—ネットワーク属性によるフィルター。 値—特定の値によるフィルター。 変換方法の結合—複数のフィルター バリアを結合します。 And—条件バリアを結合します。 Or—いずれかの条件バリアが満たされた場合に使用します。	Value Table
関数バリアのフィルター (オプション)	特定のカテゴリーのトレース結果をフィルターします。 値テーブル列: 関数—関数によるフィルター。 最小—最小の入力値を特定します。 最大—最大の入力値を特定します。 平均—入力値の平均値を計算します。 個数—フィーチャ数を特定します。 加算—値の合計を計算します。 減算—値の差を計算します。 サブネットワーク コントローラーおよびループ トレース タイプは、減算関数をサポートしていません。 属性—ネットワーク属性によるフィルター。 演算子—演算子によるフィルター。 等しい—属性と値が等しい。 等しくない—属性と値が等しくありません。 より大きい—属性が値より大きい。 以上—属性が値以上です。 より小さい—属性が値より小さい。 以下—属性が値以下です。 値を含む (ビット単位の論理積が値と等しい)—値のすべてのビットが、属性内に存在するビット単位の論理積演算 (bitwise AND == value)。 値を含まない (ビット単位の論理積が値と等しくない)—値の一部のビットが、属性内に存在しないビット単位の論理積演算 (bitwise AND != value)。 任意の値を含む (ビット単位の論理積が True と等しい)—値の少なくとも 1 つのビットが、属性内に存在するビット単位の論理積演算 (bitwise AND == True)。 値を含まない (ビット単位の論理積が False と等しい)—値のビットが、属性内に存在しないビット単位の論理積演算 (bitwise AND == False)。 値—特定の値によるフィルター。 ローカル値の使用—グローバル変数ではなくローカル変数を使用するブール値。	Value Table
フィルターの適用 (オプション)	特定のカテゴリーのフィルターをジャンクション、エッジ、その両方のいずれに適用するかを指定します。 たとえば、Device Status が Open であり、通過可能性の範囲がエッジのみに設定されている場合に、トレースを停止するようにフィルター バリアを定義すると、トレースでオープン デバイスが検出された場合でも、Device Status はジャンクションにしか適用されないため、トレースは停止しません。 言い換えると、このパラメーターは、ジャンクション、エッジ、またはその両方を無視するかどうかをトレースに指示します。 ジャンクションとエッジの両方 - フィルターをジャンクションとエッジの両方に適用します。 これがデフォルトです。 ジャンクションのみ - フィルターをジャンクションのみに適用します。 エッジのみ - フィルターをエッジのみに適用します。 ジャンクションとエッジの両方—フィルターをジャンクションとエッジの両方に適用します。 これがデフォルトです。 ジャンクションのみ—フィルターをジャンクションのみに適用します。 エッジのみ—フィルターをエッジのみに適用します。	String
bitset ネットワーク属性によるフィルター (オプション)	bitset によるフィルターに使用するネットワーク属性の名前。 このパラメーターは、上流、下流、およびループ トレース タイプのみに適用できます。 このパラメーターを使用すると、トレースが実世界のシナリオをより細密に反映するように、トレース中に特別なロジックを追加できます。 たとえば、ループ トレースの場合、Phases current ネットワーク属性は、ループが真の電気ループである (ループ全体で同じフェーズに電源が入る) かどうかを判断し、トレース結果の真の電源ループのみを返すことができます。 上流トレースの場合、たとえば、配電網のトレース時に Phases current ネットワーク属性を指定することにより、トレース結果に、すべてのパスではなく、ネットワーク属性で指定された有効なパスのみを含めます。	String
最近隣によるフィルター (オプション)	K 最近隣内挿アルゴリズムを使用して、所定の距離内の特定のタイプのフィーチャの数を返すかどうかを指定します。 個数、コスト、およびカテゴリーやアセット タイプのコレクションを指定できます。 オン—K 最近隣内挿アルゴリズムを使用して、nearest_count、nearest_cost_network_attribute、nearest_categories、または nearest_assets パラメーターで指定された、さまざまなフィーチャを返します。 オフ—K 最近隣内挿アルゴリズムを使用して、結果をフィルターしません。 これがデフォルトです。	Boolean
個数 (オプション)	最近隣によるフィルター をオンにしたときに返されるフィーチャの数。	Long
コスト ネットワーク属性 (オプション)	最近隣によるフィルター をオンにした場合に、近接性、コスト、または距離の計算に使用される数値のネットワーク属性 (たとえば、形状の長さ)。	String
最近隣カテゴリー (オプション)	最近隣によるフィルター をオンにしたときに返されるカテゴリー (たとえば、Protective)。	String
最近隣アセット グループ/タイプ (オプション)	最近隣によるフィルター をオンにしたときに返されるアセット グループおよびアセット タイプ (たとえば、ElectricDistributionDevice/Transformer/Step Down)。	String
関数 (オプション)	トレース結果に適用される計算関数。 値テーブル列: 関数—演算関数。 平均—入力値の平均値を計算します。 個数—フィーチャ数を特定します。 最大値—最大の入力値を特定します。 最小値—最小の入力値を特定します。 加算—入力値の合計を計算します。 減算—入力値の差を計算します。 サブネットワーク コントローラーおよびループ トレース タイプは、減算関数をサポートしていません。 属性—ネットワーク属性によるフィルター フィルター名—ネットワーク属性名によるフィルター。 フィルター演算子—演算子によるフィルター。 等しい—属性と値が等しい。 等しくない—属性と値が等しくありません。 より大きい—属性が値より大きい。 以上—属性が値以上です。 より小さい—属性が値より小さい。 以下—属性が値以下です。 値を含む (ビット単位の論理積が値と等しい)—値のすべてのビットが、属性内に存在するビット単位の論理積演算 (bitwise AND == value)。 値を含まない (ビット単位の論理積が値と等しくない)—値の一部のビットが、属性内に存在しないビット単位の論理積演算 (bitwise AND != value)。 任意の値を含む (ビット単位の論理積が True と等しい)—値の少なくとも 1 つのビットが、属性内に存在するビット単位の論理積演算 (bitwise AND == True)。 値を含まない (ビット単位の論理積が False と等しい)—値のビットが、属性内に存在しないビット単位の論理積演算 (bitwise AND == False)。 フィルター タイプ—属性タイプによるフィルター。 特定の値—特定の値によるフィルター。 ネットワーク属性—ネットワーク属性によるフィルター。 フィルター値—特定の値によるフィルター。 関数名—関数の結果を説明するエイリアス名。	Value Table
プロパゲーター (オプション)	反映させるネットワーク属性、およびトレース中に反映がどのように発生するかを指定します。 反映されるクラス属性は、サブネットワーク内の他のフィーチャに広められる、サブネットワーク コントローラーの重要な値を示します。 たとえば、配電モデルでは、位相値を反映することができます。 通信ドメイン ネットワークでは、回路位置として定義されたフィーチャから、波長の値を反映できます。 ビット単位の演算子の詳細 注意: このパラメーターは Python でのみ使用できます。 値テーブル列: 属性—ネットワーク属性によるフィルター。 代替属性—代替に使用されるネットワーク属性。 関数—関数によるフィルター。 演算子—演算子によるフィルター。 値—特定の値によるフィルター。	Value Table
出力アセット タイプ (オプション)	結果に含める出力アセット タイプをフィルターします (たとえば、頭上の変圧器のみを返すなど)。	String
出力条件 (オプション)	ネットワーク属性またはカテゴリーに基づいて、返されるフィーチャのタイプです。 たとえば、Tap フィーチャ以外をすべて除外するよう構成されたトレースでは、Tap カテゴリーが割り当てられていないトレース済みフィーチャは、結果に含まれません。 そのカテゴリーがあるトレース対象フィーチャは、結果選択セットに返されます。 複数の式の使用方法の詳細 値テーブル列: 名前—ネットワーク属性名によるフィルター。 演算子—演算子によるフィルター。 等しい—属性と値が等しい。 等しくない—属性と値が等しくありません。 より大きい—属性が値より大きい。 以上—属性が値以上です。 より小さい—属性が値より小さい。 以下—属性が値以下です。 値を含む (ビット単位の論理積が値と等しい)—値のすべてのビットが、属性内に存在するビット単位の論理積演算 (bitwise AND == value)。 値を含まない (ビット単位の論理積が値と等しくない)—値の一部のビットが、属性内に存在しないビット単位の論理積演算 (bitwise AND != value)。 任意の値を含む (ビット単位の論理積が True と等しい)—値の少なくとも 1 つのビットが、属性内に存在するビット単位の論理積演算 (bitwise AND == True)。 値を含まない (ビット単位の論理積が False と等しい)—値のビットが、属性内に存在しないビット単位の論理積演算 (bitwise AND == False)。 タイプ—特定の種類によるフィルター。 特定の値—特定の値によるフィルター。 ネットワーク属性—ネットワーク属性によるフィルター。 値—特定の値によるフィルター。 変換方法の結合—このパラメーターを使用して複数の条件を結合します。 And—条件を結合します。 Or—いずれかの条件を満たした場合に使用します。	Value Table
分離フィーチャを含める (オプション)	トラディショナル ドメイン ネットワークで分離フィーチャをトレース結果に含めるかどうかを指定します。 このパラメーターは、分離トレースの実行時にのみ使用されます。 オン—分離フィーチャをトレース結果に含めます。 オフ—分離フィーチャをトレース結果に含めません。 これがデフォルトです。	Boolean
始点でバリアを無視する (オプション)	始点では、トレース構成内のダイナミック バリアを無視するかどうかを指定します。 これは、上流の保護デバイスのトレースを実行し、検出された保護デバイス (バリア) を始点として使用して、その後の上流の保護デバイスを検索する場合に、役立ちます。 オン—始点にあるバリアは、トレース内で無視されます。 オフ—始点にあるバリアは、トレース内で無視されません。 これがデフォルトです。	Boolean
最初の空間格納器まで含める (オプション)	返される格納器を、トレース結果の各ネットワーク エレメントの最初の空間格納器およびそれまで検出した格納器に制限するかどうかを指定します。 所定のネットワーク エレメントで、空間格納器が検出されず、非空間格納器のみがある場合、結果にはすべての非空間格納器が含まれます。 このパラメーターは、include_containers が INCLUDE_CONTAINERS に設定されている場合のみ有効です。 オン—トレース パスに沿って、ネストされた格納の関連付けが検出された場合、結果には最初の空間格納器まで (最初の空間格納器を含む) に遭遇した格納器のみが返されます。 空間格納器がない場合、所定のネットワーク エレメントの結果には、すべての非空間格納器が含まれます。 オフ—すべての格納器が結果に返されます。 これがデフォルトです。	Boolean
結果タイプ (オプション)	トレースから返される結果のタイプを指定します。 選択—トレース結果は、該当するネットワーク フィーチャの選択セットとして返されます。 これがデフォルトです。 集約されたジオメトリー—トレース結果は、ジオメトリー タイプによって集約され、アクティブなマップのレイヤー内に表示される、マルチパート フィーチャクラスに格納されます。 接続性—トレース結果は、通過したネットワーク フィーチャの指定した出力 .json ファイルで、接続性グラフとして返されます。 このオプションにより、 ジオメトリーを含める、 ドメインの説明を含める、 出力 JSON の各パラメーターが有効になります。 エレメント—トレース結果は、通過したネットワーク フィーチャの指定した出力 .json ファイルで、フィーチャ ベースの情報として返されます。 このオプションによって、 出力 JSON パラメーターが有効になります。 フィーチャ—トレース結果は、通過したネットワーク フィーチャの指定した出力 .json ファイルで、フィーチャ ベースの情報として返されます。 このオプションにより、 ジオメトリーを含める、 ドメインの説明を含める、 結果ネットワーク属性、 結果フィールド、および 出力 JSON パラメーターが有効になります。 注意: エンタープライズ ジオデータベースの場合、このオプションは、ArcGIS Enterprise 11.1 以降を必要とします。 格納および付属物の関連付け—トレース結果は、指定された出力 .json ファイル内の格納および構造物付属物の関連付けを介して関連付けられた、通過したネットワーク フィーチャの関連付け情報として返されます。 このオプションにより、 ドメインの説明を含める および 出力 JSON パラメーターが有効になります。 注意: エンタープライズ ジオデータベースの場合、このオプションは、ArcGIS Enterprise 11.1 以降を必要とします。 関連データ—指定したリレーションシップ クラスとフィールドを使用して、通過したフィーチャの関連オブジェクトの値が、出力 .json ファイルで返されます。 このオプションにより、 ジオメトリーを含める、 ドメインの説明を含める、 関連レコード フィールド、 出力 JSON の各パラメーターが有効になります。 注意: エンタープライズ ジオデータベースの場合、このオプションは ArcGIS Enterprise 11.5 以降を必要とします。 回路—トレース結果は回路定義として返され、各セクションのパス接続情報とジオメトリーを、指定された出力 .json ファイルに含めることもできます。 このオプションは、通信ドメイン ネットワークの回路トレースでのみサポートされており、 ジオメトリーを含める、 ジオメトリーの合成、 JSON 出力 のパラメーターが有効になります。	String
選択タイプ	どのように選択を適用するか、選択が存在する場合にはどうなるかを指定します。 新しい選択—結果として得られる選択によって、現在の選択が置換されます。 これがデフォルトです。 現在の選択に追加—選択が存在する場合、結果として得られる選択が現在の選択に追加されます。 選択が存在しない場合は、新しい選択オプションと同じです。 現在の選択から削除—結果として得られる選択が、現在の選択から削除されます。 選択が存在しない場合、このオプションは影響を与えません。新しい選択オプションと同じです。 現在の選択からサブセットを選択—結果として得られる選択が、現在の選択に統合されます。 両方に共通のレコードだけが、選択された状態となります。 現在の選択の切り替え—選択結果が切り替えられます。 選択された結果が現在の選択から削除され、選択されなかった結果が現在の選択に追加されます。 選択が存在しない場合は、新しい選択オプションと同じです。	String
以前のトレース結果をすべて消去 (オプション)	集約されたジオメトリーを格納するために、選択されたフィーチャクラスの内容を切り捨てるか、追加するかを指定します。 このパラメーターは、 集約されたジオメトリー 結果タイプのみに適用されます。 オン—集約されたトレース ジオメトリーを格納するフィーチャクラスは切り捨てられます。 現在のトレース操作の出力ジオメトリーのみが書き込まれます。 これがデフォルトです。 オフ—現在のトレース操作の出力ジオメトリーが、集約されたジオメトリーを格納するフィーチャクラスに追加されます。	Boolean
トレース名 (オプション)	トレース操作の名前。 この値は、出力フィーチャクラスの TRACENAME フィールドに格納され、トレース結果の識別に役立ちます。 このパラメーターは、 集約されたジオメトリー 結果タイプのみに適用されます。	String
集約されたポイント (オプション)	集約された結果ジオメトリーを含む出力マルチポイント フィーチャクラス。 デフォルトでは、このパラメーターは、Trace_Results_Aggregated_Points というシステムで生成されるフィーチャクラスを使用して設定され、プロジェクトのデフォルト ジオデータベースに格納されます。 このフィーチャクラスが存在しない場合は、自動的に作成されます。 既存のフィーチャクラスも、集約されたジオメトリーの格納に使用できます。 デフォルト以外のフィーチャクラスを使用する場合は、TRACENAME という文字列フィールドを含むマルチポイント フィーチャクラスである必要があります。 このパラメーターは、 集約されたジオメトリー 結果タイプのみに適用されます。	Feature Class
集約されたライン (オプション)	集約された結果ジオメトリーを含む出力ポリライン フィーチャクラス。 デフォルトでは、このパラメーターは、Trace_Results_Aggregated_Lines というシステムで生成されるフィーチャクラスを使用して設定され、プロジェクトのデフォルト ジオデータベースに格納されます。 このフィーチャクラスが存在しない場合は、自動的に作成されます。 既存のフィーチャクラスも、集約されたジオメトリーの格納に使用できます。 デフォルト以外のフィーチャクラスを使用する場合は、TRACENAME という文字列フィールドを含むポリライン フィーチャクラスである必要があります。 このパラメーターは、 集約されたジオメトリー 結果タイプのみに適用されます。	Feature Class
集約されたポリゴン (オプション)	集約された結果ジオメトリーを含む出力ポリゴン フィーチャクラス。 デフォルトでは、このパラメーターは、Trace_Results_Aggregated_Polygons というシステムで生成されるフィーチャクラスを使用して設定され、プロジェクトのデフォルト ジオデータベースに格納されます。 このフィーチャクラスが存在しない場合は、自動的に作成されます。 既存のフィーチャクラスも、集約されたジオメトリーの格納に使用できます。 デフォルト以外のフィーチャクラスを使用する場合は、TRACENAME という文字列フィールドを含むポリゴン フィーチャクラスである必要があります。 このパラメーターは、 集約されたジオメトリー 結果タイプのみに適用されます。	Feature Class
不定フローを許可 (オプション)	フローが、不定のフィーチャをトレースするかどうかを指定します。 不定フローは、フロー方向があいまいであるか判定できないサブネットワーク内のエリアとして定義されます。 このパラメーターは、上流トレース、下流トレース、または分離トレースを実行する場合にのみ適用できます。 注意: このパラメーターには、ユーティリティー ネットワーク バージョン の値が 5 以上であることが必要です。 オン—フローが、不定のフィーチャがトレースされます。 これがデフォルトです。 オフ—不定フローを持つフィーチャは通過可能性が停止し、トレースされません。	Boolean
配置可能性の検証 (オプション)	トレース中に、関連付け階層内で必要な接続性、格納、付属物が、いずれも関連付けられていない非空間のジャンクション オブジェクトまたはエッジ オブジェクトが検出された場合に、エラーを返すかどうかを指定します。 このパラメーターにより、トレースまたはサブネットワーク更新操作によって返される非空間オブジェクトを、フィーチャまたは他の配置可能オブジェクトとの関連付けを通じて、配置できるようになります。 オン—関連付け階層内の必要な接続性、格納、付属物が、いずれも関連付けられていない未配置の非空間のジャンクション オブジェクトまたはエッジ オブジェクトが検出された場合に、トレースからエラーが返されます。 オフ—トレースは、配置不能なオブジェクトをチェックせず、通過したオブジェクトの関連付け階層に配置不能なオブジェクトが存在するかどうかに関係なく、結果を返します。 これがデフォルトです。	Boolean
トレース構成の使用 (オプション)	このツールのパラメーターを設定するために、既存の名前付きトレース構成を使用するかどうかを指定します。 注意: このパラメーターには、ユーティリティー ネットワーク バージョン の値が 5 以上であることが必要です。 オン—既存の指定トレース構成を使用して、トレースのプロパティを定義します。 trace_config_name、starting_points、barriers を除く、すべてのパラメーターが無視されます。 オフ—既存の指定トレース構成を使用して、トレースのプロパティを定義します。 これがデフォルトです。	Boolean
トレース構成名 (オプション)	既存の指定トレース構成の名前を使用して、トレースのプロパティを定義します。 このパラメーターは、 トレース構成の使用 パラメーターがオンの場合にのみ有効になります。 注意: このパラメーターには、ユーティリティー ネットワーク バージョン の値が 5 以上であることが必要です。	String
出力 JSON (オプション)	接続性、 エレメント、 フィーチャ、 格納および付属物の関連付け、または 関連データ 結果タイプを使用して、トレース結果を返す際に生成される .json ファイルの名前と場所。	File
サーバーでの非同期モードでの実行 (オプション)	エンタープライズ ジオデータベースで、ユーティリティー ネットワークを操作するときに、トレース操作を非同期で処理するかどうかを指定します。 オン—トレース操作を非同期で処理します。 オフ—トレース操作を同期的に処理します。 これがデフォルトです。	Boolean
ジオメトリーを含める (オプション)	ジオメトリーを結果に含めるかどうかを指定します。 注意: エンタープライズ ジオデータベースの場合、このパラメーターは、ArcGIS Enterprise 11.1 以降を必要とします。 オン—ジオメトリーは、結果に含まれます。 オフ—ジオメトリーは、結果に含まれません。 これがデフォルトです。	Boolean
ドメインの説明を含める (オプション)	ドメインの説明を出力 .json ファイルに含めて、コントローラー、featureElements、接続性、関連付けのドメイン マッピングを伝えるかどうかを指定します。 注意: エンタープライズ ジオデータベースの場合、このパラメーターは、ArcGIS Enterprise 11.1 以降を必要とします。 オン—ドメインの説明を結果に含めます。 オフ—ドメインの説明を結果に含めません。 これがデフォルトです。	Boolean
結果のネットワーク属性 (オプション)	結果に含めるネットワーク属性。 注意: エンタープライズ ジオデータベースの場合、このパラメーターは、ArcGIS Enterprise 11.1 以降を必要とします。	String
結果フィールド (オプション)	結果として返されるフィーチャクラスのフィールド。 フィールドの値は、トレース内のフィーチャの結果で返されます。 注意: エンタープライズ ジオデータベースの場合、このパラメーターは、ArcGIS Enterprise 11.1 以降を必要とします。 値テーブル列: フィーチャクラス—ユーティリティー ネットワークに属しているフィーチャクラス。 フィールド名—結果によって返される値を格納するフィーチャクラスのフィールド名。	Value Table
デジタイズ方向を使用 (オプション)	上流および下流のトレース操作でラインのデジタイズ方向、関連付けに含まれるエッジ オブジェクトの From グローバル ID と To グローバル ID、および Flow direction 属性を使用してフロー方向を決定するかどうかを指定します。 このパラメーターは、ユーティリティー ネットワーク バージョン 7 以降で、trace_type パラメーターが UPSTREAM または DOWNSTREAM に設定されているときのみ使用可能で、アクティブになります。 注意: エンタープライズ ジオデータベースの場合、このパラメーターは ArcGIS Enterprise 11.3 以降を必要とします。 オン—トレース操作で、ラインのデジタイズ方向、関連付けのエッジ オブジェクトの From および To グローバル ID、フロー方向属性を使用して、フロー方向が決定されます。 このオプションにより、層に構成されているプロパゲーターは無視され、domain_network、tier、および target_tier の各パラメーターも無視されます。 オフ—トレース操作は、サブネットワーク コントローラーの位置に基づいて、フロー方向を決定します。 これがデフォルトです。	Boolean
ジオメトリーの合成 (オプション)	トレース操作の一環として、通過した関連付けとエッジ オブジェクトのジオメトリーの推測と作成 (合成) を実行するかどうかを指定します。 このパラメーターは、 集約されたジオメトリー と 回路 の結果タイプのみに適用されます。 注意: エンタープライズ ジオデータベースの場合、このパラメーターは、 集約されたジオメトリー 結果タイプで使用するには ArcGIS Enterprise 11.3 以降、 回路 結果タイプで使用するには ArcGIS Enterprise 12.1 以降を必要とします。 オン—通過した関連付けとエッジ オブジェクトのジオメトリーが推測され、Trace_Results_Aggregated_Lines 出力フィーチャクラス内に作成されます。 オフ—通過した関連付けとエッジ オブジェクトのジオメトリーが合成されません。 これがデフォルトです。	Boolean
停止点 (オプション)	トレース ウィンドウの 停止 タブを使用して作成されたフィーチャ レイヤー、またはパス トレースの停止点を表す 1 つ以上のレコードが含まれているテーブルまたはフィーチャクラス。 このフィーチャクラスまたはテーブルには、関連付けられているネットワーク フィーチャの情報を格納する FEATUREGLOBALID フィールドが含まれている必要があります。 デフォルトでは、プロジェクトのデフォルト ジオデータベース内の UN_Temp_Stopping_Points フィーチャクラスが使用されます。 注意: エンタープライズ ジオデータベースの場合、このパラメーターは ArcGIS Enterprise 12.1 以降を必要とします。	Feature Layer; Table View
パス数 (オプション)	パス トレース内の一連の開始位置と停止位置の間で返されるパスの最大数。 デフォルトは 1 です。 このパラメーターは、 トレース タイプ パラメーターが パス に設定されている場合にのみ有効です。 注意: エンタープライズ ジオデータベースの場合、このパラメーターは ArcGIS Enterprise 12.1 以降を必要とします。	Long
最大ホップ (オプション)	パスで許容されるエッジ間の最大ホップ数 (始点を除く)。 すべてのエッジとジャンクション-ジャンクション接続性の関連付けは、通過時に固定ユニット長 1 を持つものとして評価されます。 ターミナル デバイスは、固定ユニット長 2 を持つものとして評価されます。 デフォルトは 100 です。 このパラメーターは、 トレース タイプ パラメーターが パス に設定されている場合にのみ有効です。 注意: エンタープライズ ジオデータベースの場合、このパラメーターは ArcGIS Enterprise 12.1 以降を必要とします。	Long
関連レコード フィールド (オプション)	結果として返される関連オブジェクト クラスのフィールド。 フィールドの値は、出力 .json ファイルで、通過したフィーチャの結果で返されます。 値テーブル列: リレーションシップ クラス—ユーティリティー ネットワークに属しているフィーチャクラスまたはオブジェクト クラスに関連するリレーションシップ クラス。 フィールド名—結果によって返される値を格納する、関連オブジェクト クラスのフィールド名。	Value Table
回路名 (オプション)	回路トレースを実行する、通信ドメイン ネットワーク内の回路の名前。 回路トレースで 始点 パラメーターを使用しない場合には必須です。 注意: エンタープライズ ジオデータベースの場合、このパラメーターは ArcGIS Enterprise 12.1 以降を必要とします。	String
接続性の推測 (オプション)	パス トレースで接続性の推測を使用して、格納の関連付けを通過し、所定の開始位置と終了位置間のパスを特定するかどうかを指定します。 このパラメーターは通信ドメイン ネットワークのパス トレースでのみサポートされており、接続性情報が明示的に利用できない場合でも、セクション間のパスを検出できるようにします。 詳細については、接続性の推測をご参照ください。 オン—接続性が不完全で通過が行えない場合でも、パス トレースで接続性の推測を使用して、格納の関連付けを通過し、所定の開始位置と終了位置間のパスを特定します。 オフ—接続性の推測を使用して、所定の開始位置と終了位置間のパスを特定しません。 これがデフォルトです。	Boolean
フロー方向を含める (オプション)	フロー方向を出力 .json ファイルに含めるかどうかを指定します。 フロー方向を含めた場合、通過したライン、エッジ オブジェクト、ターミナルがあるデバイスの内部エッジ、接続性の関連付けのサブネットワーク コントローラーから派生したフロー方向情報が、ファイルに含まれます。 このパラメーターは、サブネットワーク、上流、および下流トレース タイプで使用する場合に、 接続性、 エレメント、 フィーチャ 結果タイプ オプションにのみ適用されます。 注意: エンタープライズ ジオデータベースの場合、このパラメーターは ArcGIS Enterprise 12.1 以降を必要とします。 オン—フロー方向は結果に含まれます。 オフ—フロー方向は結果に含まれません。 これがデフォルトです。	Boolean
反映される値を含める (オプション)	サブネットワークベースのトレースを実行するときに、反映される値を出力 .json ファイルに含めるかどうかを指定します。 このパラメーターは、 フィーチャ 結果タイプにのみ適用されます。 注意: エンタープライズ ジオデータベースの場合、このパラメーターは ArcGIS Enterprise 12.1 以降を必要とします。 オン—反映される値は結果に含まれます。 オフ—反映される値は結果に含まれません。 これがデフォルトです。	Boolean

派生した出力

ラベル	説明	データ タイプ
出力ユーティリティー ネットワーク	更新されたユーティリティー ネットワーク。	Utility Network

環境

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

ライセンス情報

• Basic: 限定的
  ArcGIS Enterprise 指定ユーザー ライセンスを使用している場合に、エンタープライズ デプロイメントでサポートされます。
• Standard: はい
• Advanced: はい

関連トピック

• ユーティリティー ネットワーク ツールボックスの概要
• ジオプロセシング ツールの検索