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.
Uso
Las subredes deben estar validadas; ejecute primero la herramienta Actualizar subred.
Los parámetros de la categoría Trace Parameters solo se pueden ejecutar mediante Python.
- Se deben cumplir los siguientes requisitos al trabajar con una geodatabase corporativa:
- El parámetro Red de servicios de entrada debe proceder de un servicio de la red de servicios.
Cuando el parámetro Definir reconocimiento de exportación está habilitado, debe cumplirse lo siguiente:
La topología de red debe estar habilitada.
- Geodatabases corporativas tienen los siguientes requisitos adicionales:
- Esta herramienta se debe ejecutar cuando esté conectada a la versión predeterminada.
- La cuenta del portal de ArcGIS Enterprise conectado debe ser el propietario de la red de servicios del portal.
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.
Sintaxis
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})
Parámetro | Explicación | Tipo 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 va a exportar. Seleccione un origen específico para exportar la información de subred correspondiente. | String |
export_acknowledged | Especifica si se actualiza el atributo LASTACKEXPORTSUBNETWORK para el controlador correspondiente en la tabla Subredes y la entidad de la clase de entidad SubnetLine.
| Boolean |
out_json_file | El nombre y la ubicación del archivo JSON que se va a 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 barrera de condición utiliza un atributo de red, un operador y un tipo, y un valor de atributo. Por ejemplo, el seguimiento se detiene cuando una entidad tiene el atributo Device Status equivale al 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:
Los valores de barrera de condición de operator son los siguientes:
Las opciones de barrera de condición de type son los siguientes:
Los valores de Combine Using son los siguientes:
Nota:Este parámetro está disponible solo a través de Python. 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 seguimiento desde el punto de partida o definir un valor máximo en el que se detiene un seguimiento. 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:
Los valores posibles para las opciones de barrera de función de function son las siguientes:
Por ejemplo, existe una entidad de punto de partida con 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:
Nota:Este parámetro está disponible solo a través de Python. | Value Table |
include_barriers (Opcional) | Especifica si las entidades de barrera de transitabilidad se incluyen o no en los resultados del trazado. Las barreras de transitabilidad son opcionales incluso si se han predefinido en la definición de subred.
Nota:Este parámetro está disponible solo a través de Python. | Boolean |
traversability_scope (Opcional) | Especifica el tipo de transitabilidad que se va a aplicar. El alcance de la transitabilidad dicta si esta se aplica en 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 debe ignorar los cruces, ejes o ambos.
Nota:Este parámetro está disponible solo a través de Python. | String |
propagators [[Attribute, Substitution Attribute, Function, Operator, Value],...] (Opcional) | Especifica qué atributos de red propagar y cómo debe producirse 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:
Los valores posibles para los propagadores de function son los siguientes:
Los valores de propagador de operator son los siguientes:
Nota:Este parámetro está disponible solo a través de Python. | Value Table |
include_geometry (Opcional) | Especifica si se incluirá la geometría en los resultados.
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 para exportar.
Nota:Para geodatabases corporativas, este parámetro requiere ArcGIS Enterprise 10.7 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 |
Salida derivada
Nombre | Explicación | Tipo de datos |
out_utility_network | La red de servicios actualizada. | Red de servicios |
Muestra de código
Exportar la información de subred correspondiente para un origen llamado RMT002 a un archivo JSON.
import arcpy
arcpy.ExportSubnetwork_un("Utility Network", "ElectricDistribution",
"Medium Voltage", "RMT002", "ACKNOWLEDGE",
"C:\\Temp\\RMT002clean.json")
Entornos
Información de licenciamiento
- Basic: No
- Standard: Sí
- Advanced: Sí