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 cuando se ejecute.

  • 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.

  • Esta herramienta puede usarse con la herramienta Definir atributo de red, que se usa para asignar 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 atributoEn líneaAsignableAnulableSustitución

    Corto

    Marca de verificaciónMarca de verificación

    Largo

    Marca de verificaciónMarca de verificaciónMarca de verificación

    (Solo fuera de línea)

    Doble

    Marca de verificaciónMarca de verificación

    Fecha

    Marca de verificación

Parámetros

EtiquetaExplicaciónTipo 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 pequeño)Tipo Entero corto
  • Largo (entero grande)Tipo Entero largo
  • Doble (precisión doble)Topo Precisión doble
  • FechaTipo 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 en línea está limitado a 28 por cada red de servicios. 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) se deben almacenar 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.

  • 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.

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.

Por ejemplo, con el atributo de red shape_length, si una entidad de línea consta de cinco elementos de eje y si la longitud total de dicha entidad de línea es de 100 pies, ese atributo se distribuirá entre todos los ejes, asignando 20 pies a cada uno. 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)

El dominio al que se desea asociar el atributo de red. Este parámetro se requiere si En línea está activado. Este dominio se utiliza para determinar cuántos bits 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 y cualquier valor que introduzca se omitirá para la versión actual. La funcionalidad de este parámetro está en proceso de desarrollo y se aplicará a una versión futura.

Especifica si un atributo de red tiene una tabla de invalidación externa que la topología de red leerá y que invalidará (o sobrescribirá) el valor actual almacenado en la topología. Puede usarse para introducir datos en directo desde sistemas externos, por ejemplo, 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.
  • Desactivado: el atributo de red no admitirá valores nulos. Esta es la opción predeterminada.

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.

  • 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)

El atributo de red que se utilizará para la 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

EtiquetaExplicaciónTipo de datos
Red de servicios actualizada

La red de servicios actualizada.

Red de servicios

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})
NombreExplicaciónTipo 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.

  • SHORTTipo Entero corto
  • LONGTipo Entero largo
  • DOUBLETopo Precisión doble
  • DATETipo 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 en línea está limitado a 28 por cada red de servicios. 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) se deben almacenar 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.

  • INLINEEl atributo se agrega internamente a la topología, lo que hace que la recuperación sea más eficiente.
  • NOT_INLINEEl 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.

Por ejemplo, con el atributo de red shape_length, si una entidad de línea consta de cinco elementos de eje y si la longitud total de dicha entidad de línea es de 100 pies, ese atributo se distribuirá entre todos los ejes, asignando 20 pies a cada uno. La distribución del valor depende del porcentaje de cada elemento de eje respecto del punto de la entidad original.

  • APPORTIONABLEEl atributo de red se distribuirá.
  • NOT_APPORTIONABLEEl atributo de red no se distribuirá. Esta es la opción predeterminada.
Boolean
domain
(Opcional)

El dominio al que se desea asociar el atributo de red. Este parámetro es obligatorio si is_inline es True. Este dominio se utiliza para determinar cuántos bits 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 y cualquier valor que introduzca se omitirá para la versión actual. La funcionalidad de este parámetro está en proceso de desarrollo y se aplicará a una versión futura.

Especifica si un atributo de red tiene una tabla de invalidación externa que la topología de red leerá y que invalidará (o sobrescribirá) el valor actual almacenado en la topología. Puede usarse para introducir datos en directo desde sistemas externos, por ejemplo, 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.

  • OVERRIDESe invalidará el valor actual almacenado en la topología.
  • NOT_OVERRIDABLENo 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.

  • NULLABLEEl atributo de red admitirá valores nulos.
  • NOT_NULLABLEEl atributo de red no admitirá valores nulos. Esta es la opción predeterminada.
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.

  • SUBSTITUTIONEl atributo de red se utilizará como sustitución.
  • NOT_SUBSTITUTIONEl atributo de red no se utilizará como sustitución. Esta es la opción predeterminada.
Boolean
network_attribute_to_substitute
(Opcional)

El atributo de red que se utilizará para la 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

NombreExplicaciónTipo de datos
out_utility_network

La red de servicios actualizada.

Red de servicios

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.AddNetworkAttribute_un("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.AddNetworkAttribute_un("Utility Network", 
                             "Phases", "LONG", "NOT_INLINE", 
                             "NOT_APPORTIONABLE", 
                             "ElectricDistributionDeviceStatus", "", 
                             "NOT_NULLABLE", "SUBSTITUTION", 
                             "Phases current")

Entornos

Casos especiales

Información de licenciamiento

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

Temas relacionados