Migrar a Utility Network (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

Parámetros

EtiquetaExplicaciónTipo 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:

  • Clase de origen: la clase de entidad de origen que se van a migrar a una red de servicio.
  • Clase de destino: la clase de red de dominio de destino para cada valor de Clase de origen.
    • Las clases de red de dominio contienen las entidades de red por las que fluye el recurso suministrado, mientras que las clases de red de dominio de estructura admiten estas entidades.
    • Las entidades de punto suelen ser dispositivos o cruces.
    • Las entidades de línea son líneas de red de dominio o estructura.
    • Las entidades poligonales pueden asignarse como límites de estructura.
  • Grupo de activos: el nombre del grupo de activos creado en la clase de red de dominio de destino. De forma predeterminada, se le asigna el nombre de la Clase de origen.
  • Tipo de activo: opcional. El subtipo o campo con un dominio de valor codificado que se utilizará para definir los tipos de activos para el grupo de activos creado en Clase de destino. Si los datos contienen subtipos u otro campo que contenga un dominio de valores codificados que pueda utilizarse para identificar de forma significativa otros tipos de equipos de la clase, este puede especificarse como el campo que se utilizará para el tipo de activo en Clase de destino. Cuando se especifica un campo de subtipo para Tipo de activo, se mantienen los códigos existentes si todos los códigos están entre 1 y 1023. Si un código queda fuera de este rango, todos los tipos de activos se crearán utilizando las descripciones de subtipo y un número que se incrementa automáticamente a partir de 1. Las opciones de Tipo de activo son las siguientes:
    • En blanco: el nombre de Grupo de activos se utiliza para crear un solo tipo de activos. Esta es la opción predeterminada.
    • Especifique el subtipo o dominio de valor codificado definido en un campo: los subtipos o valores codificados del campo se utilizan para definir los tipos de activos.
      Nota:
      Si la clase tiene subtipos y se selecciona un campo que no es subtipo, el dominio se debe definir en el campo. El dominio de valor codificado definido en los campos de subtipo no se utiliza.
  • Es controlador: especifique si las clases de entidades pueden actuar como fuentes o sumideros en la red de dominio. Esto permite que las entidades que pertenecen a este grupo de activos actúen como controladores de subred en la red de dominio de salida. Las opciones de Es controlador son las siguientes:
    • Activado: al grupo de activos y los tipos de activos especificados se les asigna la categoría de red controlador de subred y son aptos para definir el origen de una subred. Si la clase de entidad de origen participa en una red geométrica, los valores del campo Ancillary Role se utilizan para determinar qué entidades del grupo de activos y tipo de activo pueden servir como controladores de subred en la red de servicios. Estas entidades se envían a la carpeta especificada para el parámetro Ubicación de salida en un archivo controllers.csv para su posterior importación a la red de servicios de salida. Si no hay ningún campo Ancillary Role presente, los controladores de subred se pueden configurar manualmente para los tipos de activo especificados en la red de servicios de salida.
    • Desactivado: al grupo de activos y a los tipos de activos especificados no se les ha asignado la categoría de red de controlador de subred y no pueden participar como controladores de subred en la red de dominio.

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. Las propiedades de la red de dominios son las siguientes:

  • Nombre: el nombre de la red de dominio. Describe el recurso que administra la red de dominio y será el prefijo de todas las clases de red agregadas a la red de dominio.
  • Tipo de controlador de subred: el tipo de controlador de subred determina cómo fluye el recurso de red por todas las subredes de una red de dominio. Especifique si los recursos se originan en un punto de la red (fuente) o fluyen hacia un punto de la red (sumidero).
    • Fuente: si la red de dominio se define con el tipo de controlador de subred de origen, un recurso solo podrá fluir desde los controladores de subred o salir de ellos, no hacia ellos ni entrar en ellos.
    • Sumidero: si la red de dominio se define con un tipo de controlador de subred de sumidero, un recurso solo podrá fluir hacia los controladores de subred o entrar en ellos, no desde ellos ni salir de ellos.
  • Definición de nivel: especifique el tipo de definición de nivel para la red de dominio, ya sea dividida o jerárquica. Una definición de nivel indica la organización de niveles en relación con el resto de la red.
    • Dividida: las entidades de una red de dominio con una definición de niveles divididos son independientes y solo pueden existir en un nivel. Las entidades pueden existir en una o varias subredes. La relación entre niveles en redes de dominio divididas es ordenada y lineal. Por ejemplo, un nivel de transmisión proporciona el recurso en largas distancias y un nivel de distribución sirve el recurso al cliente.
    • Jerárquica: las entidades en una red de dominio con una definición de niveles jerárquicos se pueden modelar en varios tipos de subredes. Por ejemplo, las zonas de presión y las zonas de aislamiento se pueden definir en dos niveles dentro de un grupo de nivel. Una entidad de gas o agua puede formar parte tanto de niveles de presión como de aislamiento.

Sugerencia:

La red de servicios y las redes de dominio creadas con esta herramienta son exclusivas de la base de datos y no heredan configuraciones de las soluciones de Utility Network Foundation. Consulte las directrices que figuran a continuación para comprender cómo configuran normalmente sus redes de dominios otros sectores:

  • Comunicación: las redes de comunicación se basan en la fuente y suelen utilizar una definición de niveles particionada. Las subredes se utilizan para modelar el circuito entre los puertos de dos equipos y cualquier puerto de un dispositivo activo puede actuar como controlador de subred.
  • Eléctricas: las redes eléctricas se basan en la fuente con una definición de niveles particionada. Las redes de distribución utilizan disyuntores como controladores de subred para cada alimentador. Los transformadores de potencia dentro de una subestación también se consideran controladores de subred para todos los equipos a ese voltaje dentro de la subestación. Las redes de transmisión utilizan el equipo de subestación en cada extremo de una línea de transmisión como controladores de subred para administrar el rastreo de la línea de transmisión.
  • Gas: las redes de gas se basan en la fuente y utilizan una definición de niveles jerárquica. Todas las fuentes de gas de un área común, como los medidores de transferencia de custodia y las interconexiones, se utilizan como orígenes.
  • Aguas pluviales: las redes de aguas pluviales se basan en el sumidero y utilizan una definición de niveles jerárquica. Las desembocaduras actúan como controladores de subredes para un área de cuenca hidrográfica.
  • Aguas residuales: las redes de aguas residuales se basan en el sumidero y utilizan una definición de niveles jerárquica. La planta de tratamiento de aguas residuales, u otros sumideros, dentro de la red actúan como controladores de subred para el área de alcantarillado.
  • Aguas: las redes de aguas se basan en la fuente y utilizan una definición de niveles jerárquica. Las fuentes de agua, como plantas de tratamiento de agua, pozos, embalses y sistemas de interconexión, se utilizan como orígenes para un sistema de agua.

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 fuente y autónomas se cargarán en la red de servicios de salida y en las clases autónomas o si solo se actualizará el esquema.

  • Activado: se cargarán los datos de las clases de origen a la red de servicios de salida y las clases independientes. Esta es la opción predeterminada.
  • Desactivado: la geodatabase será de solo esquema. 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 red de servicios de salida.
  • Desactivado: las clases relacionadas de la fuente y las clases independientes no se incluirán en la red de servicios 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á.

  • ActualSe creará la versión más reciente de la red de servicios compatible con la versión actual de ArcGIS Pro. Esta es la opción predeterminada.
  • 7Se creará una red de servicios de la versión 7.
  • 6Se creará una red de servicios de la versión 6.
  • 5Se creará una red de servicios de la versión 5.
String

Salida derivada

EtiquetaExplicaciónTipo 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)
NombreExplicaciónTipo 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:

  • Source Class: la clase de entidad de origen que se van a migrar a una red de servicio.
  • Target Class: la clase de red de dominio de destino para cada valor de Source Class. Esto viene determinado por el tipo de geometría de las entidades en el origen.
    • Las clases de red de dominio contienen las entidades de red por las que fluye el recurso suministrado, mientras que las clases de red de dominio de estructura admiten estas entidades.
    • Las entidades de punto suelen ser dispositivos o cruces.
    • Las entidades de línea son líneas de red de dominio o estructura.
    • Las entidades poligonales pueden asignarse como límites de estructura.
  • Asset Group: el nombre del grupo de activos creado en la clase de red de dominio de destino. De forma predeterminada, se le asigna el nombre de la Source Class.
  • Asset Type: opcional. El subtipo o campo que contiene un dominio de valor codificado que se utilizará para definir los tipos de activos para el grupo de activos creado en Target Class. Si los datos contienen subtipos u otro campo que contenga un dominio de valores codificados que pueda utilizarse para identificar de forma significativa otros tipos de equipos de la clase, este puede especificarse como el campo que se utilizará para el tipo de activo en Target Class. Para el dominio de valor codificado, se conservan los códigos del 1 al 1023 si se utilizan subtipos para definir los tipos de activos y todos los códigos están en el rango. Las opciones de Asset Type son las siguientes:
    • Blank: el nombre de Asset Group se utiliza para el valor Asset Type. Esta es la opción predeterminada.
    • Field: los subtipos o el dominio de valor codificado definido en el campo se utilizan para generar el valor Asset Type. Los códigos del dominio no se conservan. Si el campo no tiene un dominio a nivel de campo o subtipo, el nombre de Asset Group se utiliza para el valor Asset Type.
  • Is Controller: especifica si las clases de entidades pueden actuar como fuentes o sumideros en la red de dominio. Esto permite que las entidades que pertenecen a este grupo de activos actúen como controladores de subred en la red de dominio de salida. Las opciones de Is Controller son las siguientes:
    • CONTROLLER: al grupo de activos y los tipos de activos especificados se les asigna la categoría de red controlador de subred y son aptos para definir el origen de una subred. Si la clase de entidad de origen participa en una red geométrica, los valores del campo Ancillary Role se utilizan para determinar qué entidades del grupo de activos y tipo de activo pueden servir como controladores de subred en la red de servicios. Estas entidades se envían a la carpeta especificada para el parámetro Output Location en un archivo controllers.csv para su posterior importación a la red de servicios de salida. Si no hay ningún campo Ancillary Role presente, los controladores de subred se pueden configurar manualmente para los tipos de activo especificados en la red de servicios de salida.
    • NO_CONTROLLER: al grupo de activos y a los tipos de activos especificados no se les ha asignado la categoría de red de controlador de subred y no pueden participar como controladores de subred en la red de dominio.

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. Las propiedades de la red de dominios son las siguientes:

  • Name: el nombre de la red de dominio. Describe el recurso que administra la red de dominio y será el prefijo de todas las clases de red agregadas a la red de dominio.
  • Subnetwork Controller Type: el tipo de controlador de subred determina cómo fluye el recurso de red por todas las subredes de una red de dominio. Especifique si los recursos se originan en un punto de la red (fuente) o fluyen hacia un punto de la red (sumidero).
    • SOURCE: si la red de dominio se define con el tipo de controlador de subred de origen, un recurso solo podrá fluir desde los controladores de subred o salir de ellos, no hacia ellos ni entrar en ellos.
    • SINK: si la red de dominio se define con un tipo de controlador de subred de sumidero, un recurso solo podrá fluir hacia los controladores de subred o entrar en ellos, no desde ellos ni salir de ellos.
  • Tier Definition: especifique el tipo de definición de nivel para la red de dominio, ya sea dividida o jerárquica. Una definición de nivel indica la organización de niveles en relación con el resto de la red.
    • PARTITIONED: las entidades en una red de dominio con una definición de niveles divididos son independientes y solo pueden existir en un nivel. Las entidades pueden existir en una o varias subredes. La relación entre niveles en redes de dominio divididas es ordenada y lineal. Por ejemplo, un nivel de transmisión proporciona el recurso en largas distancias y un nivel de distribución sirve el recurso al cliente.
    • HIERARCHICAL: las entidades en una red de dominio con una definición de niveles jerárquicos se pueden modelar en varios tipos de subredes. Por ejemplo, las zonas de presión y las zonas de aislamiento se pueden definir en dos niveles dentro de un grupo de nivel. Una entidad de gas o agua puede formar parte tanto de niveles de presión como de aislamiento.

