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 de esta herramienta 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. Para crear un dataset de LRS, agregue las capas de punto de calibración, línea de centro y marcado a un dataset de entidades y, a continuación, ejecute la herramienta Modificar LRS con la geodatabase como entrada.

• El 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 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.

• Cuando la prevención de conflictos está activada, 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.
    • 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
  • 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 la ejecución 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

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

  Puede obtener más información sobre la prevención de conflictos en ArcGIS Pipeline Referencing o la prevención de conflictos en ArcGIS Roads and Highways.

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo 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 los eventos incorporados con superposiciones de medición o temporalidad con Id. de evento idénticos como registros de Evento de destino se cargarán en la clase de entidad de evento. Agregar—Los registros de Evento de entrada se incorporarán al valor del parámetro Evento de destino. No se realiza ningún cambio en los registros de Evento de destino. Retirar superposiciones—Los registros de Evento de entrada se incorporarán al valor del parámetro Evento de destino y se eliminará cualquier registro en el valor del parámetro Evento de destino con superposiciones de medición o temporalidad como los eventos incorporados. Si el evento incorporado eclipsa el valor del parámetro Evento de destino, se eliminará el valor del parámetro Evento de destino. Esta opción solo se debe utilizar para eventos lineales. Retirar por Id. de evento—Los registros de Evento de entrada se incorporarán al valor del parámetro Evento de destino y se eliminará cualquier registro en el valor del parámetro Evento de destino con los mismos Id. de evento y superposiciones de temporalidad que los eventos incorporados. Si el evento incorporado eclipsa un valor del parámetro Evento de destino con el mismo Id. de evento, se eliminará el valor del parámetro Evento de destino. Reemplazar por Id. de evento—Los registros de Evento de entrada se incorporarán al valor del parámetro Evento de destino y se eliminará cualquier registro en el valor del parámetro Evento de destino con 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 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

Etiqueta	Explicación	Tipo 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

Python

arcpy.locref.AppendEvents(in_dataset, in_target_event, field_mapping, {load_type}, {generate_event_ids}, {generate_shapes})

Nombre	Explicación	Tipo 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. ADD—Los registros de in_dataset se incorporarán al valor del parámetro in_target_event. No se realiza ningún cambio en los registros de in_target_event. RETIRE_OVERLAPS—Los registros de in_dataset se incorporarán al valor del parámetro in_target_event y se eliminará cualquier registro en el valor del parámetro in_target_event con superposiciones de medición o temporalidad como los eventos incorporados. Si el evento incorporado eclipsa el valor del parámetro in_target_event, se eliminará el valor del parámetro in_target_event. Esta opción solo se debe utilizar para eventos lineales. RETIRE_BY_EVENT_ID—Los registros de in_dataset se incorporarán al valor del parámetro in_target_event y se eliminará cualquier registro en el valor del parámetro in_target_event con los mismos Id. de evento y superposiciones de temporalidad que los eventos incorporados. Si el evento incorporado eclipsa un valor del parámetro in_target_event con el mismo Id. de evento, se eliminará el valor del parámetro in_target_event. REPLACE_BY_EVENT_ID—Los registros de in_dataset se incorporarán al valor del parámetro in_target_event y se eliminarán los registros del valor del parámetro in_target_event con 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_IDS—Se generarán los Id. de evento para los registros de in_dataset que se van a incorporar. NO_GENERATE_EVENT_IDS—No 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 in_dataset es una capa de entidades o clase de entidad. GENERATE_SHAPES—Se regenerarán las formas de las entidades de eventos de entrada. Esta es la opción predeterminada. NO_SHAPES—Las formas de las entidades de eventos de entrada no se regenerarán.	Boolean

Salida derivada

Nombre	Explicación	Tipo 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

# Import arcpy module
import arcpy

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

# 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)

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

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')

Entornos

Espacio de trabajo actual

Información de licenciamiento

• Basic: Requiere ArcGIS Location Referencing
• Standard: Requiere ArcGIS Location Referencing
• Advanced: Requiere ArcGIS Location Referencing