Agregar ubicaciones de trazado (Herramientas de red de servicios)
Resumen
Crea una clase de entidad que se utilizará como entrada de puntos de partida, puntos de parada y barreras para la herramienta Trazado.
Uso
La clase de entidad de salida tendrá el mismo esquema que los puntos de partida, puntos de paradas y barreras de entrada que se necesitan como entrada para la herramienta Trazado. De este modo, puede especificar distintas ubicaciones de trazado en las operaciones de trazado de ModelBuilder o Python.
No puede especificar valores de forma simultánea para los parámetros Cargar entidades seleccionadas y Ubicaciones de trazado, ya que se excluyen mutuamente.
La red de servicios de entrada a la que se agregarán las ubicaciones de seguimiento.
Importante:
Cuando la red de servicios especificada para el parámetro Red de servicios de entrada contiene una red de dominio de telecomunicaciones, las ubicaciones de trazado de salida incluyen tres campos adicionales: FIRSTUNIT, LASTUNIT y COLORSCHEME. Estos campos deben modificarse manualmente en la clase de entidad de salida para especificar los identificadores de unidad en los objetos agrupados a los que se aplica la ubicación de trazado.
Utility Network; Utility Network Layer
Clase de entidad de salida
La clase de entidad de salida que contiene las ubicaciones de seguimiento.
Si proporciona un nuevo nombre de clase de entidad, se creará una nueva clase de entidad de salida. Puede proporcionar el nombre de una clase de entidad existente y optar por agregar ubicaciones de trazado a cualquier ubicación existente en la clase de entidad, o sobrescribirlas utilizando el parámetro Borrar ubicaciones de trazado.
Nota:
Cuando se trabaja con una red de servicios versión 7 o posterior, la clase de entidad de salida se debe crear en una geodatabase corporativa, de archivos o móvil.
Feature Class
Cargar entidades seleccionadas
(Opcional)
Especifica si las entidades seleccionadas en el mapa activo se cargarán como ubicaciones de seguimiento.
Activado—Se cargarán las ubicaciones de seguimiento en función de la selección del mapa.
Desactivado—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 trazado se pueden especificar con el parámetro Ubicaciones de trazado.
Boolean
Borrar las ubicaciones de seguimiento
(Opcional)
Especifica si las ubicaciones de trazado existentes se borrarán de la clase de entidad de salida.
Activado—Las ubicaciones de seguimiento existentes se borrarán.
Desactivado—Las ubicaciones de trazado existentes no se borrarán; se conservarán e incorporará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 seguimiento si introduce los valores necesarios en la tabla de valores.
Columnas de la tabla de valores:
Layer Name—The layer that contains the locations to add.
Global ID—The Global ID of the feature for the location to add.
Terminal—The terminal ID of the feature for the location to add.
Percent Along—The percent along value of the feature. For lines and edge objects, the default value is 0.5.
Value Table
Barrera de filtro
Especifica si las ubicaciones de trazado se comportarán como barreras de filtro cuando se utilicen como barreras.
Activado—Las barreras se comportarán como barreras de filtrado. Es útil para los trazados basados en subredes en los que la barrera permite evaluar primero la subred y luego se aplica en un segundo trazado poligonal de las entidades de la red.
Desactivado—Las barreras se comportarán como barreras de transitabilidad, que definen la extensión de las subredes y se evaluarán en la primera pasada. Esta es la opción predeterminada.
La red de servicios de entrada a la que se agregarán las ubicaciones de seguimiento.
Importante:
Cuando la red de servicios especificada para el parámetro in_utility_network de entrada contiene una red de dominio de telecomunicaciones, las ubicaciones de trazado de salida incluyen tres campos adicionales: FIRSTUNIT, LASTUNIT y COLORSCHEME. Estos campos deben modificarse manualmente en la clase de entidad de salida para especificar los identificadores de unidad en los objetos agrupados a los que se aplica la ubicación de trazado.
Utility Network; Utility Network Layer
out_feature_class
La clase de entidad de salida que contiene las ubicaciones de seguimiento. Si proporciona un nuevo nombre de clase de entidad, se creará una nueva clase de entidad de salida. Puede proporcionar el nombre de una clase de entidad existente y optar por agregar ubicaciones de trazado a cualquier ubicación existente en la clase de entidad, o sobrescribirlas utilizando el parámetro clear_trace_locations.
Nota:
Cuando se trabaja con una red de servicios versión 7 o posterior, la clase de entidad de salida se debe crear en una geodatabase corporativa, de archivos o móvil.
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 trazado se pueden especificar con el parámetro trace_locations.
Boolean
clear_trace_locations
(Opcional)
Especifica si las ubicaciones de trazado existentes 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 trazado existentes no se borrarán; se conservarán e incorporará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 trazado si introduce los valores necesarios en la tabla de valores.
Columnas de la tabla de valores:
Layer Name—The layer that contains the locations to add.
Global ID—The Global ID of the feature for the location to add.
Terminal—The terminal ID of the feature for the location to add.
Percent Along—The percent along value of the feature. For lines and edge objects, the default value is 0.5.
Value Table
filter_barrier
Especifica si las ubicaciones de trazado se comportarán como barreras de filtro cuando se utilicen como barreras.
FILTER_BARRIER—Las barreras se comportarán como barreras de filtrado. Es útil para los trazados basados en subredes en los que la barrera permite evaluar primero la subred y luego se aplica en un segundo trazado poligonal de las entidades de la red.
TRAVERSABILITY_BARRIER—Las barreras se comportarán como barreras de transitabilidad, que definen la extensión de las subredes y se evaluarán en la primera pasada. Esta es la opción predeterminada.
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.un.AddTraceLocations("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.un.AddTraceLocations(r"http://landbase.mydomain.com/server/rest/services/NapervilleElectric/FeatureServer/9",
r"C:\Project\MyUNProject.gdb\TraceLocations",
"DO_NOT_LOAD_SELECTED_FEATURES",
"KEEP_LOCATIONS",
"'Circuit Breaker' {DDB0765D-860A-4054-908D-9360E1A32F74} '(3/Load)' #;'ElecDist Line' {67C0534B-A80D-4E5F-8926-5FB5F887A5F2} # 0.25",
"TRAVERSABILITY_BARRIER")