Входной коннектор Получать текст из TCP-сокета можно использовать для получения данных о событиях в формате текста с разделителями, который был получен через подключение к TCP-сокету. Разделителем атрибутивных значений часто является запятая (,), поэтому этот тип данных иногда называется значениями, разделенными запятыми ArcGIS GeoEvent Server может использовать любой печатаемый символ ASCII в качестве разделителя для разделения значений атрибутов данных.
Примечания по использованию
При использовании входного коннектора Получать текст из TCP-сокета имейте в виду следующее:
- Этот входной коннектор соединяет в пару Входящий адаптер Текст и Входящий транспорт TCP.
- Используйте этот коннектор для получения текста с разделителями из любого клиента TCP, который может видеть ваш сервер и подключаться к указанному TCP-сокету.
- Обычно этот оператор используется для получения симулированных записей о данных событий из GeoEvent Simulator.
- По умолчанию оператор открывает TCP-сокет на порте 5565, но может использоваться любой доступный порт сервера.
- Можно настроить несколько потоков получения текста из входных операторов TCP-сокета, но для каждого понадобится отдельный порт.
- Несколько клиентских приложений TCP могут одновременно подключаться и отправлять данные на один входной оператор.
- Параметр Разделитель сообщений является обязательным. Этот единичный символ определяет конец записи о событии. Новая линия (\n) - это наиболее типичный разделитель конца записи.
- Параметр Разделитель атрибутов является обязательным. Этот единичный символ отделяет одно атрибутивное значение от другого. Запятая (,) является обычным разделителем атрибутов.
- GeoEvent Simulator интерпретирует конец файла как неявный разделитель событий, когда файл симуляции загружается в память. Нет необходимости заканчивать файл симуляции пустой строкой, чтобы принудительно включить разделитель сообщений. Другие TCP-клиенты могут действовать по-другому.
- Первый атрибут полученной строки данных с разделителями может использоваться для указания имени Определение GeoEvent. Это полезно, когда ожидается получение дейтаграмм с различными типами данных атрибутов или количеством атрибутов данных; сами данные могут помочь понять, какое Определение GeoEvent следует использовать адаптеру для интерпретации полученных значений данных. Для включения этой функциональности используйте Определение GeoEvent Входящие данные содержат. Как правило, все записи данных, полученные на данном сокете, будут иметь одну и ту же схему, поэтому для этого параметра должно быть установлено значение Нет (по умолчанию).
Параметры
Ниже приведены параметры для входного коннектора Получать текст из TCP-сокета:
| Параметр | Описание |
|---|---|
| Имя | Описательное имя входного коннектора, используемое для ссылки в GeoEvent Manager. |
Пространственная привязка по умолчанию | Известный идентификатор (WKID) пространственной привязки, используемый при построении геометрии из значений полей атрибутов, координаты которых не являются значениями широты и долготы для предполагаемой географической системы координат WGS84, или строки геометрии, не включающие пространственную привязку. Также может быть указано известное текстовое значение (WKT) или имя поля атрибута, содержащего WKID или WKT. |
Порт сервера | Порт сервера, используемый при установке сокета TCP. Клиенты TCP должны иметь возможность обнаруживать и подключаться к этому порту. По умолчанию - это порт 5565, но можно использовать любой доступный порт сервера. |
Разделитель сообщений | Один буквенный символ, который указывает на конец записи данных событий. Значения Unicode могут применяться для указания разделителя символов. Этот символ не должен заключаться в кавычки. Перенос строки (\n) - это наиболее типичный разделитель конца записи. |
Разделитель атрибутов | Один буквенный символ, используемый для отделения одного значения атрибута от другого в сообщении. Значения Unicode могут применяться для указания разделителя символов. Этот символ не должен заключаться в кавычки. Обычно разделителем атрибутов является запятая. |
Ожидаемый формат данных | Шаблон, используемый для соответствия ожидаемым строковым представлениям значений даты/времени и преобразования их в значения даты Java. Формат шаблона следует нормам для класса Java SimpleDateFormat. GeoEvent Server предпочитает, чтобы значения даты/времени выражались в стандарте ISO 8601, но несколько строковых представлений значений даты/времени, обычно распознаваемых как значения даты, могут быть преобразованы в значения даты Java без указания шаблона Ожидаемого формата даты. К ним относятся:
Если полученные значения даты/времени выражены с помощью формата, отличного от одного из пяти, показанных выше, необходимо указать ожидаемый формат даты, чтобы GeoEvent Server знал, как следует адаптировать значения даты/времени. |
Входящие данные содержат определение 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 геометрия точки. Параметр показывается, когда для Построить геометрию из полей задано значение Да, и скрыто, если задано значение Нет. |
Язык форматирования чисел | Идентификатор локали (ID), используемый для чувствительного к локали поведения при форматировании чисел из значений данных. По умолчанию используется локаль компьютера, на котором установлен GeoEvent Server. Дополнительные сведения см. в разделе Поддерживаемые локали Java. |