Входной коннектор Получать JSON на конечной точке REST можно использовать для получения и адаптации данных событий, представленных в формате стандартного JSON, на конечной точке REST, обслуживаемой ArcGIS GeoEvent Server. При стандартной конфигурации GeoEvent Server для поставщиков данных ожидаемым вариантом будет отправка данных через HTTP/POST на конечную точку в формате https://<machine_name>.<domain>:6143/geoevent/rest/receiver/name, где name — это имя настроенного входного коннектора.
Примечания по использованию
При использовании входного коннектора Получать JSON на конечной точке REST имейте в виду следующее:
- Используйте этот входной коннектор для получения данных, отформатированных как стандартный JSON, отправляйте с помощью HTTP/POST на конечную точку REST, обслуживаемую GeoEvent Server.
- Этот входной коннектор соединяет в пару Входящий адаптер Generic JSON с Входящим транспортом HTTP.
- Типичный блок общего JSON показан выше. В этом примере три записи о событиях организованы в массив.
- Адаптер будет обрабатывать каждый объект в массиве как отдельную запись события.
- GeoJSON и объект JSON являются разновидностями стандартного JSON; для обработки этих специальных форматов используются разные адаптеры GeoEvent Server.
- Дополнительную информацию о структурах JSON см. в блоге Esri Community JSON Data Structures - Working with Hierarchy and Multicardinality.
- Настройка и сохранение нового оператора Получать JSON на конечной точке REST создает конечную точку REST, которая обслуживается GeoEvent Server.
- Можно восстановить полный путь к конечной точке REST, обслуживаемой GeoEvent Server, изменив входные данные после сохранения.
- Можно настроить GeoEvent Server на использование другого базового URL для приемника REST или подключения через порт, отличный от 6143.
- Поставщик данных должен включить в заголовок HTTP/POST тип MIME, связанный с отправляемыми данными.
- Настроенные входные параметры должны описывать, какие типы MIME будет принимать транспорт.
- Этот входной коннектор ожидает тип MIME application/json, который является типом MIME по умолчанию для обмена JSON между клиентом и сервером.
- Адаптер поддерживает возможность построения точечной геометрии из атрибутивных значений x, y и z
- Транспорт будет принимать и запросы HTTP/GET, и HTTP/POST. Поставщик данных обычно создает запрос HTTP/POST на отправку данных о событии на GeoEvent Server c JSON в теле запроса без параметров запроса. Этот входной оператор подключения, однако, может извлечь данные о событиях в формате общего JSON, если данные включены в один или несколько параметров запроса в URL запроса HTTP/GET. Используйте параметр Получить запрос, содержащий сырые данные, чтобы использовать эту возможность. Более подробную информацию см. в блоге Esri Community Enhancements to the GeoEvent Server HTTP Inbound Transport.
- Этот входной коннектор включает параметр Режим обучения, который может быть полезен, если необходимо разрешить входному коннектору изменять построенное им определение GeoEvent. Цель этого параметра состоит в том, чтобы временно принять те полученные данные о событиях, у которых переменная схема или структура данных. Входной коннектор будет использовать образец полученных записей данных, чтобы узнать больше о переменной структуре данных и добавить новые, ранее не наблюдаемые поля атрибутов к существующему определению GeoEvent.
Возможность изменения определения GeoEvent "на лету" может отрицательно повлиять на проект анализа в режиме реального времени в сервисе GeoEvent. Если во входных данных событий ожидается изменение схемы, рекомендуется использовать режим обучения максимально непродолжительное время, чтобы создать определение GeoEvent Definition, которое поддерживает все ожидаемые варианты входных данных. Затем режим обучения можно отключить, а автоматически созданное определение GeoEvent скопировать и адаптировать для производственного развертывания.
Параметры
Ниже приведены параметры для входного коннектора Получать JSON на конечной точке REST:
| Параметр | Описание |
|---|---|
Имя | Описательное имя входного коннектора, используемое для ссылки в GeoEvent Manager. |
Пространственная привязка по умолчанию | Известный идентификатор (WKID) пространственной привязки, используемый при построении геометрии из значений полей атрибутов, координаты которых не являются значениями широты и долготы для предполагаемой географической системы координат WGS84, или когда получены строки геометрии, не содержащие пространственной привязки. Также может быть указано известное текстовое значение (WKT) или имя поля атрибута, содержащего WKID или WKT. |
Имя объекта JSON | Имя элемента JSON, который может использоваться в качестве корневого узла подструктуры в пределах полученных данных JSON. Когда Имя объекта JSON используется для указания элемента JSON по имени, адаптер ищет подструктуры, имя объекта которых соответствует указанному имени элемента. Рассматриваются только данные в пределах идентифицированной подструктуры. Если оставить пустым, что является значением по умолчанию, верхний объект JSON используется в качестве корня всей структуры JSON. |
Создать определение GeoEvent | Указывает, используется ли новое или существующее определение GeoEvent для данных входящих событий. Определение GeoEvent требуется GeoEvent Server, чтобы понимать поля атрибутов и типы данных входящих событий.
|
Имя определения GeoEvent (новое) (Условия) | Имя, которое присваивается для нового Определения GeoEvent. Если определение GeoEvent с указанным именем уже существует, используется существующее определение GeoEvent. Первая полученная запись данных используется для определения ожидаемой схемы последующих записей данных, на основе которой создается новое определение GeoEvent. Этот параметр показывается, когда для свойства Создать определение GeoEvent задано значение Да, и скрыто, если задано значение Нет. |
Имя определения GeoEvent (существующее) (Условия) | Имя существующего определения GeoEvent для использования при адаптации полученных данных для создания данных событий для обработки сервисом GeoEvent. Этот параметр показывается, когда для свойства Создать определение GeoEvent задано значение Нет, и скрыто, если задано значение Да. |
Пространственная привязка по умолчанию | Известный идентификатор (WKID) пространственной привязки, используемый при построении геометрии из значений полей атрибутов, координаты которых не являются значениями широты и долготы для предполагаемой географической системы координат WGS84, или когда получены строки геометрии, не содержащие пространственной привязки. Также может быть указано известное текстовое значение (WKT) или имя поля атрибута, содержащего WKID или WKT. |
Допустимые типы MIME (режим Server) | Определяет типы MIME, которые принимает входной коннектор. Используйте запятые для разделения значений, например text/plain,application/xml,text/xml. Типы MIME обычно состоят из структуры типа и подтипа и используются, когда сервер должен указать типы интернет-медиа данных, которые он получает от клиентов. По умолчанию используется application/json, который является официальным типом MIME для обмена JSON между клиентом и сервером. Подробнее об официальных типах MIME см. Internet Assigned Numbers Authority (IANA). Подробнее о типах MIME, которые не используются ArcGIS Server, см. Типы MIME, не используемые ArcGIS Server. |
Ожидаемый формат данных | Шаблон, используемый для соответствия ожидаемым строковым представлениям значений даты/времени и преобразования их в значения даты Java. Формат шаблона следует нормам для класса Java SimpleDateFormat. Хотя предпочтительным шаблоном для значений даты/времени в GeoEvent Server является стандарт ISO 8601, несколько строковых представлений значений даты/времени, обычно распознаваемых как значения даты, могут быть преобразованы в значения даты Java без указания значения Ожидаемого формата даты. К ним относятся:
Если полученные значения даты/времени используют соглашение, отличное от перечисленных выше, необходимо указать ожидаемый шаблон формата даты, чтобы GeoEvent Server мог адаптировать значения даты/времени. |
Построить геометрию из полей | Указывает, будет ли входной коннектор создавать геометрию точки, используя значения координат, полученные в качестве атрибутов. По умолчанию Нет.
|
Поле геометрии X (Условия) | Поле атрибута в данных входящего события, содержащее координатную часть X (например, горизонталь или долготу) местоположения точки. Этот параметр показывается, когда для Построить геометрию из полей задано значение Да, и скрыто, если задано значение Нет. |
Поле геометрии Y (Условия) | Поле атрибута в данных входящего события, содержащее координатную часть Y (например, вертикаль или широту) местоположения точки. Этот параметр показывается, когда для Построить геометрию из полей задано значение Да, и скрыто, если задано значение Нет. |
Поле геометрии Z (Условия) | Поле атрибута в данных входящего события, содержащего координатную часть Z (например, глубина или высота) местоположения точки. Если значение не предоставлено, значение z опускается и строится 2D геометрия точки. Этот параметр показывается, когда для Построить геометрию из полей задано значение Да, и скрыто, если задано значение Нет. |
Режим Обучение | Указывает активен или недоступен Режим обучения. Если для Режим обучения задано значение Да, входящий адаптер добавляет новые поля к определению GeoEvent, которое он создал и поддерживает.
Режим обучения может быть полезен, если необходимо разрешить входному коннектору изменять построенное им определение GeoEvent. Цель этого параметра состоит в том, чтобы временно принять те полученные данные событий, у которых переменная схема или структура данных. Входной коннектор использует образец полученных записей данных, чтобы определить дополнительную информацию о переменной структуре данных и добавить новые, ранее не наблюдаемые поля атрибутов к существующему определению GeoEvent. Возможность изменить определение GeoEvent на лету может негативно повлиять на дизайн аналитики в режиме реального времени в сервисе GeoEvent. Если во входных данных события ожидается изменение схемы, рекомендуется, по возможности, использовать Режим обучения непродолжительное время, чтобы создать определение GeoEvent, которое поддерживает все ожидаемые варианты входящих данных. Затем Режим обучения можно отключить, а автоматически созданное определение GeoEvent скопировать и адаптировать для производственного развертывания. |
Запрос Get содержит сырые данные | Указывает, как коннектор обрабатывает данные, включенные в полученные HTTP-запросы. Необработанные данные могут быть отправлены как значение одного параметра запроса с помощью запроса HTTP/GET, если Имя параметра сырых данных указывает имя параметра запроса. В противном случае запрос HTTP/GET должен содержать несколько параметров запроса, имена которых соответствуют полям атрибутов, указанным в определении GeoEvent, для использования которого настроен коннектор. Этот коннектор использует Универсальный входящий адаптер JSON, следовательно, при использовании формы одного параметра запроса его значение должно быть отформатировано как универсальный JSON. Убедитесь, что тело содержимого запроса пустое при использовании запросов HTTP/GET для отправки данных. Данные обычно отправляются с помощью запроса HTTP/POST без каких-либо параметров запроса. Ожидается, что полезные данные запроса будут отформатированы как общий JSON с данными события, включенными в тело содержимого запроса. Любые данные, включенные в параметры запроса, игнорируются при использовании HTTP/POST для отправки данных событий на GeoEvent Server.
|
Имя параметра для сырых данных (Условия) | Имя параметра запроса, чьи значения являются сырыми данными для внутренних запросов HTTP/GET. Отформатируйте значение параметра запроса как однострочный универсальный JSON. Этот параметр показывается, когда для Запрос Get содержит сырые данные задано значение Да, и скрыто, если задано значение Нет. |