Agregar la configuración de terminal (Red de servicios)

Resumen

Agrega una configuración de terminales a una red de servicios existente.

Las entidades de red con terminales requieren restricciones que definan la configuración válida de la conectividad interna del dispositivo u objeto de cruce. Esta herramienta permite agregar una nueva configuración de terminales a una red de servicios que se puede asignar a una clase en el nivel de grupo de activos o tipo de activo utilizando la herramienta Definir configuración de terminal.

Uso

  • Los terminales se configuran en un dispositivo u objeto de cruce al asignarles una configuración de terminales. Solo se puede asignar una única configuración de terminales a cada uno de los tipos de activos que admitan terminales.

  • Los terminales de una entidad u objeto presentan una configuración de direccionalidad. Pueden estar configurados como direccionales (solo se permite una dirección de flujo) o bidireccionales (se permiten ambas direcciones de flujo).

  • Se debe especificar un mínimo de dos terminales y se puede especificar un máximo de ocho terminales. Los nombres de los terminales deben ser descriptivos, por ejemplo, lado-alta o lado-fuente.

  • En el caso de las entidades con tres o cuatro terminales, puede definir rutas válidas. Esta posibilidad se ha diseñado para administrar dispositivos de conmutación complejos cuando se necesita restringir las rutas de flujo entre pares de terminales. Por ejemplo, en un dispositivo con cuatro terminales denominados A, B, C y D, quizá desea permitir el flujo de A a B y a C, pero no de A a D.

  • La topología de red debe estar desactivada.

  • Al trabajar con una geodatabase corporativa, existen estos requisitos:

    • 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.
    • El valor del 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.
    • La cuenta del portal de ArcGIS Enterprise conectada debe corresponder al propietario del portal de utility network.

Parámetros

EtiquetaExplicaciónTipo de datos
Red de servicios de entrada

La red de servicios de entrada a la que se agregará la configuración de terminales.

Utility Network; Utility Network Layer
Nombre

El nombre de la configuración de terminales.

String
Direccionalidad

Especifica la direccionalidad de la configuración de terminales. Un modelo de transitabilidad direccional significa que el flujo para el terminal solo irá en una dirección. Un modelo de transitabilidad bidireccional significa que el terminal permite el flujo en ambas direcciones.

  • DireccionalSolo se permite una dirección de flujo.
  • BidireccionalSe permiten ambas direcciones de flujo.
String
Terminales
(Opcional)

El nombre y flujo direccional de cada terminal direccional. Se debe especificar un mínimo de dos terminales y se puede especificar un máximo de ocho. El nombre de cada terminal no puede rebasar los 32 caracteres. Este parámetro es obligatorio si el valor del parámetro Direccionalidad es Direccional.

  • Nombre: proporcione el nombre del terminal.
  • Aguas arriba: indique si el terminal está aguas arriba o aguas abajo.
    • Activado: el terminal está aguas arriba.
    • Desactivado: el terminal está aguas abajo.
Value Table
Terminales
(Opcional)

El nombre de cada terminal bidireccional. Se debe especificar un mínimo de dos terminales y se puede especificar un máximo de ocho. El nombre de cada terminal no puede rebasar los 32 caracteres. Este parámetro es obligatorio si el valor del parámetro Direccionalidad es Bidireccional (traversability_model = "BIDIRECTIONAL" en Python).

Value Table
Rutas válidas
(Opcional)

El nombre o nombres y la ruta o rutas válidas para la configuración de terminales. Para la transitabilidad bidireccional, este parámetro es obligatorio si tiene tres o cuatro terminales. Si está utilizando la transitabilidad direccional, uno de los terminales debe ser aguas arriba para tener configuraciones válidas. Se deben crear rutas válidas para indicar qué rutas de un dispositivo u objeto de cruce son válidas para el paso de un recurso. Indique un nombre para cada ruta válida y un valor.

  • Nombre: el nombre de la ruta válida.
  • Valor: el valor de la ruta válida.
    • Todas: introduzca el valor Todas para crear una opción que indique que todas las rutas son válidas.
    • Ninguna: introduzca el valor Ninguna para crear una opción que indique que ninguna de las rutas es válida.
    • Pares de terminales: introduzca un solo par de terminales o una serie de pares de terminales. Introduzca un par de terminales único especificando la ruta de un terminal a otro separado por un guion, por ejemplo, A-B. Introduzca una serie de pares de terminales separados por comas, por ejemplo, A-B, A-C.
Value Table
Ruta predeterminada
(Opcional)

La ruta predeterminada de las configuraciones válidas. Se asignará a las entidades nuevas que tengan asignada esta configuración de terminales en su tipo de activos. Si no se han especificado rutas válidas, se utilizará la ruta predeterminada Todas.

  • TodasTodas las rutas son válidas. Esta es la opción predeterminada.
  • NadaNinguna de las rutas es válida.
String

