Volver al principio

Incorporar eventos (Location Referencing)

En este tema

  1. Resumen
  2. Uso
  3. Parámetros
  4. Entornos
  5. Información de licenciamiento

Disponible con licencia de Location Referencing.

Resumen

Incorpora registros de eventos desde una tabla, capa o clase de entidad a una clase de entidad de evento LRS existente.

Nota:

Cuando la capa de destino sea una capa de servicio de entidades, los resultados de validación se escribirán en un archivo del directorio de ArcGIS Server. De forma predeterminada, este archivo se limpiará automáticamente después de 10 minutos, lo que puede no ser suficiente para procesar todas las validaciones y escribirlas en la estación de trabajo que ejecuta ArcGIS Pro. Para las cargas de datos más grandes, se recomienda ajustar la antigüedad máxima del archivo a al menos una hora. Puede editar un directorio de servidor en ArcGIS Server Manager para ajustar esta configuración.

Uso

  • Se requiere una licencia de LRS para ejecutar esta herramienta.

    • Más información sobre cómo crear un dataset LRS en ArcGIS Pipeline Referencing
    • Más información sobre cómo crear un dataset LRS en ArcGIS Roads and Highways

  • El valor del parámetro Evento de entrada puede ser una tabla, capa o clase de entidad.

    • Más información sobre los campos requeridos por el modelo de datos de eventos de Pipeline Referencing
    • Más información sobre los campos requeridos por el modelo de datos de eventos de Roads and Highways

  • El valor del parámetro Evento de destino debe ser una capa o clase de entidad registrada con un LRS.

  • Se ignorarán los conjuntos de selección y las consultas de definición sobre el valor del parámetro Evento de destino.

  • Esta herramienta admite entidades de punto y línea. El tipo de entidad de los parámetros Evento de entrada y Evento de destino debe coincidir.

  • Cuando se incorporan nuevos eventos usando la opción Agregar para el parámetro Tipo de carga, si el valor de Evento de destino tiene un campo RouteName configurado, los eventos se pueden incorporar usando el campo RouteName.

    • Si los registros de Evento de entrada tienen campos RouteID nulos, pero campos RouteName rellenados, los eventos se pueden incorporar usando el campo RouteName. RouteID Luego, los campos se generan automáticamente para esos eventos incorporados.
    • Si los registros de Evento de entrada tienen los campos RouteID y RouteName rellenados, los eventos se incorporarán usando el campo RouteID.

  • Si el parámetro Generar GUID de Id. de evento para eventos cargados está activado, no asigne el campo EventID en el parámetro Asignar campo o asegúrese de que haya valores nulos en el campo EventID del evento de entrada. Si se rellena el campo EventID de un registro de evento de origen y se activa el parámetro Generar GUID de Id. de evento para eventos cargados, el valor del campo EventID del registro de evento de origen se cargará en el evento de destino.

  • Si el parámetro Incorporar eventos a las rutas dominantes está activado, los registros del valor del parámetro Evento de entrada se incorporarán a las rutas dominantes donde existan concurrencias de ruta. Si existen varias concurrencias a lo largo de la ruta, los registros de Evento de entrada se dividirán y se incorporarán a la ruta dominante para cada sección de ruta concurrente. Si no existe concurrencia de rutas, los registros del valor del parámetro Evento de entrada se incorporarán igualmente a las rutas especificadas en el dataset de entrada.

    • La herramienta proporcionará un archivo de texto con registros de eventos que difieren de las rutas especificadas en el dataset de entrada y se incorporan a las rutas dominantes.

  • Esta herramienta admite la prevención de conflictos e intentará adquirir y transferir bloqueos.

  • Cuando se habilita la prevención de conflictos, se admite lo siguiente:

    • Los eventos que se deben incorporar adquirirán automáticamente bloqueos de evento, si están disponibles. Si no se pueden adquirir los bloqueos, la herramienta devolverá un error y proporcionará un archivo de texto de bloqueos conflictivos.
      • Más información sobre la prevención de conflictos en Pipeline Referencing
      • Más información sobre la prevención de conflictos en Roads and Highways
    • Cuando el parámetro Incorporar eventos a rutas dominantes está activado, los bloqueos de evento se verifican solo con las rutas de destino, que son las rutas más dominantes a las que se incorporarán los eventos. Si no se pueden adquirir los bloqueos de las rutas de destino, la herramienta devolverá un error y proporcionará un archivo de texto de bloqueos conflictivos.
      • Más información sobre cómo se calculan las concurrencias de ruta
    • Al trabajar en la versión predeterminada, los bloqueos adquiridos se liberan automáticamente al finalizar la herramienta.
    • Mientras trabaja en una versión con nombre, los bloqueos adquiridos permanecerán en el estado En publicación al finalizar la herramienta. Debe publicar o eliminar la versión para liberar los bloqueos.
    • Mientras trabaja en una versión con nombre, si se cancela el proceso de la herramienta, los bloqueos adquiridos permanecerán en estado liberable.

  • La calibración de ruta en rutas con huecos físicos afecta a los eventos incorporados como se indica a continuación:

    • Si la diferencia de calibración de ruta a lo largo del hueco no es cero, los eventos incorporados se dividirán en huecos.
    • Si la diferencia de calibración de la ruta a lo largo del hueco es cero, los eventos incorporados serán eventos multiparte.

  • Puede emplear un archivo .csv con formato ASCII para incorporar eventos cuando lo utilice con un archivo de inicialización (schema.ini) que defina los campos separados por comas en el archivo .csv. El archivo de inicialización del esquema debe incluir lo siguiente:

    • El nombre de archivo .csv y el formato de archivo para inicializar
    • Un nombre y tipo de datos para cada columna
    • Un ancho máximo que se debe utilizar si el tipo de datos es Texto

    En el siguiente ejemplo de inicialización se indica el nombre y el formato de archivo .csv que se van a utilizar, el nombre de campo y el tipo de datos que se deben usar en cada columna (de izquierda a derecha) y un ancho máximo para los campos de texto:

    schema.ini
    
