Входной коннектор Получать текст из 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. |
Порт Server | Порт сервера, используемый при установке сокета UDP. Клиенты UDP должны иметь возможность обнаруживать и подключаться к этому порту. По умолчанию - это порт 5000, но можно использовать любой доступный порт сервера. |
Прикрепить исходный IP к сообщению | Указывает, должен ли будет транспорт добавлять IP-адрес компьютера, отправившего дейтаграмму UDP к дейтаграмме (сообщению). Если указанное значение параметра Символ префикса IP источника совпадает со значением Разделитель атрибутов, адаптер интерпретирует добавленные значение IP и порт как дополнительное строковое значение атрибута. Убедитесь, что Определение GeoEvent включает атрибутивное поле для добавления данных, присоединенных к каждой дейтаграмме.
|
Символ-префикс исходного IP (Условия) | Один буквенный символ, используемый транспортом для разделения IP-адреса и номера порта, добавляемых к каждой датаграмме UDP. Обычно используется тот же символ, что и разделитель атрибутов для значений основного атрибута сообщения, поэтому 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 для специального использования администратором организации в пределах одной локальной сети. Этот параметр показывается, когда для свойства Режим мультикаст задано значение Да, и скрыто, если задано значение Нет. |