Skip To Content

Получать XML на конечной точке REST

Входной коннектор Получить XML на конечной точке REST можно использовать для получения и адаптации данных событий, представленных в формате XML, на конечной точке REST, обслуживаемой ArcGIS GeoEvent Server. При стандартной конфигурации GeoEvent Server для поставщиков данных ожидаемым вариантом будет отправка данных через HTTP/POST на конечную точку в формате https://<machine_name>.<domain>:6143/geoevent/rest/receiver/name, где name - это имя настроенного входного коннектора.

Структура данных XML с записями о событиях, организованными с использованием иерархии тегов, элементов и атрибутивных значений XML

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

  • Используйте этот входной коннектор для получения данных, отформатированных как стандартный XML, отправляйте с помощью HTTP/POST на конечную точку REST, обслуживаемую GeoEvent Server.
  • Этот входной оператор подключения соединяет в пару Входящий адаптер объект XML с Входящим транспортом HTTP.
  • Типовая структура данных XML с записями о событиях, организованными с использованием иерархии тегов, элементов и атрибутивных значений XML, показана выше.
  • Свойство Имя объекта XML используется для идентификации имени элемента группы в структуре документа XML.
  • Записи данных, организованные под указанным элементом группы, будут обрабатываться как отдельные записи событий, если указано имя элемента группировки.
  • Если параметр Имя объекта XML не задан, то учитывается все структура данных в корневом элементе документа XML; схема записей о событиях (т.е. Определение GeoEvent) будет отражать структуру документа XML полностью. Дополнительную информацию о структурах XML см. в блоге Esri Community XML Data Structures - Characteristics and Limitations.
  • Настройка и сохранение новых входных параметров создает конечную точку REST, которая обслуживается GeoEvent Server.
  • Вы можете восстановить полный путь к конечной точке REST, обслуживаемой GeoEvent Server, изменив входные данные после сохранения.
  • GeoEvent Server можно настроить на использование другого базового URL для приемника REST и/или подключения через порт, отличный от 6143.
  • Поставщик данных должен включить в заголовок HTTP/POST тип MIME, связанный с отправляемыми данными.
  • Настроенные входные параметры должны описывать, какие типы MIME будет принимать транспорт.
  • Этот оператор подключения ожидает тип MIME application/xml или text/xml, который является типом MIME по умолчанию для обмена XML между клиентом и сервером.
  • Адаптер поддерживает возможность построения точечной геометрии из атрибутивных значений X, Y и Z.
  • Транспорт будет принимать и запросы HTTP/GET, и HTTP/POST. Поставщик данных обычно создает запрос HTTP/POST на отправку данных событий на GeoEvent Server с XML в теле запроса без параметров запроса. Этот входной оператор подключения, однако, может извлечь данные о событиях в формате XML, если данные включены в один или несколько параметров запроса в URL запроса HTTP/GET. Используйте свойство Имя параметра для исходных данных для этой возможности. Более подробную информацию см. в блоге Esri Community Enhancements to the GeoEvent Server HTTP Inbound Transport.
  • Этот входной коннектор включает Режим обучения, который может быть полезен, если необходимо разрешить входному коннектору изменять построенное им определение GeoEvent. Цель этого свойства состоит в том, чтобы временно принять те полученные данные о событиях, у которых переменная схема или структура данных. Входной коннектор будет использовать образец полученных записей данных, чтобы узнать больше о переменной структуре данных и добавить новые, ранее не наблюдаемые поля атрибутов к существующему определению GeoEvent.

    Возможность изменения определения GeoEvent "на лету" может отрицательно повлиять на проект анализа в режиме реального времени в сервисе GeoEvent. Если у входящих данных событий ожидается переменная схема, рекомендуется для создания определения GeoEvent, поддерживающего все ожидаемые варианты входящих данных, использовать режим обучения в течение как можно более короткого периода времени. Затем Режим обучения можно отключить, а автоматически созданное определение GeoEvent скопировать и адаптировать для производственного развертывания.

Параметры

ПараметрОписание

Имя

Описательное имя входного коннектора, используемое для ссылки в GeoEvent Manager.

Имя объекта XML

Имя элемента XML, используемого для идентификации отдельных записей данных в полученной структуре данных XML. Если Имя объекта XML используется для указания элемента XML по имени, адаптер будет искать узлы, соответствующие указанному имени, и будет рассматривать эти узлы только как записи данных. Если не указано, что является значением по умолчанию, учитываются все данные под верхним корневым элементом XML.

Создать определение GeoEvent

Указывает, следует ли использовать новое или существующее Определение GeoEvent для данных входящих событий. Определение GeoEvent требуется GeoEvent Server, чтобы понимать поля атрибутов и типы данных входящих событий.

  • Да – новое Определение GeoEvent будет создано на основе схемы первой полученной записи события.
  • Нет – новое Определение GeoEvent не будет создаваться. Выберите существующее Определение GeoEvent, соответствующее схеме данных входящего события.

Имя определения GeoEvent (новое)

(Условия)

Имя, которое присваивается для нового Определения GeoEvent. Если определение GeoEvent с указанным именем уже существует, будет использоваться существующее определение GeoEvent. Первая полученная запись данных будет использоваться для определения ожидаемой схемы последующих записей данных, на основе которой будет создано новое определение GeoEvent.

