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 propietaria 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 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

    Entero grande

    Nota:
    Los atributos de red Entero grande son compatibles con Utility Network versión 7 y posteriores.
    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

Nombre del atributo de red que se agregará a la red de servicio.

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.
  • FechaEl tipo de campo será fecha.
  • Entero grande (entero de 64 bits)El tipo de campo será entero grande.
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 o 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.

Por ejemplo, con el atributo de red shape_length, si una entidad de línea consta de cinco elementos de eje de 20 pies cada uno en los que la longitud total de dicha entidad de línea es de 100 pies, el 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.

Más información sobre cómo calcular el tamaño de bit para atributos de red En línea

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

EtiquetaExplicaciónTipo de datos
Red de servicios actualizada

La red de servicios actualizada.

Utility Network

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

Nombre del atributo de red que se agregará a la red de servicio.

String
attribute_type

Especifica el tipo de datos del atributo de red.

  • SHORTEl tipo de campo será corto.
  • LONGEl tipo de campo será largo.
  • DOUBLEEl tipo de campo será doble.
  • DATEEl tipo de campo será fecha.
  • BIGINTEGEREl tipo de campo será entero grande.
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 o largo).

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

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.

Por ejemplo, con el atributo de red shape_length, si una entidad de línea consta de cinco elementos de eje de 20 pies cada uno en los que la longitud total de dicha entidad de línea es de 100 pies, el 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.

  • APPORTIONABLEEl atributo de red se distribuirá.
  • NOT_APPORTIONABLEEl 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.

  • 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. Esta es la opción predeterminada.
  • NOT_NULLABLEEl 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.

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

Atributo de red que se 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

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

Información de licenciamiento

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

Temas relacionados