サブネットワークのエクスポート (Export Subnetwork) (ユーティリティーネットワークツール)

サマリー

サブネットワークを、トラディショナルドメインネットワークから .json ファイルにエクスポートします。 Is deleted 属性が True に設定されている限り、このツールを使用して、サブネットワークテーブル内の行を削除することもできます。この属性の True の値は、サブネットワークコントローラーがサブネットワークから削除されていることを示します。

注意:

サブネットワークのエクスポート操作は、エンタープライズジオデータベースでユーティリティーネットワークとともに動作している場合、UtilityNetworkTools ジオプロセシングサービスを使用して非同期に処理されます。 UtilityNetworkTools サービスは、ユーティリティーネットワークを含むフィーチャサービスの System フォルダーで事前構成済みです。このサービスは、タイムアウト設定が長く、ユーティリティーネットワークのジオプロセシングタスク用に予約されています。

サブネットワークのエクスポートの詳細

使用法

サブネットワークをエクスポートするには、クリーンでなければなりません。最初に サブネットワークの更新 ツールを実行してください。
Trace Parameters カテゴリー内のパラメーターは、Python でしか使用できません。
エンタープライズジオデータベースを操作する場合、次の要件が満たされている必要があります。
- 入力ユーティリティーネットワーク パラメーター値は、ユーティリティーネットワークサービスから取得する必要があります。
- ライセンス:
  
  エンタープライズデプロイメントでこのツールを使用するには、アクティブなポータルアカウントは、ArcGIS Advanced Editing ユーザータイプエクステンションのライセンスが付与される必要があります。
エクスポートを承認済みに設定 パラメーターをオンにする場合、次の条件を満たす必要があります:
- ネットワークトポロジーが有効化されている必要があります。
- エンタープライズジオデータベースには、次の追加要件があります。
  - このツールを実行するには、デフォルトバージョンに接続する必要があります。
    - デフォルトバージョンに接続されているその他のセッションでは、有効化操作の実行中に、検証操作も有効化操作も実行できません。
  - 接続された ArcGIS Enterprise ポータルアカウントは、ポータルユーティリティーネットワークの所有者である必要があります。

