Сводка
Процессор Калькулятор поля (Регулярное выражение) применяется, чтобы использовать возможности регулярных выражений для идентификации шаблона в пределах целевого поля и извлечения подстрок полученных событий. Извлеченные подстроки записываются либо обратно в целевое поле, заменяя его исходное значение, либо в новое поле. Данный процессор не поддерживает общие математические, лексические и логические выражения, поддерживаемые процессором Калькулятор поля.
Примеры
| Значение поля | 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}. Синтаксис для ссылки на имена полей с помощью процессора отличается от того, что используется в процессоре Калькулятор полей, где имена полей записи событий не заключаются в специальные знаки. |
| Шаблон | Регулярное выражение, используемое для идентификации шаблона из целевого поля записи события в соответствии с параметром Имя поля. Процессор использует шаблон для идентификации и извлечения подстроки из целевого поля записи события. Примечание:Ниже приведены примеры нескольких различных типов шаблонов регулярных выражений |
| Целевое поле | Задает целевое поле для значения(й), вычисляемых процессором. Целевое поле – это место, куда будет записан результат выражения. По умолчанию – Существующее поле.
|
| Имя нового поля (Условия) | Имя нового поля, в которое будут записаны значения, вычисленные процессором. Свойство отображается, когда Целевое поле установлено как Новое поле, и скрыто, когда выбрано Существующее поле. |
| Тип нового поля (Условия) | Укажите тип данных нового поля, создаваемого процессором. По умолчанию – Boolean. Доступные типы данных:
Свойство отображается, когда Целевое поле установлено как Новое поле, и скрыто, когда выбрано Существующее поле. |
| Тег нового поля (Условия) | Имя существующего тега поля, который будет применен к новому полю. Для этого параметра отсутствует значение по умолчанию. Примечание:Тег должен уже существовать, чтобы новое поле было им отмечено. Процессор не создает теги динамически. Дополнительные сведения об управлении и создании тегов см. в разделе Управление тегами. Свойство отображается, когда Целевое поле установлено как Новое поле, и скрыто, когда выбрано Существующее поле. |
| Имя нового определения GeoEvent (Условия) | Имя, которое присваивается для нового Определения GeoEvent. Новое определение GeoEvent объединит схему записи входящего события с новым полем, используемым для хранения вычисленных значений. Свойство отображается, когда Целевое поле установлено как Новое поле, и скрыто, когда выбрано Существующее поле. |
| Имя существующего поля | Имя существующего поля, в которое будут записаны значения, вычисленные процессором. Для этого параметра отсутствует значение по умолчанию. Примечание:Используйте меню Определение, чтобы задать определение GeoEvent записей входящих событий. Указание определения GeoEvent сузит область доступных полей для выбора. Используйте меню Поле, чтобы выбрать имя существующего поля, в которое будут записаны значения, вычисленные процессором. |
Советы и ограничения
- Процессор Калькулятор поля (Регулярное выражение) не поддерживает обратные ссылки в шаблоне, заданном с помощью регулярных выражений.