Входной коннектор Опрос ArcGIS Server на наличие объектов может использоваться для опроса слоя картографического сервиса или сервиса объектов ArcGIS Enterprise или ArcGIS Online на наличие записей объектов с целью их обработки как записей событий.
Примечания по использованию
При использовании входного коннектора Опрос ArcGIS Server на наличие объектов имейте в виду следующее:
- Используйте этот коннектор для извлечения объектов из слоя сервиса карт или объектов.
- Этот входной коннектор сопрягает входной адаптер Объектов JSON с входным транспортом Сервиса объектов. Входящий адаптер Объектов JSON интерпретирует объекты JSON особым образом. Дополнительные сведения см. в разделе Объекты Geometry.
- Поддерживаются сервисы карт и объектов ArcGIS Enterprise, ArcGIS Online и ArcGIS Server (автономный).
- На слои сервисов можно ссылаться с помощью опции Перейти к слою или задав URL c помощью опции URL слоя сервиса. Оба метода требуют, чтобы было установлено зарегистрированное подключение к хранилищу данных.
- Как и для всех входных коннекторов, ему требуется определение GeoEvent. Определение GeoEvent описывает схему получаемых записей событий. Дополнительные сведения см. в разделе Определения GeoEvent.
- Значения данных из атрибутивных полей событий, не включенных в определение GeoEvent, игнорируются.
- Этот входной коннектор с заданным интервалом опрашивает указанный слой сервиса карт или объектов. Как и с любым веб-сервером или веб-сервисом, частые опросы, например, раз в секунду, не рекомендуются.
- Для определения набора записей объектов, возвращаемых каждым опросом сервиса карт или объектов, используется простое выражение WHERE. По умолчанию, включаются все записи из набора записей объектов, например, WHERE 1=1. Выражение WHERE по умолчанию может быть изменено для включения определенных значений атрибутов и логических условий.
- Этот входной коннектор поддерживает пространственные фильтры, которые используют указанную геометрию и пространственные отношения, например, пересечение полигонов.
- Этот входной коннектор поддерживает опционное удаление запрошенных записей из слоя сервиса карт/объектов.
- Этот входной коннектор поддерживает уникальную возможность получения накопительных обновлений для опроса новых добавленных или обновленных записей объектов с использованием значений ObjectID или Timestamp.
- Для настройки накопительного опроса можно выбрать одну из четырех опций. Вы можете использовать идентификатор объекта записи объекта, метку времени с момента последнего получения, метку времени в интервале между последним запросом и настоящим моментом или метку времени, которая перекрывается с текущей датой и временем системы.
- Дополнительную информацию об опросе накопительных обновлений см. в следующих ресурсах Сообщества Esri:
- Опрос ArcGIS Server на наличие объектов: методы, используемые для идентификации накопительных обновлений.
- Опрос сервисов объектов для "Накопительных обновлений"
- Вопрос относительно обходных путей для "Накопительных обновлений", пользовательские компоненты
- Использование частичного определения GeoEvent для обновления записей объектов
Параметры
Ниже приведены параметры для входного коннектора Опрос ArcGIS Server на наличие объектов:
| Параметр | Описание |
|---|---|
Имя | Описательное имя входного коннектора, используемое для ссылки в GeoEvent Manager. |
Зарегистрированное подключение к серверу | Подключение ArcGIS Server, ArcGIS Enterprise или ArcGIS Online, зарегистрированное на ArcGIS GeoEvent Server как хранилище данных. Зарегистрированные подключения к серверу кэшируют информацию о сервисах карт/объектов, их слоях и свойствах слоев. |
Ссылка на Тип слоя | Определяет опции для ссылки на слой.
|
Папка (Условия) | Папка сервисов 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 задано значение Нет, и скрыто, если задано значение Да. |
Интервал обновления | Период (в секундах), в течение которого векторный слой карты/сервиса объектов будет опрошен для записей объектов. Значение по умолчанию – 10 (один запрос сбора данных будет выполнен каждые 10 секунд). |
Получить накопительные обновления | Задает запрос только новых или обновленных записей объектов, используя кэшированное значение ObjectID или Timestamp. По умолчанию Нет.
|
Метод идентификации накопительных обновлений (Условия) | Указывает, как GeoEvent Server будет идентифицировать недавно добавленные или недавно обновленные записи объектов при опросе накопительных обновлений. Доступные опции включают следующее:
Параметр показывается, когда для свойства Получить накопительные обновления задано значение Да, и скрыто, если для свойства Получить накопительные обновления задано значение Нет. |
Продолжительность наложения временных меток в секундах (Условия) | Количество секунд, которое нужно вычесть из нижней границы построенного временного запроса. Используется для искусственного расширения временного диапазона при запросе значений между временем последнего запроса и текущим моментом. Параметр отображается, когда для Метода идентификации накопительных обновлений установлено значение Интервал временной отметки между временем последнего запроса с наложением до настоящего момента. |
Поле времени для идентификации накопительных обновлений (Условия) | Поле атрибута, значение которого будет использоваться при построении временных запросов. Также используется при определении того, находится ли временная отметка записи объекта между нижней и верхней границей построенного временного запроса. Можно выбрать только те атрибуты, тип данных которых соответствует Date. Параметр отображается, когда для Метода идентификации накопительных обновлений задано значение, отличное от ObjectID. |
Определение запроса | Задает логическое выражение, используемое для ограничения записей объектов, возвращаемых при опросе векторного слоя карты/сервиса объектов. Выражение используется в качестве предиката в предложении Where языка структурированных запросов (SQL). Примеры:
|
Использовать фильтр геометрии | Указывает, следует ли использовать объект геометрии в качестве пространственного фильтра для ограничения записей объектов, возвращаемых при опросе векторного слоя карты/сервиса объектов. Фильтр геометрии, если он указан, будет объединен с указанным определением запроса для дальнейшего ограничения записей объектов, возвращаемых из запроса векторного слоя. Дополнительные сведения см. в разделе Объекты Geometry.
|
Фильтр геометрии (Условия) | Объект геометрии, выраженный с помощью функции JSON, используется в качестве пространственного фильтра. Для дополнительной информации о правильном синтаксисе объектов геометрии см. раздел Объекты геометрии. Параметр показывается, когда для свойства Использовать фильтр геометрии задано Да. |
Тип геометрии (Условия) | Задает тип геометрии, описываемый объектом JSON для фильтра геометрии. Поддерживаются типы геометрии: конверт, точка, полилиния, полигон и мультиточка. Параметр показывается, когда для свойства Использовать фильтр геометрии задано Да. |
Пространственная привязка (Условия) | Указывает идентификатор ID (WKID) системы координат для геометрии. Параметр показывается, когда для свойства Использовать фильтр геометрии задано Да. |
Пространственное отношение (Условия) | Задает пространственное отношение, используемое при оценке записей объектов, извлеченных из векторного слоя карты/сервиса объектов, чтобы определить, удовлетворяют ли они условиям фильтра геометрии. Параметр показывается, когда для свойства Использовать фильтр геометрии задано Да. |
Удалить опрошенные объекты | Указывает, следует ли удалять записи объектов из набора записей, возвращаемых из сервиса объектов, из векторного слоя сервиса объектов. По умолчанию Нет. |
Советы и ограничения
Уникальная возможность входных данных опроса ArcGIS Server на наличие объектов опрашивать только вновь добавленные или недавно обновленные записи объектов может быть полезна, если вы не хотите принимать, адаптировать и обрабатывать записи объектов, которые были обработаны ранее, и не хотите удалять ранее обработанные записи объектов из источника данных. Однако возможность опроса накопительных обновлений не является устойчивой при перезапуске сервиса или перезагрузки сервера. Это связано с тем, что эта возможность основана на хранении в кэше памяти последнего идентификатора объекта или значения даты и времени для выполнения последовательного опроса новых или обновленных записей. Если какое-либо значение-заполнитель потеряно после перезапуска системы, входной коннектор будет опрашивать записи, которые уже были обработаны ранее. В некоторых случаях это может привести к появлению ложноположительных отчетов ваших сервисов GeoEvent.
Если ваше решение должно быть более устойчивым к перезапускам системы, рассмотрите возможность применения пометки записей обрабатываемых объектов репрезентативным значением поля. Это рекомендуется использовать вместо использования возможности опроса накопительных обновлений. Например, рассмотрите возможность добавления поля в схему вашего сервиса объектов с именем hasBeenProcessed или аналогичным. Попросите сервис объектов назначать значение по умолчанию 0 для новых записей. Когда входной коннектор опрашивает записи, замените 0 на 1, чтобы указать, что запись была обработана. Это можно сделать с помощью калькулятора полей в вашем сервисе GeoEvent. Одновременно настройте входной коннектор с помощью выражения WHERE определяющего запроса hasBeenProcessed < 1. Это гарантирует, что GeoEvent Server будет извлекать только новые записи, значение hasBeenProcessed которых равно 0, что означает новые. Если вы захотите повторно обработать запись объекта, убедитесь, что в рабочем процессе редактирования объекта атрибуту hasBeenProcessed снова с 1 возвращается значение 0, чтобы записи были включены в следующий опрос.
Дополнительную информацию об опросе накопительных обновлений см. в следующих ресурсах Сообщества Esri:
- Опрос ArcGIS Server на наличие объектов: методы, используемые для идентификации накопительных обновлений.
- Опрос сервисов объектов "Накопительных обновлений"
- Вопрос относительно обходных путей для "Накопительных обновлений", пользовательские компоненты
- Использование частичного определения GeoEvent для обновления записей объектов