使用 LRS 配置外部事件 (位置参考)

摘要

将存储在外部系统中的事件数据与 LRS 相关联。

使用情况

• 存在关联事件的地理数据库和 LRS 所在的地理数据库必须是企业级地理数据库。

• 此工具还可用于修改现有已配置外部事件的名称、字段和事件行为。

• 默认设置以下事件行为规则：

  活动	规则
  校准路径	固定不动
  停用路径	固定不动
  延伸路径	固定不动
  重新分配路径	固定不动
  重新对齐路径	固定不动
  反转路径	固定不动
  制图重新对齐路线	依边线连通路线测量值

参数

对话框

标注	说明	数据类型
输入事件	要注册到 LRS 的外部事件要素类或表。	Table View
父 LRS 网络	事件将注册到的 LRS 网络。	Feature Layer
LRS 事件名称	将注册到 LRS 的外部事件或表的名称。	String
事件 ID 字段	事件要素类或表中可用的事件 ID 字段。	Field
路径 ID 字段	如果是不跨越路径的点事件或线事件，则为路径 ID 字段的名称；如果事件跨越路径，则为来自路径 ID 字段的名称。 该字段必须在外部事件表或要素类中可用。	Field
测量字段	如果是点事件，则为“测量”字段的名称；如果是线事件，则为“测量始于”字段的名称。	Field
几何类型 (可选)	指定外部事件或表的几何类型。 点—事件的几何类型将是点。 这是默认设置。 线—事件的几何类型将是折线。	String
测量止于字段 (可选)	“测量止于”字段的名称 此字段仅对线路事件是必需的。	Field
“开始日期”字段 (可选)	事件要素类或表中的开始日期字段。	Field
“结束日期”字段 (可选)	事件要素类或表中的“结束日期”字段。	Field
事件跨越路径 (可选)	指定事件记录是否跨越路径。 原样—不会更改属性。 这是默认设置。 不跨越路径—事件记录不会跨越路径。 此选项仅适用于线事件。 跨越路径—事件记录将跨越路径。 此选项仅适用于线事件。	String
“路径止于 ID”字段 (可选)	事件要素类或表中可用的“路径止于 ID”字段的名称。	Field
存储路径名称 (可选)	指定是否将路径名称与事件记录一起存储。 原样—不会更改属性。 这是默认设置。 不存储路径名称—路径名称不会与事件记录一起存储。 存储路径名称—路径名称将与事件记录一起存储。	String
“路径名称”字段 (可选)	如果是不跨越路径的点事件或线事件，则为路径名称字段；如果事件跨越路径，则为“路径始于名称”字段的名称。 该字段必须在外部事件表或要素类中可用。	Field
“路径止于名称”字段 (可选)	跨越路径的线事件的“路径止于名称”字段。 如果设置了存储路径名称和事件跨越路径参数，则需要此参数。	Field
校准规则 (可选)	指定校准活动的事件行为规则。 固定不动—事件的地理位置将被保留；测量值可能会改变。 这是默认设置。 停用—测量值和地理位置都将被保留；该事件将被停用。 移动—事件测量值将被保留，地理位置可能发生变化。	String
停用规则 (可选)	指定停用活动的事件行为规则。 固定不动—事件的地理位置将被保留；测量值可能会改变。 这是默认设置。 停用—测量值和地理位置都将被保留；该事件将被停用。 移动—事件测量值将被保留，地理位置可能发生变化。	String
扩展规则 (可选)	指定扩展活动的事件行为规则。 固定不动—事件的地理位置将被保留；测量值可能会改变。 这是默认设置。 停用—测量值和地理位置都将被保留；该事件将被停用。 移动—事件测量值将被保留，地理位置可能发生变化。 覆盖—线事件的几何位置和测量值将被修改以包括新的或新修改的部分。	String
重新分配规则 (可选)	指定重新分配活动的事件行为规则。 固定不动—事件的地理位置将被保留；测量值可能会改变。 这是默认设置。 停用—测量值和地理位置都将被保留；该事件将被停用。 移动—事件测量值将被保留，地理位置可能发生变化。 捕捉—通过将事件捕捉到并发路线，保留事件的地理位置；测量值可能会改变。	String
重新对齐规则 (可选)	指定重新对齐活动的事件行为规则。 固定不动—事件的地理位置将被保留；测量值可能会改变。 这是默认设置。 停用—测量值和地理位置都将被保留；该事件将被停用。 移动—事件测量值将被保留，地理位置可能发生变化。 捕捉—通过将事件捕捉到并发路线，保留事件的地理位置；测量值可能会改变。 覆盖—线事件的几何位置和测量值将被修改以包括新的或新修改的部分。	String
反向规则 (可选)	指定反向活动的事件行为规则。 固定不动—事件的地理位置将被保留；测量值可能会改变。 这是默认设置。 停用—测量值和地理位置都将被保留；该事件将被停用。 移动—事件测量值将被保留，地理位置可能发生变化。	String
制图重新对齐规则 (可选)	指定制图重新对齐活动的事件行为规则。 支持路径测量—将保留事件的测量值，或与路径测量值更改成比例地更改测量值。 这是默认设置。	String

