Exportar subred (Red de servicios)

Resumen

Exporta subredes desde una red de servicios a un archivo .json. Esta herramienta también permite eliminar una fila de la tabla Subredes, siempre que el atributo Is deleted tenga el valor true. Esto indica que el controlador de subred se ha eliminado de la subred.

Nota:

A partir de ArcGIS Enterprise 10.9.1, la operación para exportar la subred se procesará de forma asíncrona con el servicio de geoprocesamiento UtilityNetworkTools al trabajar con una red de servicios en una geodatabase corporativa. El servicio UtilityNetworkTools se configura previamente en la carpeta Sistema en servicios de entidades que incluyen una red de servicios. Tiene una configuración de tiempo de espera más largo y está reservado para tareas de geoprocesamiento de la red de servicios.

Más información sobre cómo exportar subredes

Uso

  • Las subredes deben estar limpias antes de poder exportarlas; ejecute primero la herramienta Actualizar subred.

  • Los parámetros de la categoría Trace Parameters solo se pueden utilizar en Python.

  • Se debe cumplir el siguiente requisito al trabajar con una geodatabase corporativa:
    • El valor del parámetro Red de servicios de entrada debe proceder de un servicio de la red de servicios.
    • Licencia:
      Para utilizar esta herramienta en una implementación empresarial, se debe asignar una licencia con la extensión de tipo de usuario ArcGIS Advanced Editing a la cuenta del portal activo.
  • Cuando el parámetro Definir reconocimiento de exportación está activado, debe cumplirse lo siguiente:

    • La topología de red debe estar habilitada.

    • Geodatabases corporativas tienen los siguientes requisitos adicionales:
      • Esta herramienta debe conectarse a la versión predeterminada para ejecutarse.
        • Todas las demás sesiones conectadas a la versión predeterminada están bloqueadas para ejecutar operaciones de validación o habilitación durante la operación de habilitación.
      • La cuenta del portal de ArcGIS Enterprise conectada debe corresponder al propietario del portal de utility network.

  • En ArcGIS Pro 2.3, se agregaron los siguientes parámetros: Incluir geometría, Tipos de resultados, Atributos de red de resultado y Campos de resultado. Cuando se usan estos parámetros, es posible que el formato del archivo JSON de salida sea distinto. Estos parámetros necesitan ArcGIS Enterprise 10.7 o versiones posteriores cuando se utilizan con una geodatabase corporativa. Revise la sintaxis de la respuesta del JSON de salida.

Parámetros

EtiquetaExplicaciónTipo de datos
Red de servicios de entrada

La red de servicios que contiene la subred que se va a exportar.

Utility Network; Utility Network Layer
Red de dominio

La red de dominio que contiene la subred.

String
Nivel

El nivel que contiene la subred.

String
Nombre de subred

El nombre de la subred que se exportará desde el nivel. Seleccione un origen específico para exportar la información de subred correspondiente. Cuando la tabla de subredes contiene 10.000 o más registros para un nivel, la lista de opciones del parámetro no se rellena y se proporciona un campo vacío para el nombre de subred.

String
Definir reconocimiento de exportación

Especifica si se actualizará el atributo LASTACKEXPORTSUBNETWORK para el controlador correspondiente en la tabla Subredes y la entidad de la clase de entidad SubnetLine.

  • Activado: se actualizará el atributo LASTACKEXPORTSUBNETWORK para el controlador correspondiente en la tabla Subredes. Si el controlador se ha marcado para su eliminación (Is deleted = True), se eliminará de la tabla Subredes. Esta opción requiere que la red de servicios de entrada haga referencia a la versión predeterminada.
  • Desactivado: no se actualizará el atributo LASTACKEXPORTSUBNETWORK para el controlador correspondiente en la tabla Subredes. Esta es la opción predeterminada.

Boolean
JSON de salida

Nombre y ubicación del archivo .json que se generará.

File
Barreras de condición
(Opcional)
Nota:

Este parámetro está disponible solo a para Python.

Value Table
Barreras de función
(Opcional)
Nota:

Este parámetro está disponible solo a para Python.

Value Table
Incluir entidades de barrera
(Opcional)
Nota:

Este parámetro está disponible solo a para Python.

Boolean
Aplicar transitabilidad a
(Opcional)

