Migrer vers un réseau de distribution (Outils Réseau de distribution)

Résumé

Permet de créer un réseau de distribution dans une géodatabase mobile à l’aide des données, de la structure et des paramètres d’appariement fournis pour prendre en charge les processus de mise à jour et de traçage de base.

Cet outil automatise la création d’un réseau de distribution à l’aide des données existantes d’une organisation. Vous pouvez convertir les données réseau d’un réseau géométrique ou les données non réseau pour générer un réseau de distribution dans une géodatabase mobile tout en conservant la structure de classe d’entités existante.

Utilisation

Pour les paramètres Source Class (Classe source) et Standalone Classes (Classes autonomes), toutes les données doivent provenir d’une géodatabase.
Pour les paramètres Include Related Classes (Inclure les classes associées) et Include Attachments (Inclure les pièces jointes), l’ensemble des relations et des pièces jointes doivent utiliser une clé primaire d’ID global Les relations plusieurs vers plusieurs et relations attribuées ne sont pas prises en charge.
Pour les valeurs de paramètre Domain Networks (Réseaux de domaine), il est essentiel de comprendre comment le réseau de distribution gère les réseaux dans un réseau de domaine traditionnel pour spécifier correctement les valeurs des paramètres Subnetwork Controller Type (Type de contrôleur de sous-réseau) et Tier Definition (Définition de niveau). Pour en savoir plus, reportez-vous aux rubriques Types de contrôleurs de sous-réseaux et Définition de niveau.
Pour le paramètre Utility Network Mapping (Appariement du réseau de distribution), tous les champs de suivi de l’éditeur sont appariés pour utiliser les champs par défaut : created_user, created_date, last_edited_user et last_edited_date.
Pour la valeur du paramètre Utility Network Mapping (Appariement du réseau de distribution), comprendre la classification des entités de réseau de distribution aide à spécifier les diverses valeurs de paramètre.

Etiqueter	Explication	Type de données
Dossier en sortie	Emplacement du dossier contenant le dossier en sortie et la géodatabase mobile spécifiés dans le paramètre Output Name (Nom en sortie).	Folder
Classe d’entités du secteur de service	Classe d’entités surfaciques utilisée pour créer l’extension géographique du réseau de distribution. Les entités du réseau de distribution ne peuvent pas être créées en dehors de cette extension.	Feature Set
Nom du réseau de distribution (Facultatif)	Nom du réseau de distribution. La valeur par défaut est Réseau.	String
Nom du jeu de classes d’entités (Facultatif)	Nom du jeu de données d’entités contenant le réseau de distribution. La valeur par défaut est UtilityNetwork.	String
Nom en sortie (Facultatif)	Nom du dossier en sortie et de la géodatabase mobile. La valeur par défaut est MigrationDatabase.	String
Utility Network Mapping (Appariement du réseau de distribution) (Facultatif)	Liste des classes d’entités et détails permettant de générer et d’apparier les groupes de ressources et types de ressources du réseau de distribution dans la géodatabase en sortie. Colonnes de la table de valeurs : 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 (Classes de réseau) (Facultatif)	Nom et propriétés du [réseau de domaine] (../../help/data/utility-network/traditional-domain-networks.md) ou des réseaux définis dans le réseau de distribution en sortie. Colonnes de la table de valeurs : 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
Classes autonomes (Facultatif)	Classes autonomes qui ne font pas partie du réseau de distribution et qui seront copiées et placées dans la géodatabase en sortie.	Table
Charger des données (Facultatif)	Indique si les données des classes source sont chargées dans le réseau de distribution en sortie ou si seule la structure des classes source est mise à jour dans le réseau de distribution en sortie. Activé—Les données des classes source sont chargées dans le réseau de distribution en sortie. Il s’agit de l’option par défaut. Décoché—Seule la structure des classes source est mise à jour dans le réseau de distribution en sortie. Les données ne seront pas chargées.	Boolean
Merge fields to utility network classes (Fusionner les champs dans les classes du réseau de distribution) (Facultatif)	Indique si les champs des classes source sont fusionnés et combinés avec les champs du réseau de distribution en sortie. Activé—Les champs des classes source sont fusionnés et combinés avec les champs du réseau de distribution en sortie. Il s’agit de l’option par défaut. Décoché—Les champs des classes source ne sont pas fusionnés et combinés avec les champs du réseau de distribution en sortie.	Boolean
Include related classes (Inclure les classes associées) (Facultatif)	Indique si les classes associées des classes source et autonomes spécifiées pour la copie sont incluses dans le réseau de distribution en sortie. Activé—Les classes associées des classes source et autonomes sont incluses dans la géodatabase en sortie. Décoché—Les classes associées des classes source et autonomes ne sont pas incluses dans la géodatabase en sortie. Il s’agit de l’option par défaut.	Boolean
Inclure des pièces jointes (Facultatif)	Indique si une table de pièces jointes est créée et des pièces jointes des classes source sont incluses dans la géodatabase en sortie. Activé—Les pièces jointes sont migrées vers la géodatabase en sortie. Décoché—Les pièces jointes ne sont pas incluses dans la géodatabase en sortie. Il s’agit de l’option par défaut.	Boolean
Version du réseau de distribution	Spécifie la version du réseau de distribution à créer. Actuel—La version la plus récente du réseau de distribution compatible avec la version actuelle d’ArcGIS Pro sera créée. Il s’agit de l’option par défaut. 7—Un réseau de distribution de version 7 est créé. 6—Un réseau de distribution de version 6 est créé. 5—Un réseau de distribution de version 5 est créé.	String

Sortie dérivée

