Migrar a red de servicios (Herramientas de red de servicios)

Resumen

Crea una red de servicios en una geodatabase móvil utilizando los datos, el esquema y los parámetros de mapeo proporcionados para soportar flujos de trabajo básicos de edición y trazado.

Esta herramienta automatiza la creación de una red de servicios utilizando los datos existentes de una organización. Puede convertir datos de red de una red geométrica o datos que no son de red para generar una red de servicios en una geodatabase móvil, conservando al mismo tiempo el esquema de clase de entidad existente.

Uso

En los parámetros Clase de origen y Clases independientes, todos los datos deben ser de una geodatabase.
En los parámetros Incluir clases relacionadas e Incluir adjuntos, todas las relaciones y adjuntos deben utilizar una Clave principal de Id. global. Las relaciones de muchos a muchos y con atributos no se admiten
En los valores del parámetro Redes de dominio, es importante comprender cómo administra las redes la red de servicios en una red de dominio tradicional para especificar correctamente los valores de los parámetros Tipo de controlador de subred y Definición de nivel. Para obtener más información, consulte Tipos de controladores de subred y Definición de nivel.
Para el parámetro Representación cartográfica de la red de servicios, todos los campos de trazado del editor se asignarán para utilizar los campos predeterminados: created_user, created_date, last_edited_user y last_edited_date.
En el valor del parámetro Representación cartográfica de la red de servicios, comprender la clasificación de entidades de red de servicios le ayudará a especificar los diversos valores del parámetro.

Etiqueta	Explicación	Tipo de datos
Carpeta de salida	La ubicación de la carpeta que contendrá la carpeta de salida y la geodatabase móvil especificada en el parámetro Nombre de salida.	Folder
Clase de entidad de territorio de servicio	La clase de entidad de polígono que se utilizará para crear la extensión geográfica de la red de servicios. No es posible crear entidades de red de servicios fuera de esta extensión.	Feature Set
Nombre de la red de servicios (Opcional)	El nombre de la red de servicios. El predeterminado es Network.	String
Nombre de dataset de entidades (Opcional)	El nombre del dataset de entidades que contiene la red de servicios. El predeterminado es UtilityNetwork.	String
Nombre de salida (Opcional)	El nombre de la carpeta de salida y la geodatabase móvil. El predeterminado es MigrationDatabase.	String
Representación cartográfica de la red de servicios (Opcional)	La lista de clases de entidades y los detalles que se utilizarán para generar y asignar los grupos y tipos de activos para la red de servicios en la geodatabase de salida: Columnas de la tabla de valores: 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
Redes de dominio (Opcional)	El nombre y las propiedades de la red o redes de dominios que se definirán en la red de servicios de salida. Columnas de la tabla de valores: 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
Clases independientes (Opcional)	Las clases independientes que no participan en la red de servicios que se copiarán y colocarán en la geodatabase de salida.	Table
Cargar datos (Opcional)	Especifica si los datos de las clases de origen se cargarán en la red de servicios de salida o si solo se actualizarán el esquema de las clases de origen en la red de servicios de salida. Activado—Se cargarán los datos de las clases de origen a la red de servicios de salida. Esta es la opción predeterminada. Desactivado—Solo se actualizará el esquema de las clases de origen en la red de servicios de salida. Los datos no se cargarán.	Boolean
Combinar campos en clases de red de servicios (Opcional)	Especifica si los campos de las clases de origen se fusionarán y combinarán con los campos de la red de servicios de salida. Activado—Los campos de las clases de origen se fusionarán y combinarán con los campos de la red de servicios de salida. Esta es la opción predeterminada. Desactivado—Los campos de las clases de origen no se fusionarán y combinarán con los campos de la red de servicios de salida.	Boolean
Incluir clases relacionadas (Opcional)	Especifica si las clases relacionadas de la fuente y las clases independientes especificadas para la copia se incluirán en la red de servicios de salida. Activado—Las clases relacionadas de la fuente y las clases independientes se incluirán en la geodatabase de salida. Desactivado—Las clases relacionadas de la fuente y las clases independientes no se incluirán en la geodatabase de salida. Esta es la opción predeterminada.	Boolean
Incluir adjuntos (Opcional)	Especifica si se creará una tabla de adjuntos y si los adjuntos de las clases de origen se incluirán en la geodatabase de salida. Activado—Los adjuntos se migrarán a la geodatabase de salida. Desactivado—Los adjuntos no se incluirán en la geodatabase de salida. Esta es la opción predeterminada.	Boolean
Versión de red de servicios	Especifica la versión de la red de servicios que se creará. Actual—Se creará la última versión de la red de servicios compatible con la versión actual de ArcGIS Pro. Esta es la opción predeterminada. 7—Se creará una red de servicios de la versión 7. 6—Se creará una red de servicios de la versión 6. 5—Se creará una red de servicios de la versión 5.	String

Salida derivada

