Configurar eventos externos con LRS (Location Referencing)

Resumen

Asocia datos de eventos almacenados en un sistema externo con un LRS.

Uso

• La geodatabase donde están presentes los eventos asociados y la geodatabase en la que reside el LRS debe ser geodatabases corporativas.

• Esta herramienta también se puede utilizar para modificar el nombre, los campos y los comportamientos de evento de los eventos externos configurados existentes.

• Las siguientes reglas de comportamiento de evento se establecen de forma predeterminada:

  Actividad	Regla
  Calibrar ruta	Permanencia
  Retirar ruta	Permanencia
  Extender ruta	Permanencia
  Reasignar ruta	Permanencia
  Realinear ruta	Permanencia
  Invertir ruta	Permanencia
  Realinear ruta cartográficamente	Respetar medición de ruta

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Evento de entrada	La tabla o clase de entidad de evento externo que se va a registrar en un LRS.	Table View
Red LRS principal	La red LRS en la que se registrará el evento.	Feature Layer
Nombre de evento LRS	El nombre del evento externo o tabla que se registrará en el LRS.	String
Campo de Id. de evento	El campo de Id. de evento disponible en la tabla o clase de entidad de evento.	Field
Campo Id. de ruta	El nombre del campo Id. de ruta si es un evento de punto o un evento de línea que no abarca rutas, o el nombre del campo Id. de ruta si el evento abarca rutas. El campo debe estar disponible en la tabla o clase de entidad de eventos externos.	Field
Campo de medición	El nombre del campo de medición si es un evento de punto o el nombre del campo de medición inicial si es un evento de línea.	Field
Tipo de geometría (Opcional)	Especifica el tipo de geometría del evento externo o tabla. Punto—El tipo de geometría del evento será punto. Esta es la opción predeterminada. Línea—El tipo de geometría del evento será polilínea.	String
Campo de medición final (Opcional)	El nombre del campo de medición final. Este campo solo es obligatorio para eventos de línea.	Field
Campo de fecha inicial (Opcional)	El campo de fecha inicial en la tabla o clase de entidad de evento.	Field
Campo de fecha final (Opcional)	El campo de fecha final en la tabla o clase de entidad de evento.	Field
El evento abarca varias rutas (Opcional)	Especifica si los registros de eventos abarcarán rutas. Tal cual—La propiedad no cambiará. Esta es la opción predeterminada. No abarcar rutas—Los registros de eventos no abarcarán rutas. Esto solo se aplica a eventos de línea. Abarcar rutas—Los registros de eventos abarcarán rutas. Esto solo se aplica a eventos de línea.	String
Campo de Id. de ruta final (Opcional)	El nombre del campo de Id. de ruta inicial disponible en la tabla o clase de entidad de evento.	Field
Almacenar nombre de ruta (Opcional)	Especifica si el nombre de ruta se almacenará con los registros de eventos. Tal cual—La propiedad no cambiará. Esta es la opción predeterminada. No almacenar nombre de ruta—El nombre de ruta no se almacenará con los registros de eventos. Almacenar nombre de ruta—El nombre de ruta se almacenará con los registros de eventos.	String
Campo de nombre de ruta (Opcional)	El campo de nombre de ruta si es un evento de punto o de línea que no abarca rutas, o el nombre del campo de nombre de ruta inicial si el evento abarca rutas. El campo debe estar disponible en la tabla o clase de entidad de eventos externos.	Field
Campo de nombre de ruta final (Opcional)	Campo nombre de ruta final para los eventos de línea que abarcan rutas. Este parámetro es obligatorio si se han definido los parámetros Almacenar nombre de ruta y El evento abarca varias rutas.	Field
Regla de calibración (Opcional)	Especifica la regla de comportamiento de evento para la actividad de calibración. Permanencia—Se preservará la ubicación geográfica del evento; las mediciones pueden cambiar. Esta es la opción predeterminada. Retirar—Se preservarán tanto la medición como la ubicación geográfica; el evento se retirará. Mover—Se preservarán las mediciones del evento; la ubicación geográfica puede cambiar.	String
Regla de retirada (Opcional)	Especifica la regla de comportamiento de evento para la actividad de retirada. Permanencia—Se preservará la ubicación geográfica del evento; las mediciones pueden cambiar. Esta es la opción predeterminada. Retirar—Se preservarán tanto la medición como la ubicación geográfica; el evento se retirará. Mover—Se preservarán las mediciones del evento; la ubicación geográfica puede cambiar.	String
Regla de extensión (Opcional)	Especifica la regla de comportamiento de evento para la actividad de extensión. Permanencia—Se preservará la ubicación geográfica del evento; las mediciones pueden cambiar. Esta es la opción predeterminada. Retirar—Se preservarán tanto la medición como la ubicación geográfica; el evento se retirará. Mover—Se preservarán las mediciones del evento; la ubicación geográfica puede cambiar. Portada—Se modificará la ubicación geométrica y la medición de un evento de línea para incluir una sección nueva o recién modificada.	String
Regla de reasignación (Opcional)	Especifica la regla de comportamiento de evento para la actividad de reasignación. Permanencia—Se preservará la ubicación geográfica del evento; las mediciones pueden cambiar. Esta es la opción predeterminada. Retirar—Se preservarán tanto la medición como la ubicación geográfica; el evento se retirará. Mover—Se preservarán las mediciones del evento; la ubicación geográfica puede cambiar. Alinear—Se preservará la ubicación geográfica del evento mediante la alineación del evento con una ruta concurrente; las mediciones pueden cambiar.	String
Regla de realineación (Opcional)	Especifica la regla de comportamiento de evento para la actividad de realineación. Permanencia—Se preservará la ubicación geográfica del evento; las mediciones pueden cambiar. Esta es la opción predeterminada. Retirar—Se preservarán tanto la medición como la ubicación geográfica; el evento se retirará. Mover—Se preservarán las mediciones del evento; la ubicación geográfica puede cambiar. Alinear—Se preservará la ubicación geográfica de un evento mediante la alineación del evento con una ruta concurrente; las mediciones pueden cambiar. Portada—Se modificará la ubicación geométrica y la medición de un evento de línea para incluir una sección nueva o recién modificada.	String
Regla de inversión (Opcional)	Especifica la regla de comportamiento de evento para la actividad de inversión. Permanencia—Se preservará la ubicación geográfica del evento; las mediciones pueden cambiar. Esta es la opción predeterminada. Retirar—Se preservarán tanto la medición como la ubicación geográfica; el evento se retirará. Mover—Se preservarán las mediciones del evento; la ubicación geográfica puede cambiar.	String
Regla de realineación cartográfica (Opcional)	Especifica la regla de comportamiento de evento para la actividad de realineación cartográfica. Respetar medición de ruta—La medición del evento se preservará o cambiará proporcionalmente al cambio de medición de la ruta. Esta es la opción predeterminada.	String