ラベル	説明	データタイプ
入力ユーティリティーネットワーク	エクスポートするサブネットワークが属しているユーティリティーネットワーク。	Utility Network; Utility Network Layer
ドメインネットワーク	サブネットワークが属しているドメインネットワーク。	String
層	サブネットワークを含む層。	String
サブネットワーク名	層からエクスポートされるサブネットワークの名前。指定したソースに対応する、サブネットワーク情報をエクスポートします。 Subnetworks テーブルの 1 つの層に 10,000 以上のレコードが含まれている場合、パラメーターの選択リストは設定されず、サブネットワーク名に空のフィールドが指定されます。	String
エクスポートを承認済みに設定	Subnetworks テーブル内の対応するコントローラーと SubnetLine フィーチャクラス内のフィーチャの `LASTACKEXPORTSUBNETWORK` 属性を更新するかどうかを指定します。オン—Subnetworks テーブルで、対応するコントローラーの `LASTACKEXPORTSUBNETWORK` 属性を更新します。削除対象の印 (Is deleted = True) をソースにつけた場合、そのソースが Subnetworks テーブルから削除されます。このオプションでは、入力ユーティリティーネットワークがデフォルトバージョンを参照する必要があります。オフ—Subnetworks テーブルで、対応するコントローラーの `LASTACKEXPORTSUBNETWORK` 属性を更新しません。これがデフォルトです。	Boolean
出力 JSON	生成される `.json` ファイルの名前と場所。	File
条件バリア (オプション)	ネットワーク属性との比較またはカテゴリ文字列のチェックに基づいて、フィーチャに対して通過可能性バリア条件を設定します。条件バリアでは、ネットワーク属性またはネットワークカテゴリー、演算子とタイプ、および属性値が使用されます。たとえば、フィーチャが `Open` の特定の値と等しい `Device Status` 属性を持っている場合に、トレースを停止します。フィーチャがこの条件を満たしている場合、トレースが停止します。複数の属性を使用している場合、結合方法パラメーターを使用して、And または Or 条件を定義できます。複数の条件式の使用方法の詳細注意: このパラメーターは Python でのみ使用可能です。値テーブル列: Name—Filter by network attribute name. Operator—Filter by an operator. Is equal to—The attribute is equal to the value. Does not equal—The attribute is not equal to the value. Is greater than—The attribute is greater than the value. Is greater than or equal to—The attribute is greater than or equal to the value. Is less than—The attribute is less than the value. Is less than or equal to—The attribute is less than or equal to the value. Includes the values (bitwise AND equals the value)—A bitwise AND operation in which all bits in the value are present in the attribute (bitwise AND == value). Does not include the values (bitwise AND does not equal the value)—A bitwise AND operation in which not all of the bits in the value are present in the attribute (bitwise AND != value). Includes any (bitwise AND equals True)—A bitwise AND operation in which at least one bit in the value is present in the attribute (bitwise AND == True). Does not include any (bitwise AND equals False)—A bitwise AND operation in which none of the bits in the value are present in the attribute (bitwise AND == False). Type—Filter by a specific type. Specific value—Filter by a specific value or network category. Network attribute—Filter by a network attribute. Value—Filter by a specific value. Combine Using—Use this parameter to combine multiple condition barriers. And—Combine the condition barriers. Or—Use if either condition barrier is met.	Value Table
関数バリア (オプション)	関数に基づいて、フィーチャに対する通過可能性バリアを設定します。関数バリアを使用して、始点からトレースが移動できる距離の制限としてそのような設定を行うか、トレースを停止するための最大値を設定することができます。たとえば、通過した各ラインの長さが、それまでに移動した合計距離に追加されます。移動した全長が指定された値に達した場合、トレースが停止します。注意: このパラメーターは Python でのみ使用可能です。値テーブル列: Function—Filter by a function. Minimum—The minimum of the input values will be identified. Maximum—The maximum of the input values will be identified. Average—The average of the input values will be calculated. Count—The number of features will be identified. Add—The sum of the input values will be calculated. Subtract—The difference in the input values will be calculated. Subnetwork controllers and loops trace types do not support the subtract function. Attribute—Filter by a network attribute. Operator—Filter by an operator. Is equal to—The attribute is equal to the value. Does not equal—The attribute is not equal to the value. Is greater than—The attribute is greater than the value. Is greater than or equal to—The attribute is greater than or equal to the value. Is less than—The attribute is less than the value. Is less than or equal to—The attribute is less than or equal to the value. Includes the values (bitwise AND equals the value)—A bitwise AND operation in which all bits in the value are present in the attribute (bitwise AND == value). Does not include the values (bitwise AND does not equal the value)—A bitwise AND operation in which not all of the bits in the value are present in the attribute (bitwise AND != value). Includes any (bitwise AND equals True)—A bitwise AND operation in which at least one bit in the value is present in the attribute (bitwise AND == True). Does not include any (bitwise AND equals False)—A bitwise AND operation in which none of the bits in the value are present in the attribute (bitwise AND == False). Value—Filter by a specific value. Use Local Values—Boolean value to use local variables instead of a global variable.	Value Table
バリアフィーチャを含める (オプション)	通過可能性バリアフィーチャが、トレース結果に含まれるかどうかを指定します。通過可能性バリアは、サブネットワーク定義内で設定済みである場合でもオプションです。オン—通過可能性バリアをトレース結果に含めます。これがデフォルトです。オフ—通過可能性バリアをトレース結果に含めません。	Boolean
通過可能性の適用 (オプション)	適用される通過可能性のタイプを指定します。通過可能性範囲は、通過可能性がジャンクション、エッジ、またはその両方のいずれに適用されるかを決定します。たとえば、`DEVICESTATUS` が `Open` に設定されている場合にトレースを停止するように条件バリアが定義されているとき、通過可能性範囲がエッジのみに設定されていると、`DEVICESTATUS` はジャンクションにしか適用されないため、トレースでオープンなデバイスが見つかっても、トレースは停止しません。言い換えると、このパラメーターは、ジャンクション、エッジ、またはその両方を無視するかどうかをトレースに指示します。注意: このパラメーターは Python でのみ使用可能です。ジャンクションとエッジの両方—通過可能性は、ジャンクションとエッジの両方に適用されます。これがデフォルトです。ジャンクションのみ—通過可能性は、ジャンクションのみに適用されます。エッジのみ—通過可能性は、エッジのみに適用されます。	String
プロパゲーター (オプション)	反映するネットワーク属性、およびトラディショナルドメインネットワークでトレース中に反映がどのように発生するかを指定します。反映されるクラス属性は、サブネットワーク内の他のフィーチャに広められる、サブネットワークコントローラーの重要な値を示します。たとえば、配電モデルでは、位相値を反映することができます。注意: このパラメーターは Python でのみ使用可能です。値テーブル列: Attribute—Filter by a network attribute. Substitution Attribute—The field used for substitution. Function—Filter by a function. Operator—Filter by an operator. Value—Filter by a specific value.	Value Table
ジオメトリーを含める (オプション)	ジオメトリーを結果に含めるかどうかを指定します。オン—ジオメトリーは、結果に含まれます。オフ—ジオメトリーは、結果に含まれません。これがデフォルトです。	Boolean
結果タイプ (オプション)	返される結果のタイプを指定します。接続性—ジオメトリーの一致または接続性の関連付けを介して接続されるフィーチャが返されます。フィーチャ—フィーチャレベルの情報を返します。格納および付属物の関連付け—格納および構造物付属物の関連付けを介して関連付けられたフィーチャが返されます。関連データ—関連オブジェクトの値が、サブネットワーク内のフィーチャの指定されたリレーションシップクラスとフィールドに返されます。注意: エンタープライズジオデータベースの場合、このオプションは ArcGIS Enterprise 11.5 以降を必要とします。	String
結果のネットワーク属性 (オプション)	結果に含めるネットワーク属性。	String
結果フィールド (オプション)	結果として返されるフィーチャクラスのフィールド。フィールドの値は、サブネットワーク内のフィーチャの結果に返されます。値テーブル列: Feature Class—A feature or object class that participates in the utility network. Field Name—The name of a field from the feature or object class that will have its values returned in the results.	Value Table
ドメインの説明を含める (オプション)	ドメインの説明を出力 `.json` ファイルに含めて、コントローラー、featureElements、接続性、関連付けのドメインマッピングを伝えるかどうかを指定します。オン—ドメインの説明を結果に含めます。オフ—ドメインの説明を結果に含めません。これがデフォルトです。	Boolean
関連レコードフィールド (オプション)	結果として返される関連オブジェクトクラスのフィールド。フィールドの値は、サブネットワーク内のフィーチャの結果に返されます。値テーブル列: Relationship Class—A relationship class that relates to a feature or object class that participates in the utility network. Field Name—The name of a field from the related object class that will have its values returned in the results.	Value Table
フロー方向を含める (オプション)	フロー方向を出力 `.json` ファイルに含めるかどうかを指定します。フロー方向を含めた場合、通過したライン、エッジオブジェクト、ターミナルがあるデバイスの内部エッジ、接続性の関連付けのサブネットワークコントローラーから派生したフロー方向情報が、ファイルに含まれます。このパラメーターは、接続性およびフィーチャ結果タイプオプションにのみ適用されます。注意: エンタープライズジオデータベースの場合、このパラメーターは ArcGIS Enterprise 12.1 以降を必要とします。オン—フロー方向は結果に含まれます。オフ—フロー方向は結果に含まれません。これがデフォルトです。	Boolean
反映される値を含める (オプション)	反映される値を、エクスポートされたサブネットワークの出力 `.json` ファイルに含めるかどうかを指定します。このパラメーターは、フィーチャ結果タイプにのみ適用されます。注意: エンタープライズジオデータベースの場合、このパラメーターは ArcGIS Enterprise 12.1 以降を必要とします。オン—反映される値は結果に含まれます。オフ—反映される値は結果に含まれません。これがデフォルトです。	Boolean

