Establece la definición de subred (Red de servicios)

Resumen

Establece las propiedades del nivel de la red de dominio para una subred de una red de servicios.

Los tipos de entidades que participan en un nivel pueden restringirse definiendo tipos de activos válidos de las clases de dispositivo, línea, cruce, objeto de eje y objeto de cruce. La definición de tipos de activos válidos ayuda a imponer la corrección de los datos al limitar los tipos de entidades que pueden participar en una subred para un nivel específico.

Se usan parámetros de configuración para establecer propiedades cuando se ejecuta un trazado en la subred.

Más información sobre la configuración de la definición de subred

Más información sobre la administración de subredes

Más información sobre el trazado en las redes de servicios

Uso

• Esta herramienta también le permite establecer y modificar la definición de la subred de nivel. Para modificar los valores de la definición de la subred de nivel, modifique los valores de los parámetros y ejecute de nuevo la herramienta.

• La topología de red debe estar desactivada.

• Se deben cumplir los siguientes requisitos al trabajar con una geodatabase corporativa:
  • La cuenta del portal de ArcGIS Enterprise conectado debe ser el propietario de la red de servicios del portal.
  • El parámetro Red de servicios de entrada debe provenir de una conexión de base de datos establecida como propietaria de la red de servicios de la base de datos.
  • Esta herramienta se debe ejecutar cuando esté conectada a la versión predeterminada.

Sintaxis

SetSubnetworkDefinition(in_utility_network, domain_network, tier_name, support_disjoint_subnetwork, valid_devices, valid_subnetwork_controller, {valid_lines}, {aggregated_line}, {diagram_template}, {summaries}, {condition_barriers}, {function_barriers}, {include_barriers}, {traversability_scope}, {propagators}, {update_structure_features}, {update_container_features}, {edit_mode_for_default_version}, {edit_mode_for_named_version}, {valid_junctions}, {valid_junction_objects}, {valid_junction_object_subnetwork_controller}, {valid_edge_objects})