Salida derivada

Etiqueta	Explicación	Tipo de datos
Tabla de eventos externos de salida	La tabla de eventos externos actualizada.	Table

Python

arcpy.locref.ConfigureExternalEventWithLRS(in_event, parent_network, event_name, event_id_field, route_id_field, measure_field, {geometry_type}, {to_measure_field}, {from_date_field}, {to_date_field}, {event_spans_routes}, {to_route_id_field}, {store_route_name}, {route_name_field}, {to_route_name_field}, {calibrate_rule}, {retire_rule}, {extend_rule}, {reassign_rule}, {realign_rule}, {reverse_rule}, {carto_realign_rule})

Nombre	Explicación	Tipo de datos
in_event	La tabla o clase de entidad de evento externo que se va a registrar en un LRS.	Table View
parent_network	La red LRS en la que se registrará el evento.	Feature Layer
event_name	El nombre del evento externo o tabla que se registrará en el LRS.	String
event_id_field	El campo de Id. de evento disponible en la tabla o clase de entidad de evento.	Field
route_id_field	El nombre del campo Id. de ruta si es un evento de punto o un evento de línea que no abarca rutas, o el nombre del campo Id. de ruta si el evento abarca rutas. El campo debe estar disponible en la tabla o clase de entidad de eventos externos.	Field
measure_field	El nombre del campo de medición si es un evento de punto o el nombre del campo de medición inicial si es un evento de línea.	Field
geometry_type (Opcional)	Especifica el tipo de geometría del evento externo o tabla. POINT—El tipo de geometría del evento será punto. Esta es la opción predeterminada. LINE—El tipo de geometría del evento será polilínea.	String
to_measure_field (Opcional)	El nombre del campo de medición final. Este campo solo es obligatorio para eventos de línea.	Field
from_date_field (Opcional)	El campo de fecha inicial en la tabla o clase de entidad de evento.	Field
to_date_field (Opcional)	El campo de fecha final en la tabla o clase de entidad de evento.	Field
event_spans_routes (Opcional)	Especifica si los registros de eventos abarcarán rutas. AS_IS—La propiedad no cambiará. Esta es la opción predeterminada. NO_SPANS_ROUTES—Los registros de eventos no abarcarán rutas. Esto solo se aplica a eventos de línea. SPANS_ROUTES—Los registros de eventos abarcarán rutas. Esto solo se aplica a eventos de línea.	String
to_route_id_field (Opcional)	El nombre del campo de Id. de ruta inicial disponible en la tabla o clase de entidad de evento.	Field
store_route_name (Opcional)	Especifica si el nombre de ruta se almacenará con los registros de eventos. AS_IS—La propiedad no cambiará. Esta es la opción predeterminada. NO_STORE_ROUTE_NAME—El nombre de ruta no se almacenará con los registros de eventos. STORE_ROUTE_NAME—El nombre de ruta se almacenará con los registros de eventos.	String
route_name_field (Opcional)	El campo de nombre de ruta si es un evento de punto o de línea que no abarca rutas, o el nombre del campo de nombre de ruta inicial si el evento abarca rutas. El campo debe estar disponible en la tabla o clase de entidad de eventos externos.	Field
to_route_name_field (Opcional)	Campo nombre de ruta final para los eventos de línea que abarcan rutas. Este parámetro es obligatorio si se han definido los parámetros store_route_name y event_spans_routes.	Field
calibrate_rule (Opcional)	Especifica la regla de comportamiento de evento para la actividad de calibración. STAY_PUT—Se preservará la ubicación geográfica del evento; las mediciones pueden cambiar. Esta es la opción predeterminada. RETIRE—Se preservarán tanto la medición como la ubicación geográfica; el evento se retirará. MOVE—Se preservarán las mediciones del evento; la ubicación geográfica puede cambiar.	String
retire_rule (Opcional)	Especifica la regla de comportamiento de evento para la actividad de retirada. STAY_PUT—Se preservará la ubicación geográfica del evento; las mediciones pueden cambiar. Esta es la opción predeterminada. RETIRE—Se preservarán tanto la medición como la ubicación geográfica; el evento se retirará. MOVE—Se preservarán las mediciones del evento; la ubicación geográfica puede cambiar.	String
extend_rule (Opcional)	Especifica la regla de comportamiento de evento para la actividad de extensión. STAY_PUT—Se preservará la ubicación geográfica del evento; las mediciones pueden cambiar. Esta es la opción predeterminada. RETIRE—Se preservarán tanto la medición como la ubicación geográfica; el evento se retirará. MOVE—Se preservarán las mediciones del evento; la ubicación geográfica puede cambiar. COVER—Se modificará la ubicación geométrica y la medición de un evento de línea para incluir una sección nueva o recién modificada.	String
reassign_rule (Opcional)	Especifica la regla de comportamiento de evento para la actividad de reasignación. STAY_PUT—Se preservará la ubicación geográfica del evento; las mediciones pueden cambiar. Esta es la opción predeterminada. RETIRE—Se preservarán tanto la medición como la ubicación geográfica; el evento se retirará. MOVE—Se preservarán las mediciones del evento; la ubicación geográfica puede cambiar. SNAP—Se preservará la ubicación geográfica del evento mediante la alineación del evento con una ruta concurrente; las mediciones pueden cambiar.	String
realign_rule (Opcional)	Especifica la regla de comportamiento de evento para la actividad de realineación. STAY_PUT—Se preservará la ubicación geográfica del evento; las mediciones pueden cambiar. Esta es la opción predeterminada. RETIRE—Se preservarán tanto la medición como la ubicación geográfica; el evento se retirará. MOVE—Se preservarán las mediciones del evento; la ubicación geográfica puede cambiar. SNAP—Se preservará la ubicación geográfica de un evento mediante la alineación del evento con una ruta concurrente; las mediciones pueden cambiar. COVER—Se modificará la ubicación geométrica y la medición de un evento de línea para incluir una sección nueva o recién modificada.	String
reverse_rule (Opcional)	Especifica la regla de comportamiento de evento para la actividad de inversión. STAY_PUT—Se preservará la ubicación geográfica del evento; las mediciones pueden cambiar. Esta es la opción predeterminada. RETIRE—Se preservarán tanto la medición como la ubicación geográfica; el evento se retirará. MOVE—Se preservarán las mediciones del evento; la ubicación geográfica puede cambiar.	String
carto_realign_rule (Opcional)	Especifica la regla de comportamiento de evento para la actividad de realineación cartográfica. HONOR_ROUTE_MEASURE—La medición del evento se preservará o cambiará proporcionalmente al cambio de medición de la ruta. Esta es la opción predeterminada.	String