派生输出

标注	说明	数据类型
输出外部事件表	更新的外部事件表。	Table

Python

arcpy.locref.ConfigureExternalEventWithLRS(in_event, parent_network, event_name, event_id_field, route_id_field, measure_field, {geometry_type}, {to_measure_field}, {from_date_field}, {to_date_field}, {event_spans_routes}, {to_route_id_field}, {store_route_name}, {route_name_field}, {to_route_name_field}, {calibrate_rule}, {retire_rule}, {extend_rule}, {reassign_rule}, {realign_rule}, {reverse_rule}, {carto_realign_rule})

名称	说明	数据类型
in_event	要注册到 LRS 的外部事件要素类或表。	Table View
parent_network	事件将注册到的 LRS 网络。	Feature Layer
event_name	将注册到 LRS 的外部事件或表的名称。	String
event_id_field	事件要素类或表中可用的事件 ID 字段。	Field
route_id_field	如果是不跨越路径的点事件或线事件，则为路径 ID 字段的名称；如果事件跨越路径，则为来自路径 ID 字段的名称。 该字段必须在外部事件表或要素类中可用。	Field
measure_field	如果是点事件，则为“测量”字段的名称；如果是线事件，则为“测量始于”字段的名称。	Field
geometry_type (可选)	指定外部事件或表的几何类型。 POINT—事件的几何类型将是点。 这是默认设置。 LINE—事件的几何类型将是折线。	String
to_measure_field (可选)	“测量止于”字段的名称 此字段仅对线路事件是必需的。	Field
from_date_field (可选)	事件要素类或表中的开始日期字段。	Field
to_date_field (可选)	事件要素类或表中的“结束日期”字段。	Field
event_spans_routes (可选)	指定事件记录是否跨越路径。 AS_IS—不会更改属性。 这是默认设置。 NO_SPANS_ROUTES—事件记录不会跨越路径。 此选项仅适用于线事件。 SPANS_ROUTES—事件记录将跨越路径。 此选项仅适用于线事件。	String
to_route_id_field (可选)	事件要素类或表中可用的“路径止于 ID”字段的名称。	Field
store_route_name (可选)	指定是否将路径名称与事件记录一起存储。 AS_IS—不会更改属性。 这是默认设置。 NO_STORE_ROUTE_NAME—路径名称不会与事件记录一起存储。 STORE_ROUTE_NAME—路径名称将与事件记录一起存储。	String
route_name_field (可选)	如果是不跨越路径的点事件或线事件，则为路径名称字段；如果事件跨越路径，则为“路径始于名称”字段的名称。 该字段必须在外部事件表或要素类中可用。	Field
to_route_name_field (可选)	跨越路径的线事件的“路径止于名称”字段。 如果设置了 store_route_name 和 event_spans_routes 参数，则需要此参数。	Field
calibrate_rule (可选)	指定校准活动的事件行为规则。 STAY_PUT—事件的地理位置将被保留；测量值可能会改变。 这是默认设置。 RETIRE—测量值和地理位置都将被保留；该事件将被停用。 MOVE—事件测量值将被保留，地理位置可能发生变化。	String
retire_rule (可选)	指定停用活动的事件行为规则。 STAY_PUT—事件的地理位置将被保留；测量值可能会改变。 这是默认设置。 RETIRE—测量值和地理位置都将被保留；该事件将被停用。 MOVE—事件测量值将被保留，地理位置可能发生变化。	String
extend_rule (可选)	指定扩展活动的事件行为规则。 STAY_PUT—事件的地理位置将被保留；测量值可能会改变。 这是默认设置。 RETIRE—测量值和地理位置都将被保留；该事件将被停用。 MOVE—事件测量值将被保留，地理位置可能发生变化。 COVER—线事件的几何位置和测量值将被修改以包括新的或新修改的部分。	String
reassign_rule (可选)	指定重新分配活动的事件行为规则。 STAY_PUT—事件的地理位置将被保留；测量值可能会改变。 这是默认设置。 RETIRE—测量值和地理位置都将被保留；该事件将被停用。 MOVE—事件测量值将被保留，地理位置可能发生变化。 SNAP—通过将事件捕捉到并发路线，保留事件的地理位置；测量值可能会改变。	String
realign_rule (可选)	指定重新对齐活动的事件行为规则。 STAY_PUT—事件的地理位置将被保留；测量值可能会改变。 这是默认设置。 RETIRE—测量值和地理位置都将被保留；该事件将被停用。 MOVE—事件测量值将被保留，地理位置可能发生变化。 SNAP—通过将事件捕捉到并发路线，保留事件的地理位置；测量值可能会改变。 COVER—线事件的几何位置和测量值将被修改以包括新的或新修改的部分。	String
reverse_rule (可选)	指定反向活动的事件行为规则。 STAY_PUT—事件的地理位置将被保留；测量值可能会改变。 这是默认设置。 RETIRE—测量值和地理位置都将被保留；该事件将被停用。 MOVE—事件测量值将被保留，地理位置可能发生变化。	String
carto_realign_rule (可选)	指定制图重新对齐活动的事件行为规则。 HONOR_ROUTE_MEASURE—将保留事件的测量值，或与路径测量值更改成比例地更改测量值。 这是默认设置。	String

