Incorporar eventos (Location Referencing)

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 de ArcGIS Location Referencing existente.

Nota:

Cuando la capa de destino es una capa de servicio de entidades, los resultados de validación se escriben en un archivo del directorio 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 del servidor en Manager para ajustar esta configuración.

Uso

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

    Encontrará más información acerca de crear un dataset LRS en ArcGIS Pipeline Referencing o crear un dataset LRS en ArcGIS Roads and Highways .

  • El valor 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 ArcGIS Pipeline Referencing

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

  • El valor Evento de destino debe ser una capa o clase de entidad registrada con Location Referencing.

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

  • Si el parámetro Generar GUID de Id. de evento para eventos cargados está activado y desea que los GUID se generen, no asigne el campo EventID en la sección de asignación de campos o asegúrese de tener registros nulos en la columna EventID de los datos de evento de origen. 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.

  • 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 bloqueos, la herramienta devolverá un error y proporcionará el archivo de texto de bloqueos conflictivos.
    • Al trabajar en la versión predeterminada, los bloqueos adquiridos se liberan automáticamente al finalizar la herramienta.
    • Mientras trabaja en una versión secundaria, los bloqueos adquiridos permanecerán en el estado de publicación al finalizar la herramienta. Debe publicar o eliminar la versión para liberar los bloqueos.
    • Mientras trabaja en una versión secundaria, si el proceso de la herramienta se cancela por interrupción, los bloqueos se adquieren y 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 CSV
    • 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 CSV (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=FromMeasure Double
    Col5=ToMeasure Double
    Col6=RdType Long
    Col7=EventID Text width 50

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

Parámetros

EtiquetaExplicaciónTipo de datos
Evento de entrada

Los registros de eventos de origen que se van a incorporar.

Table View
Evento de destino

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

Feature Layer
Mapa de campo

Controla la forma en que la información de atributo en los campos del valor del parámetro Evento de entrada se transfiere al valor del parámetro Evento de destino.

Dado que el valor del parámetro Evento de entrada se incorpora en un evento existente que tiene un esquema predefinido (definiciones de campo), los campos no se pueden agregar o quitar del dataset 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 adjuntos en la clase de entidad de evento de destino.

  • AgregarLos registros de Eventos de entrada se agregarán a la clase de entidad de evento de destino especificada.
  • Retirar superposicionesLos registros de Evento de entrada se incorporarán a la clase de entidad de evento de destino especificada y se eliminarán todos los registros que tengan la misma medición o superposición temporal que los eventos incorporados. Si el evento adjunto eclipsa la función de evento de destino especificada, se eliminará el registro del evento de destino. Use esta opción solamente para eventos lineales.
  • Retirar por Id. de eventoLos registros de Evento de entrada se incorporarán a la clase de entidad de evento de destino especificada y se eliminarán todos los registros que tengan el mismo Id. de evento o 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 eventoLos registros de Evento de entrada se incorporarán a la clase de entidad de evento de destino especificada 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 entrada que se van a incorporar. La generación de Id. de eventos solo se aplicará a los registros de Evento de entrada con un valor nulo para el campo Event ID.

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

Especifica si se regenerarán las formas de los registros que se van a incorporar. Este parámetro solo está activo si el valor del Evento de entrada es una capa de entidades o clase de entidad.

  • Activado: se regenerarán las formas de las entidades de eventos de entrada. Esta es la opción predeterminada.
  • Desactivado: no se regenerarán las formas de las entidades de eventos de entrada.
Boolean

Salida derivada

EtiquetaExplicaciónTipo de datos
Evento de destino de salida

La capa de eventos o clase de entidad a la que se han incorporado los registros de eventos 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})
NombreExplicaciónTipo de datos
in_dataset

Los registros de eventos de origen que se van a incorporar.

Table View
in_target_event

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

Feature Layer
field_mapping

Controla la forma en que la información de atributos en los campos de in_dataset se transfiere a in_target_event.

Dado que el valor del parámetro in_dataset se incorpora en un evento existente que tiene un esquema predefinido (definiciones de campo), los campos no se pueden agregar o quitar del dataset 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 los eventos incorporados con superposiciones de medición o temporalidad con Id. de evento idénticos como registros de in_target_event se cargarán en la clase de entidad de evento.

  • ADDLos registros de in_dataset se agregarán a la clase de entidad de evento de destino especificada. No se realizan cambios en los registros de eventos de destino.
  • RETIRE_OVERLAPSLos registros de in_dataset se incorporarán a la clase de entidad de evento de destino especificada y se eliminarán todos los registros que tengan la misma medición o superposición temporal que los eventos incorporados. Si el evento adjunto eclipsa la función de evento de destino especificada, se eliminará el registro del evento de destino. Use esta opción solamente para eventos lineales.
  • RETIRE_BY_EVENT_IDLos registros de in_dataset se incorporarán a la clase de entidad de evento de destino especificada 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_IDLos registros de in_dataset se incorporarán a la clase de entidad de evento de destino especificada 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 in_dataset que se van a incorporar. La generación de Id. de eventos solo se aplicará a los registros de in_dataset con un valor nulo para el campo Event ID.

  • GENERATE_EVENT_IDSSe generarán los Id. de evento para los registros de in_dataset que se van a incorporar.
  • NO_GENERATE_EVENT_IDSNo se generarán Id. de evento para los registros de in_dataset que se van a incorporar. Esta es la opción predeterminada.
Boolean
generate_shapes
(Opcional)

Especifica si se regenerarán las formas de los registros que se van a incorporar. Este parámetro solo está habilitado si el valor de in_dataset es una capa de entidades o clase de entidad.

  • GENERATE_SHAPESSe regenerarán las formas de las entidades de eventos de entrada. Esta es la opción predeterminada.
  • NO_SHAPESLas formas de las entidades de eventos de entrada no se regenerarán.
Boolean

Salida derivada

NombreExplicaciónTipo de datos
out_target_event

La capa de eventos o clase de entidad a la que se han incorporado los registros de eventos 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'

load_type = "Add"

generate_event_ids = "NO_GENERATE_EVENT_IDS"

generate_shapes = "GENERATE_SHAPES"

# Execute the tool
arcpy.locref.AppendEvents(in_dataset, in_target_event, field_mapping, load_type, generate_event_ids, generate_shapes)
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.

# 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 b/w 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"

load_type = "REPLACE_BY_EVENT_ID"

generate_event_ids = "NO_GENERATE_EVENT_IDS"

generate_shapes = "GENERATE_SHAPES"

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

# 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
sourceevent = 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;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"

# 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.
targetevent = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/34"

# Execute the tool
arcpy.locref.AppendEvents(sourceevent, targetevent, field_mapping, load_type, generate_event_ids, generate_shapes)

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

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