Присоединить события (Инструменты Location Referencing)
Краткая информация
Присоединяет записи событий из таблицы, слоя или класса объектов к имеющемуся классу объектов событий LRS.
Примечание:
Если целевым слоем является слой сервиса объектов, результаты проверки записываются в файл в директории ArcGIS Server. По умолчанию этот файл автоматически очищается через 10 минут, этого может быть недостаточно для обработки всех проверок и их записи в рабочую станцию, запускающую ArcGIS Pro. При больших объемах данных рекомендуется установить максимальный возраст файла как минимум один час. Вы можете отредактировать серверную директорию в ArcGIS Server Manager (https://enterprise.arcgis.com/en/server/12.0/administer/windows/editing-a-server-directory-in-manager.htm), чтобы настроить этот параметр.
Использование
Для запуска этого инструмента требуется набор данных LRS.
Значение параметра Входное событие может быть таблицей, слоем или классом объектов.
Значение параметра Целевое событие должно быть слоем или классом объектов, зарегистрированным с LRS.
Наборы выборки и определяющие запросы для значения параметра Целевое событие будут игнорироваться.
Этот инструмент поддерживает точечные и линейные объекты. Тип объекта в параметрах Входное событие и Целевое событие должен совпадать.
При добавлении новых событий с использованием опции Добавить для параметра Тип загрузки, если у значения Целевое событие настроено поле
RouteName, его можно использовать для добавления событий.Если записи Входных событий содержат пустые поля
RouteIDи заполненные поляRouteName, события могут быть добавлены с помощью поляRouteName. Затем автоматически генерируются поляRouteIDдля этих добавленных событий.Если записи Входных событий имеют заполненные поля
RouteIDиRouteName, события будут добавлены с помощью поляRouteID.
Сопоставление полей
FromDateиToDateявляется дополнительным для опции Добавить параметра Тип загрузки. Поддерживаются следующие сценарии:Если поля
FromDateиToDateне сопоставлены, добавленное событие будет иметь такую же дату начала, как и у активного временного среза маршрута, а дата окончания будет иметь значение null.Если поле
FromDateсопоставлено, а полеToDateне сопоставлено, добавленное событие будет иметь значение null для даты окончания.Если поле
FromDateне сопоставлено, а полеToDateсопоставлено, инструмент вернет ошибку.Для связанных линейных событий инструмент сначала определяет самый последний временной срез по всем маршрутам, имеющим один и тот же идентификатор линии. Затем дата начала последнего временного среза маршрута будет назначена в качестве даты начала добавленного события, а дата окончания будет иметь значение null.
Примечание:
Если вы не сопоставляете поле
ToDateили оба поляFromDateиToDate, то это поле или поля необходимо удалить из списка полей в параметре Список полей.Если параметр Построить GUID идентификаторов загруженных событий отмечен, либо не сопоставляйте поле
EventIDв параметре Сопоставить поле, либо убедитесь, что в полеEventIDвходных событий находятся значения null. Если полеEventIDв исходной записи события заполнено, а параметр Построить GUID идентификаторов загруженных событий включен, значение в полеEventIDзаписи исходного события будет загружено в целевое событие.Если параметр Присоединить события к доминирующим маршрутам включен, записи из значения параметра Входное событие будут присоединены к доминирующим маршрутам, если существуют конкурирующие. Если на маршруте существует несколько совпадений, записи Входное событие будут разделены и добавлены к доминирующему маршруту для каждого конкурирующего участка маршрута. Если конкуренции маршрутов нет, записи из значения параметра Входное событие все равно будут добавлены к маршрутам, указанным во входном наборе данных.
- Инструмент предоставляет текстовый файл с записями событий, которые отличаются от маршрутов, указанных во входном наборе данных, и добавляются к доминирующим маршрутам.
Этот инструмент поддерживает предотвращение конфликтов и пытается получить и перенести блокировки.
Когда включено предотвращение конфликтов, поддерживается следующее:
События, которые должны быть присоединены, автоматически получать блокировку, если допустимо. Если блокировку получить нельзя, инструмент возвратит ошибку и создаст текстовой файл с описанием неудачных блокировок.
Когда отмечен параметр Присоединить события к доминирующим маршрутам, блокировки таких событий сравниваются только с наиболее доминирующими целевыми маршрутами, к которым они будут добавляться. Если блокировку для целевых маршрутов получить нельзя, инструмент возвратит ошибку и создаст текстовой файл с описанием неудачных блокировок.
Если отмечен параметр Присоединить даже при наличии блокировок предотвращения конфликтов, в результате работы этого инструмента существующие блокировки будут проигнорированы, а новые блокировки устанавливаться не будут.
Внимание:
Обход блокировок, предотвращающих конфликты, может привести к повреждению данных или неожиданному поведению. Подумайте о возможных последствиях и всегда создавайте резервную копию базы данных перед запуском этого инструмента с отмеченным параметром Присоединить даже при наличии блокировок предотвращения конфликтов.
При работе с версией default, полученные блокировки будут сняты автоматически по завершении работы инструмента.
При работе с именованной версией, полученные блокировки останутся в статусе закрепления по завершении работы инструмента. Необходимо закрепить или удалить версию, чтобы снять блокировки.
При работе в именованной версии, если процесс использования инструмента будет отменен, произведенные блокировки будут оставаться в состоянии, которое можно отменить.
Калибровка маршрута на маршрутах с реальными промежутками влияет на присоединенные события следующими способами:
Если разница в калибровке маршрута через промежуток не нулевая, присоединенные события будут разделены по промежуткам.
Если разница в калибровке маршрута через промежуток является нулевой, присоединенные события будут составными.
Вы можете использовать файл
.csvв формате ASCII для присоединения событий, когда он используется вместе с файлом инициализации (schema.ini), который задает разделенные запятыми поля в файле.csv. Схема файла инициализации должна содержать следующее:Имя файла
.csvи формат инициализацииИмя и тип данных для каждого столбца
Максимальная ширина, использующаяся, если тип данных - текст
В следующем примере инициализации указываются имя файла
.csvи используемый формат, имя поля и тип данных для каждого столбца (слева направо), а также максимальная ширина текстовых полей:schema.ini
<!--```other [source_events.csv] Format=CSVDelimited ColNameHeader=True Col1=FromDate Date Col2=ToDate Date Col3=RouteID Text ширина 255 Col4=RouteName Text ширина 255 Col5=FromMeasure Double Col6=ToMeasure Double Col7=RdType Long Col8=EventID Text ширина 50
[Более подробно о добавлении таблицы ASCII или таблицы в текстовом файле](../../help/data/tables/add-an-ascii-or-text-file-table.md) > [!LEGACY] > Параметр **Создать формы** больше не поддерживается.
Параметры
| Подпись | Объяснение | Тип данных |
|---|---|---|
|
Входное событие |
Исходные записи событий для присоединения. |
Table View |
|
Целевое событие |
Слой событий LRS или класс объектов, к которому будут присоединены исходные записи событий. |
Feature Layer |
|
Сопоставление полей |
Управляет тем, как атрибутивная информация в полях входного события будет переноситься в целевое событие. Поскольку записи исходных событий будут добавляться к существующему целевому событию, у которого есть предопределенная схема (определения полей), добавление или удаление полей из целевого события невозможно. Хотя вы можете установить правила слияния для каждого выходного поля, инструмент игнорирует эти правила. |
Field Mappings |
|
Тип загрузки (Дополнительный) |
Указывает, как присоединенные события будут загружаться в целевое событие.
|
String |
|
Построить GUID идентификаторов загруженных событий (Дополнительный) |
Определяет, будут ли создаваться ID событий для присоединяемых записей исходных событий. Генерация ID событий будет применяться только к записям исходных событий со значением null в поле
|
Boolean |
|
Создать формы (Дополнительный) |
Примечание:Этот параметр более не поддерживается. |
Boolean |
|
Присоединить события к доминирующим маршрутам (Дополнительный) |
Задает, будут ли исходные записи событий добавляться к доминирующим маршрутам, если существует конкуренция маршрутов. Этот параметр работает со всеми опциями Тип загрузки: Добавить, Исключить наложения, Исключить событие по ID и Заменить событие по ID.
|
Boolean |
|
Присоединить даже при наличии блокировок предотвращения конфликтов (Дополнительный) |
Указывает, будут ли добавлены события даже при наличии блокировок предотвращения конфликтов. Этот параметр доступен только в том случае, если в наборе данных LRS включено предотвращение конфликтов. Внимание:Обход блокировок, предотвращающих конфликты, может привести к повреждению данных или неожиданному поведению. Подумайте о возможных последствиях и создайте резервную копию базы данных перед запуском инструмента с отмеченным параметром.
|
Boolean |
Производные выходные данные
| Подпись | Объяснение | Тип данных |
|---|---|---|
|
Выходное целевое событие |
Слой событий или класс объектов, к которому будут присоединены исходные записи событий. |
Feature Layer |
|
Выходной файл результатов |
Текстовый файл, в котором подробно описаны изменения, внесенные инструментом. |
Text File |
Параметры среды
Информация о лицензировании
- 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)