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:

    ActividadRegla

    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

EtiquetaExplicaciónTipo 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.

  • PuntoEl tipo de geometría del evento será punto. Esta es la opción predeterminada.
  • LíneaEl 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 cualLa propiedad no cambiará. Esta es la opción predeterminada.
  • No abarcar rutasLos registros de eventos no abarcarán rutas. Esto solo se aplica a eventos de línea.
  • Abarcar rutasLos 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 cualLa propiedad no cambiará. Esta es la opción predeterminada.
  • No almacenar nombre de rutaEl nombre de ruta no se almacenará con los registros de eventos.
  • Almacenar nombre de rutaEl 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.

  • PermanenciaSe preservará la ubicación geográfica del evento; las mediciones pueden cambiar. Esta es la opción predeterminada.
  • RetirarSe preservarán tanto la medición como la ubicación geográfica; el evento se retirará.
  • MoverSe 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.

  • PermanenciaSe preservará la ubicación geográfica del evento; las mediciones pueden cambiar. Esta es la opción predeterminada.
  • RetirarSe preservarán tanto la medición como la ubicación geográfica; el evento se retirará.
  • MoverSe preservarán las mediciones del evento; la ubicación geográfica puede cambiar.
  • AlinearSe 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 extensión
(Opcional)

Especifica la regla de comportamiento de evento para la actividad de extensión.

  • PermanenciaSe preservará la ubicación geográfica del evento; las mediciones pueden cambiar. Esta es la opción predeterminada.
  • RetirarSe preservarán tanto la medición como la ubicación geográfica; el evento se retirará.
  • MoverSe preservarán las mediciones del evento; la ubicación geográfica puede cambiar.
  • PortadaSe 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.

  • PermanenciaSe preservará la ubicación geográfica del evento; las mediciones pueden cambiar. Esta es la opción predeterminada.
  • RetirarSe preservarán tanto la medición como la ubicación geográfica; el evento se retirará.
  • MoverSe preservarán las mediciones del evento; la ubicación geográfica puede cambiar.
  • AlinearSe 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.

  • PermanenciaSe preservará la ubicación geográfica del evento; las mediciones pueden cambiar. Esta es la opción predeterminada.
  • RetirarSe preservarán tanto la medición como la ubicación geográfica; el evento se retirará.
  • MoverSe preservarán las mediciones del evento; la ubicación geográfica puede cambiar.
  • AlinearSe preservará la ubicación geográfica del evento mediante la alineación del evento con una ruta concurrente; las mediciones pueden cambiar.
  • PortadaSe 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.

  • PermanenciaSe preservará la ubicación geográfica del evento; las mediciones pueden cambiar. Esta es la opción predeterminada.
  • RetirarSe preservarán tanto la medición como la ubicación geográfica; el evento se retirará.
  • MoverSe 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 rutaLa 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

EtiquetaExplicaciónTipo de datos
Tabla de eventos externos de salida

La tabla de eventos externos actualizada.

Table

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

  • POINTEl tipo de geometría del evento será punto. Esta es la opción predeterminada.
  • LINEEl 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_ISLa propiedad no cambiará. Esta es la opción predeterminada.
  • NO_SPANS_ROUTESLos registros de eventos no abarcarán rutas. Esto solo se aplica a eventos de línea.
  • SPANS_ROUTESLos 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_ISLa propiedad no cambiará. Esta es la opción predeterminada.
  • NO_STORE_ROUTE_NAMEEl nombre de ruta no se almacenará con los registros de eventos.
  • STORE_ROUTE_NAMEEl 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_PUTSe preservará la ubicación geográfica del evento; las mediciones pueden cambiar. Esta es la opción predeterminada.
  • RETIRESe preservarán tanto la medición como la ubicación geográfica; el evento se retirará.
  • MOVESe 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_PUTSe preservará la ubicación geográfica del evento; las mediciones pueden cambiar. Esta es la opción predeterminada.
  • RETIRESe preservarán tanto la medición como la ubicación geográfica; el evento se retirará.
  • MOVESe preservarán las mediciones del evento; la ubicación geográfica puede cambiar.
  • SNAPSe preservará la ubicación geográfica del evento mediante la alineación del evento con una ruta concurrente; las mediciones pueden cambiar.
String
extend_rule
(Opcional)

Especifica la regla de comportamiento de evento para la actividad de extensión.

  • STAY_PUTSe preservará la ubicación geográfica del evento; las mediciones pueden cambiar. Esta es la opción predeterminada.
  • RETIRESe preservarán tanto la medición como la ubicación geográfica; el evento se retirará.
  • MOVESe preservarán las mediciones del evento; la ubicación geográfica puede cambiar.
  • COVERSe 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_PUTSe preservará la ubicación geográfica del evento; las mediciones pueden cambiar. Esta es la opción predeterminada.
  • RETIRESe preservarán tanto la medición como la ubicación geográfica; el evento se retirará.
  • MOVESe preservarán las mediciones del evento; la ubicación geográfica puede cambiar.
  • SNAPSe 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_PUTSe preservará la ubicación geográfica del evento; las mediciones pueden cambiar. Esta es la opción predeterminada.
  • RETIRESe preservarán tanto la medición como la ubicación geográfica; el evento se retirará.
  • MOVESe preservarán las mediciones del evento; la ubicación geográfica puede cambiar.
  • SNAPSe preservará la ubicación geográfica del evento mediante la alineación del evento con una ruta concurrente; las mediciones pueden cambiar.
  • COVERSe 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_PUTSe preservará la ubicación geográfica del evento; las mediciones pueden cambiar. Esta es la opción predeterminada.
  • RETIRESe preservarán tanto la medición como la ubicación geográfica; el evento se retirará.
  • MOVESe 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_MEASURELa 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

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

Temas relacionados