Añadir Regla (Red de servicios)

Resumen

Agrega una regla de red a una red de servicios.

Todas las reglas de red creadas en una red de servicios se basan en clases de la red de dominio y la red de estructura en los niveles de grupo de activos y tipo de activo que le permiten definir qué tipos de entidades u objetos se pueden conectar o asociar. Estas reglas se definen en función de las prácticas empresariales y se utilizan junto con las restricciones de entidades, que restringen las relaciones válidas entre clases, para administrar la corrección de los activos de una red.

Más información sobre las restricciones de entidades y las reglas de red

Uso

Parámetros

EtiquetaExplicaciónTipo de datos
Red de servicios de entrada

La red de servicios a la que se agregará la regla.

Utility Network; Utility Network Layer
Tipo de regla

Especifica el tipo de regla que se creará.

  • Conectividad de cruce-cruceSe creará una regla de conectividad de cruce-cruce para permitir la conexión de entidades de punto u objetos de cruce mediante una asociación de conectividad.
  • ContenciónSe creará una regla de contención en la cual los parámetros de origen son el contenedor y los parámetros de destino son el contenido de una asociación de contención.
  • Adjunto estructuralSe creará una regla de adjunto estructural en la cual los parámetros de origen son las entidades u objetos de estructura y los parámetros de destino son las entidades u objetos de adjunto de una asociación de adjunto estructural.
  • Conectividad de cruce-ejeSe creará una regla de conectividad de cruce-eje para permitir que las entidades de punto y línea se conecten mediante coincidencia geométrica (las entidades están en la misma ubicación x,y,z) o para permitir que un objeto de eje se conecte con entidades de punto u objetos de cruce mediante una asociación de conectividad.
  • Conectividad de eje-cruce-ejeSe creará una regla de conectividad de eje-cruce-eje para permitir que una línea se conecte a cualquier lado de una entidad de punto o para permitir que un objeto de eje se conecte con otro objeto de línea o de eje a través de una entidad de punto o un objeto de cruce.
String
Tabla de origen

La clase de entidad de red de servicios u objeto no espacial de origen que se incluirá en la regla.

Las reglas de asociación de contención y de adjunto estructural requieren que la entidad de red de estructura o contenedor se encuentre en este parámetro.

Al crear reglas de conectividad de cruce-eje y eje-cruce-eje, este parámetro debe hacer referencia al cruce u objeto de cruce.

String
Desde Grupo de activos

Un grupo de activos para el valor del parámetro Desde tabla al que se aplicará la regla.

String
Desde Tipo de activo

Un tipo de activo para el valor del parámetro Desde tabla al que se aplicará la regla.

String
Tabla de destino

La clase de entidad de red de servicios u objeto no espacial de destino que se incluirá en la regla.

Las reglas de asociación de contención y adjunto estructural requieren que la entidad de red de contenido o de adjuntos se encuentre en este parámetro.

Al crear reglas de conectividad de cruce-eje y eje-cruce-eje, el parámetro Desde tabla debe hacer referencia al cruce u objeto de cruce.

String
A Grupo de activos

Un grupo de activos para el valor del parámetro A tabla al que se aplicará la regla.

String
A Tipo de activo

Un tipo de activo para el valor del parámetro A tabla al que se aplicará la regla.

String
Desde terminal
(Opcional)

El terminal de origen al que se aplicará la regla. Será un terminal del valor del parámetro Desde tabla. Al crear una regla de conectividad para un dispositivo u objeto de cruce con terminales para la conexión a otra entidad de red, se debe especificar el lado del terminal desde el que conectarse, por ejemplo, el terminal del lado de alta de un transformador.

Este parámetro es obligatorio si el tipo de activo tiene terminales. Está inactivo si se especifica la regla de adjunto estructural o asociación de contención en el parámetro Tipo de regla.

String
A terminal
(Opcional)

El terminal de destino al que se aplicará la regla. Será un terminal en el valor del parámetro A tabla. Al crear una regla de conectividad para un dispositivo u objeto de cruce para la conexión a otra entidad de red con terminales, se debe especificar el lado del terminal al que conectarse, por ejemplo, el terminal del lado de baja de un transformador.