派生输出

名称	说明	数据类型
out_external_event_table	更新的外部事件表。	Table

代码示例

ConfigureExternalEventWithLRS 示例 1（Python 窗口）

以下脚本演示了如何使用 ConfigureExternalEventWithLRS 函数在 Python 窗口中配置外部点事件。

# Name: Configure_Externalevent_LRS_ex1.py
# Description: Configure an external point event in an LRS Network in the Python window.
# Requires: ArcGIS Location Referencing

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

#Tool variables
in_event = "C:\\Eventdata.sde\\pointevent"
parent_network = "C:\\Networkdata.sde\\Network1"
event_name = "PointEvent"
event_id_field = "EventId"
route_id_field = "RouteId"
measure_field =  "Measure"
geometry_type = "POINT"
to_measure_field = None
from_date_field = "FromDate"
to_date_field =  "ToDate"
event_spans_routes =  "AS_IS"
to_route_id_field = None
store_route_name = "AS_IS"
route_name_field = None
to_route_name_field = None
calibrate_rule = "STAY_PUT"
retire_rule ="STAY_PUT"
extend_rule ="STAY_PUT"
reassign_rule ="STAY_PUT"
realign_rule ="STAY_PUT"
reverse_rule = "STAY_PUT"
carto_realign_rule = "HONOR_ROUTE_MEASURE"

# set current workspace
#arcpy.env.workspace = "C:\\Networkdata.sde"

# execute the tool
arcpy.locref.ConfigureExternalEventWithLRS(in_event, parent_network, event_name, event_id_field, route_id_field, measure_field, geometry_type, to_measure_field, from_date_field, to_date_field, event_spans_routes, to_route_id_field, store_route_name, route_name_field, to_route_name_field, calibrate_rule, retire_rule, extend_rule, reassign_rule, realign_rule, reverse_rule, carto_realign_rule)

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

