Daten in Versorgungsnetz migrieren (Utility Network Tools)

Zusammenfassung

Erstellt anhand der bereitgestellten Daten-, Schema- und Zuordnungsparameter ein Versorgungsnetz in einer Mobile-Geodatabase, um grundlegende Bearbeitungs- und Verfolgungs-Workflows zu unterstützen.

Dieses Werkzeug automatisiert die Erstellung eines Versorgungsnetzes unter Verwendung der vorhandenen Daten einer Organisation. Sie können Netzwerkdaten aus einem geometrischen Netzwerk oder Daten, die keine Netzwerkdaten sind, konvertieren, um ein Versorgungsnetz in einer Mobile-Geodatabase zu generieren und dabei das vorhandene Feature-Class-Schema beibehalten.

Verwendung

Für die Parameter Quellklasse und Standalone-Klassen müssen alle Daten aus einer Geodatabase stammen.
Bei den Parametern Zugehörige Klassen einbeziehen und Anlagen einbeziehen muss für alle Beziehungen und Anlagen der Primärschlüssel "Global-ID" verwendet werden. Viele-zu-viele- und attributierte Beziehungen werden nicht unterstützt.
Für die Werte des Parameters Netzarten müssen Sie wissen, wie Netzwerke in einer herkömmlichen Netzart vom Versorgungsnetz verwaltet werden, damit Sie die Werte der Parameter Teilnetz-Controller-Typ und Ebenendefinition ordnungsgemäß festlegen können. Weitere Informationen finden Sie unter Typen von Teilnetz-Controllern und Ebenendefinition.
Für den Parameter Versorgungsnetz — Kartierung werden alle Editor-Tracking-Felder zugeordnet, um die Standardfelder zu verwenden: created_user, created_date, last_edited_user und last_edited_date.
Für den Wert des Parameters Versorgungsnetz — Kartierung ist es hilfreich, sich mit der Klassifizierung von Versorgungsnetz-Features vertraut zu machen, um die verschiedenen Parameterwerte anzugeben.