Salida derivada

Nombre	Explicación	Tipo de datos
out_external_event_table	La tabla de eventos externos actualizada.	Table

Muestra de código

Ejemplo de ConfigureExternalEventWithLRS 1 (ventana de Python)

El siguiente script muestra cómo utilizar la función ConfigureExternalEventWithLRS para configurar un evento de punto externo en la ventana de Python.

# Name: Configure_Externalevent_LRS_ex1.py
# Description: Configure an external point event in an LRS Network in the Python window.
# Requires: ArcGIS Location Referencing

# Check out license
arcpy.CheckOutExtension("LocationReferencing")

#Tool variables
in_event = "C:\\Eventdata.sde\\pointevent"
parent_network = "C:\\Networkdata.sde\\Network1"
event_name = "PointEvent"
event_id_field = "EventId"
route_id_field = "RouteId"
measure_field =  "Measure"
geometry_type = "POINT"
to_measure_field = None
from_date_field = "FromDate"
to_date_field =  "ToDate"
event_spans_routes =  "AS_IS"
to_route_id_field = None
store_route_name = "AS_IS"
route_name_field = None
to_route_name_field = None
calibrate_rule = "STAY_PUT"
retire_rule ="STAY_PUT"
extend_rule ="STAY_PUT"
reassign_rule ="STAY_PUT"
realign_rule ="STAY_PUT"
reverse_rule = "STAY_PUT"
carto_realign_rule = "HONOR_ROUTE_MEASURE"