Especifica el tipo de transitabilidad que se aplicará. El alcance de la transitabilidad determina si esta se aplica a los cruces, los ejes o en ambos. Por ejemplo, si se define que una barrera de condición detenga el trazado si DEVICESTATUS está establecido en Open y el alcance de transitabilidad se establece solo en los ejes, el trazado no se detendrá, aunque se encuentre con un dispositivo abierto, porque DEVICESTATUS solo se aplica a los cruces. Es decir, este parámetro indica al trazado si debe ignorar los cruces, ejes o ambos.

  • Tanto a los cruces como a los ejesSe aplicará la transitabilidad tanto a los cruces como a los ejes.
  • Solo a los crucesSolo se aplicará la transitabilidad a los cruces.
  • Solo a los ejesSolo se aplicará la transitabilidad a los ejes.
Nota:

Este parámetro está disponible solo a para Python.

String
Propagadores
(Opcional)
Nota:

Este parámetro está disponible solo a para Python.

Value Table
Incluir geometría
(Opcional)

Especifica si se incluirá la geometría en los resultados.

  • Activado: la geometría se incluirá en los resultados.
  • Desactivado: la geometría no se incluirá en los resultados. Esta es la opción predeterminada.

Nota:

Para geodatabases corporativas, este parámetro requiere ArcGIS Enterprise 10.7 o posterior.

Boolean
Tipos de resultados
(Opcional)

Especifica el tipo de resultados que se devolverán.

  • ConectividadSe devolverán las entidades conectadas mediante coincidencia geométrica o asociaciones de conectividad. Esta es la opción predeterminada.
  • EntidadesSe devolverá la información de nivel de entidad.
  • Asociaciones de contenido y de adjuntoSe devolverán las entidades asociadas a través de asociaciones de contención y adjunto estructural.
Nota:

Para geodatabases corporativas, este parámetro requiere ArcGIS Enterprise 10.7 o posterior.

La opción de asociaciones de contenido y de adjunto requiere ArcGIS Enterprise 10.8.1 o posterior.

String
Atributos de red de resultado
(Opcional)

Los atributos de red que se incluirán en los resultados.

Nota:

Para geodatabases corporativas, este parámetro requiere ArcGIS Enterprise 10.7 o posterior.

String
Campos de resultado
(Opcional)

Los campos de una clase de entidad que se devolverán como resultados. Los valores del campo se devolverán en los resultados de las entidades de la subred.

Nota:

Para geodatabases corporativas, este parámetro requiere ArcGIS Enterprise 10.7 o posterior.

Value Table
Incluir descripciones de dominio
(Opcional)

Especifica si las descripciones de dominio se incluirán en el archivo .json de salida para comunicar la asignación de dominio de controladores, featureElements, conectividad y asociaciones.

  • Activado: se incluirán descripciones de dominio en los resultados.
  • Desactivado: no se incluirán descripciones de dominio en los resultados. Esta es la opción predeterminada.

Nota:

Para geodatabases corporativas, este parámetro requiere ArcGIS Enterprise 10.9.1 o posterior.

Boolean

Salida derivada

EtiquetaExplicaciónTipo de datos
Red de servicios actualizada

La red de servicios actualizada.

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})
NombreExplicaciónTipo de datos
in_utility_network

La red de servicios que contiene la subred que se va a exportar.

Utility Network; Utility Network Layer
domain_network

La red de dominio que contiene la subred.

String
tier

El nivel que contiene la subred.

String
subnetwork_name

El nombre de la subred que se exportará desde el nivel. Seleccione un origen específico para exportar la información de subred correspondiente.

String
export_acknowledged

Especifica si se actualizará el atributo LASTACKEXPORTSUBNETWORK para el controlador correspondiente en la tabla Subredes y la entidad de la clase de entidad SubnetLine.

  • ACKNOWLEDGESe actualizará el atributo LASTACKEXPORTSUBNETWORK para el controlador correspondiente en la tabla Subredes. Si la fuente se ha marcado para su eliminación (Is deleted = True), se eliminará de la tabla Subredes. Esta opción requiere que la red de servicios de entrada haga referencia a la versión predeterminada.
  • NO_ACKNOWLEDGENo se actualizará el atributo LASTACKEXPORTSUBNETWORK para el controlador correspondiente en la tabla Subredes. Esta es la opción predeterminada.
Boolean
out_json_file

Nombre y ubicación del archivo .json que se generará.

File
condition_barriers
[[Name, Operator, Type, Value, Combine Using],...]
(Opcional)

