Agregar la configuración de terminal (Herramientas de 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 la red de servicios.

Etiqueta	Explicación	Tipo 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. Direccional—Solo se permite una dirección de flujo. Bidireccional—Se 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. Columnas de la tabla de valores: Name—The name of the terminal. Upstream—Indicates whether the terminal is upstream or downstream.	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.	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. Utilice el siguiente valor: All—Introduzca el valor Todas para crear una opción que indique que todas las rutas son válidas. None—Introduzca el valor Ninguna para crear una opción que indique que ninguna de las rutas es válida. Terminal pair(s)—Introduzca un solo par de terminales o una colección de los mismos. Introduzca un par de terminales único especificando la ruta de un terminal a otro separado por un guion, por ejemplo, A-B. Introduzca una colección de pares de terminales separados por una coma, por ejemplo, A-B, A-C. Columnas de la tabla de valores: Name—The name of the valid path. Value—The value of the path.	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. Todo—Todas las rutas son válidas. Esta es la opción predeterminada. Ninguno—Ninguna de las rutas es válida.	String

Salida derivada

Etiqueta	Explicación	Tipo 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})

Nombre	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 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 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`. Columnas de la tabla de valores: `Name`—The name of the terminal. `Upstream`—Indicates whether the terminal is upstream or downstream.	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 `traversability_model` es `BIDIRECTIONAL`.	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. Utilice el siguiente valor: All—Introduzca el valor Todas para crear una opción que indique que todas las rutas son válidas. None—Introduzca el valor Ninguna para crear una opción que indique que ninguna de las rutas es válida. Terminal pair(s)—Introduzca un solo par de terminales o una colección de los mismos. Introduzca un par de terminales único especificando la ruta de un terminal a otro separado por un guion, por ejemplo, A-B. Introduzca una colección de pares de terminales separados por una coma, por ejemplo, A-B, A-C. Columnas de la tabla de valores: `Name`—The name of the valid path. `Value`—The value of the path.	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`. `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.	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.un.AddTerminalConfiguration('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.un.AddTerminalConfiguration('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.un.AddTerminalConfiguration('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í
Avanzado: Sí

Agregar la configuración de terminal (Herramientas de red de servicios)

Resumen

Uso

Parámetros

Salida derivada

Entornos

Información de licenciamiento

Temas relacionados