Etiqueta	Explicación	Tipo de datos
Red de servicios de salida	La red de servicios de salida.	Utility Network
Controladores de salida	Los controladores de subred de salida.	File
Archivo de capa de salida	Un archivo de capa de salida que contiene capas de grupos de subtipos para cada clase controlada por la red de servicios.	File
Espacio de trabajo de carga de datos	Un espacio de trabajo de carga de datos que asigna los datos de origen a la red de servicios de salida. Esto puede utilizarse para habilitar la recarga de datos en una red de servicios de salida sin necesidad de crear otra geodatabase móvil.	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)

Nombre	Explicación	Tipo de datos
output_folder	La ubicación de la carpeta que contendrá la carpeta de salida y la geodatabase móvil especificada en el parámetro `output_name`.	Folder
service_territory_feature_class	La clase de entidad de polígono que se utilizará para crear la extensión geográfica de la red de servicios. No es posible crear entidades de red de servicios fuera de esta extensión.	Feature Set
utility_network_name (Opcional)	El nombre de la red de servicios. El predeterminado es Network.	String
dataset_name (Opcional)	El nombre del dataset de entidades que contiene la red de servicios. El predeterminado es UtilityNetwork.	String
output_name (Opcional)	El nombre de la carpeta de salida y la geodatabase móvil. El predeterminado es MigrationDatabase.	String
un_mapping [un_mapping,...] (Opcional)	La lista de clases de entidades y los detalles que se utilizarán para generar y asignar los grupos y tipos de activos para la red de servicios en la geodatabase de salida: Columnas de la tabla de valores: `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,...] (Opcional)	El nombre y las propiedades de la red o redes de dominios que se definirán en la red de servicios de salida. Columnas de la tabla de valores: `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,...] (Opcional)	Las clases independientes que no participan en la red de servicios que se copiarán y colocarán en la geodatabase de salida.	Table
load_data (Opcional)	Especifica si los datos de las clases de origen se cargarán en la red de servicios de salida o si solo se actualizarán el esquema de las clases de origen en la red de servicios de salida. `LOAD`—Se cargarán los datos de las clases de origen a la red de servicios de salida. Esta es la opción predeterminada. `SCHEMA`—Solo se actualizará el esquema de las clases de origen en la red de servicios de salida. Los datos no se cargarán.	Boolean
merge_fields (Opcional)	Especifica si los campos de las clases de origen se fusionarán y combinarán con los campos de la red de servicios de salida. `MERGE`—Los campos de las clases de origen se fusionarán y combinarán con los campos de la red de servicios de salida. Esta es la opción predeterminada. `DO_NOT_MERGE`—Los campos de las clases de origen no se fusionarán y combinarán con los campos de la red de servicios de salida.	Boolean
include_related (Opcional)	Especifica si las clases relacionadas de la fuente y las clases independientes especificadas para la copia se incluirán en la red de servicios de salida. `INCLUDE`—Las clases relacionadas de la fuente y las clases independientes se incluirán en la geodatabase de salida. `DO_NOT_INCLUDE`—Las clases relacionadas de la fuente y las clases independientes no se incluirán en la geodatabase de salida. Esta es la opción predeterminada.	Boolean
include_attachments (Opcional)	Especifica si se creará una tabla de adjuntos y si los adjuntos de las clases de origen se incluirán en la geodatabase de salida. `INCLUDE`—Los adjuntos se migrarán a la geodatabase de salida. `DO_NOT_INCLUDE`—Los adjuntos no se incluirán en la geodatabase de salida. Esta es la opción predeterminada.	Boolean
utility_network_version	Especifica la versión de la red de servicios que se creará. `CURRENT`—Se creará la última versión de la red de servicios compatible con la versión actual de ArcGIS Pro. Esta es la opción predeterminada. `VERSION_7`—Se creará una red de servicios de la versión 7. `VERSION_6`—Se creará una red de servicios de la versión 6. `VERSION_5`—Se creará una red de servicios de la versión 5.	String

Salida derivada

Nombre	Explicación	Tipo de datos
out_utility_network	La red de servicios de salida.	Utility Network
out_controller	Los controladores de subred de salida.	File
out_layer_file	Un archivo de capa de salida que contiene capas de grupos de subtipos para cada clase controlada por la red de servicios.	File
out_loading_workspace	Un espacio de trabajo de carga de datos que asigna los datos de origen a la red de servicios de salida. Esto puede utilizarse para habilitar la recarga de datos en una red de servicios de salida sin necesidad de crear otra geodatabase móvil.	File

Muestra de código

Ejemplo de MigrateToUtilityNetwork (ventana de Python)

Utilice la función MigrateToUtilityNetwork para crear una red de dominio de agua jerárquica basada en el origen a partir de clases de origen en una red geométrica existente en LocalGovernment.gdb. Los tipos de activos se definen para varias clases de entidad, como WaterLine, y los tipos de activos para el grupo de activos wNetworkStructure se especifican como controladores.

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

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

Basic: No
Standard: Sí
Avanzado: Sí

Migrar a red de servicios (Herramientas de red de servicios)

Resumen

Uso

Parámetros

Salida derivada

Entornos

Información de licenciamiento

Temas relacionados