Define una condición de barrera de transitabilidad en entidades basadas en una comparación con un atributo de red o busque una cadena de categoría. Una condición de barrera utiliza un atributo de red, un operador y un tipo, y un valor de atributo. Por ejemplo, el trazado se detiene cuando una entidad tiene el atributo Device Status igual que el valor específico de Open. Cuando una entidad cumple esta condición, el seguimiento se detiene. Si está utilizando más de un atributo, puede usar el parámetro Combinar usando para definir una condición Y u O.

Los componentes de condición de barrera son los siguientes:

  • Name: filtre por cualquier atributo de red definido en el sistema.
  • Operator: elija entre una variedad de operadores diferentes.
  • Type: elija un valor o un atributo de red específicos del valor que se especifica en el parámetro name.
  • Value: establezca un valor específico del tipo de atributo de entrada que causará la finalización en función del valor del operador.
  • Combine Using: defina este valor si tiene varios atributos que agregar. Puede combinarlos utilizando una condición Y u O.

Los valores de barrera de condición de operator son los siguientes:

  • IS_EQUAL_TOEl atributo es igual que el valor.
  • DOES_NOT_EQUALEl atributo no es igual que el valor.
  • IS_GREATER_THANEl atributo es mayor que el valor.
  • IS_GREATER_THAN_OR_EQUAL_TOEl atributo es mayor o igual que el valor.
  • IS_LESS_THANEl atributo es menor que el valor.
  • IS_LESS_THAN_OR_EQUAL_TOEl atributo es menor o igual que el valor.
  • INCLUDES_THE_VALUESUna operación bitwise AND en la que todos los bits del valor están presentes en el atributo (bitwise AND == valor).
  • DOES_NOT_INCLUDE_THE_VALUESUna operación bitwise AND en la que no todos los bits del valor están presentes en el atributo (bitwise AND != valor).
  • INCLUDES_ANYUna operación bitwise AND en la que al menos un bit del valor está presente en el atributo (bitwise AND == True).
  • DOES_NOT_INCLUDE_ANYUna operación bitwise AND en la que ninguno de los bits del valor está presente en el atributo (bitwise AND == False).

Las opciones de barrera de condición de type son las siguientes:

  • SPECIFIC_VALUEFiltrar por un valor específico.
  • NETWORK_ATTRIBUTEFiltrar por un atributo de red.

Los valores de Combine Using son los siguientes:

  • ANDCombinar las barreras de condición.
  • ORUsar si se cumple alguna de las barreras de condición.

Más información sobre el uso de varias expresiones condicionales

Value Table
function_barriers
[[Function, Attribute, Operator, Value, Use Local Values],...]
(Opcional)

Define una barrera de transitabilidad en entidades basadas en una función. Las barreras de función se pueden utilizar para hacer cosas como restringir cuánto se desplaza el trazado desde el punto de partida o definir un valor máximo en el que se detiene un trazado. Por ejemplo, la longitud de cada línea recorrida se suma a la distancia total recorrida hasta ese momento. Cuando la longitud total recorrida alcanza el valor especificado, el seguimiento se detiene.

Los componentes de barrera de función son los siguientes:

  • Function: elija entre una variedad de funciones de cálculo diferentes.
  • Attribute: filtre por cualquier atributo de red definido en el sistema.
  • Operator: elija entre una variedad de operadores diferentes.
  • Value: establezca un valor específico del tipo de atributo de entrada que, si se descubre, causará la finalización.
  • Use Local Values: calcule valores en todas las direcciones, en lugar de un valor global general. Por ejemplo, úselo para una barrera de función que está calculando la suma de Shape length en la que el trazado termina si el valor es mayor o igual que 4. En el caso global, después de haber hecho un trazado poligonal de dos ejes con un valor de 2, ya ha alcanzado una longitud de forma cuya suma sea 4, de forma que el trazado finaliza. Si se utilizan valores locales, los valores locales a lo largo de cada ruta cambian, de forma que el trazado va más lejos.

  • TRUEUsar valores locales.
  • FALSEUsar valores globales. Esta es la opción predeterminada.

Los valores posibles para las opciones de barrera de función de function son los siguientes:

  • AVERAGEEl promedio de los valores de entrada.
  • COUNTEl número de entidades.
  • MAXEl máximo de valores de entrada.
  • MINEl mínimo de valores de entrada.
  • ADDSumar los valores.
  • SUBTRACTRestar los valores. Ni los controladores de subred ni los tipos de trazado en bucle admiten la función de resta.