Beschriftung	Erläuterung	Datentyp
Ausgabeordner	Der Speicherort des Ordners, der den Ausgabeordner und die Mobile-Geodatabase enthält, die im Parameter Ausgabename angegeben sind.	Folder
Service Territory-Feature-Class	Die Polygon-Feature-Class, die zum Erstellen der geographischen Ausdehnung des Versorgungsnetzes verwendet wird. Versorgungsnetz-Features können nicht außerhalb dieser Ausdehnung erstellt werden.	Feature Set
Name des Versorgungsnetzes (Optional)	Der Name des Versorgungsnetzes. Der Standardname ist "Network".	String
Feature-Dataset-Name (Optional)	Der Name des Feature-Datasets, in dem das Versorgungsnetz enthalten ist. Der Standardname ist "UtilityNetwork".	String
Ausgabename (Optional)	Der Name des Ausgabeordners und der Mobile-Geodatabase. Der Standardname ist "MigrationDatabase".	String
Versorgungsnetz — Kartierung (Optional)	Die Liste der Feature-Classes und die Details, die zum Generieren und Zuordnen der Asset-Gruppen und Asset-Typen für das Versorgungsnetz in der Ausgabe-Geodatabase verwendet werden. Spalten der Wertetabelle: Source Class—The source feature class that will be migrated to a utility network. Target Class—The target domain network class for each Source Class value. Asset Group—The name of the asset group created in the target domain network class. By default, this is assigned the name from Source Class. Asset Type—The subtype or field with a coded value domain that will be used to define the asset types for the asset group created in Target Class. If the data contains subtypes, or another field containing a coded value domain that can be used to meaningfully identify different types of equipment in the class, this can be specified as the field to be used for the asset type in Target Class. When a subtype field is specified for Asset Type, existing codes are maintained if all codes are between 1 and 1023. If a code falls outside this range, all asset types will be created using the subtype descriptions and an automatically incrementing number starting at 1. Is Controller—Specify whether the feature classes can act as sources or sinks in the domain network. This enables features belonging to this asset group to act as subnetwork controllers in the output domain network. Controller—The specified asset group and asset types are assigned the subnetwork controller network category and are eligible to define the origin of a subnetwork. If the source feature class participates in a geometric network, the values from the Ancillary Role field are used to determine which features for the asset group and asset type can serve as subnetwork controllers in the utility network. These features are output to the folder specified for the Output Location parameter in a controllers.csv file for later import into the output utility network. When no Ancillary Role field is present, subnetwork controllers can be set manually for the specified asset types in the output utility network. No Controller—The specified asset group and asset types are not assigned the subnetwork controller network category and are not eligible to participate as subnetwork controllers in the domain network.	Value Table
Netzarten (Optional)	Der Name und die Eigenschaften für die Netzart oder Netzwerke, die im Ausgabe-Versorgungsnetz definiert werden. Spalten der Wertetabelle: Name—The name of the domain network. This describes the resource that the domain network manages and will prefix all network classes added to the domain network. Subnetwork Controller Type—The subnetwork controller type determines how the network resource flows through all subnetworks of a domain network. Specify whether resources originate from a point in the network (source) or flow toward a point in the network (sink). Source—If the domain network is defined with the source subnetwork controller type, a resource can only flow away from or exit subnetwork controllers, not toward or into them. Sink—If the domain network is defined with a sink subnetwork controller type, a resource can only flow toward and enter subnetwork controllers, not away from or exit them. Tier Definition—Specify the tier definition type for the domain network, either partitioned or hierarchical. A tier definition denotes the organization of the tiers relative to the rest of the network. Partitioned—Features in a domain network with a partitioned tier definition are independent and can only exist in one tier. Features can exist in one or multiple subnetworks. The relationship between tiers in partitioned domain networks is ordered and linear. For example, a transmission tier delivers the resource over a long distance, and a distribution tier serves the resource to the customer. Hierarchical—Features in a domain network with a hierarchical tier definition can be modeled in multiple types of subnetworks. For example, pressure zones and isolation zones can be defined in two tiers within a tier group. A gas or water feature can be part of both the pressure and isolation tiers.	Value Table
Standalone-Klassen (Optional)	Die Standalone-Klassen, die nicht am Versorgungsnetz beteiligt sind, das kopiert und in die Ausgabe-Geodatabase geschrieben wird.	Table
Laden von Daten (Optional)	Gibt an, ob Daten aus den Quellklassen in das Ausgabe-Versorgungsnetz geladen werden oder ob nur das Schema aus den Quellklassen im Ausgabe-Versorgungsnetz aktualisiert wird. Aktiviert—Daten aus den Quellklassen werden in das Ausgabe-Versorgungsnetz geladen. Dies ist die Standardeinstellung. Deaktiviert—Nur das Schema aus den Quellklassen wird im Ausgabe-Versorgungsnetz aktualisiert. Daten werden nicht geladen.	Boolean
Felder mit Versorgungsnetzklassen zusammenführen (Optional)	Gibt an, ob Felder aus den Quellklassen zusammengeführt und mit den Feldern im Ausgabe-Versorgungsnetz kombiniert werden. Aktiviert—Felder aus den Quellklassen werden zusammengeführt und mit den Feldern im Ausgabe-Versorgungsnetz kombiniert. Dies ist die Standardeinstellung. Deaktiviert—Felder aus den Quellklassen werden nicht zusammengeführt und mit den Feldern im Ausgabe-Versorgungsnetz kombiniert.	Boolean
Zugehörige Klassen einbeziehen (Optional)	Gibt an, ob zugehörige Klassen aus den Quellklassen und eigenständigen Klassen, die zum Kopieren angegeben wurden, in das Ausgabe-Versorgungsnetz aufgenommen werden. Aktiviert—Zugehörige Klassen aus den Quellklassen und eigenständigen Klassen werden in die Ausgabe-Geodatabase aufgenommen. Deaktiviert—Zugehörige Klassen aus den Quellklassen und den eigenständigen Klassen werden nicht in die Ausgabe-Geodatabase aufgenommen. Dies ist die Standardeinstellung.	Boolean
Einbeziehen von Anlagen (Optional)	Gibt an, ob eine Anlagentabelle erstellt wird und Anlagen aus den Quellklassen in die Ausgabe-Geodatabase aufgenommen werden. Aktiviert—Anlagen werden zur Ausgabe-Geodatabase migriert. Deaktiviert—Anlagen werden nicht in die Ausgabe-Geodatabase aufgenommen. Dies ist die Standardeinstellung.	Boolean
Utility Network-Version	Gibt die Version des Versorgungsnetzes an, die erstellt wird. Aktuell—Es wird die letzte Version des Versorgungsnetzes erstellt, die kompatibel ist mit den aktuellen Versionen von ArcGIS Pro. Dies ist die Standardeinstellung. 7—Es wird ein Versorgungsnetz der Version 7 erstellt. 6—Es wird ein Versorgungsnetz der Version 6 erstellt. 5—Es wird ein Versorgungsnetz der Version 5 erstellt.	String

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Ausgabe-Versorgungsnetz	Das Ausgabe-Versorgungsnetz.	Utility Network
Ausgabe-Controller	Die Ausgabe-Teilnetz-Controller.	File
Ausgabe-Layer-Datei	Eine Ausgabe-Layer-Datei mit Subtype-Gruppen-Layern für jede vom Versorgungsnetz gesteuerte Klasse.	File
Workspace zum Laden von Daten	Ein Workspace zum Laden von Daten, der die Quelldaten dem Ausgabe-Versorgungsnetz zuordnet. Dieser kann verwendet werden, um das erneute Laden von Daten in ein Ausgabe-Versorgungsnetz zu ermöglichen, ohne dass eine weitere Mobile-Geodatabase erstellt werden muss.	File

