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

Resumen

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

Las entidades con terminales requieren restricciones que definan la configuración válida de la conectividad interna del dispositivo u objeto de cruce. Esta herramienta le permite agregar una nueva configuración de terminales a una red de servicios que se puede asignar más tarde 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 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 y un máximo de ocho terminales. El nombre del terminal debe ser una descripción significativa, por ejemplo, lado de alta o lado de fuente.

• En el caso de las entidades con tres o cuatro terminales, puede definir configuraciones 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 se debe ejecutar cuando esté conectada a la versión predeterminada.
  • 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.
  • La cuenta del portal de ArcGIS Enterprise conectado debe ser el propietario de la red de servicios del portal.

Sintaxis

AddTerminalConfiguration(in_utility_network, terminal_configuration_name, traversability_model, {terminals_directional}, {terminals_bidirectional}, {valid_paths}, {default_path})

Parámetro	Explicación	Tipo 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. DIRECTIONAL —Solo se permite una única dirección de flujo. BIDIRECTIONAL —Se permiten ambas direcciones de flujo.	String
terminals_directional [[name, upstream],...] (Opcional)	El nombre y flujo direccional de cada terminal. Se debe especificar un mínimo de dos y un máximo de ocho terminales. 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 y un máximo de ocho terminales. 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 más terminales. Si está utilizando la transitabilidad direccional, uno de los terminales debe ser aguas arriba para tener configuraciones válidas. Se deben definir 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 especifique un valor. Nombre: el nombre de la ruta válida. Valor: el valor de la ruta válida. Todas: todas las rutas son válidas. Ninguna: ninguna de las rutas es válida. Par de terminales: una ruta única de un terminal a otro, por ejemplo, A-B. Colección de pares de terminales: indica una colección de rutas individuales de un terminal a otro, 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 configuraciones válidas, se utilizará la configuración predeterminada ALL. ALL —Todas las rutas son válidas. Esta es la opción predeterminada. NONE —Ninguna de las rutas es válida.	String

Salida derivada

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

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', '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', 
                                  'Top A-B;Bottom A-C', 'Bottom')

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

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