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 debe conectarse a la versión predeterminada cuando se ejecute.
- 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 conectado debe ser el propietario de la red de servicios del portal.
Sintaxis
arcpy.un.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.
| String |
terminals_directional [[name, upstream],...] (Opcional) | El nombre y flujo direccional de cada terminal direccional. Se debe especificar un mínimo de dos terminales, hasta 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.
| Value Table |
terminals_bidirectional [[name],...] (Opcional) | El nombre de cada terminal bidireccional. Se debe especificar un mínimo de dos terminales, hasta 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 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.
| 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.
| String |
Salida derivada
| Nombre | Explicación | Tipo de datos |
| out_utility_network | La red de servicios actualizada. | Red de servicios |
Muestra de código
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')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')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
Información de licenciamiento
- Basic: No
- Standard: Sí
- Advanced: Sí