Este parámetro es obligatorio si el tipo de activo tiene terminales. Está inactivo para los tipos de regla de adjunto estructural y de asociación de contención.

String
A través de tabla
(Opcional)

La clase de entidad u objeto de cruce de la red de servicios a la que se aplicará la regla. Este parámetro solo está disponible si el parámetro Tipo de regla está establecido en Conectividad de eje-cruce-eje, dado que se requieren tres clases para participar en una conectividad de eje-cruce-eje.

String
A través de Grupo de activos
(Opcional)

Un grupo de activos del valor del parámetro A través de tabla al que se aplicará la regla. Este parámetro solo se activa cuando el parámetro Tipo de regla tiene el valor Conectividad de eje-cruce-eje.

String
A través de Tipo de activo
(Opcional)

Un tipo de activo del valor del parámetro A través de tabla al que se aplicará la regla. Este parámetro solo se activa cuando el parámetro Tipo de regla tiene el valor Conectividad de eje-cruce-eje.

String
A través de Terminal
(Opcional)

El terminal del valor del parámetro A través de tabla al que se aplicará la regla. Este parámetro solo se activa cuando el parámetro Tipo de regla tiene el valor Conectividad de eje-cruce-eje.

String

Salida derivada

EtiquetaExplicaciónTipo de datos
Red de servicios actualizada

La red de servicios actualizada.

Utility Network

arcpy.un.AddRule(in_utility_network, rule_type, from_class, from_assetgroup, from_assettype, to_class, to_assetgroup, to_assettype, {from_terminal}, {to_terminal}, {via_class}, {via_assetgroup}, {via_assettype}, {via_terminal})
NombreExplicaciónTipo de datos
in_utility_network

La red de servicios a la que se agregará la regla.

Utility Network; Utility Network Layer
rule_type

Especifica el tipo de regla que se creará.

  • JUNCTION_JUNCTION_CONNECTIVITYSe creará una regla de conectividad de cruce-cruce para permitir la conexión de entidades de punto u objetos de cruce mediante una asociación de conectividad.
  • CONTAINMENTSe creará una regla de contención en la cual los parámetros de origen son el contenedor y los parámetros de destino son el contenido de una asociación de contención.
  • STRUCTURAL_ATTACHMENTSe creará una regla de adjunto estructural en la cual los parámetros de origen son las entidades u objetos de estructura y los parámetros de destino son las entidades u objetos de adjunto de una asociación de adjunto estructural.
  • JUNCTION_EDGE_CONNECTIVITYSe creará una regla de conectividad de cruce-eje para permitir que las entidades de punto y línea se conecten mediante coincidencia geométrica (las entidades están en la misma ubicación x,y,z) o para permitir que un objeto de eje se conecte con entidades de punto u objetos de cruce mediante una asociación de conectividad.
  • EDGE_JUNCTION_EDGE_CONNECTIVITYSe creará una regla de conectividad de eje-cruce-eje para permitir que una línea se conecte a cualquier lado de una entidad de punto o para permitir que un objeto de eje se conecte con otro objeto de línea o de eje a través de una entidad de punto o un objeto de cruce.
String
from_class

La clase de entidad de red de servicios u objeto no espacial de origen que se incluirá en la regla.

Las reglas de asociación de contención y de adjunto estructural requieren que la entidad de red de estructura o contenedor se encuentre en este parámetro.

Al crear reglas de conectividad de cruce-eje y eje-cruce-eje, este parámetro debe hacer referencia al cruce u objeto de cruce.

String
from_assetgroup

Un grupo de activos para el valor del parámetro from_class al que se aplicará la regla.

String
from_assettype

Un tipo de activo para el valor del parámetro from_class al que se aplicará la regla.

String
to_class

La clase de entidad de red de servicios u objeto no espacial de destino que se incluirá en la regla.

Las reglas de asociación de contención y adjunto estructural requieren que la entidad de red de contenido o de adjuntos se encuentre en este parámetro.

Al crear reglas de conectividad de cruce-eje y eje-cruce-eje, el parámetro from_class debe hacer referencia al cruce u objeto de cruce.

String
to_assetgroup

Un grupo de activos para el valor del parámetro to_class al que se aplicará la regla.

String
to_assettype

Un tipo de activo para el valor del parámetro to_class al que se aplicará la regla.