[source_events.csv]
Format=CSVDelimited
ColNameHeader=True
Col1=FromDate Date
Col2=ToDate Date
Col3=RouteID Text width 255
Col4=RouteName Text width 255
Col5=FromMeasure Double
Col6=ToMeasure Double
Col7=RdType Long
Col8=EventID Text width 50

    Más información sobre cómo agregar una tabla de archivo de texto o ASCII

    • Heredado:

    El parámetro Generar formas ya no es compatible.

Parámetros

Cuadro de diálogoPython

EtiquetaExplicaciónTipo de datos
Evento de entrada

Los registros de evento de origen que se incorporarán.

Table View
Evento de destino

La clase de entidad o la capa de eventos LRS a la que se incorporarán los registros de eventos de origen.

Feature Layer
Mapa de campo

Controla cómo se transfiere la información de atributo de los campos del evento de entrada al evento de destino.

Dado que los registros de evento de origen se incorporan a un evento de destino existente que tiene un esquema predefinido (definiciones de campo), no es posible agregar ni eliminar campos del evento de destino. Aunque puede establecer reglas de fusión para cada campo de salida, la herramienta ignora esas reglas.

Field Mappings
Tipo de carga
(Opcional)

Especifica cómo se cargarán los eventos incorporados en el evento de destino.

  • Agregar—Los registros del evento de origen se incorporarán al evento de destino especificado.
  • Retirar superposiciones—Los registros del evento de origen se incorporarán al evento de destino especificado y se eliminarán todos los registros que tengan la misma medición o superposición temporal que los eventos incorporados. Si el evento incorporado eclipsa el registro del evento de destino especificado, este se eliminará. Use esta opción solamente para eventos de línea.
  • Retirar por Id. de evento—Los registros del evento de origen se incorporarán al evento de destino especificado y se eliminarán todos los registros que tengan el mismo Id. de evento y superposición temporal que los eventos incorporados. Si el evento adjunto eclipsa un registro de evento de destino que tiene el mismo Id. de evento, se eliminará el registro de evento de destino.
  • Reemplazar por Id. de evento—Los registros de evento de origen se incorporarán al evento de destino especificado y se reemplazarán todos los registros que tengan el mismo Id. de evento que los eventos incorporados.