# set current workspace
#arcpy.env.workspace = "C:\\Networkdata.sde"

# execute the tool
arcpy.locref.ConfigureExternalEventWithLRS(in_event, parent_network, event_name, event_id_field, route_id_field, measure_field, geometry_type, to_measure_field, from_date_field, to_date_field, event_spans_routes, to_route_id_field, store_route_name, route_name_field, to_route_name_field, calibrate_rule, retire_rule, extend_rule, reassign_rule, realign_rule, reverse_rule, carto_realign_rule)

# Check in license
arcpy.CheckInExtension("LocationReferencing")

Ejemplo de ConfigureExternalEventWithLRS 2 (ventana de Python)

El siguiente script muestra cómo utilizar la función ConfigureExternalEventWithLRS para configurar un evento de línea externo en la ventana de Python.

# Name: Configure_Externalevent_LRS_ex2.py
# Description: Configure an external line event in an LRS Network in the Python window.
# Requires: ArcGIS Location Referencing

# Check out license
arcpy.CheckOutExtension("LocationReferencing")

# Tool variables
in_event = "C:\\Eventdata.sde\\lineevent"
parent_network = "C:\\Networkdata.sde\\Network1"
event_name = "LineEvent"
event_id_field = "EventId"
route_id_field = "RouteId"
measure_field =  "FromMeasure"
geometry_type = "LINE"
to_measure_field = "ToMeasure"
from_date_field = "FromDate"
to_date_field =  "ToDate"
event_spans_routes =  "AS_IS"
to_route_id_field = None
store_route_name = "STORE ROUTE NAME"
route_name_field = "RouteName"
to_route_name_field = None
calibrate_rule = "STAY_PUT"
retire_rule ="STAY_PUT"
extend_rule ="STAY_PUT"
reassign_rule ="STAY_PUT"
realign_rule ="STAY_PUT"
reverse_rule = "STAY_PUT"
carto_realign_rule = "HONOR_ROUTE_MEASURE"