String
from_terminal
(Opcional)

El terminal de origen al que se aplicará la regla. Será un terminal del valor del parámetro from_class. Al crear una regla de conectividad para un dispositivo u objeto de cruce con terminales para la conexión a otra entidad de red, se debe especificar el lado del terminal desde el que conectarse, por ejemplo, el terminal del lado de alta de un transformador.

Este parámetro es obligatorio si el tipo de activo tiene terminales. Se ignora para los tipos de regla de adjunto estructural o de contención.

String
to_terminal
(Opcional)

El terminal de destino al que se aplicará la regla. Será un terminal del valor del parámetro to_class. Al crear una regla de conectividad para un dispositivo u objeto de cruce para la conexión a otra entidad de red con terminales, se debe especificar el lado del terminal al que conectarse, por ejemplo, el terminal del lado de baja de un transformador.

Este parámetro es obligatorio si el tipo de activo tiene terminales. Se ignora para los tipos de regla de adjunto estructural o de contención.

String
via_class
(Opcional)

Tabla o clase de entidad de red de servicios de cruce a la que se aplicará la regla. Este parámetro solo se puede especificar si el parámetro rule_type está establecido en EDGE_JUNCTION_EDGE_CONNECTIVITY, ya que se requieren tres clases para participar en una conectividad de eje-cruce-eje.

String
via_assetgroup
(Opcional)

Un grupo de activos del valor del parámetro via_class al que se aplicará la regla. Este parámetro solo se puede especificar si el parámetro rule_type está establecido en EDGE_JUNCTION_EDGE_CONNECTIVITY.

String
via_assettype
(Opcional)

Un tipo de activo del valor del parámetro via_class al que se aplicará la regla. Este parámetro solo se puede especificar si el parámetro rule_type está establecido en EDGE_JUNCTION_EDGE_CONNECTIVITY.

String
via_terminal
(Opcional)

El terminal del valor del parámetro via_class al que se aplicará la regla. Este parámetro solo se puede especificar si el parámetro rule_type está establecido en EDGE_JUNCTION_EDGE_CONNECTIVITY.

String

Salida derivada

NombreExplicaciónTipo de datos
out_utility_network

La red de servicios actualizada.

Utility Network

Muestra de código

Ejemplo 1 de AddRule (ventana de Python)

Este ejemplo crea una regla de asociación de conectividad de cruce-cruce para permitir que el lado de carga de los interruptores de circuito se conecte al lado de alta de los transformadores de una red de distribución eléctrica.

import arcpy
arcpy.un.AddRule("Distribution Network", "JUNCTION_JUNCTION_CONNECTIVITY", 
                 "ElectricDistributionDevice", "CircuitBreaker", "Air powered", 
                 "ElectricDistributionLine", "Transformer", "High")
Ejemplo 2 de AddRule (ventana de Python)

Este ejemplo crea una regla de conectividad de cruce-eje para permitir que el lado de carga de los interruptores de circuito se conecte a líneas de media tensión de una red de distribución eléctrica.

import arcpy
arcpy.un.AddRule("Utility Network", "JUNCTION_EDGE_CONNECTIVITY", 
                 "ElectricDistributionDevice", "CircuitBreaker", "Air powered", 
                 "ElectricDistributionLine", "Medium Voltage", 
                 "Single Phase Overhead")
Ejemplo 3 de AddRule (ventana de Python)

Este script de ejemplo crea una regla de asociación de contención para permitir que una caja de conexiones contenga un codo.

import arcpy
arcpy.un.AddRule("Electric Network", "CONTAINMENT", "StructureJunction", 
                 "JunctionBox", "Junction Box", "ElectricDistributionDevice", 
                 "Fuse", "Underground Single Phase Load Break Elbow")
Ejemplo 4 de AddRule (ventana de Python)

Este script de ejemplo crea una regla de asociación de adjunto estructural para permitir la conexión estructural de un interruptor a un poste.

import arcpy
arcpy.un.AddRule("Electric Network", "STRUCTURAL_ATTACHMENT", 
                 "StructureJunction", "Pole", "Wood", 
                 "ElectricDistributionDevice", "Switch", 
                 "Overhead Low Voltage Single Phase Disconnect")

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

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

Temas relacionados