Por ejemplo, la entidad de punto de partida tiene un valor de 20. La siguiente entidad tiene el valor 30. Si utiliza la función mínimo, el resultado es 20; máximo es 30; suma es 50; promedio es 25; recuento es 2; y resta es -10.

Las opciones de valor de barrera de función de operator son las siguientes:

  • IS_EQUAL_TOEl atributo es igual que el valor.
  • DOES_NOT_EQUALEl atributo no es igual que el valor.
  • IS_GREATER_THANEl atributo es mayor que el valor.
  • IS_GREATER_THAN_OR_EQUAL_TOEl atributo es mayor o igual que el valor.
  • IS_LESS_THANEl atributo es menor que el valor.
  • IS_LESS_THAN_OR_EQUAL_TOEl atributo es menor o igual que el valor.
  • INCLUDES_THE_VALUESUna operación bitwise AND en la que todos los bits del valor están presentes en el atributo (bitwise AND == valor).
  • DOES_NOT_INCLUDE_THE_VALUESUna operación bitwise AND en la que no todos los bits del valor están presentes en el atributo (bitwise AND != valor).
  • INCLUDES_ANYUna operación bitwise AND en la que al menos un bit del valor está presente en el atributo (bitwise AND == True).
  • DOES_NOT_INCLUDE_ANYUna operación bitwise AND en la que ninguno de los bits del valor está presente en el atributo (bitwise AND == False).
Value Table
include_barriers
(Opcional)

Especifica si las entidades de barrera de transitabilidad se incluirán en los resultados del seguimiento. Las barreras de transitabilidad son opcionales incluso si se han predefinido en la definición de subred.

  • INCLUDE_BARRIERSLas barreras de transitabilidad se incluirán en los resultados del trazado. Esta es la opción predeterminada.
  • EXCLUDE_BARRIERSLas barreras de transitabilidad no se incluirán en los resultados del trazado.
Boolean
traversability_scope
(Opcional)

Especifica el tipo de transitabilidad que se aplicará. El alcance de la transitabilidad determina si esta se aplica a los cruces, los ejes o en ambos. Por ejemplo, si se define que una barrera de condición detenga el trazado si DEVICESTATUS está establecido en Open y el alcance de transitabilidad se establece solo en los ejes, el trazado no se detendrá, aunque se encuentre con un dispositivo abierto, porque DEVICESTATUS solo se aplica a los cruces. Es decir, este parámetro indica al trazado si debe ignorar los cruces, ejes o ambos.

  • BOTH_JUNCTIONS_AND_EDGESSe aplicará la transitabilidad tanto a los cruces como a los ejes.
  • JUNCTIONS_ONLYSolo se aplicará la transitabilidad a los cruces.
  • EDGES_ONLYSolo se aplicará la transitabilidad a los ejes.
String
propagators
[[Attribute, Substitution Attribute, Function, Operator, Value],...]
(Opcional)

Especifica qué atributos de red propagar y cómo se producirá dicha propagación durante un seguimiento. Los atributos de clase propagados indican los valores clave en controladores de subred que se difunden al resto de las entidades de la subred. Por ejemplo, en un modelo de distribución eléctrica, puede propagar el valor de fase.

Los componentes propagadores son los siguientes:

  • Attribute: filtre por cualquier atributo de red definido en el sistema.
  • Substitution Attribute: utilice un valor sustituido en lugar de valores de atributo de red de conjunto de bits. Las sustituciones se codifican a partir del número de bits del atributo de red propagado. Una sustitución es una correlación de cada bit de la fase con otro bit. Por ejemplo, para la Fase AC, una sustitución podría correlacionar el bit A al B y el bit C a nulo. En este ejemplo, la sustitución para 1010 (Fase AC) es 0000-0010-0000-0000 (512). La sustitución captura la correlación de forma que usted sabe que la Fase A se correlacionó con B y la Fase C se correlacionó con nulo y no al contrario (es decir, no se correlacionó la Fase A a nulo ni se correlacionó la Fase C a B).
  • Function: elija entre una variedad de funciones de cálculo.
  • Operator: elija entre una variedad de operadores.
  • Value: proporcione un valor específico para un tipo de atributo de entrada que causaría la finalización en función de un valor del operador.

