Agregar atributo de red (Red de servicios)

Resumen

Agrega un atributo de red a una red de servicios.

Un atributo de red es un valor derivado de atributos de las entidades correspondientes de la red y almacenado en la topología de red. Los atributos de red se utilizan en el análisis de seguimiento para controlar cómo se recorre la red. Mientras que un atributo de red puede asociarse a un único atributo de una clase de entidad, no existe ningún límite en cuanto al número de atributos de red que puede tener una sola red de servicios. Los atributos de red se usan como pesos para controlar la traversabilidad y para modelar el coste de las rutas de la red.

Uso

• Los atributos de red pueden asociarse a un único atributo de una clase de entidad; sin embargo, es posible asociarlo a varias clases de entidades.

• Al trabajar con una geodatabase corporativa, la cuenta del portal de ArcGIS Enterprise conectada debe ser el propietario de la red de servicios del portal.

• La topología de red debe estar desactivada.

• Al trabajar con una geodatabase corporativa, esta herramienta debe conectarse a la versión predeterminada para ejecutarse.

• Al trabajar con una geodatabase corporativa, 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.

Licencia:

Para utilizar esta herramienta en una implementación empresarial, se debe asignar una licencia con la extensión de tipo de usuario ArcGIS Advanced Editing a la cuenta del portal activo.

• Esta herramienta puede usarse con la herramienta Definir atributo de red, que asigna el atributo de red a un campo de clase de entidad de la red de servicios.

• La siguiente tabla enumera los tipos de atributos de red y sus parámetros aplicables:

  Tipo de atributo	En línea	Asignable	Anulable	Sustitución
  Corto
  Largo				(Solo fuera de línea)
  Doble
  Fecha

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Red de servicios de entrada	La red de servicios de entrada a la que se agregará el atributo de red.	Utility Network; Utility Network Layer
Nombre de atributo	El nombre del atributo de red que se desea agregar a la red de servicios.	String
Tipo de atributo	Especifica el tipo de datos del atributo de red. Corto (entero de 16 bits)—El tipo de campo será corto. Largo (entero de 32 bits)—El tipo de campo será largo. Doble (punto flotante de 64 bits)—El tipo de campo será doble. Fecha—El tipo de campo será fecha.	String
En línea (Opcional)	Especifica si el atributo de red será persistente en línea. Los atributos de red en línea son levemente más eficientes, pero el número de bits de los atributos de red en línea definidos por el usuario está limitado a 25 por cada red de servicios. Guarde los atributos de red utilizados más frecuentemente (por ejemplo, fase en las redes eléctricas, presión en las redes de gas y agua) en línea siempre que sea posible. El tamaño de los bits depende del parámetro de dominio. Los atributos en línea solo se admiten para los atributos de red de entero (corto, largo). Activado: el atributo se agrega internamente a la topología, lo que hace que la recuperación sea más eficiente. Desactivado: el atributo se almacena en una tabla externa y su recuperación requerirá una llamada a la tabla de pesos externa. Esta es la opción predeterminada.	Boolean
Asignable (Opcional)	Especifica si el atributo de red se distribuirá a través de varios ejes que pertenecen a la misma entidad. El comportamiento prorrateado silo se admite con atributos de red dobles. Los atributos de red con la propiedad distribuible se pueden asignar a campos de clases de entidades de cruce o línea, pero solo las entidades de línea tendrán el comportamiento distribuible. Para ilustrarlo, considere el atributo de red shape_length y una entidad de línea formada por cinco elementos de eje de 20 pies cada uno, donde la longitud total de esa entidad de línea es de 100 pies. Este atributo se distribuirá entre todos los ejes. Por ejemplo, al usar una función en un trazado conectado para contar el atributo shape length de esta línea, se devolverá un recuento de 5 porque tiene en cuenta cada elemento de eje individual y no la línea entera. La distribución del valor depende del porcentaje de cada elemento de eje respecto del punto de la entidad original. Activado: el atributo de red se distribuirá. Desactivado: el atributo de red no se distribuirá. Esta es la opción predeterminada.	Boolean
Nombre de dominio (Opcional)	Dominio al que se asociará el atributo de red. Este parámetro se requiere si En línea está activado. Este dominio se utiliza para determinar la cantidad de bits que se desea asignar para el atributo en línea y debe ser un tipo de valor codificado. Por ejemplo, el dominio LifeCycleStatusDomain (0, Unknown | 1, In-Service | 2, Proposed | 3, Abandoned) tiene cuatro entradas, lo que significa que se requieren 2 bits para almacenar el atributo en línea. El dominio de valor codificado debe tener códigos secuenciales, a partir de 0.	String
Es invalidable (Opcional)	Nota: Este parámetro no se utiliza en la versión actual y cualquier valor que se proporcione se ignorará. La funcionalidad de este parámetro está en proceso de desarrollo y se aplicará a una versión futura. Especifica si el valor actual almacenado en la topología se invalidará utilizando una tabla de invalidación externa. Este parámetro puede usarse, por ejemplo, para introducir datos en directo desde sistemas externos, como la posición actual en el caso de la electricidad o el valor de presión en el caso del gas. Un ejemplo es un sistema SCADA que traslada las posiciones de conmutación actualizadas del Dispositivo A a la tabla de invalidación del atributo de red DeviceStatus, que se utiliza a continuación desde el motor de topología para invalidar su valor actual de estado de dispositivo para el Dispositivo A con el valor de invalidación. Activado: se invalidará el valor actual almacenado en la topología. Desactivado: no se invalidará el valor actual almacenado en la topología. Esta es la opción predeterminada.	Boolean
Anulable (Opcional)	Especifica si el atributo de red admitirá valores nulos. Activado: el atributo de red admitirá valores nulos. Esta es la opción predeterminada. Desactivado: el atributo de red no admitirá valores nulos.	Boolean
Sustitución (Opcional)	Especifica si el atributo de red se utilizará como sustitución. Los atributos de red de sustitución permiten utilizar un valor sustituido en lugar de valores de atributo de red de conjunto de bits durante una propagación en una operación de seguimiento. La sustitución solo se admite con atributos de red de enteros largos. Activado: el atributo de red se utilizará como sustitución. Desactivado: el atributo de red no se utilizará como sustitución. Esta es la opción predeterminada.	Boolean
Atributo de red a sustituir (Opcional)	Atributo de red que se va a utilizar en sustitución. Las sustituciones se codifican a partir del número de bits del atributo de red propagado. El atributo de red debe estar en línea y ser un campo de tipo entero de 8 bits o menos.	String