arcpy.un.MigrateToUtilityNetwork(output_folder, service_territory_feature_class, {utility_network_name}, {dataset_name}, {output_name}, {un_mapping}, {domain_networks}, {in_standalone_classes}, {load_data}, {merge_fields}, {include_related}, {include_attachments}, utility_network_version)

Name	Erläuterung	Datentyp
output_folder	Der Speicherort des Ordners, der den Ausgabeordner und die Mobile-Geodatabase enthält, die im Parameter `output_name` angegeben sind.	Folder
service_territory_feature_class	Die Polygon-Feature-Class, die zum Erstellen der geographischen Ausdehnung des Versorgungsnetzes verwendet wird. Versorgungsnetz-Features können nicht außerhalb dieser Ausdehnung erstellt werden.	Feature Set
utility_network_name (Optional)	Der Name des Versorgungsnetzes. Der Standardname ist "Network".	String
dataset_name (Optional)	Der Name des Feature-Datasets, in dem das Versorgungsnetz enthalten ist. Der Standardname ist "UtilityNetwork".	String
output_name (Optional)	Der Name des Ausgabeordners und der Mobile-Geodatabase. Der Standardname ist "MigrationDatabase".	String
un_mapping [un_mapping,...] (Optional)	Die Liste der Feature-Classes und die Details, die zum Generieren und Zuordnen der Asset-Gruppen und Asset-Typen für das Versorgungsnetz in der Ausgabe-Geodatabase verwendet werden. Spalten der Wertetabelle: `Source Class`—The source feature class that will be migrated to a utility network. `Target Class`—The target domain network class for each Source Class value. `Asset Group`—The name of the asset group created in the target domain network class. By default, this is assigned the name from Source Class. `Asset Type`—The subtype or field with a coded value domain that will be used to define the asset types for the asset group created in Target Class. If the data contains subtypes, or another field containing a coded value domain that can be used to meaningfully identify different types of equipment in the class, this can be specified as the field to be used for the asset type in Target Class. When a subtype field is specified for Asset Type, existing codes are maintained if all codes are between 1 and 1023. If a code falls outside this range, all asset types will be created using the subtype descriptions and an automatically incrementing number starting at 1. `Is Controller`—Specify whether the feature classes can act as sources or sinks in the domain network. This enables features belonging to this asset group to act as subnetwork controllers in the output domain network. `CONTROLLER`—The specified asset group and asset types are assigned the subnetwork controller network category and are eligible to define the origin of a subnetwork. If the source feature class participates in a geometric network, the values from the Ancillary Role field are used to determine which features for the asset group and asset type can serve as subnetwork controllers in the utility network. These features are output to the folder specified for the Output Location parameter in a controllers.csv file for later import into the output utility network. When no Ancillary Role field is present, subnetwork controllers can be set manually for the specified asset types in the output utility network. `NO_CONTROLLER`—The specified asset group and asset types are not assigned the subnetwork controller network category and are not eligible to participate as subnetwork controllers in the domain network.	Value Table
domain_networks [domain_networks,...] (Optional)	Der Name und die Eigenschaften für die Netzart oder Netzwerke, die im Ausgabe-Versorgungsnetz definiert werden. Spalten der Wertetabelle: `Name`—The name of the domain network. This describes the resource that the domain network manages and will prefix all network classes added to the domain network. `Subnetwork Controller Type`—The subnetwork controller type determines how the network resource flows through all subnetworks of a domain network. Specify whether resources originate from a point in the network (source) or flow toward a point in the network (sink). `SOURCE`—If the domain network is defined with the source subnetwork controller type, a resource can only flow away from or exit subnetwork controllers, not toward or into them. `SINK`—If the domain network is defined with a sink subnetwork controller type, a resource can only flow toward and enter subnetwork controllers, not away from or exit them. `Tier Definition`—Specify the tier definition type for the domain network, either partitioned or hierarchical. A tier definition denotes the organization of the tiers relative to the rest of the network. `PARTITIONED`—Features in a domain network with a partitioned tier definition are independent and can only exist in one tier. Features can exist in one or multiple subnetworks. The relationship between tiers in partitioned domain networks is ordered and linear. For example, a transmission tier delivers the resource over a long distance, and a distribution tier serves the resource to the customer. `HIERARCHICAL`—Features in a domain network with a hierarchical tier definition can be modeled in multiple types of subnetworks. For example, pressure zones and isolation zones can be defined in two tiers within a tier group. A gas or water feature can be part of both the pressure and isolation tiers.	Value Table
in_standalone_classes [in_standalone_classes,...] (Optional)	Die Standalone-Klassen, die nicht am Versorgungsnetz beteiligt sind, das kopiert und in die Ausgabe-Geodatabase geschrieben wird.	Table
load_data (Optional)	Gibt an, ob Daten aus den Quellklassen in das Ausgabe-Versorgungsnetz geladen werden oder ob nur das Schema aus den Quellklassen im Ausgabe-Versorgungsnetz aktualisiert wird. `LOAD`—Daten aus den Quellklassen werden in das Ausgabe-Versorgungsnetz geladen. Dies ist die Standardeinstellung. `SCHEMA`—Nur das Schema aus den Quellklassen wird im Ausgabe-Versorgungsnetz aktualisiert. Daten werden nicht geladen.	Boolean
merge_fields (Optional)	Gibt an, ob Felder aus den Quellklassen zusammengeführt und mit den Feldern im Ausgabe-Versorgungsnetz kombiniert werden. `MERGE`—Felder aus den Quellklassen werden zusammengeführt und mit den Feldern im Ausgabe-Versorgungsnetz kombiniert. Dies ist die Standardeinstellung. `DO_NOT_MERGE`—Felder aus den Quellklassen werden nicht zusammengeführt und mit den Feldern im Ausgabe-Versorgungsnetz kombiniert.	Boolean
include_related (Optional)	Gibt an, ob zugehörige Klassen aus den Quellklassen und eigenständigen Klassen, die zum Kopieren angegeben wurden, in das Ausgabe-Versorgungsnetz aufgenommen werden. `INCLUDE`—Zugehörige Klassen aus den Quellklassen und eigenständigen Klassen werden in die Ausgabe-Geodatabase aufgenommen. `DO_NOT_INCLUDE`—Zugehörige Klassen aus den Quellklassen und den eigenständigen Klassen werden nicht in die Ausgabe-Geodatabase aufgenommen. Dies ist die Standardeinstellung.	Boolean
include_attachments (Optional)	Gibt an, ob eine Anlagentabelle erstellt wird und Anlagen aus den Quellklassen in die Ausgabe-Geodatabase aufgenommen werden. `INCLUDE`—Anlagen werden zur Ausgabe-Geodatabase migriert. `DO_NOT_INCLUDE`—Anlagen werden nicht in die Ausgabe-Geodatabase aufgenommen. Dies ist die Standardeinstellung.	Boolean
utility_network_version	Gibt die Version des Versorgungsnetzes an, die erstellt wird. `CURRENT`—Es wird die letzte Version des Versorgungsnetzes erstellt, die kompatibel ist mit den aktuellen Versionen von ArcGIS Pro. Dies ist die Standardeinstellung. `VERSION_7`—Es wird ein Versorgungsnetz der Version 7 erstellt. `VERSION_6`—Es wird ein Versorgungsnetz der Version 6 erstellt. `VERSION_5`—Es wird ein Versorgungsnetz der Version 5 erstellt.	String

