Опрос ArcGIS Server на наличие объектов

Входной коннектор Опрос ArcGIS Server на наличие объектов может использоваться для опроса слоя картографического сервиса или сервиса объектов ArcGIS Enterprise или ArcGIS Online на наличие записей объектов с целью их обработки как записей событий.

Примечания по использованию

• Используйте этот коннектор для извлечения объектов из слоя сервиса карт или объектов.
• Это входной коннектор спаривает Feature JSON Inbound Adapter с Feature Service Inbound Transport. Feature JSON Inbound Adapter интерпретирует объект JSON особым образом. Дополнительные сведения см. в разделе Объекты Geometry.
• Поддерживаются картографические сервисы и сервисы пространственных объектов ArcGIS Enterprise, ArcGIS Online и ArcGIS Server (автономный).
• На слои сервисов можно ссылаться с помощью функциональности Перейти к слою или задав URL c помощью функциональности URL слоя сервиса. Оба метода требуют, чтобы было установлено зарегистрированное подключение к хранилищу данных.
• Как и для всех входных коннекторов, ему требуется определение GeoEvent. Определение GeoEvent описывает схему получаемых записей событий. Дополнительные сведения см. в разделе Управление определениями GeoEvent.
• Значения данных из атрибутивных полей событий, не включенных в определение GeoEvent, игнорируются.
• Этот входной коннектор с заданным интервалом опрашивает указанный слой сервиса карт/объектов. Как и с любым веб-сервером или веб-сервисом, частые опросы, например, раз в секунду, не рекомендуются.
• Для определения набора записей объектов, возвращаемых каждым опросом сервиса, используется простое выражение WHERE. По умолчанию, включаются все записи из набора записей объектов, т.е., WHERE 1=1. Выражение WHERE по умолчанию может быть изменено для включения определенных значений атрибутов и логических условий.
• Поддерживаются пространственные фильтры, которые используют указанную геометрию и пространственные отношения, например, пересечение полигонов.
• Дополнительно поддерживается удаление запрошенных записей из слоя сервиса карт/объектов.
• Поддерживается уникальная возможность Получение накопительных обновлений для опроса новых добавленных или обновленных записей объектов с использованием значений ObjectID или Timestamp, полученных из записей объектов или извлеченных из интервала опроса и кэшированных входным коннектором.
• Кэшированные значения встраиваются в выражение WHERE для запроса записей, значения которых больше кэшированных значений, или в пределах интервала опроса относительно текущего момента.
• Существует три метода для идентификации накопительных обновлений: ObjectID, Timestamp и Timestamp until now.
• Дополнительные сведения см. в блоге Esri Community Polling Feature Services for Incremental Updates.

Параметры