String
Generar GUID de Id. de evento para eventos cargados
(Opcional)

Especifica si se generarán Id. de evento para los registros de evento de origen que se van a incorporar. La generación de Id. de eventos solo se aplicará a los registros de evento de origen con un valor nulo en el campo Event ID.

  • Activado: se generarán Id. de evento para los registros de evento de origen que se van a incorporar.
  • Desactivado: no se generarán Id. de evento para los registros de evento de origen que se van a incorporar. Esta es la opción predeterminada.
Boolean
Generar formas
(Opcional)
Nota:

Este parámetro ya no es compatible.

Boolean
Incorporar eventos a las rutas dominantes
(Opcional)

Especifica si los registros de evento de origen se incorporarán a las rutas dominantes si existe concurrencia de rutas.

  • Activado: los registros de evento de origen se incorporarán a las rutas dominantes.
  • Desactivado: los registros de evento de origen se incorporarán a las rutas especificadas en el dataset de entrada, independientemente del predominio de ruta. Esta es la opción predeterminada.

Este parámetro funciona con todas las opciones de Tipo de carga: Agregar, Retirar superposiciones, Retirar por Id. de evento y Reemplazar por Id. de evento.

Boolean

Salida derivada

EtiquetaExplicaciónTipo de datos
Evento de destino de salida

La capa de eventos o clase de entidad a la que se incorporan los registros de evento de origen.

Feature Layer
Archivo de resultados de salida

Archivo de texto que detalla los cambios realizados por la herramienta.

Text File

arcpy.locref.AppendEvents(in_dataset, in_target_event, field_mapping, {load_type}, {generate_event_ids}, {generate_shapes}, {append_to_dominant_route})
NombreExplicaciónTipo de datos
in_dataset

Los registros de evento de origen que se incorporarán.

Table View
in_target_event

La clase de entidad o la capa de eventos LRS a la que se incorporarán los registros de eventos de origen.

Feature Layer
field_mapping

Controla cómo se transfiere la información de atributo de los campos del evento de entrada al evento de destino.

Dado que los registros de evento de origen se incorporan a un evento de destino existente que tiene un esquema predefinido (definiciones de campo), no es posible agregar ni eliminar campos del evento de destino. Aunque puede establecer reglas de fusión para cada campo de salida, la herramienta ignora esas reglas.

La clase FieldMappings se puede usar para definir este parámetro.

Field Mappings
load_type
(Opcional)

Especifica cómo se cargarán los eventos incorporados en el evento de destino.

  • ADD—Los registros del evento de origen se incorporarán al evento de destino especificado.
  • RETIRE_OVERLAPS—Los registros del evento de origen se incorporarán al evento de destino especificado y se eliminarán todos los registros que tengan la misma medición o superposición temporal que los eventos incorporados. Si el evento incorporado eclipsa el registro del evento de destino especificado, este se eliminará. Use esta opción solamente para eventos de línea.
  • RETIRE_BY_EVENT_ID—Los registros del evento de origen se incorporarán al evento de destino especificado y se eliminarán todos los registros que tengan el mismo Id. de evento y superposición temporal que los eventos incorporados. Si el evento adjunto eclipsa un registro de evento de destino que tiene el mismo Id. de evento, se eliminará el registro de evento de destino.
  • REPLACE_BY_EVENT_ID—Los registros de evento de origen se incorporarán al evento de destino especificado y se reemplazarán todos los registros que tengan el mismo Id. de evento que los eventos incorporados.
String
generate_event_ids
(Opcional)

Especifica si se generarán Id. de evento para los registros de evento de origen que se van a incorporar. La generación de Id. de eventos solo se aplicará a los registros de evento de origen con un valor nulo en el campo Event ID.

  • GENERATE_EVENT_IDS—Se generarán Id. de evento para los registros de evento de origen que se van a incorporar.
  • NO_GENERATE_EVENT_IDS—No se generarán Id. de evento para los registros de evento de origen que se van a incorporar. Esta es la opción predeterminada.
Boolean
generate_shapes
(Opcional)
Nota:

Este parámetro ya no es compatible.

Boolean
append_to_dominant_route
(Opcional)