派生した出力

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

arcpy.un.ExportSubnetwork(in_utility_network, domain_network, tier, subnetwork_name, export_acknowledged, out_json_file, {condition_barriers}, {function_barriers}, {include_barriers}, {traversability_scope}, {propagators}, {include_geometry}, {result_types}, {result_network_attributes}, {result_fields}, {include_domain_descriptions}, {related_record_fields}, {include_flow_directions}, {include_propagated_values})

名前	説明	データタイプ
in_utility_network	エクスポートするサブネットワークが属しているユーティリティーネットワーク。	Utility Network; Utility Network Layer
domain_network	サブネットワークが属しているドメインネットワーク。	String
tier	サブネットワークを含む層。	String
subnetwork_name	層からエクスポートされるサブネットワークの名前。指定したソースに対応する、サブネットワーク情報をエクスポートします。	String
export_acknowledged	Subnetworks テーブル内の対応するコントローラーと SubnetLine フィーチャクラス内のフィーチャの `LASTACKEXPORTSUBNETWORK` 属性を更新するかどうかを指定します。 `ACKNOWLEDGE`—Subnetworks テーブルで、対応するコントローラーの `LASTACKEXPORTSUBNETWORK` 属性を更新します。削除対象の印 (Is deleted = True) をソースにつけた場合、そのソースが Subnetworks テーブルから削除されます。このオプションでは、入力ユーティリティーネットワークがデフォルトバージョンを参照する必要があります。 `NO_ACKNOWLEDGE`—Subnetworks テーブルで、対応するコントローラーの `LASTACKEXPORTSUBNETWORK` 属性を更新しません。これがデフォルトです。	Boolean
out_json_file	生成される `.json` ファイルの名前と場所。	File
condition_barriers [[Name, Operator, Type, Value, Combine Using],...] (オプション)	ネットワーク属性との比較またはカテゴリ文字列のチェックに基づいて、フィーチャに対して通過可能性バリア条件を設定します。条件バリアでは、ネットワーク属性またはネットワークカテゴリー、演算子とタイプ、および属性値が使用されます。たとえば、フィーチャが `Open` の特定の値と等しい `Device Status` 属性を持っている場合に、トレースを停止します。フィーチャがこの条件を満たしている場合、トレースが停止します。複数の属性を使用している場合、結合方法パラメーターを使用して、And または Or 条件を定義できます。複数の条件式の使用方法の詳細注意: このパラメーターは Python でのみ使用可能です。値テーブル列: `Name`—Filter by network attribute name. `Operator`—Filter by an operator. `IS_EQUAL_TO`—The attribute is equal to the value. `DOES_NOT_EQUAL`—The attribute is not equal to the value. `IS_GREATER_THAN`—The attribute is greater than the value. `IS_GREATER_THAN_OR_EQUAL_TO`—The attribute is greater than or equal to the value. `IS_LESS_THAN`—The attribute is less than the value. `IS_LESS_THAN_OR_EQUAL_TO`—The attribute is less than or equal to the value. `INCLUDES_THE_VALUES`—A bitwise AND operation in which all bits in the value are present in the attribute (bitwise AND == value). `DOES_NOT_INCLUDE_THE_VALUES`—A bitwise AND operation in which not all of the bits in the value are present in the attribute (bitwise AND != value). `INCLUDES_ANY`—A bitwise AND operation in which at least one bit in the value is present in the attribute (bitwise AND == True). `DOES_NOT_INCLUDE_ANY`—A bitwise AND operation in which none of the bits in the value are present in the attribute (bitwise AND == False). `Type`—Filter by a specific type. `SPECIFIC_VALUE`—Filter by a specific value or network category. `NETWORK_ATTRIBUTE`—Filter by a network attribute. `Value`—Filter by a specific value. `Combine Using`—Use this parameter to combine multiple condition barriers. `AND`—Combine the condition barriers. `OR`—Use if either condition barrier is met.	Value Table
function_barriers [[Function, Attribute, Operator, Value, Use Local Values],...] (オプション)	関数に基づいて、フィーチャに対する通過可能性バリアを設定します。関数バリアを使用して、始点からトレースが移動できる距離の制限としてそのような設定を行うか、トレースを停止するための最大値を設定することができます。たとえば、通過した各ラインの長さが、それまでに移動した合計距離に追加されます。移動した全長が指定された値に達した場合、トレースが停止します。注意: このパラメーターは Python でのみ使用可能です。値テーブル列: `Function`—Filter by a function. `MIN`—The minimum of the input values will be identified. `MAX`—The maximum of the input values will be identified. `AVERAGE`—The average of the input values will be calculated. `COUNT`—The number of features will be identified. `ADD`—The sum of the input values will be calculated. `SUBTRACT`—The difference in the input values will be calculated. Subnetwork controllers and loops trace types do not support the subtract function. `Attribute`—Filter by a network attribute. `Operator`—Filter by an operator. `IS_EQUAL_TO`—The attribute is equal to the value. `DOES_NOT_EQUAL`—The attribute is not equal to the value. `IS_GREATER_THAN`—The attribute is greater than the value. `IS_GREATER_THAN_OR_EQUAL_TO`—The attribute is greater than or equal to the value. `IS_LESS_THAN`—The attribute is less than the value. `IS_LESS_THAN_OR_EQUAL_TO`—The attribute is less than or equal to the value. `INCLUDES_THE_VALUES`—A bitwise AND operation in which all bits in the value are present in the attribute (bitwise AND == value). `DOES_NOT_INCLUDE_THE_VALUES`—A bitwise AND operation in which not all of the bits in the value are present in the attribute (bitwise AND != value). `INCLUDES_ANY`—A bitwise AND operation in which at least one bit in the value is present in the attribute (bitwise AND == True). `DOES_NOT_INCLUDE_ANY`—A bitwise AND operation in which none of the bits in the value are present in the attribute (bitwise AND == False). `Value`—Filter by a specific value. `Use Local Values`—Boolean value to use local variables instead of a global variable.	Value Table
include_barriers (オプション)	通過可能性バリアフィーチャが、トレース結果に含まれるかどうかを指定します。通過可能性バリアは、サブネットワーク定義内で設定済みである場合でもオプションです。 `INCLUDE_BARRIERS`—通過可能性バリアをトレース結果に含めます。これがデフォルトです。 `EXCLUDE_BARRIERS`—通過可能性バリアをトレース結果に含めません。	Boolean
traversability_scope (オプション)	適用される通過可能性のタイプを指定します。通過可能性範囲は、通過可能性がジャンクション、エッジ、またはその両方のいずれに適用されるかを決定します。たとえば、`DEVICESTATUS` が `Open` に設定されている場合にトレースを停止するように条件バリアが定義されているとき、通過可能性範囲がエッジのみに設定されていると、`DEVICESTATUS` はジャンクションにしか適用されないため、トレースでオープンなデバイスが見つかっても、トレースは停止しません。言い換えると、このパラメーターは、ジャンクション、エッジ、またはその両方を無視するかどうかをトレースに指示します。 `BOTH_JUNCTIONS_AND_EDGES`—通過可能性は、ジャンクションとエッジの両方に適用されます。これがデフォルトです。 `JUNCTIONS_ONLY`—通過可能性は、ジャンクションのみに適用されます。 `EDGES_ONLY`—通過可能性は、エッジのみに適用されます。	String
propagators [[Attribute, Substitution Attribute, Function, Operator, Value],...] (オプション)	反映するネットワーク属性、およびトラディショナルドメインネットワークでトレース中に反映がどのように発生するかを指定します。反映されるクラス属性は、サブネットワーク内の他のフィーチャに広められる、サブネットワークコントローラーの重要な値を示します。たとえば、配電モデルでは、位相値を反映することができます。注意: このパラメーターは Python でのみ使用可能です。値テーブル列: `Attribute`—Filter by a network attribute. `Substitution Attribute`—The field used for substitution. `Function`—Filter by a function. `Operator`—Filter by an operator. `Value`—Filter by a specific value.	Value Table
include_geometry (オプション)	ジオメトリーを結果に含めるかどうかを指定します。 `INCLUDE_GEOMETRY`—ジオメトリーは、結果に含まれます。 `EXCLUDE_GEOMETRY`—ジオメトリーは、結果に含まれません。これがデフォルトです。	Boolean
result_types [result_types,...] (オプション)	返される結果のタイプを指定します。 `CONNECTIVITY`—ジオメトリーの一致または接続性の関連付けを介して接続されるフィーチャが返されます。 `FEATURES`—フィーチャレベルの情報を返します。 `CONTAINMENT_AND_ATTACHMENT_ASSOCIATIONS`—格納および構造物付属物の関連付けを介して関連付けられたフィーチャが返されます。 `RELATED_RECORDS`—関連オブジェクトの値が、サブネットワーク内のフィーチャの指定されたリレーションシップクラスとフィールドに返されます。注意: エンタープライズジオデータベースの場合、このオプションは ArcGIS Enterprise 11.5 以降を必要とします。	String
result_network_attributes [result_network_attributes,...] (オプション)	結果に含めるネットワーク属性。	String
result_fields [[Feature Class, Field Name],...] (オプション)	結果として返されるフィーチャクラスのフィールド。フィールドの値は、サブネットワーク内のフィーチャの結果に返されます。値テーブル列: `Feature Class`—A feature or object class that participates in the utility network. `Field Name`—The name of a field from the feature or object class that will have its values returned in the results.	Value Table
include_domain_descriptions (オプション)	ドメインの説明を出力 `.json` ファイルに含めて、コントローラー、featureElements、接続性、関連付けのドメインマッピングを伝えるかどうかを指定します。 `INCLUDE_DOMAIN_DESCRIPTIONS`—ドメインの説明を結果に含めます。 `EXCLUDE_DOMAIN_DESCRIPTIONS`—ドメインの説明を結果に含めません。これがデフォルトです。	Boolean
related_record_fields [[Feature Class, Field Name],...] (オプション)	結果として返される関連オブジェクトクラスのフィールド。フィールドの値は、サブネットワーク内のフィーチャの結果に返されます。値テーブル列: `Relationship Class`—A relationship class that relates to a feature or object class that participates in the utility network. `Field Name`—The name of a field from the related object class that will have its values returned in the results.	Value Table
include_flow_directions (オプション)	フロー方向を出力 `.json` ファイルに含めるかどうかを指定します。フロー方向を含めた場合、通過したライン、エッジオブジェクト、ターミナルがあるデバイスの内部エッジ、接続性の関連付けのサブネットワークコントローラーから派生したフロー方向情報が、ファイルに含まれます。このパラメーターは `CONNECTIVITY` および `FEATURES` の結果タイプオプションにのみ適用されます。注意: エンタープライズジオデータベースの場合、このパラメーターは ArcGIS Enterprise 12.1 以降を必要とします。 `INCLUDE_FLOW_DIRECTIONS`—フロー方向は結果に含まれます。 `EXCLUDE_FLOW_DIRECTIONS`—フロー方向は結果に含まれません。これがデフォルトです。	Boolean
include_propagated_values (オプション)	サブネットワークベースのトレースを実行するときに、反映される値を出力 `.json` ファイルに含めるかどうかを指定します。このパラメーターは、`FEATURES` 結果タイプにのみ適用されます。注意: エンタープライズジオデータベースの場合、このパラメーターは ArcGIS Enterprise 12.1 以降を必要とします。 `INCLUDE_PROPAGATED_VALUES`—反映される値は結果に含まれます。 `EXCLUDE_PROPAGATED_VALUES`—反映される値は結果に含まれません。これがデフォルトです。	Boolean

