ユーティリティ ネットワーク ツールボックスの移行ツールセットには、3 つのツールが用意されています。これらは、既存のデータをユーティリティ ネットワークに移行して、基本的な編集およびトレース ワークフローをサポートできるよう設計されています。
ネットワーク データの解析 (Analyze Network Data) ツールは、入力ユーティリティ ネットワークを評価して、自己交差ライン、スタック ポイント、無効な接続性などの一般的なタイプのトポロジの不整合を検出します。 このツールは、データ内で検出したエラー タイプを説明する、さまざまなフィーチャクラスとテーブルが含まれているモバイル ジオデータベースを出力として生成します。 これらの出力フィーチャクラスとテーブルを使用すると、エラー シナリオを理解して、エラー タイプごとに実行すべきアクションを定義できます。 出力 Error Resolutions テーブルは編集可能で、エラー解決の適用ツールの入力として、エラー シナリオに対処するために使用できます。
要件
ネットワーク データを解析し、一般的なエラー タイプを検出するには、次の要件が満たされている必要があります。
- ネットワーク トポロジは、有効化または無効化できます。
- エンタープライズ ジオデータベースを操作する場合、次の要件が満たされている必要があります。
エンタープライズ ジオデータベースを操作する場合、[入力ユーティリティ ネットワーク] パラメーターは、「データベース ユーティリティ ネットワークの所有者」として、確立されたデータベース コネクションから取得する必要があります。
ネットワーク データの解析によるエラーの検出
ネットワーク データを解析して一般的なエラー タイプを調べるには、次の手順を実行します。
- [解析] タブの [ジオプロセシング] グループで、[ツール]
をクリックして、[ジオプロセシング] ウィンドウを開きます。 - [ジオプロセシング] ウィンドウで、[ネットワーク データの解析] を検索して選択します。
- [入力ユーティリティ ネットワーク] パラメーターに、ユーティリティ ネットワークを指定します。
フィーチャ サービスのユーティリティ ネットワークはサポートされていません。
- [出力場所] パラメーターに、出力モバイル ジオデータベースを格納するフォルダーのパスを指定します。
- [出力名] パラメーターに、出力モバイル ジオデータベースの名前を指定します。
デフォルトは AnalysisResults です。
これにより、[出力場所] パラメーターで指定したフォルダーが作成され、指定した名前のモバイル ジオデータベースがそこに格納されます。
- [デフォルト解決アクションの設定] パラメーターで、指定したエラー タイプに対してデフォルトの [アクション] 属性値を Error Resolutions テーブル内に設定するかどうかを指定します。
ツールで設定するエラー アクションの値は変更できます。 すべてのエラーが定義済みのデフォルトのエラー アクションを持つ訳ではありません。
- オン - 次のエラー タイプは、出力 Error Resolutions テーブルの Action フィールドにデフォルトの解決アクションが設定されます。
- 空の図形の長さ - フィーチャクラスから行を削除します。
- 自己交差ライン - 最初の頂点を除くすべての頂点を削除します。
- 重複頂点 - 最初の頂点を除くすべての頂点を削除します。
- スタック ポイント - 最初の頂点を除くすべての頂点を削除します。
- オフ - エラー タイプは、出力 Error Resolutions テーブルにデフォルトのエラー アクションが設定されません。 これがデフォルトです。
- オン - 次のエラー タイプは、出力 Error Resolutions テーブルの Action フィールドにデフォルトの解決アクションが設定されます。
- [実行] をクリックします。
[ネットワーク データの解析 (Analyze Network Data)] ツールが実行され、指定した出力場所にモバイル ジオデータベースが作成されます。 Error Summary および Error Locations フィーチャクラスと Error Resolutions テーブルが、グループ レイヤーを使用してアクティブなマップに追加されます。
フィーチャクラスとテーブルの出力
ネットワーク データの解析ツールによって作成されたモバイル ジオデータベースには、次のフィーチャクラスとテーブルが含まれます。
- ErrorLocations - エラーが検出されたネットワーク内の個別の位置を説明するポイント フィーチャクラス。
- ErrorSummary - マルチパート フィーチャを使用してネットワーク内のエラーのすべての一意の組み合わせを集計するポイント フィーチャクラス。
- ErrorRecords - 各エラーの位置に存在するすべてのフィーチャと、関連するエラーのタイプに関する情報を含むテーブル。
- ErrorResolution - エラーの各グループに対して望ましい解決策を記述するために使用するテーブル。 これは、[エラー解決の適用 (Apply Error Resolutions)] ツールの入力として使用されます。
モバイル ジオデータベースが格納されるフォルダーには、エラーを理解して解決するために利用できるレイヤー (.lyrx) と .csv ファイルも含まれています。
- 入力ユーティリティ ネットワーク内に見つかったエラーをシンボル表示するグループ レイヤー。 このグループ レイヤーの名前は、[ネットワーク データの解析 (Analyze Network Data)] ツールを実行するときに [出力名] パラメーターで指定した名前と一致します。 このレイヤーは、マップでのエラーの視覚化を支援するために、モバイル ジオデータベース内にある他のテーブルとフィーチャクラスを使用します。
- RuleCandidates - エラーを解決するために追加できるユーティリティ ネットワーク ルールの候補を伝える .csv ファイル。
グループ レイヤーを使用して出力内のフィーチャクラスとテーブルをユーティリティ ネットワークとオーバーレイすることで、コンテキストを提供し、発生したさまざまなエラーの視覚化を支援することができます。 以下のセクションでは、さまざまな出力クラスとそれらのスキーマについて概要を説明します。
Error Summary および Error Locations フィーチャクラス
Error Locations および Error Summary ポイント フィーチャクラスは、入力ユーティリティ ネットワークで検出したエラーについて異なる情報を提供します。 Error Summary フィーチャクラスには、解析タイプとエラー コード値を共有する Error Locations フィーチャクラス内にあるすべての同種フィーチャを集約するマルチポイント ジオメトリが含まれており、ユーティリティ ネットワーク内に存在するさまざまなエラー タイプの概要を、クラス、アセット グループ、アセット タイプ別に提供します。
Error Locations フィーチャクラスには、エラーが発生しているすべての位置のポイント フィーチャが含まれています。 これにより、Error Summary マルチポイント フィーチャによって表現される個々の位置を確認できます。 位置フィーチャを選択すると、関連レコードも Error Records テーブル内で選択されます。
注意:
Error Locations フィーチャクラス内のレコードを選択すると、ソース フィーチャクラスがマップに追加され (まだ存在しない場合)、関連フィーチャが選択されます。 このリレーションシップは、ソース データへの絶対パスを使用します。 ソース データが移動した場合は、このリレーションシップを更新する必要があります。
Error Summary フィーチャクラスには、次の属性フィールドが含まれています。
| フィールド名 | フィールド エイリアス | 説明 |
|---|---|---|
OBJECTID | Object ID | マルチポイント エラー サマリー フィーチャのオブジェクト ID。 |
ErrorCode | エラー コード | 集計されたエラー タイプのエラー コード。 |
AnalysisTypes | 解析タイプ | この位置に存在するフィーチャクラス、アセット グループ、アセット タイプ。 これには、エラーが発生したフィーチャと、一致するフィーチャが含まれます。 ヒント:[オプション] で、[テーブル] タブの [行の高さ] 設定を [3 倍] に設定すると、このフィールドの読みやすさが改善します。 |
TypesInError | エラーのタイプ | エラーが発生したフィーチャのフィーチャクラス、アセット グループ、アセット タイプ。 |
SourceName | ソース レイヤー | エラーが発生したフィーチャのフィーチャクラス。 |
AssetGroupName | アセット グループ | エラーが発生したフィーチャのアセット グループ。 |
AssetTypeName | アセット タイプ | エラーが発生したフィーチャのアセット タイプ。 |
Occurrences | 出現回数 | Analysis types と Error code の一意の組み合わせごとにマルチポイント ジオメトリを構成する Error Locations フィーチャの数。 |
ResolutionKey | 解決キー | Error Summary フィーチャクラスを Error Resolution テーブルにリンクする場合に使用するリレーショナル キー。 Error Summary クラス内のマルチポイント フィーチャを選択すると、Error Resolution テーブル内の関連レコードが選択されます。 |
Shape | 形状 | フィーチャの位置。 |
Error Locations フィーチャクラスには、次の属性フィールドが含まれています。
| フィールド名 | フィールド エイリアス | 説明 |
|---|---|---|
OBJECTID | Object ID | ユーティリティ ネットワークの個々のエラーのオブジェクト ID。 |
ErrorCode | エラー コード | エラーが発生したフィーチャと関連付けられているエラー コード。 |
AnalysisTypes | 解析タイプ | この位置に存在するフィーチャクラス、アセット グループ、アセット タイプ。 これには、エラーが発生したフィーチャと、一致するフィーチャが含まれます。 |
ResolutionKey | ResolutionKey | |
SHAPE | 形状 | フィーチャの位置。 |
エラー レコード テーブル
Error Records テーブルには、Error Locations テーブル内に存在する各エラーに関連するフィーチャに関する詳細情報が含まれています。 マップに追加したグループ レイヤーには、定義クエリを使用してフィルターしたエラーを含むすべてのフィーチャクラスに対応する、このテーブルのレコードのサブセットが含まれています。 このテーブルは、報告されたエラーの状態の原因となった可能性のあるその他のフィーチャを評価する場合にご参照ください。
Error Records テーブルには、次の属性フィールドが含まれています。
| フィールド名 | フィールド エイリアス | 説明 |
|---|---|---|
OBJECTID | Object ID | エラー レコードのオブジェクト ID。 |
LocationKey | 位置キー | エラー レコードの位置キーの値。 これは、Error Locations フィーチャクラス内のフィーチャのオブジェクト ID に対応しています。 |
ErrorCode | エラー コード | エラーが発生したフィーチャと関連付けられているエラー コード。 |
AnalysisTypes | 解析タイプ | この位置に存在するフィーチャクラス、アセット グループ、アセット タイプ。 これには、エラーが発生したフィーチャと、一致するフィーチャが含まれます。 |
ClassGroupType | フィーチャ タイプ | 関連付けられているフィーチャのフィーチャクラス、アセット グループ、アセット タイプ。 |
SourceID | ソース レイヤー | エラー レコードと関連付けられているフィーチャクラス。 |
SourceOID | フィーチャ ID | エラーと関連付けられているフィーチャのオブジェクト ID。 |
エラー解決テーブル
Error Resolutions テーブルは編集可能なテーブルで、[ネットワーク データの解析 (Analyze Network Data)] ツールで検出したエラーに対して行う必要がある是正処置を定義するために使用されます。 このテーブルは変更後に、フィーチャを編集してエラー シナリオを修正するために [エラー解決の適用 (Apply Error Resolutions)] ツールの入力として使用されます。
Error Resolutions テーブルには、次の列が含まれています。
| フィールド名 | フィールド エイリアス | 説明 |
|---|---|---|
OBJECTID | Object ID | 解決レコードのオブジェクト ID。 |
ErrorCode | エラー コード | エラーが発生したフィーチャと関連付けられているエラー コード。 |
AnalysisTypes | 解析タイプ | この位置に存在するフィーチャクラス、アセット グループ、アセット タイプ。 これには、エラーが発生したフィーチャと、一致するフィーチャが含まれます。 ヒント:[オプション] で、[テーブル] タブの [行の高さ] 設定を [3 倍] に設定すると、このフィールドの読みやすさが改善します。 |
ResolutionKey | 解決キー | Error Summary フィーチャクラスに関連するリレーショナル キー。 |
GroupPosition | グループ位置 | 解析タイプ グループ内の行の順序。 |
ClassGroupType | フィーチャ タイプ | エラーが発生したフィーチャのフィーチャクラス、アセット グループ、アセット タイプ。 |
SourceNames | ソース レイヤー | エラー レコードと関連付けられているフィーチャクラス。 |
AssetGroupNames | アセット グループ | エラー レコードと関連付けられているフィーチャのアセット グループ。 |
AssetTypeNames | アセット タイプ | エラー レコードと関連付けられているフィーチャのアセット タイプ。 |
ErrorContext | コンテキスト | エラーが発生したフィーチャと、コンテキストのために提供された一致するフィーチャのどちらをレコードが参照しているかを識別します。 |
ErrorAction | アクション | エラー タイプを解決するために実行する是正措置。 値は次のとおりです。
|
DeltaX | 相対 X | ポイントのジオメトリまたはラインの頂点の X 座標に適用されるオフセット値。 これは、更新または作成アクションの場合のみ有効です。 |
DeltaY | 相対 Y | ポイントのジオメトリまたはラインの頂点の Y 座標に適用されるオフセット値。 これは、更新または作成アクションの場合のみ有効です。 |
DeltaZ | 相対 Z | ポイントのジオメトリまたはラインの頂点の Z 座標に適用されるオフセット値。 これは、更新または作成アクションの場合のみ有効です。 |
DeltaStep | 相対ステップ | 同じ位置に複数のフィーチャが存在する場合に、後続の各フィーチャの相対 (X、Y、Z) フィールドに適用するオフセット値を定義します。 これは、更新または作成アクションの場合のみ有効です。 |
ActionClassGroupType | 作成/更新タイプ | 新しいフィーチャを作成するときや既存のフィーチャを更新するときに使用するアセット グループとアセット タイプを指定します。 |
ツールを使用して検出されたエラー タイプ
[ネットワーク データの解析 (Analyze Network Data)] ツールはすべてのエラーを特定するためのものではありませんが、次の一般的なユーティリティ ネットワーク エラーが検出され、Error Summary および Error Locations フィーチャクラスと Error Resolutions テーブル内の Error codes 属性フィールドに返されます。 ツールによって検出されるエラー コード、関連付けられているエラー ID、エラー シナリオの説明、および Error Resolutions テーブル内のエラーを解決するために適用できるアクション (該当する場合) を以下の表に示します。
注意:
すべてのエラー タイプに自動化された解決策がある訳ではありません。| Error code | 関連付けられているエラー ID | 説明 | 利用可能なエラー アクション |
|---|---|---|---|
空のジオメトリ | 1 | ネットワーク フィーチャのジオメトリが空です。 このエラーは、ライン フィーチャの長さがゼロまたはゼロに近い場合に発生する可能性があります。 | すべて削除/最初以外すべて削除 (頂点) |
Shape Length | 5 | ライン フィーチャの長さが許容値内です。 このエラーは、ライン フィーチャの長さがゼロまたはゼロに近い場合に発生する可能性があります。 | すべて削除/最初以外すべて削除 (頂点) |
ルールなし | 8 | 接続性を許可するルールがない状態で、2 つのフィーチャ間に接続性が存在しています | N/A |
不明確な接続性 | 9 | 潜在的な接続に対して複数のルールが使用できる場合に発生します。 ラインのエンドポイントに、複数のデバイスが存在する場合に、このエラーを受け取る可能性もあります。 | N/A |
ジャンクションがない | 10 | 中間デバイスまたはジャンクション フィーチャがない状態で、異なるアセット グループおよびアセット タイプ間で接続されているライン フィーチャのために、無効な接続性が存在しています。 | 作成 |
エッジの接続性ポリシー | 13 | ラインの接続性がエッジの接続性ポリシーに違反している場合に発生します。 たとえば、端点の接続性だけを許可するライン フィーチャの中間部分にポイントまたは別のライン フィーチャが置かれています。 | N/A |
自己交差ライン | 20 | ライン フィーチャがループバックし、それ自体と 2 つの頂点で交差して、オーバーラップする場合に発生する可能性があります。 | すべて削除/最初以外すべて削除 (頂点) |
重複する頂点 | 21 | ライン ネットワーク フィーチャに、同一の X、Y、Z 位置またはネットワーク許容値内に存在する複数の頂点があります。 | すべて削除/最初以外すべて削除 (頂点) |
スタック ポイント | 25 | 複数のポイントのジオメトリが一致しているか、ネットワークの許容値内にあります。 たとえば、供給ポイントと電圧レギュレーターの X、Y、Z 座標が同一です。 | すべて削除/最初以外すべて削除 (頂点) |
無効なターミナル | 36 | ライン フィーチャが無効なターミナルを含んでいます。 ラインの始点ターミナル ID または終点ターミナル ID 属性が、接続されたデバイスのいずれかで有効でない場合に発生します。 | N/A |
中間部分のターミナル デバイス | 38 | 複数ターミナルを持つデバイスは、ライン沿いの中間部分にできません。 ターミナル デバイスがラインの中間部分に描画される場合に発生します。 | N/A |
エラー解決アクションの定義
Error Resolutions テーブルは、[ネットワーク データの解析 (Analyze Network Data)] ツールで検出したエラーに対して行う必要がある是正処置を定義するために使用されます。 自己交差ライン エラーに対処する次のワークフローは、Error Resolutions テーブルとモバイル ジオデータベース内の他のクラスを使用して、ユーティリティ ネットワーク内のエラーを解決するためのアクションを理解および定義する方法を示しています。
- ユーティリティ ネットワークと関連するすべてのクラスをアクティブなマップに追加します。
- Error Summary フィーチャクラス、Error Locations フィーチャクラス、Error Records テーブル、Error Resolutions テーブルを含むグループ レイヤー (.lyrx) を追加します。
デフォルトでは、これは、[ネットワーク データの解析 (Analyze Network Data)] ツールの実行時に [出力名] パラメーターで指定したフォルダーにあります。
- [コンテンツ] ウィンドウで Error Summary フィーチャクラスを右クリックし、[属性] をクリックします。
Error Summary フィーチャクラスの属性テーブルが開きます。
- Error code が Self-intersecting line のレコードを特定し、行を選択します。
Error Summary マルチポイント フィーチャと Error Resolutions テーブル内の関連する行が選択されます。
- Error Summary 属性テーブルで選択した行を右クリックし、[ズーム] をクリックします。
マップがズームされ、エラーに関連付けられているすべてのサマリー レコードが表示されます。
- [コンテンツ] ウィンドウで Error Resolutions テーブルを右クリックして [開く] をクリックします。
Error Resolutions テーブルの属性テーブルが開きます。
- Error Resolutions テーブルで、テーブルをフィルターして [選択レコードを表示] します。
- 選択したレコードで、Error の [コンテキスト] 値を持つレコードを特定し、[アクション] 属性値を確認します。
[ネットワーク データの解析 (Analyze Network Data)] ツールの実行時に [デフォルト解決アクションの設定] パラメーターをオンにした場合、そのフィールドには Delete all but first のデフォルト解決アクションがすでに指定されています。 オフの場合、フィールドのドロップダウンからこの値を選択します。 このアクションは、[エラー解決の適用 (Apply Error Resolutions)] ツールに伝達して、交差位置でラインの最初の頂点を除くすべての頂点を削除します。
- リボンの [編集の管理] グループで、[保存] をクリックして、編集内容を保存します。
解決アクションは、[ネットワーク データの解析 (Analyze Network Data)] ツールで検出したエラーに対して定義されています。 Error Resolutions テーブルを [エラー解決の適用 (Apply Error Resolutions)] ツールの入力として使用して、ユーティリティ ネットワーク データを編集し、エラーを解決することができます。