Agregar ubicaciones de seguimiento (Red de servicios)

Resumen

Crea una clase de entidad para su uso como entrada de barreras y puntos de partida para la herramienta Seguimiento.

Uso

• La clase de entidad de salida tiene el mismo esquema que las barreras y puntos de partida de entrada que se necesitan como entrada para la herramienta Seguimiento. De este modo, puede especificar distintas ubicaciones de seguimiento en las operaciones de seguimiento de ModelBuilder o un entorno de scripts.

• No puede especificar valores de forma simultánea para los parámetros Cargar entidades seleccionadas y Ubicaciones de seguimiento, ya que se excluyen mutuamente.

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án las ubicaciones de seguimiento.	Utility Network; Utility Network Layer
Clase de entidad de salida	La clase de entidad de salida que contiene las ubicaciones de seguimiento. Si especifica un nuevo nombre de clase de entidad, se creará una nueva clase de entidad de salida. Para utilizar una clase de entidad existente que se creó anteriormente con esta herramienta e incorporar o sobrescribir las ubicaciones existentes, especifique el nombre de dicha clase de entidad.	Feature Class
Cargar entidades seleccionadas (Opcional)	Especifica si las entidades seleccionadas en el mapa activo se cargarán como ubicaciones de seguimiento. Activado: cargará las ubicaciones de seguimiento en función de la selección del mapa. Desactivado: no cargará las ubicaciones de seguimiento en función de la selección del mapa. Esta es la opción predeterminada. Sin embargo, estas ubicaciones de seguimiento se pueden cargar con el parámetro Ubicaciones de seguimiento.	Boolean
Borrar las ubicaciones de seguimiento (Opcional)	Especifica si las ubicaciones de seguimiento se borrarán de la clase de entidad de salida. Activado: las ubicaciones de seguimiento existentes se borrarán. Desactivado: las ubicaciones de seguimiento existentes no se borrarán; se conservarán. Esta es la opción predeterminada.	Boolean
Ubicaciones de trazado (Opcional)	Ubicaciones de seguimiento que se agregarán a la clase de entidad de salida. Si no está utilizando el parámetro Cargar entidades seleccionadas en un mapa activo, puede utilizarlo para especificar las entidades de red de servicios para agregarlas como ubicaciones de trazado si introduce los valores necesarios en la tabla de valores. Las propiedades de las ubicaciones de seguimiento son las siguientes: Nombre de la capa: la capa que forma parte de la red de servicios y que contiene una ubicación de barrera o punto de partida que se desea agregar. Si hay un mapa activo, solo se permiten las capas del mapa. Id. global: el Id. global de la entidad de capa en la que se agrega la ubicación. Id. de terminal: el Id. de terminal de la entidad de capa en la que se agrega la ubicación. Porcentaje a lo largo: el valor de porcentaje a lo largo de la entidad de capa. En el caso de las entidades de línea, el valor predeterminado es 0,5.	Value Table
Barrera de filtro	Especifica el comportamiento de las barreras para las ubicaciones de trazado. Activado: la barrera se comporta como una barrera de filtro. Es útil para trazados basados en subredes donde la barrera permite que la subred se evalúe primero y, después, se aplica en un segundo recorrido de las entidades de red, actuando fundamentalmente como una barrera de filtro. Desactivado: la barrera se comporta como una barrera de transitabilidad. Las barreras de transitabilidad definen la extensión de las subredes y se evaluarán en la primera pasada. Esta es la opción predeterminada. Nota: Este parámetro requiere ArcGIS Enterprise 10.9 o versiones posteriores.	Boolean

Python

arcpy.un.AddTraceLocations(in_utility_network, out_feature_class, {load_selected_features}, {clear_trace_locations}, {trace_locations}, filter_barrier)