Especifica si los registros in_dataset se incorporarán a las rutas dominantes si existe concurrencia de rutas.

  • APPEND_TO_DOMINANT_ROUTE—Los registros de evento de origen se incorporarán a las rutas dominantes.
  • NO_APPEND_TO_DOMINANT_ROUTE—Los registros de evento de origen se incorporarán a las rutas especificadas en el dataset de entrada, independientemente del predominio de ruta. Esta es la opción predeterminada.

Este parámetro funciona con todas las opciones de load_type: ADD, RETIRE_OVERLAPS, RETIRE_BY_EVENT_ID y REPLACE_BY_EVENT_ID.

Boolean

Salida derivada

NombreExplicaciónTipo de datos
out_target_event

La capa de eventos o clase de entidad a la que se incorporan los registros de evento de origen.

Feature Layer
out_details_file

Archivo de texto que detalla los cambios realizados por la herramienta.

Text File

Muestra de código

Ejemplo de AppendEvents 1 (ventana de Python)

Muestra cómo utilizar la función AppendEvents en la ventana de Python para incorporar registros de eventos a una clase de entidad de evento existente.

# Name: AppendEvents_ex1_pro.py
# Description: Append event records into an existing Location Referencing event feature class.
# Requires: ArcGIS Location Referencing

# Set current workspace
arcpy.env.workspace= r"C:\Pipeline.gdb"

# Set tool variables
# Source Event Table in fgdb
in_dataset = "PTMS_Add"

# Target Event Feature Class in fgdb
in_target_event = "LRSE_PTMS"

#Map fields between target and source
field_mapping = r'AADT "AADT" true true false 4 Long 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,AADT,-1,-1;YEAR_ "YEAR_" true true false 2 Short 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,YEAR_,-1,-1;Cosite "Cosite" true true false 6 Text 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,Cosite,0,6;Classd "Classd" true true false 3 Text 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,Classd,0,3;SECTION_ "SECTION_" true true false 8 Text 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,SECTION_,0,8;COMM "COMM" true true false 254 Text 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,COMM,0,254;Active "Active" true true false 1 Text 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,Active,0,1;Sitetype "Sitetype" true true false 11 Text 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,Sitetype,0,11;KFCTR "KFCTR" true true false 8 Double 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,KFCTR,-1,-1;DFCTR "DFCTR" true true false 8 Double 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,DFCTR,-1,-1;TFCTR "TFCTR" true true false 8 Double 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,TFCTR,-1,-1;LOCATION "LOCATION" true true false 8 Double 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,LOCATION,-1,-1;FromDate "FromDate" true true false 8 Date 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,FromDate,-1,-1;ToDate "ToDate" true true false 8 Date 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,ToDate,-1,-1;EventID "EventID" true true false 50 Text 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,EventID,0,50;RouteName "RouteName" true true false 255 Text 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,RouteName,0,255'

load_type = "ADD"

generate_event_ids = "NO_GENERATE_EVENT_IDS"

generate_shapes = "GENERATE_SHAPES"

append_to_dominant_route = "NO_APPEND_TO_DOMINANT_ROUTE"

# Execute the tool
arcpy.locref.AppendEvents(in_dataset, in_target_event, field_mapping, load_type, generate_event_ids, None, append_to_dominant_route)
Ejemplo de AppendEvents 2 (script independiente)

Muestra cómo utilizar la función AppendEvents en un script de Python independiente para incorporar registros de evento a una clase de entidad de evento existente. Los eventos se incorporan a las rutas dominantes.

# Name: AppendEvents_StandAlonePython_Example.py
# Description: Append event records into an existing event feature class.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

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

# Set tool variables
# Source Event Table in fgdb
in_dataset = r"C:\Pipeline.gdb\LRS\PTMS_Add"

# Target Event Feature Class in fgdb
in_target_event = r"C:\Pipeline.gdb\LRS\LRSE_PTMS"