Abgeleitete Ausgabe

Name	Erläuterung	Datentyp
out_utility_network	Das Ausgabe-Versorgungsnetz.	Utility Network
out_controller	Die Ausgabe-Teilnetz-Controller.	File
out_layer_file	Eine Ausgabe-Layer-Datei mit Subtype-Gruppen-Layern für jede vom Versorgungsnetz gesteuerte Klasse.	File
out_loading_workspace	Ein Workspace zum Laden von Daten, der die Quelldaten dem Ausgabe-Versorgungsnetz zuordnet. Dieser kann verwendet werden, um das erneute Laden von Daten in ein Ausgabe-Versorgungsnetz zu ermöglichen, ohne dass eine weitere Mobile-Geodatabase erstellt werden muss.	File

Codebeispiel

'MigrateToUtilityNetwork': Beispiel (Python-Fenster)

Verwenden Sie die Funktion MigrateToUtilityNetwork, um eine quellenbasierte hierarchische Netzart des Typs "Wasser" aus Quellklassen in einem vorhandenen geometrischen Netzwerk in der LocalGovernment.gdb zu erstellen. Für verschiedene Feature-Classes, wie z. B. WaterLine, sind Asset-Typen definiert und Asset-Typen für die Asset-Gruppe "wNetworkStructure" sind als Controller angegeben.