# Set current workspace
arcpy.env.workspace = "C:\\Networkdata.sde"

# Execute the tool
arcpy.locref.ConfigureExternalEventWithLRS(in_event, parent_network, event_name, event_id_field, route_id_field, measure_field, geometry_type, to_measure_field, from_date_field, to_date_field, event_spans_routes, to_route_id_field, store_route_name, route_name_field, to_route_name_field, calibrate_rule, retire_rule, extend_rule, reassign_rule, realign_rule, reverse_rule, carto_realign_rule)

# Check in license
arcpy.CheckInExtension('LocationReferencing')

Ejemplo de ConfigureExternalEventWithLRS 3 (ventana de Python)

El siguiente script muestra cómo utilizar la función ConfigureExternalEventWithLRS para modificar un evento de línea externo existente en la ventana de Python.

# Name: Configure_Externalevent_LRS_ex3.py
# Description: Modify an existing external line event in an LRS Network in the Python window. Event name and optional parameter fields are updated.
# Requires: ArcGIS Location Referencing

# Check out license
arcpy.CheckOutExtension("LocationReferencing")

# Tool variables
in_event = "C:\\Eventdata.sde\\lineevent"
parent_network = "C:\\Networkdata.sde\\Network1"
event_name = "LineEvent_updated"
event_id_field = "EventId_updated"
route_id_field = "RouteId_updated"
measure_field =  "FromMeasure_updated"
geometry_type = "LINE"
to_measure_field = "ToMeasure_updated"
from_date_field = "FromDate_updated"
to_date_field =  "ToDate_updated"
event_spans_routes =  "AS_IS"
to_route_id_field = None
store_route_name = "STORE_ROUTE_NAME" 
route_name_field = "FromRouteName_updated"
to_route_name_field = None
calibrate_rule = "RETIRE"
retire_rule ="RETIRE"
extend_rule ="RETIRE"
reassign_rule ="RETIRE"
realign_rule ="RETIRE"
reverse_rule = "STAY_PUT"
carto_realign_rule = "HONOR_ROUTE_MEASURE"

# Set current workspace
arcpy.env.workspace = "C:\\Networkdata.sde"

# Execute the tool
arcpy.locref.ConfigureExternalEventWithLRS(in_event, parent_network, event_name, event_id_field, route_id_field, measure_field, geometry_type, to_measure_field, from_date_field, to_date_field, event_spans_routes, to_route_id_field, store_route_name, route_name_field, to_route_name_field, calibrate_rule, retire_rule, extend_rule, reassign_rule, realign_rule, reverse_rule, carto_realign_rule)

# Check in license
arcpy.CheckInExtension("LocationReferencing")

Ejemplo de ConfigureExternalEventWithLRS 4 (script independiente)

El siguiente script independiente muestra cómo utilizar la función ConfigureExternalEventWithLRS para configurar un evento de línea externo que abarque rutas en una red LRS.

# Name: Configure_Externalevent_LRS_ex4.py
# Description: Configure an external line event spanning routes in an LRS Network using a stand-alone Python script.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

# Check out license
arcpy.CheckOutExtension("LocationReferencing")