#Map fields between target and source
field_mapping = r"AADT \"AADT\" true true false 4 Long 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,AADT,-1,-1;YEAR_ \"YEAR_\" true true false 2 Short 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,YEAR_,-1,-1;Cosite \"Cosite\" true true false 6 Text 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,Cosite,0,6;Classd \"Classd\" true true false 3 Text 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,Classd,0,3;SECTION_ \"SECTION_\" true true false 8 Text 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,SECTION_,0,8;COMM \"COMM\" true true false 254 Text 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,COMM,0,254;Active \"Active\" true true false 1 Text 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,Active,0,1;Sitetype \"Sitetype\" true true false 11 Text 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,Sitetype,0,11;KFCTR \"KFCTR\" true true false 8 Double 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,KFCTR,-1,-1;DFCTR \"DFCTR\" true true false 8 Double 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,DFCTR,-1,-1;TFCTR \"TFCTR\" true true false 8 Double 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,TFCTR,-1,-1;LOCATION \"LOCATION\" true true false 8 Double 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,LOCATION,-1,-1;FromDate \"FromDate\" true true false 8 Date 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,FromDate,-1,-1;ToDate \"ToDate\" true true false 8 Date 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,ToDate,-1,-1;EventID \"EventID\" true true false 50 Text 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,EventID,0,50;RouteName \"RouteName\" true true false 255 Text 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,RouteName,0,255"

load_type = "REPLACE_BY_EVENT_ID"

generate_event_ids = "NO_GENERATE_EVENT_IDS"

generate_shapes = "GENERATE_SHAPES"

append_to_dominant_route = "APPEND_TO_DOMINANT_ROUTE"

# Execute the tool
arcpy.locref.AppendEvents(in_dataset, in_target_event, field_mapping, load_type, generate_event_ids, None, append_to_dominant_route)

# Check in license
arcpy.CheckInExtension("LocationReferencing")
Ejemplo de AppendEvents 3 (script independiente)

Muestra cómo utilizar la función AppendEvents en un script independiente de Python para incorporar registros de eventos a un servicio de entidades.

# Name: AppendEvents_Pro_Ex3.py
# Description: Append events using a feature service. It is recommended to work in a version and post to the default version.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

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

# Set tool variables
in_dataset = r"C:\LocationReferencing\LR.gdb\LRS\LineEvent"
field_mapping = r'FROMDATE "From Date" true true false 8 Date 0 0,First,#,C:\LocationReferencing\LR.gdb\LRS\LineEvent,FROMDATE,-1,-1;TODATE "To Date" true true false 8 Date 0 0,First,#,C:\LocationReferencing\LR.gdb\LRS\LineEvent,TODATE,-1,-1;EVENTID "Event ID" true true false 50 Text 0 0,First,#,C:\LocationReferencing\LR.gdb\LRS\LineEvent,EVENTID,0,50;ROUTEID "Route ID" true true false 255 Text 0 0,First,#,C:\LocationReferencing\LR.gdb\LRS\LineEvent,ROUTEID,0,255;RouteName "RouteName" true true false 255 Text 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,RouteName,0,255;FROMMEASURE "From Measure" true true false 0 Double 0 0,First,#,C:\LocationReferencing\LR.gdb\LRS\LineEvent,FROMMEASURE,-1,-1;TOMEASURE "To Measure" true true false 0 Double 0 0,First,#,C:\LocationReferencing\LR.gdb\LRS\LineEvent,TOMEASURE,-1,-1'
load_type = "ADD"
generate_event_ids = "NO_GENERATE_EVENT_IDS"
generate_shapes = "GENERATE_SHAPES"
append_to_dominant_route = "NO_APPEND_TO_DOMINANT_ROUTE"

# Target event is in a feature service. Sign in to portal is required to access the feature service. 
arcpy.SignInToPortal('https://yourdomain.com/portal', 'username', 'password')

# Map the target event from the feature service. In the feature service, 34 corresponds to the target event.
in_target_event = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/34"

# Execute the tool
arcpy.locref.AppendEvents(in_dataset, in_target_event, field_mapping, load_type, generate_event_ids, None, append_to_dominant_route)

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

Entornos

Espacio de trabajo actual

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

  • Descripción general de la caja de herramientas Referenciación de ubicación
  • Buscar una herramienta de geoprocesamiento

¿Algún comentario sobre este tema?

En este tema
  1. Resumen
  2. Uso
  3. Parámetros
  4. Entornos
  5. Información de licenciamiento