Salida derivada

EtiquetaExplicaciónTipo de datos
Red de servicios actualizada

La red de servicios actualizada.

Utility Network

arcpy.un.AddTerminalConfiguration(in_utility_network, terminal_configuration_name, traversability_model, {terminals_directional}, {terminals_bidirectional}, {valid_paths}, {default_path})
NombreExplicaciónTipo de datos
in_utility_network

La red de servicios de entrada a la que se agregará la configuración de terminales.

Utility Network; Utility Network Layer
terminal_configuration_name

El nombre de la configuración de terminales.

String
traversability_model

Especifica la direccionalidad de la configuración de terminales. Un modelo de transitabilidad direccional significa que el flujo para el terminal solo irá en una dirección. Un modelo de transitabilidad bidireccional significa que el terminal permite el flujo en ambas direcciones.

  • DIRECTIONALSolo se permite una dirección de flujo.
  • BIDIRECTIONALSe permiten ambas direcciones de flujo.
String
terminals_directional
[[name, upstream],...]
(Opcional)

El nombre y flujo direccional de cada terminal direccional. Se debe especificar un mínimo de dos terminales y se puede especificar un máximo de ocho. El nombre de cada terminal no puede rebasar los 32 caracteres. Este parámetro es obligatorio si el valor del parámetro traversability_model es DIRECTIONAL.

  • Name: proporcione el nombre del terminal.
  • Upstream: indique si el terminal está aguas arriba o aguas abajo.
    • True: el terminal está aguas arriba.
    • False: el terminal está aguas abajo.
Value Table
terminals_bidirectional
[[name],...]
(Opcional)

El nombre de cada terminal bidireccional. Se debe especificar un mínimo de dos terminales y se puede especificar un máximo de ocho. El nombre de cada terminal no puede rebasar los 32 caracteres. Este parámetro es obligatorio si el valor del parámetro Direccionalidad es Bidireccional (traversability_model = "BIDIRECTIONAL" en Python).

Value Table
valid_paths
[[Name, [Value]],...]
(Opcional)

El nombre o nombres y la ruta o rutas válidas para la configuración de terminales. Para la transitabilidad bidireccional, este parámetro es obligatorio si tiene tres o cuatro terminales. Si está utilizando la transitabilidad direccional, uno de los terminales debe ser aguas arriba para tener configuraciones válidas. Se deben crear rutas válidas para indicar qué rutas de un dispositivo u objeto de cruce son válidas para el paso de un recurso. Indique un nombre para cada ruta válida y un valor.

  • Nombre: el nombre de la ruta válida.
  • Valor: el valor de la ruta válida.
    • Todas: introduzca el valor Todas para crear una opción que indique que todas las rutas son válidas.
    • Ninguna: introduzca el valor Ninguna para crear una opción que indique que ninguna de las rutas es válida.
    • Pares de terminales: introduzca un solo par de terminales o una serie de pares de terminales. Introduzca un par de terminales único especificando la ruta de un terminal a otro separado por un guion, por ejemplo, A-B. Introduzca una serie de pares de terminales separados por comas, por ejemplo, A-B, A-C.
Value Table
default_path
(Opcional)

La ruta predeterminada de las configuraciones válidas. Se asignará a las entidades nuevas que tengan asignada esta configuración de terminales en su tipo de activos. Si no se han especificado rutas válidas, se utilizará la ruta predeterminada All.

  • ALLTodas las rutas son válidas. Esta es la opción predeterminada.
  • NONENinguna de las rutas es válida.
String

Salida derivada

NombreExplicaciónTipo de datos
out_utility_network

La red de servicios actualizada.

Utility Network

Muestra de código

Ejemplo 1 de AddTerminalConfiguration (ventana de Python)

Agregar una configuración de terminales bidireccional con tres terminales.

import arcpy
arcpy.AddTerminalConfiguration_un('Electric Utility Network', 'config1', 
                                  'BIDIRECTIONAL', None, 'A;B;C', 
                                  'Top A-B;Bottom A-C', 'Top')
Ejemplo 2 de AddTerminalConfiguration (ventana de Python)

Agregar una configuración de terminales direccional con tres terminales.

import arcpy
arcpy.AddTerminalConfiguration_un('Electric Utility Network', 'config2', 
                                  'DIRECTIONAL', 'A true;B true;C false', None, 
                                  'Top A-B;Bottom A-C', 'Bottom')
Ejemplo 3 de AddTerminalConfiguration (ventana de Python)

Agregar una configuración de terminales direccional con tres terminales. Las rutas válidas se especifican mediante el uso de una colección de pares terminales.

import arcpy
arcpy.AddTerminalConfiguration_un('Electric Utility Network', 'config3', 
                                  'DIRECTIONAL', 'A true;B false;C false', None, 
                                  "AB A-B;ABAC 'A-B;A-C'", 'AB')

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

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

Temas relacionados