Входной коннектор Получать текст из UDP-сокета можно использовать для получения данных событий в формате текста с разделителями, который был получен через подключение к UDP-сокету. Разделителем атрибутивных значений часто является запятая (,), поэтому этот тип данных иногда называется значениями, разделенными запятыми ArcGIS GeoEvent Server может использовать любой печатаемый символ ASCII в качестве разделителя для разделения значений атрибутов данных.
Примечания по использованию
При использовании входного коннектора Получать текст из UDP-сокета имейте в виду следующее:
- Этот входной оператор подключения соединяет в пару Входящий адаптер Текст с Входящим транспортом UDP.
- Используйте этот оператор подключения для получения текста с разделителями из любого клиента UDP, который может видеть ваш сервер и подключаться к указанному UDP-сокету.
- По умолчанию оператор открывает UDP-сокет на порте 5000, но может использоваться любой доступный порт сервера.
- Можно настроить несколько потоков получения текста из входных операторов UDP-сокета, но для каждого понадобится отдельный порт.
- Несколько клиентских приложений UDP могут одновременно подключаться и отправлять данные на один входной оператор.
- Параметр Разделитель сообщений является обязательным. Этот единичный символ определяет конец записи о событии. Перенос строки (\n) является обычным разделителем записей.
- Параметр Разделитель атрибутов является обязательным. Этот единичный символ отделяет одно атрибутивное значение от другого. Запятая (,) является обычным разделителем атрибутов.
- UDP-дейтаграммы обычно являются компактными сообщениями, и клиентские приложения могут не включать разделитель между сообщениями. Параметр Символы для добавления к каждому сообщению позволяет добавлять неявный разделитель сообщений к каждому полученному сообщению.
- Если для параметра Прикрепить исходный IP к сообщению установлено значение Да, то IP-адрес и порт клиентского приложения будут присоединены к дейтаграмме (сообщению). Если символ, указанный в параметре Символ префикса IP источника, совпадает с символом, указанным в параметре Разделитель атрибутов, то коннектор будет интерпретировать присоединенные IP и порт как строковые атрибутивные значения. Убедитесь, что Определение GeoEvent включает атрибутивное поле для добавления данных, присоединенных к каждой дейтаграмме.
- Первый атрибут полученной строки данных с разделителями может использоваться для указания имени Определения GeoEvent. Это полезно, когда ожидается получение дейтаграмм с различными типами данных атрибутов или количеством атрибутов данных; сами данные могут помочь понять, какое Определение GeoEvent следует использовать коннектору для интерпретации полученных значений данных. Для включения этой функциональности используйте Определение GeoEvent Входящие данные содержат. Как правило, все записи данных, полученные на данном сокете, будут иметь одну и ту же схему, поэтому для этого параметра должно быть установлено значение Нет (по умолчанию).
Параметры
Ниже приведены параметры для входного коннектора Получать текст из UDP-сокета:
| Параметр | Описание |
|---|---|
| Имя | Описательное имя входного коннектора, используемое для ссылки в GeoEvent Manager. |
Пространственная привязка по умолчанию | Известный идентификатор (WKID) пространственной привязки, используемый при построении геометрии из значений полей атрибутов, координаты которых не являются значениями широты и долготы для предполагаемой географической системы координат WGS84, или строки геометрии, не включающие пространственную привязку. Также может быть указано известное текстовое значение (WKT) или имя поля атрибута, содержащего WKID или WKT. |
Порт сервера | Порт сервера, используемый при установке сокета UDP. Клиенты UDP должны иметь возможность обнаруживать и подключаться к этому порту. По умолчанию - это порт 5000, но можно использовать любой доступный порт сервера. |
Прикрепить исходный IP к сообщению | Указывает, должен ли транспорт добавлять IP-адрес компьютера, отправившего дейтаграмму UDP к дейтаграмме (сообщению). Если указанный параметр Символ префикса IP источника совпадает с Разделителем атрибутов, адаптер интерпретирует добавленные значение IP и порт как дополнительное строковое значение атрибута. Убедитесь, что Определение GeoEvent включает атрибутивное поле для добавления данных, присоединенных к каждой дейтаграмме.
|
Символ-префикс исходного IP (Условия) | Один буквенный символ, используемый транспортом для разделения IP-адреса и номера порта, добавляемых к каждой датаграмме UDP. Обычно используется тот же символ, что и разделитель атрибутов для значений основного атрибута сообщения, поэтому IP-адрес и порт добавляются в качестве нового атрибута, однако значения IP-адреса и порта могут быть присоединены к конечному строковому значению с помощью другого разделителя. Параметр показывается, когда для параметра Прикрепить исходный IP к сообщению задано значение Да, и скрыто, когда для параметра Прикрепить исходный IP к определению сообщения задано значение Нет. |
Символы для прикрепления к каждому сообщению | Один буквенный символ, который транспорт добавит к каждой дейтаграмме UDP, прежде чем необработанный массив байтов сообщения будет отправлен адаптеру. UDP-дейтаграммы обычно являются компактными сообщениями; клиентские приложения могут не включать разделитель между сообщениями. Однако адаптеру требуется разделитель сообщений для указания конца записи данных события, поэтому если передающий UDP-клиент не включает разделитель сообщений, укажите его с помощью этого параметра. |
Размер буфера (байты) | Задает размер буфера, выделяемого транспортом для хранения необработанных байтов, полученных из передающего клиентского приложения UDP. Значение по умолчанию – 2048 байт. Буфер должен быть достаточно большим для размещения IP-заголовков, заголовков UDP, значений атрибутивных данных, строковых представлений геометрии, принимаемых в качестве данных, и любых данных, добавляемых к каждому полученному сообщению. |
Разделитель сообщений | Один буквенный символ, который указывает на конец записи данных событий. Значения Unicode могут применяться для указания разделителя символов. Этот символ не должен заключаться в кавычки. Перенос строки (\n) - это наиболее типичный разделитель конца записи. |
Разделитель атрибутов | Один буквенный символ, используемый для отделения одного значения атрибута от другого в сообщении. Значения Unicode могут применяться для указания разделителя символов. Этот символ не должен заключаться в кавычки. Обычно разделителем атрибутов является запятая. |
Входящие данные содержат определение GeoEvent | Указывает, следует ли использовать первое значение атрибута каждой строки текста с разделителями в качестве имени определения GeoEvent. Дополнительные сведения см. в примечаниях к использованию выше.
|
Создать определения неопознанных событий (Условия) | Указывает, следует ли создавать новое Определение GeoEvent, если определение с указанным именем не существует. Если текстовый файл с разделителями содержит записи событий от различных типов датчиков, для указания типа события используется первое значение атрибута, которое берется в качестве имени определения GeoEvent.
Параметр показывается, когда для Входящие данные содержат определение GeoEvent задано значение Да, и скрыто, если задано значение Нет. |
Создать определение GeoEvent (Условия) | Указывает, следует ли использовать новое или существующее Определение GeoEvent для данных входящих событий. Определение GeoEvent требуется GeoEvent Server, чтобы понимать поля атрибутов и типы данных входящих событий.
Параметр показывается, когда для Входящие данные содержат определение GeoEvent задано значение Нет, и скрыто, если задано значение Да. |
Имя определения GeoEvent (новое) (Условия) | Имя, которое присваивается для нового Определения GeoEvent. Если определение GeoEvent с указанным именем уже существует, будет использоваться существующее определение GeoEvent. Первая полученная запись данных будет использоваться для определения ожидаемой схемы последующих записей данных, на основе которой будет создано новое определение GeoEvent. Параметр показывается, когда для свойства Создать определение GeoEvent задано значение Да, и скрыто, если задано значение Нет. |
Имя определения GeoEvent (существующее) (Условия) | Имя существующего определения GeoEvent для использования при адаптации полученных данных для создания данных событий для обработки сервисом GeoEvent. Параметр показывается, когда для свойства Создать определение GeoEvent задано значение Нет, и скрыто, если задано значение Да. |
Построить геометрию из полей | Указывает, должен ли входной коннектор создавать геометрию точки, используя значения координат, полученные в качестве атрибутов. По умолчанию Нет.
|
Поле геометрии X (Условия) | Поле атрибута в данных входящего события, содержащее координатную часть X (например, горизонталь или долготу) местоположения точки. Параметр показывается, когда для Построить геометрию из полей задано значение Да, и скрыто, если задано значение Нет. |
Поле геометрии Y (Условия) | Поле атрибута в данных входящего события, содержащее координатную часть Y (например, вертикаль или широту) местоположения точки. Параметр показывается, когда для Построить геометрию из полей задано значение Да, и скрыто, если задано значение Нет. |
Поле геометрии Z (Условия) | Имя поля в данных входящего события, содержащего координатную часть Z (например, глубина или высота) местоположения точки. Если оставить его пустым, значение Z будет опущено и будет построена 2D геометрия точки. Параметр показывается, когда для Построить геометрию из полей задано значение Да, и скрыто, если задано значение Нет. |
Ожидаемый формат данных | Шаблон, используемый для соответствия ожидаемым строковым представлениям значений даты/времени и преобразования их в значения даты Java. Формат шаблона следует нормам для класса Java SimpleDateFormat. GeoEvent Server предпочитает, чтобы значения даты/времени выражались в стандарте ISO 8601, но несколько строковых представлений значений даты/времени, обычно распознаваемых как значения даты, могут быть преобразованы в значения даты Java без указания шаблона Ожидаемого формата даты. К ним относятся:
Если полученные значения даты/времени выражены с помощью формата, отличного от одного из пяти, показанных выше, необходимо указать ожидаемый формат даты, чтобы GeoEvent Server знал, как следует адаптировать значения даты/времени. |
Язык форматирования чисел | Идентификатор локали (ID), используемый для чувствительного к локали поведения при форматировании чисел из значений данных. По умолчанию используется локаль компьютера, на котором установлен GeoEvent Server. Дополнительные сведения см. в разделе Поддерживаемые локали Java. |
Режим мультикаст | Указывает, должен ли входной коннектор присоединяться к группе мультикаст для получения сообщений, маршрутизируемых внутренней сетью группе предполагаемых получателей. По умолчанию Нет.
|
Группа мультикаст (Условия) | Укажите адрес группы, к которой присоединится входной коннектор в режиме мультикаст. Входной коннектор будет получать пакеты, отправленные на этот адрес группы. Диапазон IP-адресов 239.x.x.x зарезервирован RFC 2365 для специального использования администратором организации в пределах одной локальной сети. Параметр показывается, когда для свойства Режим мультикаст задано значение Да, и скрыто, если задано значение Нет. |