派生した出力

名前	説明	データタイプ
out_utility_network	更新されたユーティリティーネットワーク。	Utility Network

コードのサンプル

ExportSubnetwork の例 (Python ウィンドウ)

RMT002 というソースに対応するサブネットワーク情報を、ドメインの説明を含めて .json ファイルにエクスポートします。

import arcpy
arcpy.un.ExportSubnetwork("Utility Network", "ElectricDistribution",
                          "Medium Voltage", "RMT002", "ACKNOWLEDGE",
                          "C:\\Temp\\RMT002clean.json", None, None,
                          "INCLUDE_BARRIERS", "BOTH_JUNCTIONS_AND_EDGES",
                          None, "INCLUDE_GEOMETRY", "FEATURES", None, None,
                          "INCLUDE_DOMAIN_DESCRIPTIONS", "INCLUDE_FLOW_DIRECTIONS")

環境

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

ライセンス情報

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

サブネットワークのエクスポート (Export Subnetwork) (ユーティリティー ネットワーク ツール)

サマリー

注意:

使用法

ライセンス:

パラメーター

注意:

注意:

注意:

注意:

注意:

注意:

注意:

派生した出力

環境

ライセンス情報

関連トピック

サブネットワークのエクスポート (Export Subnetwork) (ユーティリティーネットワークツール)