Форматировать строку по regex
Робот «Форматировать строку по regex» для бизнес-процессов Битрикс24 выполняет PHP preg_replace над исходной строкой: находит совпадение по регулярному выражению и заменяет его строкой замены, где $0 — всё совпадение, а $1, $2 — захваченные группы. Он возвращает преобразованный «Результат» и признак «Успех» (false при ошибке в regex).
«Форматировать строку по regex» — это текстовый робот для бизнес-процессов и роботов Битрикс24, дающий полную замену по регулярному выражению (PHP preg_replace) прямо в конструкторе бизнес-процессов. Вы задаёте исходную строку, шаблон и строку замены; робот применяет шаблон к тексту и возвращает изменённое значение в поле «Результат». В строке замены можно ссылаться на всё совпадение через $0 и на захваченные группы через $1, $2 и так далее, что позволяет переставлять, переформатировать или извлекать части значения. Также возвращается признак «Успех» — он равен false, если шаблон некорректен, поэтому можно безопасно ветвиться, а не сохранять испорченный результат. Используйте его, чтобы переформатировать телефоны, привести даты к единому виду, убрать или переставить части строки или извлечь фрагмент из данных CRM. Развёртывание кода и разработчик не требуются.
Какие параметры принимает робот?
| Параметр | Тип | Обязательный? | По умолчанию |
|---|---|---|---|
| Исходная строка | string | да | |
| Регулярное выражение (pattern) | string | да | |
| Строка замены ($1, $2 — группы) | string | — |
Что возвращает робот?
| Параметр | Тип |
|---|---|
| Результат | string |
| Успех (false при ошибке в regex) | bool |
Сценарий: переформатировать 10-значный телефон в читаемую маску.
- Шаг 1. Добавьте робота «Форматировать строку по regex» в бизнес-процесс.
- Шаг 2. В «Исходная строка» укажите поле, например {=Document:PHONE}.
- Шаг 3. Задайте шаблон и строку замены с группами, например замену «+7 ($1) $2-$3».
- Шаг 4. Используйте поле «Результат» далее и проверьте признак «Успех» в условии.