Skip to main content

追加事件 (位置参考工具)

汇总

用于将事件记录从表、图层或要素类追加到现有 LRS 事件要素类。

注:

当目标图层为要素服务图层时，验证结果将写入 ArcGIS Server 目录中的文件。 默认情况下，此文件会在 10 分钟后自动清除，这可能不足以处理所有验证并将其写入正在运行 ArcGIS Pro 的工作站。 对于较大的数据负载，建议您将最大文件期限调整为至少一小时。 可以在 ArcGIS Server Manager 中编辑服务器目录以调整此设置。

用法

  • 运行此工具需要 LRS 数据集。

  • 输入事件参数值可以为表、图层或要素类。

  • 目标事件参数值必须为注册到 LRS 的图层或要素类。

  • 将忽略目标事件参数值的选择集和定义查询。

  • 此工具支持点和线要素。 输入事件和目标事件参数中的要素类型必须相匹配。

  • 当针对加载类型参数使用添加选项追加新事件时，如果目标事件值已配置 RouteName 字段，则可以使用该字段追加事件。

    • 如果输入事件记录的 RouteID 字段为空，但已填充 RouteName 字段，则可以使用 RouteName 字段追加事件。 然后，将为这些追加事件自动生成 RouteID 字段。

    • 如果输入事件记录同时填充了 RouteID 字段和 RouteName 字段，则将使用 RouteID 字段追加事件。

  • 对于加载类型参数的添加选项，FromDate 和 ToDate 字段的映射是可选项。 支持以下场景：

    • 如果已映射 FromDate 和 ToDate 字段，则追加事件的开始日期将是路径的活动时间片，结束日期将为 null 值。

    • 如果 FromDate 字段已映射，且 ToDate 字段未映射，则追加事件的结束日期将为 null 值。

    • 如果未映射 FromDate 字段，但已映射 ToDate 字段，则该工具返回错误。

    • 对于跨路线事件，该工具首先会识别共享同一线 ID 的所有路径中最近的时间切片。 之后，该路径最近的时间片的起始日期将被指定为追加事件的起始日期，结束日期将为 null 值。

    注:

    如果未映射 ToDate 字段，或 FromDate 和 ToDate 字段，则该字段或这两个字段必须从字段映射参数的字段列表中移除。

  • 如果选中为已加载的事件生成事件 ID GUID 参数，请勿映射字段映射参数中的 EventID 字段，或者确保输入事件的 EventID 字段中存在空值。 如果填充源事件记录中的 EventID 字段并选中为已加载的事件生成事件 ID GUID 参数，则源事件记录 EventID 字段中的值将加载到目标事件中。

  • 如果选中将事件追加到主要路径参数，则输入事件参数值中的记录将追加到存在路径并发的主要路径。 如果沿该路径存在多个并发，则将对输入事件记录进行分割并将其追加到每个并发路径部分的主要路径。 如果路径并发不存在，则输入事件参数值中的记录仍将追加到在输入数据集中指定的路径。

    • 该工具将提供一个事件记录文本文件，这些事件记录与在输入数据集中指定的路径不同，并将追加到主要路径。

  • 此工具支持冲突预防，并将尝试获取和转移锁。

  • 启用冲突预防后，将支持以下内容：

    • 如果可用，需要追加的事件将自动获取事件锁定。 如果无法获取锁定，该工具将返回错误并提供违规锁定的文本文件。

    • 当选中将事件追加到主要路径参数时，将仅针对目标路径对比事件锁，目标路线是事件将追加到的最主要路径。 如果无法获取目标路径的锁定，该工具将返回错误并提供违规锁定的文本文件。

    • 如果选中即使存在冲突预防锁也要追加参数，则将绕过现有锁，并且运行此工具不会获取新锁。

      注意：

      绕过冲突预防锁可能会导致数据损坏或意外行为。 如果选中即使存在冲突预防锁也要追加参数，请在运行此工具前评估潜在后果并总是创建数据库备份。

    • 在默认版本中工作时，获取的锁定将在工具完成后自动释放。

    • 在授权版本中工作时，获得的锁定将在工具完成后保持为 On Post 状态。 您必须发布或删除该版本才能释放锁定。

    • 当在授权版本中工作时，如果取消工具进程，则获取的锁将保持在可释放状态。

  • 物理间距路径上的路径校准对追加事件产生以下方式影响：

    • 如果跨间距的路径校准差异不为零，则追加事件将在间距处拆分。

    • 如果跨间距的路径校准差异为零，则追加事件将变为多部分事件。

  • 将 ASCII 格式的 .csv 文件与定义 .csv 文件中以逗号分隔的字段的初始化文件 (schema.ini) 配合使用时，可以使用其来追加事件。 架构初始化文件必须包含以下内容：

    • 要初始化的 .csv 文件名和格式

    • 每个列的名称和数据类型

    • 数据类型为文本时使用的最大宽度

    以下初始化文件示例声明了要使用的 .csv 文件名和格式、用于每个列的字段名称和数据类型（从左到右），以及文本字段的最大宽度：

    schema.ini

    <!--```other [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

    
[了解有关添加 ASCII 或文本文件表的详细信息](../../help/data/tables/add-an-ascii-or-text-file-table.md)

> [!LEGACY]
> 不再支持**生成形状**参数。

参数

标注 说明 数据类型

输入事件

将追加到的源事件记录。

Table View

目标事件

源事件记录将追加到的 LRS 事件图层或要素类。

Feature Layer

字段映射

用于控制将输入事件的字段中的属性信息传输到目标事件的方式。

由于源事件记录将追加到具有预定义方案（字段定义）的现有目标事件，因此不允许在目标事件中添加或移除字段。 虽然可以为每个输出字段设置合并规则，但该工具将忽略这些规则。

Field Mappings

加载类型

（可选）

用于指定将追加事件加载到目标事件中的方式。

  • 添加—源事件记录将追加到指定目标事件。

  • 停用重叠—源事件记录将追加到指定目标事件，并且将停用任何具有相同测量值或时间性重叠的记录。 如果追加事件超过指定的目标事件记录，则将删除目标事件记录。 仅对线事件使用此选项。

  • 按事件 ID 停用—源事件记录将追加到指定目标事件，并且将停用任何具有相同事件 ID 和时间性重叠的记录。 如果追加事件超过具有相同事件 ID 的目标事件记录，则将删除目标事件记录。

  • 按事件 ID 替换—源事件记录将追加到指定目标事件，并且将替换任何具有相同事件 ID 的记录。

String

为加载的事件生成事件 ID GUID

（可选）

指定是否将为正在追加的源事件记录生成事件 ID。 事件 ID 的生成将仅适用于 Event ID 字段中具有空值的源事件记录。

  • 选中—将为正在追加的源事件记录生成事件 ID。

  • 未选中—将不会为正在追加的源事件记录生成事件 ID。 这是默认设置。

Boolean

生成形状

（可选）
注:

现在，已不再支持此参数。

Boolean

将事件追加到主要路径

（可选）

如果存在路径并发，指定是否将源事件记录追加到主要路径。

此参数适用于所有加载类型选项：添加、停用重叠、按事件 ID 停用以及按事件 ID 替换。

  • 选中—源事件记录将追加到主要路径。

  • 未选中—源事件记录将追加到在输入数据集中指定的路径，不考虑路径优先级。 这是默认设置。

Boolean

即使存在冲突预防锁也要追加

（可选）

指定是否即使存在冲突预防锁也要追加事件。

只有在 LRS 数据集上启用冲突预防时，此参数才可用。

注意：

绕过冲突预防锁可能会导致数据损坏或意外行为。 如果选中此参数，请在运行工具前评估潜在后果并创建数据库备份。

  • 选中—即使存在冲突预防锁也要追加事件。

  • 未选中—如果存在冲突预防锁，则不追加事件。 这是默认设置。

Boolean

派生输出

标注 说明 数据类型

输出目标事件

源事件记录将追加到的事件图层或要素类。

Feature Layer

输出结果文件

详细说明工具所做更改的文本文件。

Text File

环境

当前工作空间

许可信息

  • 基本: 需要 ArcGIS Location Referencing（ArcGIS Pipeline Referencing 或 ArcGIS Roads and Highways）
  • 标准: 需要 ArcGIS Location Referencing（ArcGIS Pipeline Referencing 或 ArcGIS Roads and Highways）
  • 高级: 需要 ArcGIS Location Referencing（ArcGIS Pipeline Referencing 或 ArcGIS Roads and Highways）