Этот параметр показывается, когда для свойства Создать определение GeoEvent задано значение Да, и скрыто, если выбрано значение Нет.

Имя определения GeoEvent (существующее)

(Условия)

Имя существующего определения GeoEvent для использования при адаптации полученных данных для создания данных событий для обработки сервисом GeoEvent.

Этот параметр показывается, когда для свойства Создать определение GeoEvent задано значение Нет, и скрыто, если выбрано значение Да.

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

Известный идентификатор (WKID) пространственной привязки, используемый при построении геометрии из значений полей атрибутов, координаты которых не являются значениями широты и долготы для предполагаемой географической системы координат WGS84, или строки геометрии, не включающие пространственную привязку. Также может быть указано известное текстовое значение (WKT) или имя поля атрибута, содержащего WKID или WKT.

Допустимые типы MIME (режим сервера)

Определяет типы MIME, которые будет принимать входной оператор подключения. Для разделения значений используйте запятые, например: text/plain,application/xml,text/xml. Типы MIME обычно состоят из структуры типа/подтипа и используются, когда серверу нужно указать тип(ы) интернет-медиа данных, которые он будет получать от клиента. По умолчанию это application/xml,text/xml, что является стандартом для обмена XML между клиентом и сервером.

Подробнее об официальных типах MIME см. Internet Assigned Numbers Authority (IANA). Подробнее о типах MIME, которые не используются ArcGIS Server, см. Типы MIME, не используемые ArcGIS Server.

Построить геометрию из полей

Указывает, должен ли входной коннектор создавать геометрию точки, используя значения координат, полученные в качестве атрибутов. По умолчанию Нет.

  • Да – значения из указанных полей атрибутов событий будут использоваться для построения геометрии точек.
  • Нет – геометрия точек не будет строиться. Предполагается, что поле атрибута содержит значение, которое может быть интерпретировано как геометрия или запись события является непространственной (не имеет геометрии).

Поле геометрии X

(Условия)

Поле атрибута в данных входящего события, содержащее координатную часть X (например, горизонталь или долготу) местоположения точки.

Этот параметр показывается, когда для Построить геометрию из полей задано значение Да, и скрыто, если выбрано значение Нет.

Поле геометрии Y

(Условия)

Поле атрибута в данных входящего события, содержащее координатную часть Y (например, вертикаль или широту) местоположения точки.

Этот параметр показывается, когда для Построить геометрию из полей задано значение Да, и скрыто, если выбрано значение Нет.

Поле геометрии Z

(Условия)

Имя поля в данных входящего события, содержащего координатную часть Z (например, глубина или высота) местоположения точки. Если оставить пустым, значение Z будет опущено и будет построена 2D геометрия точки.

Этот параметр показывается, когда для Построить геометрию из полей задано значение Да, и скрыто, если выбрано значение Нет.

Ожидаемый формат данных

Шаблон, используемый для соответствия ожидаемым строковым представлениям значений даты / времени и преобразования их в значения даты Java. Формат шаблона следует нормам для класса Java SimpleDateFormat. У этого параметра нет значения по умолчанию.

GeoEvent Server предпочитает, чтобы значения даты/времени выражались в стандарте ISO 8601, но несколько строковых представлений значений даты/времени, обычно распознаваемых как значения даты, могут быть преобразованы в значения даты Java без указания Ожидаемого формата даты. В том числе:

  • "2019-12-31T23:59:59" – формат стандарта ISO 8601
  • 1577836799000 – дата Java (epoch long integer; UTC)
  • "Tue Dec 31 23:59:59 -0000 2019" – общий строковый формат веб-сервисов
  • "12/31/2019 11:59:59 PM" – общий формат, используемый в США (12 часов)
  • "12/31/2019 23:59:59" – общий формат, используемый в США (24 часа)

Если полученные значения даты/времени выражены с помощью формата, отличного от одного из пяти, показанных выше, необходимо указать Ожидаемый формат даты, чтобы GeoEvent Server знал, как следует адаптировать значения даты/времени.

Режим Обучение

Указывает, активен или отключен Режим обучения. Если для режима обучения установлено значение Да, входящий адаптер добавит новые поля к определению GeoEvent, которое он создал и поддерживает.

  • Да – режим обучения будет включен. Определение GeoEvent будет обновлено новыми полями из записей событий, использующих разные схемы.
  • Нет – режим обучения не будет включен. Определение GeoEvent не будет изменено.

Режим обучения может быть полезен, если необходимо разрешить входному коннектору изменять построенное им определение GeoEvent. Цель этого параметра состоит в том, чтобы временно принять те полученные данные о событиях, у которых переменная схема или структура данных. Входной коннектор будет использовать образец полученных записей данных, чтобы узнать больше о переменной структуре данных и добавить новые, ранее не наблюдаемые поля атрибутов к существующему определению GeoEvent.

Имя параметра для сырых данных

(Условия)

Имя параметра запроса, чьи значения являются сырыми данными для внутренних запросов HTTP/GET. Значение параметра запроса должно быть в формате единой текстовой строки, как обычный XML.

Когда клиентские приложения используют запросы HTTP/POST для отправки данных, это свойство должно остаться пустым. Тело содержания запроса HTTP/POST должно содержать отформатированные данные XML.