Salida derivada

Etiqueta	Explicación	Tipo de datos
Red de servicios actualizada	La red de servicios actualizada.	Utility Network

Python

arcpy.un.AddNetworkAttribute(in_utility_network, attribute_name, attribute_type, {is_inline}, {is_apportionable}, {domain}, {is_overridable}, {is_nullable}, {is_substitution}, {network_attribute_to_substitute})

Nombre	Explicación	Tipo de datos
in_utility_network	La red de servicios de entrada a la que se agregará el atributo de red.	Utility Network; Utility Network Layer
attribute_name	El nombre del atributo de red que se desea agregar a la red de servicios.	String
attribute_type	Especifica el tipo de datos del atributo de red. SHORT—El tipo de campo será corto. LONG—El tipo de campo será largo. DOUBLE—El tipo de campo será doble. DATE—El tipo de campo será fecha.	String
is_inline (Opcional)	Especifica si el atributo de red será persistente en línea. Los atributos de red en línea son levemente más eficientes, pero el número de bits de los atributos de red en línea definidos por el usuario está limitado a 25 por cada red de servicios. Guarde los atributos de red utilizados más frecuentemente (por ejemplo, fase en las redes eléctricas, presión en las redes de gas y agua) en línea siempre que sea posible. El tamaño de los bits depende del parámetro de dominio. Los atributos en línea solo se admiten para los atributos de red de entero (corto, largo). INLINE—El atributo se agrega internamente a la topología, lo que hace que la recuperación sea más eficiente. NOT_INLINE—El atributo se almacena en una tabla externa y su recuperación requerirá una llamada a la tabla de pesos externa. Esta es la opción predeterminada.	Boolean
is_apportionable (Opcional)	Especifica si el atributo de red se distribuirá a través de varios ejes que pertenecen a la misma entidad. El comportamiento prorrateado silo se admite con atributos de red dobles. Los atributos de red con la propiedad distribuible se pueden asignar a campos de clases de entidades de cruce o línea, pero solo las entidades de línea tendrán el comportamiento distribuible. Para ilustrarlo, considere el atributo de red shape_length y una entidad de línea formada por cinco elementos de eje de 20 pies cada uno, donde la longitud total de esa entidad de línea es de 100 pies. Este atributo se distribuirá entre todos los ejes. Por ejemplo, al usar una función en un trazado conectado para contar el atributo shape_length de esta línea, se devolverá un recuento de 5 porque tiene en cuenta cada elemento de eje individual y no la línea entera. La distribución del valor depende del porcentaje de cada elemento de eje respecto del punto de la entidad original. APPORTIONABLE—El atributo de red se distribuirá. NOT_APPORTIONABLE—El atributo de red no se distribuirá. Esta es la opción predeterminada.	Boolean
domain (Opcional)	Dominio al que se asociará el atributo de red. Este parámetro es obligatorio cuando is_inline = "INLINE". Este dominio se utiliza para determinar la cantidad de bits que se desea asignar para el atributo en línea y debe ser un tipo de valor codificado. Por ejemplo, el dominio LifeCycleStatusDomain (0, Unknown | 1, In-Service | 2, Proposed | 3, Abandoned) tiene cuatro entradas, lo que significa que se requieren 2 bits para almacenar el atributo en línea. El dominio de valor codificado debe tener códigos secuenciales, a partir de 0.	String
is_overridable (Opcional)	Nota: Este parámetro no se utiliza en la versión actual y cualquier valor que se proporcione se ignorará. La funcionalidad de este parámetro está en proceso de desarrollo y se aplicará a una versión futura. Especifica si el valor actual almacenado en la topología se invalidará utilizando una tabla de invalidación externa. Este parámetro puede usarse, por ejemplo, para introducir datos en directo desde sistemas externos, como la posición actual en el caso de la electricidad o el valor de presión en el caso del gas. Un ejemplo es un sistema SCADA que traslada las posiciones de conmutación actualizadas del Dispositivo A a la tabla de invalidación del atributo de red DeviceStatus, que se utiliza a continuación desde el motor de topología para invalidar su valor actual de estado de dispositivo para el Dispositivo A con el valor de invalidación. OVERRIDE—Se invalidará el valor actual almacenado en la topología. NOT_OVERRIDABLE—No se invalidará el valor actual almacenado en la topología. Esta es la opción predeterminada.	Boolean
is_nullable (Opcional)	Especifica si el atributo de red admitirá valores nulos. NULLABLE—El atributo de red admitirá valores nulos. Esta es la opción predeterminada. NOT_NULLABLE—El atributo de red no admitirá valores nulos.	Boolean
is_substitution (Opcional)	Especifica si el atributo de red se utilizará como sustitución. Los atributos de red de sustitución permiten utilizar un valor sustituido en lugar de valores de atributo de red de conjunto de bits durante una propagación en una operación de seguimiento. La sustitución solo se admite con atributos de red de enteros largos. SUBSTITUTION—El atributo de red se utilizará como sustitución. NOT_SUBSTITUTION—El atributo de red no se utilizará como sustitución. Esta es la opción predeterminada.	Boolean
network_attribute_to_substitute (Opcional)	Atributo de red que se va a utilizar en sustitución. Las sustituciones se codifican a partir del número de bits del atributo de red propagado. El atributo de red debe estar en línea y ser un campo de tipo entero de 8 bits o menos.	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 AddNetworkAttribute (ventana de Python)

Agregar un atributo de red denominado Device Status con un tipo de atributo corto.

import arcpy
arcpy.un.AddNetworkAttribute("Utility Network", "Device Status", "SHORT", 
                             "INLINE", "NOT_APPORTIONABLE", "", 
                             "ElectricDistributionDeviceStatus", 
                             "NOT_OVERRIDABLE")

Ejemplo 2 de AddNetworkAttribute (ventana de Python)

Agregar un atributo de red para su uso para la sustitución.

import arcpy
arcpy.un.AddNetworkAttribute("Utility Network", 
                             "Phases", "LONG", "NOT_INLINE", 
                             "NOT_APPORTIONABLE", 
                             "ElectricDistributionDeviceStatus", "", 
                             "NOT_NULLABLE", "SUBSTITUTION", 
                             "Phases current")

Entornos

Espacio de trabajo actual

Información de licenciamiento

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