Parámetro	Explicación	Tipo de datos
in_utility_network	La red de servicios de entrada que contiene la subred de nivel.	Utility Network; Utility Network Layer
domain_network	La red de dominio que contiene el nivel.	String
tier_name	El nombre del nivel que contiene la subred.	String
support_disjoint_subnetwork	Especifica si el nivel de entrada admite las subredes inconexas. Como subredes inconexas se entienden dos o más subredes que pertenecen al mismo nivel y tienen el mismo nombre de subred, pero no son transitables. Esta opción solo está disponible para los niveles de dentro de redes de dominio con una definición de niveles divididos. Los niveles de una red de dominio con una definición de niveles jerárquicos siempre tendrán esta propiedad de nivel con el valor True para admitir subredes inconexas. SUPPORT_DISJOINT — El nivel de entrada admite las subredes inconexas. NO_DISJOINT —El nivel de entrada no admite las subredes inconexas. Esta es la opción predeterminada.	Boolean
valid_devices [valid_devices,...]	Los pares de grupo de activos/tipo de activos identificados como dispositivos válidos para la subred.	String
valid_subnetwork_controller [valid_subnetwork_controller,...]	Los pares de grupo de activos/tipo de activos identificados como controladores de subred de dispositivos válidos para la subred.	String
valid_lines [valid_lines,...] (Opcional)	Los pares de grupo de activos/tipo de activos identificados como líneas válidas para la subred.	String
aggregated_line [aggregated_line,...] (Opcional)	Las líneas válidas cuya geometría se agregará para generar las entidades SubnetLine. Esta lista es un subconjunto de los valores especificados en el parámetro valid_lines.	String
diagram_template [diagram_template,...] (Opcional)	Las plantillas que se utilizarán para generar diagramas de sistema de subred para cada subred.	String
summaries [[Function, Attribute, Filter Name, Filter Operator, Filter Type, Filter Value, Summary Attribute],...] (Opcional)	Define el campo de resumen que debe almacenar los resultados de la función al insertar o actualizar entidades SubnetLine. Los componentes de resúmenes son los siguientes: Function: elija entre una variedad de funciones de cálculo. Attribute: filtre por cualquier atributo de red definido en el sistema. Filter Name: filtre los resultados de la función por nombre de atributo. Filter Operator: elija entre una variedad de operadores. Filter Type: elija entre una variedad de tipos de filtros. Filter Value: indique un valor específico para el atributo de filtro de entrada. Summary Attribute: el campo de la clase de entidad SubnetLine que almacena de forma persistente el resultado de la función. Dependiendo de la función seleccionada y el tipo de atributo de red, solo será válido para este parámetro el tipo aplicable de atributos de subred agregados por el usuario. Si no existe ningún campo en la clase de entidad SubnetLine en donde almacenar el resultado del resumen, se puede usar la herramienta Agregar campo para crear uno. Un campo solo es compatible con el resultado de un resumen; por lo tanto, cada resumen necesita su propio campo en la clase de entidad SubnetLine. Consulte la siguiente matriz de tipos de campos válidos para las distintas funciones: Las opciones de valor de los resúmenes de Function son las siguientes: AVERAGE —El promedio de los valores de entrada. COUNT —El número de entidades. MAX —El máximo de valores de entrada. MIN —El mínimo de valores de entrada. ADD —La suma de los valores de entrada. SUBTRACT —La diferencia entre los valores de entrada. Ni los controladores de subred ni los tipos de trazado en bucle admiten la función de resta. Las opciones de valor de los resúmenes de Filter Operator son las siguientes: IS_EQUAL_TO —El atributo es igual que el valor. DOES_NOT_EQUAL —El atributo no es igual que el valor. IS_GREATER_THAN —El atributo es mayor que el valor. IS_GREATER_THAN_OR_EQUAL_TO —El atributo es mayor o igual que el valor. IS_LESS_THAN —El atributo es menor que el valor. IS_LESS_THAN_OR_EQUAL_TO —El atributo es menor o igual que el valor. INCLUDES_THE_VALUES —Una 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_VALUES —Una operación bitwise AND en la que no todos los bits del valor están presentes en el atributo (bitwise AND != valor). INCLUDES_ANY —Una operación bitwise AND en la que al menos un bit del valor está presente en el atributo (bitwise AND == True). DOES_NOT_INCLUDE_ANY —Una operación bitwise AND en la que ninguno de los bits del valor está presente en el atributo (bitwise AND == False). Las opciones de valor de los resúmenes de Filter Type son las siguientes: SPECIFIC_VALUE —Filtrar por un valor específico. NETWORK_ATTRIBUTE —Filtrar por un atributo de red. Más información sobre los operadores bitwise	Value Table
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: Name: filtre por cualquier atributo de red definido en el sistema. Operator: elija entre una variedad de operadores. Type: elija un valor o un atributo de red específicos del valor que se especifica en el parámetro name. Value: indique un valor específico de un tipo de atributo de entrada que causaría la finalización en función de un valor del operador. Combine Using: defina este valor si tiene varios atributos que agregar. Puede combinarlos utilizando las condiciones Y u O. Los valores de barrera de condición de operator son los siguientes: IS_EQUAL_TO —El atributo es igual que el valor. DOES_NOT_EQUAL —El atributo no es igual que el valor. IS_GREATER_THAN —El atributo es mayor que el valor. IS_GREATER_THAN_OR_EQUAL_TO —El atributo es mayor o igual que el valor. IS_LESS_THAN —El atributo es menor que el valor. IS_LESS_THAN_OR_EQUAL_TO —El atributo es menor o igual que el valor. INCLUDES_THE_VALUES —Una 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_VALUES —Una operación bitwise AND en la que no todos los bits del valor están presentes en el atributo (bitwise AND != valor). INCLUDES_ANY —Una operación bitwise AND en la que al menos un bit del valor está presente en el atributo (bitwise AND == True). DOES_NOT_INLCUDE_ANY —Una operación bitwise AND en la que ninguno de los bits del valor está presente en el atributo (bitwise AND == False). Más información sobre los operadores bitwise Las opciones del valor Type de las barreras de condición son las siguientes: SPECIFIC_VALUE —Filtrar por un valor específico. NETWORK_ATTRIBUTE —Filtrar por un atributo de red. Los valores de Combine Using son los siguientes: AND —Combinar las barreras de condición. OR —Usar 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 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: Function: elija entre una variedad de funciones de cálculo. Attribute: filtre por cualquier atributo de red definido en el sistema. Operator: elija entre una variedad de operadores. Value: indique un valor específico del tipo de atributo de entrada que, si se descubre, causará la finalización. Use Local Values: calcular los valores de cada dirección en lugar del valor global general, por ejemplo, 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 y el trazado continúa. Las opciones de valor de barrera de función de function son las siguientes: AVERAGE —El promedio de los valores de entrada. COUNT —El número de entidades. MAX —El máximo de valores de entrada. MIN —El mínimo de valores de entrada. ADD —La suma de los valores de entrada. SUBTRACT —La diferencia entre los valores de entrada.Ni los controladores de subred ni los tipos de trazado en bucle admiten la función de resta. Las opciones de valor de barrera de función de operator son las siguientes: IS_EQUAL_TO —El atributo es igual que el valor. DOES_NOT_EQUAL —El atributo no es igual que el valor. IS_GREATER_THAN —El atributo es mayor que el valor. IS_GREATER_THAN_OR_EQUAL_TO —El atributo es mayor o igual que el valor. IS_LESS_THAN —El atributo es menor que el valor. IS_LESS_THAN_OR_EQUAL_TO —El atributo es menor o igual que el valor. INCLUDES_THE_VALUES —Una 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_VALUES —Una operación bitwise AND en la que no todos los bits del valor están presentes en el atributo (bitwise AND != valor). INCLUDES_ANY —Una operación bitwise AND en la que al menos un bit del valor está presente en el atributo (bitwise AND == True). DOES_NOT_INCLUDE_ANY —Una operación bitwise AND en la que ninguno de los bits del valor está presente en el atributo (bitwise AND == False). Más información sobre los operadores bitwise Las opciones de valor de barrera de función de Use Local Values son las siguientes: TRUE —Usar valores locales. FALSE —Usar valores globales. Esta es la opción predeterminada.	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_BARRIERS —Las barreras de transitabilidad se incluirán en los resultados del trazado. Esta es la opción predeterminada. EXCLUDE_BARRIERS —Las barreras de transitabilidad no se incluirán en los resultados del trazado.	Boolean
traversability_scope (Opcional)	El tipo de traversabilidad 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 condición de barrera detenga el trazado si Estado de dispositivo equivale a Abierto y el alcance de transitabilidad se establece solo en los ejes, el trazado no se detendrá, aunque se encuentre con un dispositivo abierto, porque Estado de dispositivo solo se aplica a los cruces. Es decir, este parámetro indica al trazado debe ignorar los cruces, ejes o ambos. BOTH_JUNCTIONS_AND_EDGES —Se aplicará la transitabilidad tanto a los cruces como a los ejes. Esta es la opción predeterminada. JUNCTIONS_ONLY —Solo se aplicará la transitabilidad a los cruces. EDGES_ONLY —Solo se aplicará la transitabilidad a los ejes.	String
propagators [[Attribute, Substitution Attribute, Function, Operator, Value, Propagated Attribute],...] (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: 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. Propagated Attribute: el nombre del campo de su clase de red que se utiliza para almacenar los valores propagados calculados. El tipo de campo debe ser el mismo que el tipo de campo del atributo de red elegido para el valor Attribute. Las opciones de valor de propagadores de function son las siguientes: PROPAGATED_BITWISE_AND —Comparar los valores de una entidad con los de la siguiente. PROPAGATED_MIN —Obtener el valor mínimo. PROPAGATED_MAX —Obtener el valor máximo. Las opciones de valor de propagadores de operator son las siguientes: IS_EQUAL_TO —El atributo es igual que el valor. DOES_NOT_EQUAL —El atributo no es igual que el valor. IS_GREATER_THAN —El atributo es mayor que el valor. IS_GREATER_THAN_OR_EQUAL_TO —El atributo es mayor o igual que el valor. IS_LESS_THAN —El atributo es menor que el valor. IS_LESS_THAN_OR_EQUAL_TO —El atributo es menor o igual que el valor. INCLUDES_THE_VALUES —Una 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_VALUES —Una operación bitwise AND en la que no todos los bits del valor están presentes en el atributo (bitwise AND != valor). INCLUDES_ANY —Una operación bitwise AND en la que al menos un bit del valor está presente en el atributo (bitwise AND == True). DOES_NOT_INCLUDE_ANY —Una operación bitwise AND en la que ninguno de los bits del valor está presente en el atributo (bitwise AND == False). Más información sobre los operadores bitwise Nota: Este parámetro está disponible solo a través de Python.	Value Table
update_structure_features (Opcional)	Especifica si el proceso de actualización de la subred actualizará el atributo de nombre de subred admitido para las estructuras. UPDATE —Se actualizan las entidades de estructura. Esta es la opción predeterminada. NOT_UPDATE —No se actualizan las entidades de estructura. Nota: Este parámetro requiere una Versión de red de servicios 4 o superior.	Boolean
update_container_features (Opcional)	Especifica si el proceso de actualización de la subred actualizará el nombre de subred admitido para los contenedores. UPDATE —Se actualizan las entidades de entidad de contenedor. Esta es la opción predeterminada. NOT_UPDATE —No se actualizan las entidades de entidad de contenedor. Nota: Este parámetro requiere una Versión de red de servicios 4 o superior.	Boolean
edit_mode_for_default_version (Opcional)	Especifica el modo de edición de las actualizaciones de subred en la versión predeterminada. WITHOUT_EVENTING —No se utilizan eventos para las actualizaciones de subred de la versión predeterminada. Este modo de edición actualiza el nombre de la subred y los valores propagados en su lugar. Esta es la opción predeterminada. WITH_EVENTING —Se utilizan eventos para las actualizaciones de subred de la versión predeterminada. Este modo de edición ejecutará el comportamiento de la geodatabase (por ejemplo, reglas de atributos, rastreo del editor, etc.) cuando se actualiza la subred. Nota: Este parámetro requiere una Versión de red de servicios 4 o superior y solo es aplicable a geodatabases corporativas.	String
edit_mode_for_named_version (Opcional)	Especifica el modo de edición de las actualizaciones de subred en una versión nominal. WITHOUT_EVENTING —No se utilizan eventos para las actualizaciones de subred de una versión nominal. Este modo de edición actualiza el nombre de la subred y los valores propagados en su lugar. Esta es la opción predeterminada. WITH_EVENTING —Se utilizan eventos para las actualizaciones de subred de una versión nominal. Este modo de edición ejecutará el comportamiento de la geodatabase (por ejemplo, reglas de atributos, rastreo del editor, etc.) cuando se actualiza la subred. Nota: Este parámetro requiere una Versión de red de servicios 4 o superior y solo es aplicable a geodatabases corporativas.	String
valid_junctions [valid_junctions,...] (Opcional)	Los pares de grupo de activos/tipo de activos identificados como cruces válidos para la subred. Nota: Este parámetro requiere una Versión de red de servicios 4 o superior.	String
valid_junction_objects [valid_junction_objects,...] (Opcional)	Los pares de grupo de activos/tipo de activos identificados como objetos de cruce válidos para la subred. Nota: Este parámetro requiere una Versión de red de servicios 4 o superior.	String
valid_junction_object_subnetwork_controller [valid_junction_object_subnetwork_controller,...] (Opcional)	Los pares de grupo de activos/tipo de activos identificados como controladores de subred de objetos de cruce válidos para la subred. Nota: Este parámetro requiere una Versión de red de servicios 4 o superior.	String
valid_edge_objects [valid_edge_objects,...] (Opcional)	Los pares de grupo de activos/tipo de activos identificados como objetos de eje válidos para la subred. Nota: Este parámetro requiere una Versión de red de servicios 4 o superior.	String

Salida derivada

Nombre	Explicación	Tipo de datos
out_utility_network	La red de servicios de entrada actualizada.	Red de servicios

Muestra de código

Ejemplo de SetSubnetworkDefinition (script independiente)

En este ejemplo se establece la definición de subred de un dominio denominado ElectricDistribution.

'''****************************************************************************
Name:        SetSubnetworkDefinition.py
Description: This script sets the subnetwork definition for a tier in a Utility Network
Created by:  Esri
****************************************************************************'''

# Import required modules        
import arcpy

# Set local variables
in_utility_network = "ElectricDistribution"
domain_network = "ElecDist"
tier_name = "Medium Voltage"
support_disjoint_subnetwork = "SUPPORT_DISJOINT"
valid_devices = "'CircuitBreaker/Unknown';'CircuitBreaker/Air powered';'NetworkProtector/Unknown';'NetworkProtector/NetworkProtector';'Transformer/Unknown';'Transformer/Buck boost';'Transformer/Single-phase overhead';'Transformer/Single-phase padmounted';'Transformer/Three-phase padmounted';'Transformer/Power';'Transformer/Step';'Transformer/Vault'"
valid_subnetwork_controller = "'CircuitBreaker/Unknown';'CircuitBreaker/Air powered'"
valid_lines = "'Busbar/Unknown';'Busbar/Busbar';'Connector/Unknown';'Connector/Connector';'LowVoltage/Unknown';'LowVoltage/Overhead';'LowVoltage/Underground';'MediumVoltage/Unknown';'MediumVoltage/Single-phase overhead';'MediumVoltage/Two-phase overhead';'MediumVoltage/Three-phase overhead';'MediumVoltage/Single-phase underground';'MediumVoltage/Two-phase underground';'MediumVoltage/Three-phase underground';'IsolatedNeutral/Unknown';'IsolatedNeutral/Concentric neutral';'IsolatedNeutral/Neutral';'SubTransmission/Unknown';'SubTransmission/Overhead';'SubTransmission/Underground'"
aggregated_line = "'Busbar/Unknown';'Busbar/Busbar';'MediumVoltage/Unknown';'MediumVoltage/Single-phase overhead';'MediumVoltage/Two-phase overhead';'MediumVoltage/Three-phase overhead';'MediumVoltage/Single-phase underground';'MediumVoltage/Two-phase underground';'MediumVoltage/Three-phase underground'"
diagram_template = "Basic"
summaries = ""
condition_barriers = "'Device Status' IS_EQUAL_TO SPECIFIC_VALUE 'Opened' #"
function_barriers = ""
include_barriers = "INCLUDE_BARRIERS"
traversability_scope = "BOTH_JUNCTIONS_AND_EDGES"
propagators = ""

# Run the SetSubnetworkDefinition tool
arcpy.SetSubnetworkDefinition_un(in_utility_network, 
                                 domain_network, 
                                 tier_name, 
                                 support_disjoint_subnetwork, 
                                 valid_devices, 
                                 valid_subnetwork_controller, 
                                 valid_lines, 
                                 aggregated_line, 
                                 diagram_template, 
                                 summaries, 
                                 condition_barriers, 
                                 function_barriers, 
                                 include_barriers, 
                                 traversability_scope, 
                                 propagators)

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

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