arcpy.un.MigrateToUtilityNetwork(r"C:\temp", r"C:\temp\LocalGovernment.gdb\wServiceBoundary", "Network", "UtilityNetwork", "MigrationDatabase", r"C:\temp\LocalGovernment.gdb\WaterDistribution\wConstructionLine StructureLine wConstructionLine # #;C:\temp\LocalGovernment.gdb\WaterDistribution\wControlValve WaterDevice wControlValve # #;C:\temp\LocalGovernment.gdb\WaterDistribution\wCasing StructureLine wCasing # #;C:\temp\LocalGovernment.gdb\WaterDistribution\wCurbStopValve WaterDevice wCurbStopValve # #;C:\temp\LocalGovernment.gdb\WaterDistribution\wFitting WaterDevice wFitting FITTINGTYPE #;C:\temp\LocalGovernment.gdb\WaterDistribution\wHydrant WaterDevice wHydrant # #;C:\temp\LocalGovernment.gdb\WaterDistribution\wLateralLine WaterLine wLateralLine LINETYPE #;C:\temp\LocalGovernment.gdb\WaterDistribution\wMain WaterLine wMain # #;C:\temp\LocalGovernment.gdb\WaterDistribution\wNetworkStructure WaterDevice wNetworkStructure STRUCTTYPE true;C:\temp\LocalGovernment.gdb\WaterDistribution\wPump WaterDevice wPump # #;C:\temp\LocalGovernment.gdb\WaterDistribution\wSamplingStation WaterJunction wSamplingStation # #;C:\temp\LocalGovernment.gdb\WaterDistribution\wServiceConnection WaterDevice wServiceConnection SERVICETYPE #;C:\temp\LocalGovernment.gdb\WaterDistribution\wStructure StructureBoundary wStructure STRUCTTYPE #;C:\temp\LocalGovernment.gdb\WaterDistribution\wSystemValve WaterDevice wSystemValve # #;C:\temp\LocalGovernment.gdb\WaterDistribution\wTestStation WaterDevice wTestStation # #", "Water SOURCE HIERARCHICAL", r"C:\temp\LocalGovernment.gdb\WaterDistribution\wAbandonedLine;C:\temp\LocalGovernment.gdb\WaterDistribution\wAbandonedPoint;C:\temp\LocalGovernment.gdb\WaterDistribution\wConstructionLine;C:\temp\LocalGovernment.gdb\WaterDistribution\wElevationPt;C:\temp\LocalGovernment.gdb\WaterDistribution\wPressureZone", "LOAD", "MERGE", "INCLUDE", "DO_NOT_INCLUDE", "VERSION_7")

Umgebungen

Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.

Lizenzierungsinformationen

Basic: Nein
Standard: Ja
Advanced: Ja

Daten in Versorgungsnetz migrieren (Utility Network Tools)

Zusammenfassung

Verwendung

Parameter

Abgeleitete Ausgabe

Umgebungen

Lizenzierungsinformationen

Verwandte Themen