Agregar nivel (Red de servicios)

Resumen

Crea un nuevo nivel para una red de dominio en una red de servicios.

Los niveles son colecciones de subredes que comparten el mismo nivel, restricciones de nombre y tipo de topología. Los niveles son necesarios para la administración de subredes.

Uso

  • Se agrega un campo de nombre de subred para redes de dominio con una definición de niveles divididos para el primer nivel agregado a la red de dominio. Para redes de dominio con una definición de niveles jerárquicos, se crea un nombre de campo de subred usando el valor del parámetro Nombre del campo de subred. Para obtener más información, consulte Nombre de subred.

  • Para redes de dominio con una definición de niveles jerárquicos, el Nombre de grupo de nivel es un parámetro obligatorio. Pueden crearse grupos de nivel para redes de dominio con una definición de niveles jerárquicos usando la herramienta Agregar grupo de nivel.

  • Es necesario agregar niveles antes de incorporar datos a las clases de entidad de red de servicios. Si los datos se incorporan antes de agregar un nuevo nivel, se genera un error.

  • La topología de red debe estar desactivada.

  • Se deben cumplir los siguientes requisitos al trabajar con una geodatabase corporativa:

Parámetros

EtiquetaExplicaciónTipo de datos
Red de servicios de entrada

La red de servicios que contiene la red de dominio donde se agregará el nivel.

Utility Network; Utility Network Layer
Red de dominio

La red de dominio donde se creará el nivel.

String
Nombre

El nombre del nuevo nivel. El nombre debe ser único dentro de toda la red de servicios.

String
Clasificación

La clasificación del nivel que se va a agregar. La clasificación más alta es el número 1.

Long
Tipo de topología
(Opcional)

Especifica el tipo de topología para el nuevo nivel. Subredes con tipos de topología radial y malla admiten uno o más controladores de subred. Este parámetro está deshabilitado en el cuadro de diálogo de la herramienta si la red de dominio de entrada se creó con una definición de niveles jerárquicos y el tipo de topología predeterminado es malla. Si la red de dominio se creó con una definición de nivel dividida, dicho parámetro poseerá todos los tipos de topología disponibles en la lista desplegable.

Para trazado o administración de subred, este parámetro no proporciona actualmente una diferencia en el comportamiento. La funcionalidad de este parámetro está en proceso de desarrollo y se aplicará a una versión futura.

  • RadialLas subredes tendrán un tipo de topología radial.
  • MallaLas subredes tendrán un tipo de topología de malla. Este es el tipo de topología predeterminado para un nivel creado con una definición de nivel jerárquica.
String
Nombre de grupo de nivel
(Opcional)

El grupo de nivel existente al que se agregará el nuevo nivel. Este parámetro se requiere para redes de dominio con una definición de niveles jerárquicos.

String
Nombre del campo de subred
(Opcional)

El nombre del campo en el que se guardarán los nombres de subred para este nivel. Se trata de un campo mantenido por el sistema que se crea la primera vez que se agrega un nivel a un grupo de niveles y se reutiliza para los niveles adicionales. Por ejemplo, tiene dos grupos de niveles: Distribución y Transmisión. Cuando agrega un nivel denominado system al grupo Distribución y especifica que el nombre de campo de subred es systemsubnet, se crea el campo. A continuación, usted agrega un segundo nivel denominado system al grupo Transmisión. Este parámetro detecta que el campo systemsubnet se debe usar como el nombre de campo de subred. Este parámetro es necesario para tipos de nivel jerárquicos.

String

Salida derivada

EtiquetaExplicaciónTipo de datos
Red de servicios actualizada

La red de servicios actualizada.

Red de servicios

arcpy.un.AddTier(in_utility_network, domain_network, name, rank, {topology_type}, {tier_group_name}, {subnetwork_field_name})
NombreExplicaciónTipo de datos
in_utility_network

La red de servicios que contiene la red de dominio donde se agregará el nivel.

Utility Network; Utility Network Layer
domain_network

La red de dominio donde se creará el nivel.

String
name

El nombre del nuevo nivel. El nombre debe ser único dentro de toda la red de servicios.

String
rank

La clasificación del nivel que se va a agregar. La clasificación más alta es el número 1.

Long
topology_type
(Opcional)

Especifica el tipo de topología para el nuevo nivel. Subredes con tipos de topología radial y malla admiten uno o más controladores de subred. Este parámetro está deshabilitado en el cuadro de diálogo de la herramienta si la red de dominio de entrada se creó con una definición de niveles jerárquicos y el tipo de topología predeterminado es malla. Si la red de dominio de entrada se creó con una definición de nivel jerárquica, el tipo de topología predeterminado es MESH. Si la red de dominio de entrada se creó con una definición de nivel dividida, se requiere el parámetro del tipo de topología.

Nota:

Para trazado o administración de subred, este parámetro no proporciona actualmente una diferencia en el comportamiento. La funcionalidad de este parámetro está en proceso de desarrollo y se aplicará a una versión futura.

  • RADIALLas subredes tendrán un tipo de topología radial.
  • MESHLas subredes tendrán un tipo de topología de malla. Este es el tipo de topología predeterminado para un nivel creado con una definición de nivel jerárquica.
String
tier_group_name
(Opcional)

El grupo de nivel existente al que se agregará el nuevo nivel. Este parámetro se requiere para redes de dominio con una definición de niveles jerárquicos.

String
subnetwork_field_name
(Opcional)

El nombre del campo en el que se guardarán los nombres de subred para este nivel. Se trata de un campo mantenido por el sistema que se crea la primera vez que se agrega un nivel a un grupo de niveles y se reutiliza para los niveles adicionales. Por ejemplo, tiene dos grupos de niveles: Distribución y Transmisión. Cuando agrega un nivel denominado system al grupo Distribución y especifica que el nombre de campo de subred es systemsubnet, se crea el campo. A continuación, usted agrega un segundo nivel denominado system al grupo Transmisión. Este parámetro detecta que el campo systemsubnet se debe usar como el nombre de campo de subred. Este parámetro es necesario para tipos de nivel jerárquicos.

String

Salida derivada

NombreExplicaciónTipo de datos
out_utility_network

La red de servicios actualizada.

Red de servicios

Muestra de código

Ejemplo 1 de AddTier (ventana de Python)

Crear un nivel en una red jerárquica denominada DistributionSystem con un tipo de topología MESH.

import arcpy
arcpy.AddTier_un("Utility Network", "GasDistribution", "Distribution System", 
                 1, "MESH", "Distribution", "System")
Ejemplo 2 de AddTier (ventana de Python)

Crear un nivel en una red dividida denominada MediumVoltage con un tipo de topología RADIAL.

import arcpy
arcpy.AddTier_un("Utility Network", "ElectricDistribution", "Medium Voltage", 
                 1, "RADIAL")

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

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

Temas relacionados