Etiqueter	Explication	Type de données
Réseau de distribution en sortie	Réseau technique en sortie.	Utility Network
Contrôleurs en sortie	Contrôleurs de sous-réseaux en sortie.	File
Fichier de couche en sortie	Fichier de couche en sortie contenant les groupes de couches de sous-type de chaque classe contrôlée par le réseau de distribution.	File
Espace de travail de chargement des données	Espace de travail de chargement des données appariant les données source au réseau de distribution en sortie. Peut être utilisé pour activer le rechargement des données dans le réseau de distribution en sortie sans avoir à créer une autre géodatabase mobile.	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)

Nom	Explication	Type de données
output_folder	Emplacement du dossier contenant le dossier en sortie et la géodatabase mobile spécifiés dans le paramètre `output_name`.	Folder
service_territory_feature_class	Classe d’entités surfaciques utilisée pour créer l’extension géographique du réseau de distribution. Les entités du réseau de distribution ne peuvent pas être créées en dehors de cette extension.	Feature Set
utility_network_name (Facultatif)	Nom du réseau de distribution. La valeur par défaut est Réseau.	String
dataset_name (Facultatif)	Nom du jeu de données d’entités contenant le réseau de distribution. La valeur par défaut est UtilityNetwork.	String
output_name (Facultatif)	Nom du dossier en sortie et de la géodatabase mobile. La valeur par défaut est MigrationDatabase.	String
un_mapping [un_mapping,...] (Facultatif)	Liste des classes d’entités et détails permettant de générer et d’apparier les groupes de ressources et types de ressources du réseau de distribution dans la géodatabase en sortie. Colonnes de la table de valeurs : `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,...] (Facultatif)	Nom et propriétés du [réseau de domaine] (../../help/data/utility-network/traditional-domain-networks.md) ou des réseaux définis dans le réseau de distribution en sortie. Colonnes de la table de valeurs : `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,...] (Facultatif)	Classes autonomes qui ne font pas partie du réseau de distribution et qui seront copiées et placées dans la géodatabase en sortie.	Table
load_data (Facultatif)	Indique si les données des classes source sont chargées dans le réseau de distribution en sortie ou si seule la structure des classes source est mise à jour dans le réseau de distribution en sortie. `LOAD`—Les données des classes source sont chargées dans le réseau de distribution en sortie. Il s’agit de l’option par défaut. `SCHEMA`—Seule la structure des classes source est mise à jour dans le réseau de distribution en sortie. Les données ne seront pas chargées.	Boolean
merge_fields (Facultatif)	Indique si les champs des classes source sont fusionnés et combinés avec les champs du réseau de distribution en sortie. `MERGE`—Les champs des classes source sont fusionnés et combinés avec les champs du réseau de distribution en sortie. Il s’agit de l’option par défaut. `DO_NOT_MERGE`—Les champs des classes source ne sont pas fusionnés et combinés avec les champs du réseau de distribution en sortie.	Boolean
include_related (Facultatif)	Indique si les classes associées des classes source et autonomes spécifiées pour la copie sont incluses dans le réseau de distribution en sortie. `INCLUDE`—Les classes associées des classes source et autonomes sont incluses dans la géodatabase en sortie. `DO_NOT_INCLUDE`—Les classes associées des classes source et autonomes ne sont pas incluses dans la géodatabase en sortie. Il s’agit de l’option par défaut.	Boolean
include_attachments (Facultatif)	Indique si une table de pièces jointes est créée et des pièces jointes des classes source sont incluses dans la géodatabase en sortie. `INCLUDE`—Les pièces jointes sont migrées vers la géodatabase en sortie. `DO_NOT_INCLUDE`—Les pièces jointes ne sont pas incluses dans la géodatabase en sortie. Il s’agit de l’option par défaut.	Boolean
utility_network_version	Spécifie la version du réseau de distribution à créer. `CURRENT`—La version la plus récente du réseau de distribution compatible avec la version actuelle d’ArcGIS Pro sera créée. Il s’agit de l’option par défaut. `VERSION_7`—Un réseau de distribution de version 7 est créé. `VERSION_6`—Un réseau de distribution de version 6 est créé. `VERSION_5`—Un réseau de distribution de version 5 est créé.	String

Sortie dérivée

Nom	Explication	Type de données
out_utility_network	Réseau technique en sortie.	Utility Network
out_controller	Contrôleurs de sous-réseaux en sortie.	File
out_layer_file	Fichier de couche en sortie contenant les groupes de couches de sous-type de chaque classe contrôlée par le réseau de distribution.	File
out_loading_workspace	Espace de travail de chargement des données appariant les données source au réseau de distribution en sortie. Peut être utilisé pour activer le rechargement des données dans le réseau de distribution en sortie sans avoir à créer une autre géodatabase mobile.	File

Exemple de code

Exemple d’utilisation de MigrateToUtilityNetwork (fenêtre Python)

La fonction MigrateToUtilityNetwork permet de créer une classe de réseau de distribution d’eau hiérarchique basée sur une source à partir des classes source d’un réseau géométrique existant dans la géodatabase LocalGovernment.gdb. Des types de ressources sont définis pour diverses classes d’entités, telles que WaterLine (Ligne d’eau), et des types de ressources du groupe de ressources wNetworkStructure sont spécifiés comme contrôleurs.

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")

Environnements

Cet outil n’utilise pas d’environnement de géotraitement.

Informations de licence

Basic: Non
Standard: Oui
Advanced: Oui

Migrer vers un réseau de distribution (Outils Réseau de distribution)

Résumé

Utilisation

Paramètres

Sortie dérivée

Environnements

Informations de licence

Rubriques connexes