Append Events (Location Referencing)

ArcGIS Pro 3.4 | | Help archive

Available with Location Referencing license.

Summary

Appends event records from a table, layer, or feature class to an existing ArcGIS Location Referencing event feature class.

Note:

When the target layer is a feature service layer, the validation results are written to a file in the ArcGIS Server directory. By default, this file will be automatically cleaned up after 10 minutes, which may not be enough time to process all of the validations and write them to the workstation that is running ArcGIS Pro. For larger data loads, it is recommended that you adjust the maximum file age to at least one hour. You can edit a server directory in Manager to adjust this setting.

Usage

  • An LRS dataset is required to run this tool.

    Learn more about creating an LRS dataset in ArcGIS Pipeline Referencing or creating an LRS dataset in ArcGIS Roads and Highways .

  • The Input Event value can be a table, layer, or feature class.

    Learn more about fields required by the ArcGIS Pipeline Referencing events data model

    Learn more about fields required by the Roads and Highways events data model

  • The Target Event value should be a layer or feature class registered with Location Referencing.

  • This tool supports point and polyline features. The feature type in the input and target event parameters must match.

  • When appending new events using the Add value for the Load Type  parameter, if the Target Event value has a RouteName field configured, events can be appended using the RouteName field.

    • If the Input Event records have Null RouteID fields but RouteName fields, events can be appended using the RouteName field. RouteID fields are then automatically generated for those appended events.
    • If the Input Event records have both RouteID fields and RouteName fields, events will be appended using the RouteID field.
  • If the Generate Event ID GUIDs for loaded events parameter is checked, either do not map the EventID field in the field mapping section or ensure that there are Null records in the EventID column in the source event data. If the EventID field in a source event record is populated and the Generate Event ID GUIDs for loaded events parameter is checked, the value in the source event record EventID field will be loaded into the target event.

  • This tool supports conflict prevention and will attempt to acquire and transfer locks.

  • When conflict prevention is enabled, the following are supported:

    • The events that need to be appended will automatically acquire event locks if available. If the locks cannot be acquired, the tool will return an error and provide the text file of offending locks.
    • While working in the default version, the locks acquired will be released automatically upon completion of the tool.
    • While working in a child version, the locks acquired will remain in post status upon completion of the tool. You must post or delete the version to release the locks.
    • While working in a child version, if the tool process is cancelled by interruption, the locks are acquired and will remain in releasable status.

  • Route calibration on physically gapped routes affects appended events in the following ways:

    • If the route calibration difference across the gap is not zero, appended events will be split at gaps.
    • If the route calibration difference across the gap is zero, appended events will be multipart events.

  • You can use an ASCII-formatted .csv file to append events when you use it with an initialization file (schema.ini) that defines the comma-separated fields in the .csv file. The schema initialization file must include the following:

    • The .csv file name and format to initialize
    • A name and data type for each CSV column
    • A maximum width to use if the data type is Text

    The following initialization example declares the .csv file name and format to use, the field name and data type to use for each CSV column (from left to right), and a maximum width for text fields:

    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

    Learn more about adding an ASCII or text file table

Parameters

LabelExplanationData Type
Input Event

The source event records to append.

Table View
Target Event

The Location Referencing event layer or feature class to which the source event records will be appended.

Feature Layer
Field Map

Controls how the attribute information in fields of the Input Event parameter value is transferred to the Target Event parameter value.

Because the Input Event parameter value is appended to an existing event that has a predefined schema (field definitions), fields cannot be added or removed from the target dataset. While you can set merge rules for each output field, the tool ignores those rules.

Field Mappings
Load Type
(Optional)

Specifies how appended events will be loaded into the target event feature class.

  • AddThe Input Event records will be appended to the specified target event feature class.
  • Retire overlapsThe Input Event records will be appended to the specified target event feature class and any records that have the same measure or temporality overlaps as the appended events will be retired. If the appended event eclipses the specified target event feature, the target event record will be deleted. Use this option for linear events only.
  • Retire by event IDThe Input Event records will be appended to the specified target event feature class and any records that have the same event ID and temporality overlaps as the appended events will be retired. If the appended event eclipses a target event record that has the same event ID, the target event record will be deleted.
  • Replace by event IDThe Input Event records will be appended to the specified target event feature class, and any records that have the same event ID as the appended events will be replaced.
String
Generate Event ID GUIDs for loaded events
(Optional)

Specifies whether event IDs will be generated for Input Event records being appended. Generation of event IDs will only be applied to Input Event records with a Null value for the Event ID field.

  • Checked—Event IDs for the Input Event records being appended will be generated.
  • Unchecked—Event IDs for the Input Event records being appended will not be generated. This is the default.
Boolean
Generate Shapes
(Optional)

Specifies whether the shapes of the records being appended will be regenerated. This parameter is only active when the Input Event value is a feature layer or feature class.

  • Checked—The shapes of the input event features will be regenerated. This is the default.
  • Unchecked—The shapes of the input event features will not be regenerated.
Boolean

Derived Output

LabelExplanationData Type
Output Target Event

The event layer or feature class to which the source event records have been appended.

Feature Layer
Output Results File

A text file that details changes made by the tool.

Text File

Environments

Licensing information

  • Basic: Requires ArcGIS Location Referencing (ArcGIS Pipeline Referencing or ArcGIS Roads and Highways)
  • Standard: Requires ArcGIS Location Referencing (ArcGIS Pipeline Referencing or ArcGIS Roads and Highways)
  • Advanced: Requires ArcGIS Location Referencing (ArcGIS Pipeline Referencing or ArcGIS Roads and Highways)

Related topics