ConfigureExternalEventWithLRS 示例 2（Python 窗口）

以下脚本演示了如何使用 ConfigureExternalEventWithLRS 函数在 Python 窗口中配置外部线事件。

# Name: Configure_Externalevent_LRS_ex2.py
# Description: Configure an external line event in an LRS Network in the Python window.
# Requires: ArcGIS Location Referencing

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

# Tool variables
in_event = "C:\\Eventdata.sde\\lineevent"
parent_network = "C:\\Networkdata.sde\\Network1"
event_name = "LineEvent"
event_id_field = "EventId"
route_id_field = "RouteId"
measure_field =  "FromMeasure"
geometry_type = "LINE"
to_measure_field = "ToMeasure"
from_date_field = "FromDate"
to_date_field =  "ToDate"
event_spans_routes =  "AS_IS"
to_route_id_field = None
store_route_name = "STORE ROUTE NAME"
route_name_field = "RouteName"
to_route_name_field = None
calibrate_rule = "STAY_PUT"
retire_rule ="STAY_PUT"
extend_rule ="STAY_PUT"
reassign_rule ="STAY_PUT"
realign_rule ="STAY_PUT"
reverse_rule = "STAY_PUT"
carto_realign_rule = "HONOR_ROUTE_MEASURE"

# Set current workspace
arcpy.env.workspace = "C:\\Networkdata.sde"

# Execute the tool
arcpy.locref.ConfigureExternalEventWithLRS(in_event, parent_network, event_name, event_id_field, route_id_field, measure_field, geometry_type, to_measure_field, from_date_field, to_date_field, event_spans_routes, to_route_id_field, store_route_name, route_name_field, to_route_name_field, calibrate_rule, retire_rule, extend_rule, reassign_rule, realign_rule, reverse_rule, carto_realign_rule)

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

ConfigureExternalEventWithLRS 示例 3（Python 窗口）

以下脚本演示了如何使用 ConfigureExternalEventWithLRS 函数在 Python 窗口中修改现有外部线事件。

# Name: Configure_Externalevent_LRS_ex3.py
# Description: Modify an existing external line event in an LRS Network in the Python window. Event name and optional parameter fields are updated.
# Requires: ArcGIS Location Referencing

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

# Tool variables
in_event = "C:\\Eventdata.sde\\lineevent"
parent_network = "C:\\Networkdata.sde\\Network1"
event_name = "LineEvent_updated"
event_id_field = "EventId_updated"
route_id_field = "RouteId_updated"
measure_field =  "FromMeasure_updated"
geometry_type = "LINE"
to_measure_field = "ToMeasure_updated"
from_date_field = "FromDate_updated"
to_date_field =  "ToDate_updated"
event_spans_routes =  "AS_IS"
to_route_id_field = None
store_route_name = "STORE_ROUTE_NAME" 
route_name_field = "FromRouteName_updated"
to_route_name_field = None
calibrate_rule = "RETIRE"
retire_rule ="RETIRE"
extend_rule ="RETIRE"
reassign_rule ="RETIRE"
realign_rule ="RETIRE"
reverse_rule = "STAY_PUT"
carto_realign_rule = "HONOR_ROUTE_MEASURE"

# Set current workspace
arcpy.env.workspace = "C:\\Networkdata.sde"

# Execute the tool
arcpy.locref.ConfigureExternalEventWithLRS(in_event, parent_network, event_name, event_id_field, route_id_field, measure_field, geometry_type, to_measure_field, from_date_field, to_date_field, event_spans_routes, to_route_id_field, store_route_name, route_name_field, to_route_name_field, calibrate_rule, retire_rule, extend_rule, reassign_rule, realign_rule, reverse_rule, carto_realign_rule)

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

ConfigureExternalEventWithLRS 示例 4（独立脚本）

以下独立脚本演示了如何使用 ConfigureExternalEventWithLRS 函数在 LRS 网络中配置跨越路径的外部线事件。

