Skip To Content

Процессор Калькулятор поля (Регулярное выражение)

Сводка

Процессор Калькулятор поля (Регулярное выражение) применяется, чтобы использовать возможности регулярных выражений для идентификации шаблона в пределах целевого поля и извлечения подстрок полученных событий. Извлеченные подстроки записываются либо обратно в целевое поле, заменяя его исходное значение, либо в новое поле. Данный процессор не поддерживает общие математические, лексические и логические выражения, поддерживаемые процессором Калькулятор поля.

Примеры

Значение поляRegEx (регулярное выражение)Результат

SWA2382

^SWA[0-9]+$

Знак (^) закрепляет шаблон к началу строки, а знак доллара ($) закрепляет шаблон в конце строки. Часть шаблона [0-9]+ указывает на то, что одна или более цифр от 0 до 9 должны быть найдены в конце строки.

Все значения в целевом поле, которые не начинаются с SWA, за которыми следует некоторое количество цифр, представляющих номер рейса, не будут извлекаться процессором как подстрока.

02/15/1973

[0-1][0-9][/][0-3][0-9][/][0-1][0-9][0-9][0-9]

Использование числовых диапазонов, например, от 0 до 1, от 0 до 3 и от 0 до 9 задает ожидаемые значения для mm/dd/yy строки с датой. Значения, которые не имеют два числа месяца, за которыми следуют две цифры дня и четыре цифры года, разделенные косой чертой (/), не будут извлекаться процессором как подстрока.

3.14159

^[-+]?[0-9]*\.?[0-9]+$

Этот шаблон проверяет, не представлена ли строка в целевом поле как числовое значение. Звездочка (*) в RegEx соответствует нулю или более экземпляров предыдущего символа; вопросительный знак (?) соответствует нулю или одному экземпляру. Обратная косая черта (\) означает, что точка (.) является буквенной десятичной точкой, а не подстановочным знаком (*). Этот шаблон делает знак плюс (+) или минус (-) целой частью значения с плавающей точкой, а буквенное десятичное число становится необязательным (может встречаться ноль раз).

Альфа

^.{0,5}

Знак карата (^) привязывает шаблон к началу строки, а точка (.) – это подстановочный знак, соответствующий любому символу. {0,5} означает, что в качестве совпадающего шаблона будет возвращена подстрока с минимальной длиной 0 и максимальной длиной 5.

Этот шаблон регулярного выражения можно использовать для возврата фиксированного количества символов в поддержку нового поля, имеющего предельный порог символов. Применение шаблона регулярного выражения к полю, значение которого равно AlphaBeta, вернет только подстроку Alpha. Alpha – это первые 5 символов строки AlphaBeta.

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

  • В отличие от процессора Калькулятор поля, который выполняет математические или лексические вычисления с использованием различных выражений, процессор Калькулятор поля (регулярное выражение) только идентифицирует и извлекает подстроки целевого поля, применяя шаблоны регулярных выражений.
  • При указании целевого поля для вычисляемого шаблона регулярного выражения требуется синтаксис ${…}, где ... – это имя поля, заключенного в ${}. А процессор Калькулятора полей ожидает, что поля будут определены только с помощью имени.
  • Процессор может быть сконфигурирован для хранения выходной подстроки в существующем поле или новом поле с помощью параметра Целевое поле. Изменение схемы записи события, когда добавляется новое поле, требует от GeoEvent Server создания нового определения GeoEvent. Новое определение GeoEvent будет управляться GeoEvent Server и будет удалено, если изменения вносятся в процессор или в сервис GeoEvent, в котором используется процессор.

Параметры

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

Имя

Описательное имя процессора, используемое для справочной информации в GeoEvent Manager.

Процессор

Имя выбранного процессора.

Имя поля

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

Необходимый синтаксис для идентификации полей: ${…}, где – это имя поля, заключенного в ${}. Например, ${Description}. Синтаксис для ссылки на имена полей с помощью процессора отличается от того, что используется в процессоре Калькулятор полей, где имена полей записи событий не заключаются в специальные знаки.

Шаблон

Регулярное выражение, используемое для идентификации шаблона из целевого поля записи события в соответствии с параметром Имя поля. Процессор использует шаблон для идентификации и извлечения подстроки из целевого поля записи события.

Примечание:

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

Целевое поле

Задает целевое поле для значения(й), вычисляемых процессором. Целевое поле – это место, куда будет записан результат выражения. По умолчанию – Существующее поле.

  • Существующее поле – целевым полем будет существующее поле. Значение(я), вычисленное процессором, будет сохранено в существующем поле из записи события.
  • Новое поле – целевым полем будет новое поле. Значение(я), вычисленное процессором, будет сохранено в новом поле. Изменение схемы записи события путем добавления нового поля требует нового определения GeoEvent.

Имя нового поля

(Условия)

Имя нового поля, в которое будут записаны значения, вычисленные процессором.

Свойство отображается, когда Целевое поле установлено как Новое поле, и скрыто, когда выбрано Существующее поле.

Тип нового поля

(Условия)

Укажите тип данных нового поля, создаваемого процессором. По умолчанию – Boolean. Доступные типы данных:

  • Boolean
  • Date
  • Double
  • Float
  • Geometry
  • Integer
  • Long
  • Short
  • String

Свойство отображается, когда Целевое поле установлено как Новое поле, и скрыто, когда выбрано Существующее поле.

Тег нового поля

(Условия)

Имя существующего тега поля, который будет применен к новому полю. Для этого параметра отсутствует значение по умолчанию.

Примечание:

Тег должен уже существовать, чтобы новое поле было им отмечено. Процессор не создает теги динамически. Дополнительные сведения об управлении и создании тегов см. в разделе Управление тегами.

Свойство отображается, когда Целевое поле установлено как Новое поле, и скрыто, когда выбрано Существующее поле.

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

(Условия)

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

Свойство отображается, когда Целевое поле установлено как Новое поле, и скрыто, когда выбрано Существующее поле.

Имя существующего поля

Имя существующего поля, в которое будут записаны значения, вычисленные процессором. Для этого параметра отсутствует значение по умолчанию.

Примечание:

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

Советы и ограничения

  • Процессор Калькулятор поля (Регулярное выражение) не поддерживает обратные ссылки в шаблоне, заданном с помощью регулярных выражений.