Настроить внешнее событие с LRS (Location Referencing)

Краткая информация

Ассоциирует данные событий, хранящиеся во внешней системе с 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—Измерения события будут сохранены; географическое местоположение может измениться. SNAP—Географическое местоположение события будет сохранено путем замыкания события на параллельный маршрут; измерения могут измениться.	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)