Входной оператор подключения Получить JSON на WebSocket можно использовать для получения и адаптации данных о событиях, представленных в формате общего JSON на WebSocket, обслуживаемой ArcGIS GeoEvent Server. С учетом стандартной конфигурации GeoEvent Server клиенты ожидают подписания и отправки данных на конечную точку в формате wss://<machine_name>.<domain>:6143/path, где path - это значение, описанное в пути URL входнго оператора подключения.
Этот входной оператор подключения запускается как сервер, чтобы позволить клиентским приложениям подписывать и отправлять данные на GeoEvent Server. Если вы ищете входной оператор подключения, который запускается, как клиент и подписывается на получение данных, передаваемых с WebSocket сервера, имейте в виду Подписаться на внешний WebSocket для JSON.
Примечания по использованию
- Используйте этот входной оператор подключения, чтобы получать данные в формате общего JSON через WebSocket, обслуживаемый GeoEvent Server.
- Этот входной оператор подключения соединяет в пару входящий адаптер Generic JSON с Входящим транспортом WebSocket.
- Этот входной оператор подключения запускается как сервер и предоставляет WebSocket , чтобы позволить клиентским приложениям подписывать и отправлять данные на GeoEvent Server.
- Адаптер интерпретирует общий JSON, отличный от объекта JSON или GeoJSON. Имейте в виду, что GeoJSON и объект JSON являются разновидностями общего JSON; для обработки этих специальных форматов используются другие адаптеры GeoEvent Server.
- Дополнительную информацию о структурах JSON см. в блоге GeoNet JSON Data Structures - Working with Hierarchy and Multicardinality.
- Типичные данные о событиях, организованные как массив JSON, показаны выше.
- Адаптер обработает обе одиночные записи JSON, организованные в массив.
- Запись общего JSON не обязательно должна содержать данные, представляющие геометрию.
- Адаптер поддерживает возможность построения точечной геометрии на основе атрибутивных значений X, Y и Z.
- Этим оператором подключения поддерживаются и протокол WebSocket (ws), и WebSocket Secure (wss).
- Клиенты, отправляющие данные на конечную точку WebSocket, должны использовать ws://<machine_name>.<domain>:6180/path.
- Этот входной оператор подключения включает Режим обучения, который может быть полезен, если вам нужно разрешить входному оператору подключения изменить определение GeoEvent, которое он построил. Цель этого свойства состоит в том, чтобы временно принять те полученные данные о событиях, у которых переменная схема или структура данных. Входной оператор подключения будет использовать пример записей полученных данных для получения более подробной информации о структуре переменных данных и присоединения новых, ранее неизученных атрибутивных полей к существующему определению GeoEvent.
Возможность изменить определение GeoEvent на лету может негативно поменять на дизайн аналитики в режиме реального времени в GeoEvent Service. Настоятельно рекомендуется в случаях, когда ожидаются изменения в схеме в ваших входных данных о событиях, использовать Режим обучения на короткий период, чтобы создать определение GeoEvent, которое поддерживает все ожидаемые варианты ваших входных данных. Режим обучения можно будет затем отключить, а автоматически созданное определение GeoEvent будет скопировано и адаптировано для производственного развертывания.
Параметры
| Параметр | Описание |
|---|---|
Имя | Описательное имя входного коннектора, используемое для справки в GeoEvent Manager. |
URL-путь | Полная конечная точка URL включает протокол, имя хоста или IP-адрес, порт и путь. Для этого коннектора ожидается, что будет указан только путь URL-адреса. Значение по умолчанию – /ws. Полный URL, который клиенты будут использовать для подписки, будет выглядеть следующим образом ws://<machine_name>.<domain>:6180/path или wss://<machine_name>.<domain>:6143/path Например, если URL-путь указан как /Sample Records, клиенты, отправляющие данные в безопасный URL WebSocket, будут использовать wss://PS000123.esri.com:6143/SampleRecords (для машины с именем PS000123 на домен esri.com ). |
Создать определение GeoEvent | Указывает, следует ли использовать новое или существующее Определение GeoEvent для данных входящих событий. Определение GeoEvent требуется для GeoEvent Server для понимания полей атрибутов и типов данных входящих событий.
|
Имя определения GeoEvent (новое) (Условия) | Имя, которое присваивается для нового Определения GeoEvent. Если определение GeoEvent с указанным именем уже существует, будет использоваться существующее определение GeoEvent. Первая полученная запись данных будет использоваться для определения ожидаемой схемы последующих записей данных, на основе которой будет создано новое определение GeoEvent. Это свойство показывается, когда для свойства Создать определение GeoEvent задано значение Да, и скрыто, если выбрано значение Нет |
Имя определения GeoEvent (существующее) (Условия) | Имя существующего определения GeoEvent для использования при адаптации полученных данных для создания данных событий для обработки сервисом GeoEvent. Это свойство показывается, когда для свойства Создать определение GeoEvent задано значение Нет, и скрыто, если выбрано значение Да |
Пространственная привязка по умолчанию | Известный идентификатор (WKID) пространственной привязки, используемый при построении геометрии из значений полей атрибутов, координаты которых не являются значениями широты и долготы для предполагаемой географической системы координат WGS84, или строки геометрии, не включающие пространственную привязку. Также может быть указано известное текстовое значение (WKT) или имя поля атрибута, содержащего WKID или WKT. |
Имя объекта JSON | Имя элемента JSON, который может использоваться в качестве корневого узла подструктуры в пределах полученных данных JSON. Когда Имя объекта JSON используется для указания элемента JSON по имени, адаптер будет искать подструктуры, имя объекта которых соответствует указанному имени элемента. Будут рассмотрены только данные в пределах идентифицированной подструктуры. Если оставить пустым, что является значением по умолчанию, верхний объект JSON используется в качестве корня всей структуры JSON. |
Ожидаемый формат данных | Шаблон, используемый для соответствия ожидаемым строковым представлениям значений даты / времени и преобразования их в значения даты Java. Формат шаблона следует нормам для класса Java SimpleDateFormat. У этого свойства нет значения по умолчанию. GeoEvent Server предпочитает, чтобы значения даты/времени выражались в стандарте ISO 8601, но несколько строковых представлений значений даты/времени, обычно распознаваемых как значения даты, могут быть преобразованы в значения даты Java без указания Ожидаемого формата даты. В том числе:
Если полученные значения даты/времени выражены с помощью формата, отличного от одного из пяти, показанных выше, необходимо указать Ожидаемый формат даты, чтобы GeoEvent Server знал, как следует адаптировать значения даты/времени. |
Построить геометрию из полей | Указывает, должен ли входной коннектор создавать геометрию точки, используя значения координат, полученные в качестве атрибутов. По умолчанию Нет.
|
Поле геометрии X (Условия) | Поле атрибута в данных входящего события, содержащее координатную часть X (например, горизонталь или долготу) местоположения точки. Это свойство показывается, когда для Построить геометрию из полей задано значение Да, и скрыто, если выбрано значение Нет |
Поле геометрии Y (Условия) | Поле атрибута в данных входящего события, содержащее координатную часть Y (например, вертикаль или широту) местоположения точки. Это свойство показывается, когда для Построить геометрию из полей задано значение Да, и скрыто, если выбрано значение Нет |
Поле геометрии Z (Условия) | Имя поля в данных входящего события, содержащего координатную часть Z (например, глубина или высота) местоположения точки. Если оставить пустым, значение Z будет опущено и будет построена 2D геометрия точки. Это свойство показывается, когда для Построить геометрию из полей задано значение Да, и скрыто, если выбрано значение Нет |
Режим Обучение | Указывает, активен или отключен Режим обучения. Если для режима обучения установлено значение Да, входящий адаптер добавит новые поля к определению GeoEvent, которое он создал и поддерживает.
Режим обучения может быть полезен, если необходимо разрешить входному коннектору изменять построенное им определение GeoEvent. Цель этого свойства состоит в том, чтобы временно принять те полученные данные о событиях, у которых переменная схема или структура данных. Входной коннектор будет использовать образец полученных записей данных, чтобы узнать больше о переменной структуре данных и добавить новые, ранее ненаблюдаемые поля атрибутов к существующему определению GeoEvent. |