Действия над текстом

Робот «Действия над текстом» для Битрикс24: обработка и преобразование текстовых данных

Что делает робот

Робот «Действия над текстом» — это универсальный инструмент для обработки текстовых данных внутри бизнес-процессов Битрикс24. В CRM и задачах постоянно возникает необходимость преобразовать текст: убрать лишние пробелы, извлечь часть строки, заменить одни символы на другие, привести к верхнему или нижнему регистру. Раньше для этого приходилось либо делать правки вручную, либо писать код. Робот выполняет эти операции автоматически.

Робот получает на вход текст и выполняет над ним заданное действие. Поддерживаемые операции включают обрезку пробелов по краям, замену подстроки, извлечение фрагмента текста по позиции, изменение регистра и другие базовые текстовые преобразования. Это не инструмент для сложного форматирования, а быстрый способ привести данные к нужному виду прямо по ходу бизнес-процесса.

Особая ценность робота — в связке с другими роботами CRM Robots 2.0. Например, один робот получает данные (список компаний, номер нумератора), а этот робот форматирует их перед отправкой в письме, задаче или чате. Без такой промежуточной обработки автоматизация часто даёт «сырой» результат, который неудобно читать.

Сценарии использования

Форматирование номера документа. Робот «Получение текущего номера нумератора» возвращает число, например «457». Робот «Действия над текстом» добавляет ведущие нули до 5 знаков и префикс «СЧ-», получая «СЧ-00457». Готовый номер записывается в поле счёта.

Очистка данных при импорте. При переносе данных из внешней системы названия компаний часто приходят с лишними пробелами или спецсимволами. Бизнес-процесс запускает этого робота для каждой записи: он обрезает пробелы, удаляет неразрывные пробелы и заменяет кавычки на стандартные. Данные становятся чистыми без ручной обработки.

Извлечение кода из составного поля. В некоторых компаниях используют составные названия сделок, например «СПБ-2024-00157 — Поставка оборудования». Робот может извлечь из такой строки только код «СПБ-2024-00157» по известной позиции и записать в отдельное поле для интеграции с 1С.

Подготовка данных для чат-бота. Бизнес-процесс собирает данные о сделке и передаёт их в чат-бот Telegram. Но перед отправкой робот обрабатывает текст: заменяет переносы строк на пробелы, обрезает слишком длинные значения и формирует компактное сообщение, которое удобно читать в мессенджере.

Настройка робота

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

• Обрезка пробелов — удаляет пробелы в начале и конце строки.
• Замена — находит указанную подстроку и заменяет её на другую.
• Извлечение подстроки — вырезает часть текста по номерам символов.
• Изменение регистра — приводит к верхнему, нижнему или капитализированному регистру.

Дополнительные параметры зависят от выбранного действия: для замены нужно указать что и на что менять, для извлечения — начальную позицию и длину.

Результат работы

Робот возвращает обработанную строку текста. Её можно использовать в любом следующем шаге бизнес-процесса: записать в поле CRM, подставить в шаблон письма, передать в задачу или комментарий, отправить во внешнюю систему. Результат — это всегда текстовая строка, поэтому дальнейшее использование ограничено только логикой вашего процесса.

Интеграция с другими роботами

Робот «Действия над текстом» наиболее ценен именно в связках:

• После робота «Получение текущего номера нумератора» — для форматирования номера.
• После робота «Компании, созданные в период» — для форматирования списка компаний в читаемый текст.
• Перед роботом «Добавить комментарий задачу» — чтобы подготовить текст комментария.
• После робота «Забытые сделки» — чтобы преобразовать список ID в форматированный перечень с пояснениями.

Пример цепочки: любой робот, возвращающий данные → «Действия над текстом» (очистка и форматирование) → «Добавить комментарий задачу» или отправка письма.

Типичные ошибки при настройке

Неправильные позиции при извлечении подстроки. Если указать начальную позицию больше длины строки, робот может вернуть пустой результат. Отсчёт символов начинается с нуля или единицы в зависимости от конкретной реализации — проверьте на тестовых данных.

Неверный порядок операций. Если нужно и обрезать пробелы, и заменить подстроку, важно сделать это в правильном порядке. Например, сначала обрезать пробелы, потом заменять — иначе пробелы внутри строки могут помешать замене. Если операций несколько, используйте несколько роботов последовательно.

Отсутствие обработки пустого значения. Если на вход роботу пришла пустая строка, он тоже вернёт пустую строку. Следующие шаги бизнес-процесса должны быть готовы к этому — например, не пытаться отправить письмо с пустым телом.