Nombre	Explicación	Tipo de datos
in_utility_network	La red de servicios de entrada a la que se agregarán las ubicaciones de seguimiento.	Utility Network; Utility Network Layer
out_feature_class	La clase de entidad de salida que contiene las ubicaciones de seguimiento. Si especifica un nuevo nombre de clase de entidad, se creará una nueva clase de entidad de salida. Para utilizar una clase de entidad existente que se creó anteriormente con esta herramienta e incorporar o sobrescribir las ubicaciones existentes, especifique el nombre de dicha clase de entidad.	Feature Class
load_selected_features (Opcional)	Especifica si las entidades seleccionadas en el mapa activo se cargarán como ubicaciones de seguimiento. LOAD_SELECTED_FEATURES—Se cargarán las ubicaciones de seguimiento en función de la selección del mapa. DO_NOT_LOAD_SELECTED_FEATURES—No se cargarán las ubicaciones de seguimiento en función de la selección del mapa. Esta es la opción predeterminada. Sin embargo, estas ubicaciones de seguimiento se pueden cargar con el parámetro trace_locations.	Boolean
clear_trace_locations (Opcional)	Especifica si las ubicaciones de seguimiento se borrarán de la clase de entidad de salida. CLEAR_LOCATIONS—Las ubicaciones de seguimiento existentes se borrarán. KEEP_LOCATIONS—Las ubicaciones de seguimiento existentes no se borrarán; se conservarán. Esta es la opción predeterminada.	Boolean
trace_locations [[Layer Name, Global ID, Terminal ID, Percent Along],...] (Opcional)	Ubicaciones de seguimiento que se agregarán a la clase de entidad de salida. Si no está utilizando el parámetro load_selected_features en un mapa activo, puede utilizarlo para especificar las entidades de red de servicios para agregarlas como ubicaciones de seguimiento si introduce los valores necesarios en la tabla de valores. Las propiedades de las ubicaciones de seguimiento son las siguientes: Layer Name: la clase de entidad o capa que forma parte de la red de servicios y que contiene la ubicación de barrera o punto de partida que se desea agregar. Si hay un mapa activo, solo se permiten las capas del mapa; si no, será el nombre de clase de entidad. Global ID: el Id. global de la entidad en la que se agrega la ubicación. Terminal ID: el Id. de terminal de la entidad en la que se agrega la ubicación. Percent Along: valor de porcentaje a lo largo de la entidad. En el caso de las entidades de línea, el valor predeterminado es 0,5.	Value Table
filter_barrier	Especifica el comportamiento de las barreras para las ubicaciones de trazado. Más información sobre las barreras FILTER_BARRIER—La barrera se comporta como una barrera de filtro. Es útil para trazados basados en subredes donde la barrera permite que la subred se evalúe primero y, después, se aplica en un segundo recorrido de las entidades de red, actuando fundamentalmente como una barrera de filtro. TRAVERSABILITY_BARRIER—La barrera se comporta como una barrera de transitabilidad. Las barreras de transitabilidad definen la extensión de las subredes y se evaluarán en la primera pasada. Esta es la opción predeterminada. Nota: Este parámetro requiere ArcGIS Enterprise 10.9 o versiones posteriores.	Boolean

Muestra de código

Ejemplo 1 de AddTraceLocations (ventana de Python)

Agregar ubicaciones de seguimiento a una nueva clase de entidad de salida denominada TraceLocations cargando entidades seleccionadas en el mapa activo.

import arcpy
arcpy.env.outputZFlag = "Enabled"
arcpy.AddTraceLocations_un("Naperville Electric UN", 
                           r"C:\MyUNProject\MyUNProject.gdb\TraceLocations",
                           "LOAD_SELECTED_FEATURES")

Ejemplo 2 de AddTraceLocations (script independiente)

Agregar ubicaciones de seguimiento a una clase de entidad existente denominada TraceLocations sin ningún mapa activo.

import arcpy
# Set the outputZFlag environment to Enabled
arcpy.env.outputZFlag = "Enabled"
# AddTraceLocations
arcpy.AddTraceLocations_un(r"http://utilitynetwork.esri.com/server/rest/services/NapervilleElectric/FeatureServer/9", 
                           r"C:\MyUNProject\MyUNProject.gdb\TraceLocations",
                           "DO_NOT_LOAD_SELECTED_FEATURES",
                           "KEEP_LOCATIONS",
                           r"'Circuit Breaker' {DDB0765D-860A-4054-908D-9360E1A32F74} '(3/Load)' '';'Circuit Breaker' {4849D307-6413-40B7-B672-716AF50EE6E6} '(3/Load)' '' )

Entornos

Espacio de trabajo actual, La salida tiene valores Z

Casos especiales

Información de licenciamiento

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