# Name: Configure_Externalevent_LRS_ex4.py
# Description: Configure an external line event spanning routes in an LRS Network using a stand-alone Python script.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

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

#Tool variables
in_event = "C:\\Eventdata.sde\\lineevent"
parent_network = "C:\\Networkdata.sde\\Network1"
event_name = "LineSpanningEvent"
event_id_field = "EventId"
route_id_field = "FromRouteId"
measure_field =  "FromMeasure"
geometry_type = "LINE"
to_measure_field = "ToMeasure"
from_date_field = "FromDate"
to_date_field =  "ToDate"
event_spans_routes =  "SPANS ROUTES"
to_route_id_field = "ToRouteId"
store_route_name = "STORE ROUTE NAME"
route_name_field = "FromRouteName"
to_route_name_field = "ToRouteName"
calibrate_rule = "STAY_PUT"
retire_rule ="STAY_PUT"
extend_rule ="STAY_PUT"
reassign_rule ="STAY_PUT"
realign_rule ="STAY_PUT"
reverse_rule = "STAY_PUT"
carto_realign_rule = "HONOR_ROUTE_MEASURE"

# set current workspace
arcpy.env.workspace = "C:\\Networkdata.sde"

# execute the tool
arcpy.locref.ConfigureExternalEventWithLRS(in_event, parent_network, event_name, event_id_field, route_id_field, measure_field, geometry_type, to_measure_field, from_date_field, to_date_field, event_spans_routes, to_route_id_field, store_route_name, route_name_field, to_route_name_field, calibrate_rule, retire_rule, extend_rule, reassign_rule, realign_rule, reverse_rule, carto_realign_rule)

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

ConfigureExternalEventWithLRS 示例 5（独立脚本）

以下独立脚本演示了如何使用 ConfigureExternalEventWithLRS 函数在 LRS 网络中修改现有的跨越路径的外部线事件。

# Name: Configure_Externalevent_LRS_ex5.py
# Description: Modify an existing external line event spanning routes of an LRS Network using a stand-alone Python script. Event name and optional parameter fields are updated.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy 

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

#Tool variables
in_event = "C:\\Eventdata.sde\\lineevent"
parent_network = "C:\\Networkdata.sde\\Network1"
event_name = "LineSpanningEvent_updated"
event_id_field = "EventId_updated"
route_id_field = "FromRouteId_updated"
measure_field =  "FromMeasure_updated"
geometry_type = "LINE"
to_measure_field = "ToMeasure_updated"
from_date_field = "FromDate_updated"
to_date_field =  "ToDate_updated"
event_spans_routes =  "SPANS ROUTES"
to_route_id_field = "ToRouteId_updated"
store_route_name = "STORE ROUTE NAME"
route_name_field = "FromRouteName_updated"
to_route_name_field = "ToRouteName_updated"
calibrate_rule = "RETIRE"
retire_rule = "RETIRE"
extend_rule = "RETIRE"
reassign_rule = "RETIRE"
realign_rule = "RETIRE"
reverse_rule = "STAY_PUT"
carto_realign_rule = "HONOR_ROUTE_MEASURE"

# set current workspace
arcpy.env.workspace = "C:\\Networkdata.sde"

# execute the tool
arcpy.locref.ConfigureExternalEventWithLRS(in_event, parent_network, event_name, event_id_field, route_id_field, measure_field, geometry_type, to_measure_field, from_date_field, to_date_field, event_spans_routes, to_route_id_field, store_route_name, route_name_field, to_route_name_field, calibrate_rule, retire_rule, extend_rule, reassign_rule, realign_rule, reverse_rule, carto_realign_rule)

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

环境

此工具不使用任何地理处理环境。

许可信息

• Basic: 需要 ArcGIS Location Referencing（ArcGIS Pipeline Referencing 或 ArcGIS Roads and Highways）
• Standard: 需要 ArcGIS Location Referencing（ArcGIS Pipeline Referencing 或 ArcGIS Roads and Highways）
• Advanced: 需要 ArcGIS Location Referencing（ArcGIS Pipeline Referencing 或 ArcGIS Roads and Highways）