Параметр	Описание
Имя	Описательное имя входного коннектора, используемое для ссылки в GeoEvent Manager.
Зарегистрированное подключение к серверу	Подключение ArcGIS Server, ArcGIS Enterprise или ArcGIS Online, зарегистрированное на ArcGIS GeoEvent Server как хранилище данных. Зарегистрированные подключения к серверу кэшируют информацию о сервисах карт/объектов, их слоях и свойствах слоев.
Ссылка на Тип слоя	Определяет опции для ссылки на слой. Перейти к слою - указать ссылку на слой сервиса, найдя его в папках зарегистрированного хранилища данных. URL слоя сервиса - указать ссылку на слой сервиса, задав URL опубликованного слоя сервиса.
Папка (Условия)	Папка сервисов ArcGIS Server, портал ArcGIS Enterprise или папка с элементами ресурсов ArcGIS Online. Параметр показывается, когда для параметра Ссылка на Тип слоя установлено Перейти к слою, и скрыт, когда установлено URL-адрес слоя сервиса.
Имя сервиса (Условия)	Имя карты/сервиса объектов, из которого вы хотите опросить записи объектов. Параметр показывается, когда для параметра Ссылка на Тип слоя установлено Перейти к слою, и скрыт, когда установлено URL-адрес слоя сервиса.
Слой (Условия)	Векторный слой карты / сервиса объектов, через который осуществляется доступ к записям объектов. Параметр показывается, когда для параметра Ссылка на Тип слоя установлено Перейти к слою, и скрыт, когда установлено URL-адрес слоя сервиса.
URL слоя сервиса (Условия)	URL к слою сервиса. Примечание: Должно быть установлено подключение к хранилищу данных при ссылке к слою сервиса через URL. Слой сервиса должен быть либо доступен для всех, либо опубликован для пользователя, у которого есть учетные данные для подключения к хранилищу данных. Параметр показывается, когда для параметра Ссылка на Тип слоя установлено URL слоя сервиса, и скрыт, когда установлено Перейти к слою.
Создать определение GeoEvent	Указывает, следует ли использовать новое или существующее Определение GeoEvent для данных входящих событий. Определение GeoEvent требуется GeoEvent Server, чтобы понимать поля атрибутов и типы данных входящих событий. Да – новое Определение GeoEvent будет создано на основе схемы первой полученной записи события. Нет – новое Определение GeoEvent не будет создаваться. Выберите существующее Определение GeoEvent, соответствующее схеме данных входящего события.
Имя определения GeoEvent (новое) (Условия)	Имя, которое присваивается для нового Определения GeoEvent. Если определение GeoEvent с указанным именем уже существует, будет использоваться существующее определение GeoEvent. Первая полученная запись данных будет использоваться для определения ожидаемой схемы последующих записей данных, на основе которой будет создано новое определение GeoEvent. Этот параметр показывается, когда для свойства Создать определение GeoEvent задано значение Да, и скрыто, если выбрано значение Нет.
Имя определения GeoEvent (существующее) (Условия)	Имя существующего определения GeoEvent для использования при адаптации полученных данных для создания данных событий для обработки сервисом GeoEvent. Этот параметр показывается, когда для свойства Создать определение GeoEvent задано значение Нет, и скрыто, если выбрано значение Да.
Интервал обновления	Период (в секундах), в течение которого векторный слой карты/сервиса объектов будет опрошен для записей объектов. Значение по умолчанию – 10 (один запрос сбора данных будет выполнен каждые 10 секунд).
Получить накопительные обновления	Задает запрос только новых или обновленных записей объектов, используя кэшированное значение ObjectID или Timestamp. Значение по умолчанию Нет. Да – GeoEvent Server будет собирать накопительные обновления с помощью кэшированного ObjectID или Timestamp. Нет - GeoEvent Server не применяет кэшированные ObjectID или Timestamp в запросах записей. Примечание: Если входной коннектор удален и воссоздан, сервис ArcGIS GeoEvent Server остановлен или перезапущен или серверная машина перезапущена, кэшированное значение ключа будет потеряно. Новые кэшированные значения будут получены при опросе доступных записей объектов и изучении набора записей объектов, полученных из сервиса карт/объектов.
Метод идентификации накопительных обновлений (Условия)	Задает тип атрибута, который GeoEvent Server будет использовать для идентификации новых или обновленных записей объектов при опросе накопительных обновлений. Доступные опции включают: ObjectID – GeoEvent Server будет кэшировать наибольший идентификатор объекта из набора записей объектов, возвращенных из опроса картографического сервиса/сервиса объектов. В следующий опрос будут включены только объекты, идентификатор объекта которых больше значения, записанного в кэш из последнего опроса. Timestamp – GeoEvent Server будет кэшировать наибольшую временную отметку в наборе записей объектов, возвращаемых из опроса картографического сервиса/сервиса объектов. В следующий опрос будут включены только объекты, временные метки которых больше значения, записанного в кэш из последнего опроса. Timestamp until now—предназначен для использования особенно, когда включено отслеживание пользователей, эта опция будет использовать последнее время опроса, а не самую большую по значению временную метку из набора записей опрошенных объектов. Если время опроса задано как 300 секунд, например, опросы будут обращаться к записям объектов, чьи временные метки попадают в интервал опроса относительно текущего момента. Например, интервал опроса может быть last_edited_date >= timestamp '2021-09-23 00:38:04.075' и last_edited_date < timestamp '2021-09-23 00:43:04.583' , где 00:38:04 был последним опросом, а 00:43:04 - на пять минут (300 секунд) позже. Любые записи объектов, которые были изменены в рамках интервала опроса, будут возвращены этим запросом. Этот параметр показывается, когда для свойства Получить накопительные обновления задано значение Да, и скрыто, если для свойства Получить накопительные обновления выбрано значение Нет.
Поле времени для идентификации накопительных обновлений (Условия)	Поле метки времени из определения GeoEvent, значения которого будут использоваться для идентификации накопительных обновлений на основе метки времени. Можно выбрать только те атрибуты, тип данных которых соответствует Date. Параметр показывается, когда для параметра Метод идентификации накопительных обновлений задана Метка времени или Метка времени до текущего момента.
Определение запроса	Задает логическое выражение, используемое для ограничения записей объектов, возвращаемых при опросе векторного слоя карты/сервиса объектов. Выражение используется в качестве предиката в предложении Where языка структурированных запросов (SQL). Примеры использования: 1=1 – по умолчанию, используется для построения условия WHERE 1=1 для опроса всех доступных записей. track_id LIKE '%AJP' – сопоставляет записи объектов с буквенной строкой AJP в любом месте строки TRACK_ID. reported_dt > timestamp '2019-04-05 22:30:00' – сопоставляет записи объектов, значение атрибута даты/времени которых больше указанной метки времени.
Использовать фильтр геометрии	Указывает, следует ли использовать объект геометрии в качестве пространственного фильтра для ограничения записей объектов, возвращаемых при опросе векторного слоя карты/сервиса объектов. Фильтр геометрии, если он указан, будет объединен с указанным определением запроса для дальнейшего ограничения записей объектов, возвращаемых из запроса векторного слоя. Дополнительные сведения см. в разделе Объекты Geometry. Да – пространственный фильтр будет использоваться для запроса объектов из векторного слоя. Нет – пространственный фильтр не будет использоваться для запроса объектов из векторного слоя.
Фильтр геометрии (Условия)	Объект геометрии, выраженный с помощью функции JSON, используется в качестве пространственного фильтра. Для дополнительной информации о правильном синтаксисе объектов геометрии см. Объекты и геометрии. Параметр показывается, когда для свойства Использовать фильтр геометрии задано Да.
Тип геометрии (Условия)	Задает тип геометрии, описываемый объектом JSON для фильтра геометрии. Поддерживаются типы геометрии: конверт, точка, полилиния, полигон и мультиточка. Параметр показывается, когда для свойства Использовать фильтр геометрии задано Да.
Пространственная привязка (Условия)	Указывает идентификатор ID (WKID) системы координат для геометрии. Параметр показывается, когда для свойства Использовать фильтр геометрии задано Да.
Пространственное отношение (Условия)	Задает пространственное отношение, используемое при оценке записей объектов, извлеченных из векторного слоя карты/сервиса объектов, чтобы определить, удовлетворяют ли они условиям фильтра геометрии. Параметр показывается, когда для свойства Использовать фильтр геометрии задано Да.
Удалить опрошенные объекты	Указывает, следует ли удалять записи объектов из набора записей, возвращаемых из сервиса объектов, из векторного слоя сервиса объектов. По умолчанию Нет.