#Tool variables
in_event = "C:\\Eventdata.sde\\lineevent"
parent_network = "C:\\Networkdata.sde\\Network1"
event_name = "LineSpanningEvent"
event_id_field = "EventId"
route_id_field = "FromRouteId"
measure_field =  "FromMeasure"
geometry_type = "LINE"
to_measure_field = "ToMeasure"
from_date_field = "FromDate"
to_date_field =  "ToDate"
event_spans_routes =  "SPANS ROUTES"
to_route_id_field = "ToRouteId"
store_route_name = "STORE ROUTE NAME"
route_name_field = "FromRouteName"
to_route_name_field = "ToRouteName"
calibrate_rule = "STAY_PUT"
retire_rule ="STAY_PUT"
extend_rule ="STAY_PUT"
reassign_rule ="STAY_PUT"
realign_rule ="STAY_PUT"
reverse_rule = "STAY_PUT"
carto_realign_rule = "HONOR_ROUTE_MEASURE"

# set current workspace
arcpy.env.workspace = "C:\\Networkdata.sde"

# execute the tool
arcpy.locref.ConfigureExternalEventWithLRS(in_event, parent_network, event_name, event_id_field, route_id_field, measure_field, geometry_type, to_measure_field, from_date_field, to_date_field, event_spans_routes, to_route_id_field, store_route_name, route_name_field, to_route_name_field, calibrate_rule, retire_rule, extend_rule, reassign_rule, realign_rule, reverse_rule, carto_realign_rule)

# Check in license
arcpy.CheckInExtension("LocationReferencing")

Ejemplo de ConfigureExternalEventWithLRS 5 (script independiente)

El siguiente script independiente muestra cómo utilizar la función ConfigureExternalEventWithLRS para modificar un evento de línea externo existente que abarque rutas en una red LRS.

# Name: Configure_Externalevent_LRS_ex5.py
# Description: Modify an existing external line event spanning routes of an LRS Network using a stand-alone Python script. Event name and optional parameter fields are updated.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy 

# Check out license
arcpy.CheckOutExtension("LocationReferencing")

#Tool variables
in_event = "C:\\Eventdata.sde\\lineevent"
parent_network = "C:\\Networkdata.sde\\Network1"
event_name = "LineSpanningEvent_updated"
event_id_field = "EventId_updated"
route_id_field = "FromRouteId_updated"
measure_field =  "FromMeasure_updated"
geometry_type = "LINE"
to_measure_field = "ToMeasure_updated"
from_date_field = "FromDate_updated"
to_date_field =  "ToDate_updated"
event_spans_routes =  "SPANS ROUTES"
to_route_id_field = "ToRouteId_updated"
store_route_name = "STORE ROUTE NAME"
route_name_field = "FromRouteName_updated"
to_route_name_field = "ToRouteName_updated"
calibrate_rule = "RETIRE"
retire_rule = "RETIRE"
extend_rule = "RETIRE"
reassign_rule = "RETIRE"
realign_rule = "RETIRE"
reverse_rule = "STAY_PUT"
carto_realign_rule = "HONOR_ROUTE_MEASURE"

# set current workspace
arcpy.env.workspace = "C:\\Networkdata.sde"

# execute the tool
arcpy.locref.ConfigureExternalEventWithLRS(in_event, parent_network, event_name, event_id_field, route_id_field, measure_field, geometry_type, to_measure_field, from_date_field, to_date_field, event_spans_routes, to_route_id_field, store_route_name, route_name_field, to_route_name_field, calibrate_rule, retire_rule, extend_rule, reassign_rule, realign_rule, reverse_rule, carto_realign_rule)

# Check in license
arcpy.CheckInExtension("LocationReferencing")

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

• Basic: Requiere ArcGIS Location Referencing (ArcGIS Pipeline Referencing o ArcGIS Roads and Highways)
• Standard: Requiere ArcGIS Location Referencing (ArcGIS Pipeline Referencing o ArcGIS Roads and Highways)
• Advanced: Requiere ArcGIS Location Referencing (ArcGIS Pipeline Referencing o ArcGIS Roads and Highways)