Los valores posibles para la function de propagadores son los siguientes:

  • PROPAGATED_BITWISE_ANDComparar los valores de una entidad con los de la siguiente.
  • PROPAGATED_MINObtener el valor mínimo.
  • PROPAGATED_MAXObtener el valor máximo.

Los valores de la operator de propagadores son los siguientes:

  • IS_EQUAL_TOEl atributo es igual que el valor.
  • DOES_NOT_EQUALEl atributo no es igual que el valor.
  • IS_GREATER_THANEl atributo es mayor que el valor.
  • IS_GREATER_THAN_OR_EQUAL_TOEl atributo es mayor o igual que el valor.
  • IS_LESS_THANEl atributo es menor que el valor.
  • IS_LESS_THAN_OR_EQUAL_TOEl atributo es menor o igual que el valor.
  • INCLUDES_THE_VALUESUna operación bitwise AND en la que todos los bits del valor están presentes en el atributo (bitwise AND == valor).
  • DOES NOT INCLUDE_THE_VALUESUna operación bitwise AND en la que no todos los bits del valor están presentes en el atributo (bitwise AND != valor).
  • INCLUDES_ANYUna operación bitwise AND en la que al menos un bit del valor está presente en el atributo (bitwise AND == True).
  • DOES_NOT_INLCUDE_ANYUna operación bitwise AND en la que ninguno de los bits del valor está presente en el atributo (bitwise AND == False).
Value Table
include_geometry
(Opcional)

Especifica si se incluirá la geometría en los resultados.

  • INCLUDE_GEOMETRYLa geometría se incluirá en los resultados.
  • EXCLUDE_GEOMETRYLa geometría no se incluirá en los resultados. Esta es la opción predeterminada.
Nota:

Para geodatabases corporativas, este parámetro requiere ArcGIS Enterprise 10.7 o posterior.

Boolean
result_types
[result_types,...]
(Opcional)

Especifica el tipo de resultados que se devolverán.

  • CONNECTIVITYSe devolverán las entidades conectadas mediante coincidencia geométrica o asociaciones de conectividad. Esta es la opción predeterminada.
  • FEATURESSe devolverá la información de nivel de entidad.
  • CONTAINMENT_AND_ATTACHMENT_ASSOCIATIONSSe devolverán las entidades asociadas a través de asociaciones de contención y adjunto estructural.
Nota:

Para geodatabases corporativas, este parámetro requiere ArcGIS Enterprise 10.7 o posterior.

La opción de asociaciones de contenido y de adjunto requiere ArcGIS Enterprise 10.8.1 o posterior.

String
result_network_attributes
[result_network_attributes,...]
(Opcional)

Los atributos de red que se incluirán en los resultados.

Nota:

Para geodatabases corporativas, este parámetro requiere ArcGIS Enterprise 10.7 o posterior.

String
result_fields
[[Feature Class, Field Name],...]
(Opcional)

Los campos de una clase de entidad que se devolverán como resultados. Los valores del campo se devolverán en los resultados de las entidades de la subred.

Nota:

Para geodatabases corporativas, este parámetro requiere ArcGIS Enterprise 10.7 o posterior.

Value Table
include_domain_descriptions
(Opcional)

Especifica si las descripciones de dominio se incluirán en la salida .json para comunicar la asignación de dominio para controladores, featureElements, conectividad y asociaciones.

  • INCLUDE_DOMAIN_DESCRIPTIONSLas descripciones de domino se incluirán en los resultados.
  • EXCLUDE_DOMAIN_DESCRIPTIONSLas descripciones de domino no se incluirán en los resultados. Esta es la opción predeterminada.
Nota:

Para geodatabases corporativas, este parámetro requiere ArcGIS Enterprise 10.9.1 o posterior.

Boolean

Salida derivada

NombreExplicaciónTipo de datos
out_utility_network

La red de servicios actualizada.

Utility Network

Muestra de código

Ejemplo de ExportSubnetwork (ventana de Python)

Exportar la información de subred correspondiente para un origen llamado RMT002 a un archivo .json con descripciones de dominio incluidas.

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, "EXCLUDE_GEOMETRY", None, None, None, 
                          "INCLUDE_DOMAIN_DESCRIPTIONS")

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

  • Basic: No
  • Standard: Sí
  • Advanced: Sí

Temas relacionados