Робот «Парсинг текста по регулярным выражениям» помогает извлекать значения из текста по заданным шаблонам, когда нужен предсказуемый результат без ручной обработки.
Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.
Для кого и какую задачу решает
Администратору CRM, который извлекает номер, артикул или другой фрагмент из сообщений с заранее известной структурой.
Свободный текст неудобен для условий процесса. Робот применяет отдельные регулярные выражения и возвращает по первому совпадению каждого шаблона. Это подходит для повторяемого формата; сложный документ с меняющейся структурой требует отдельной проверки.
Параметры и подготовка
В множественном поле формы добавляйте каждое значение отдельным элементом. В текстовое JSON-поле вставляйте целиком только значение из блока именно для этого поля: массив или объект, без внешнего объекта со всеми настройками робота. Обычные текстовые, числовые и списковые поля заполняйте в формате, указанном в таблице.
| Поле | Как заполнить |
|---|---|
Текст для анализа (TEXT) |
Обязательное поле |
Регулярные выражения (REGULAR_EXPRESSION) |
Обязательное поле. можно передать несколько значений |
Перед настройкой выберите, откуда процесс получит каждое значение: постоянная настройка, поле карточки или результат предыдущего шага. Подписи в таблице соответствуют полям робота. Коды в скобках помогают различать похожие параметры при передаче данных между шагами.
Как использовать
- Передайте непустой TEXT и добавьте регулярные выражения отдельными значениями множественного поля.
- Для каждого шаблона используйте первую группу, если нужен только фрагмент без подписи. Без группы возвращается всё первое совпадение.
- Сопоставьте порядок шаблонов результатам result1, result2 и далее. В объявленной схеме доступны первые десять результатов.
- После выполнения проверяйте заполненность обязательных результатов. Успешный статус не доказывает корректность каждого шаблона: неверный шаблон или отсутствие совпадения дают пустое значение.
Как заполнить JSON-поля
Регулярные выражения (REGULAR_EXPRESSION)
[
"Заказ: ([A-Z]-[0-9]+)",
"Количество: ([0-9]+)"
]
Это пример набора отдельных значений множественного поля. В штатной форме добавьте два выражения по отдельности; не вставляйте JSON-скобки как один шаблон. При программной передаче нужен список или объект значений; [] ничего не извлекает.
Это массив: внешние квадратные скобки обязательны. Пустой массив [] отличается от объекта {}; возможность пустого списка определяется правилами этого поля, описанными ниже.
Учебный пример и ожидаемый результат
TEXT=«Заказ: A-123; Количество: 5». Первое выражение Заказ: ([A-Z]-[0-9]+), второе Количество: ([0-9]+). Ожидаются result1=A-123, result2=5. Все значения возвращаются текстом. Если шаблон не совпал, его результат пустой; остальные выражения продолжают обработку.
Пример показывает подготовленные учебные данные. Фактический результат зависит от переданных значений и доступных данных вашего процесса.
Что возвращает и как продолжить процесс
- «Результат 1» (
result1). - «Результат 2» (
result2). - «Результат 3» (
result3). - «Результат 4» (
result4). - «Результат 5» (
result5). - «Результат 6» (
result6). - «Результат 7» (
result7). - «Результат 8» (
result8). - «Результат 9» (
result9). - «Результат 10» (
result10).
Для каждого выражения используется первое найденное совпадение и только первая захватывающая группа. Робот не выдаёт все повторения в одном массиве. Пустой список выражений при непустом тексте не извлекает значения, хотя действие может завершиться успешно.
Статус показывает завершение обработки, но не успешность каждого выражения. Отдельного выходного поля ошибки нет. Проверяйте, что нужный resultN заполнен и соответствует ожидаемому формату, прежде чем сохранять его в обязательное поле.
Ограничения и разбор ошибок
TEXT очищается по краям. Для каждого регулярного выражения берётся первое совпадение, при наличии групп первая группа. Внешние / убираются только если стоят в начале и конце. Неверный шаблон даёт пустой результат без отрицательного общего статуса. Объявлены result1–result10; отдельного результата ошибки нет.
Не передавайте одиночную строку вместо набора выражений программно: настройка ожидает множественные значения. Выражения не проверяют бизнес-смысл найденного номера или даты. Для числового сравнения преобразуйте найденную строку отдельно.