Sugerencia:

La red de servicios y las redes de dominio creadas con esta herramienta son exclusivas de la base de datos y no heredan configuraciones de las soluciones de Utility Network Foundation. Consulte las directrices que figuran a continuación para comprender cómo configuran normalmente sus redes de dominios otros sectores:

  • Comunicación: las redes de comunicación se basan en la fuente y suelen utilizar una definición de niveles particionada. Las subredes se utilizan para modelar el circuito entre los puertos de dos equipos y cualquier puerto de un dispositivo activo puede actuar como controlador de subred.
  • Eléctricas: las redes eléctricas se basan en la fuente con una definición de niveles particionada. Las redes de distribución utilizan disyuntores como controladores de subred para cada alimentador. Los transformadores de potencia dentro de una subestación también se consideran controladores de subred para todos los equipos a ese voltaje dentro de la subestación. Las redes de transmisión utilizan el equipo de subestación en cada extremo de una línea de transmisión como controladores de subred para administrar el rastreo de la línea de transmisión.
  • Gas: las redes de gas se basan en la fuente y utilizan una definición de niveles jerárquica. Todas las fuentes de gas de un área común, como los medidores de transferencia de custodia y las interconexiones, se utilizan como orígenes.
  • Aguas pluviales: las redes de aguas pluviales se basan en el sumidero y utilizan una definición de niveles jerárquica. Las desembocaduras actúan como controladores de subredes para un área de cuenca hidrográfica.
  • Aguas residuales: las redes de aguas residuales se basan en el sumidero y utilizan una definición de niveles jerárquica. La planta de tratamiento de aguas residuales, u otros sumideros, dentro de la red actúan como controladores de subred para el área de alcantarillado.
  • Aguas: las redes de aguas se basan en la fuente y utilizan una definición de niveles jerárquica. Las fuentes de agua, como plantas de tratamiento de agua, pozos, embalses y sistemas de interconexión, se utilizan como orígenes para un sistema de agua.

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.

  • LOADSe cargarán los datos de las clases de origen a la red de servicios de salida. Esta es la opción predeterminada.
  • SCHEMASolo 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.

  • MERGELos 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_MERGELos 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.

  • DO_NOT_INCLUDELas clases relacionadas de la fuente y las clases independientes no se incluirán en la geodatabase de salida. Esta es la opción predeterminada.
  • INCLUDELas clases relacionadas de la fuente y las clases independientes se incluirán en la geodatabase de salida.
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.

  • DO_NOT_INCLUDELos adjuntos no se incluirán en la geodatabase de salida. Esta es la opción predeterminada.
  • INCLUDELos adjuntos se migrarán a la geodatabase de salida.
Boolean
utility_network_version

Especifica la versión de la red de servicios que se creará.

  • CURRENTSe creará la versión más reciente de la red de servicios compatible con la versión actual de ArcGIS Pro. Esta es la opción predeterminada.
  • VERSION_7Se creará una red de servicios de la versión 7.
  • VERSION_6Se creará una red de servicios de la versión 6.
  • VERSION_5Se creará una red de servicios de la versión 5.
String

Salida derivada

NombreExplicaciónTipo 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í
  • Advanced: Sí

Temas relacionados