Замена текста

Робот «Замена текста» заменяет в тексте нужные фрагменты: точным совпадением или по шаблону, с сохранением найденных частей.

Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.

Для кого и какую задачу решает

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

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

Параметры и подготовка

В множественном поле формы добавляйте каждое значение отдельным элементом. В текстовое JSON-поле вставляйте целиком только значение из блока именно для этого поля: массив или объект, без внешнего объекта со всеми настройками робота. Обычные текстовые, числовые и списковые поля заполняйте в формате, указанном в таблице.

Поле	Как заполнить
Текст (TEXT)	Обязательное поле
Режим замены (MODE)	Обязательное поле. по умолчанию plain. Точное совпадение (plain); По шаблону (регулярное выражение) (regex)
Что заменить (SEARCH)	Обязательное поле. можно передать несколько значений
На что заменить (REPLACE)	Необязательное поле. можно передать несколько значений
Не учитывать регистр (IGNORE_CASE)	Необязательное поле. по умолчанию N
Максимум замен (MAX_REPLACEMENTS)	Необязательное поле. по умолчанию 0

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

Как использовать

1. Передайте TEXT и выберите MODE: plain для буквального совпадения, regex для регулярного выражения.
2. Заполните SEARCH и REPLACE согласованными парами. При нескольких значениях порядок важен; отсутствующая замена для очередного поиска считается пустой строкой.
3. Укажите IGNORE_CASE для сравнения без регистра и MAX_REPLACEMENTS. Ноль по умолчанию не ограничивает количество; ограничение применяется к каждой паре.
4. После выполнения проверьте status и error. При ошибке отдельного шаблона другие пары могут быть обработаны, поэтому не принимайте частичный результат без проверки.

Как заполнить JSON-поля

Что заменить (SEARCH)

[
  "товар",
  "старый"
]

Это два отдельных значения множественного поиска. В форме заполните их отдельными элементами. Пары применяются последовательно; JSON-скобки не являются частью буквального поиска.

Это массив: внешние квадратные скобки обязательны. Пустой массив [] отличается от объекта {}; возможность пустого списка определяется правилами этого поля, описанными ниже.

На что заменить (REPLACE)

[
  "позиция",
  "новый"
]

Значения соответствуют SEARCH по позиции. Если для поиска замена отсутствует, используется пустая строка. [] означает пустые замены, а не запрет обработки.

Это массив: внешние квадратные скобки обязательны. Пустой массив [] отличается от объекта {}; возможность пустого списка определяется правилами этого поля, описанными ниже.

Учебный пример и ожидаемый результат

TEXT=«товар А, товар Б», MODE=plain, SEARCH=«товар», REPLACE=«позиция», IGNORE_CASE=N, MAX_REPLACEMENTS=0. Ожидаются «позиция А, позиция Б», count=2, changed=Y. Для режима regex шаблон (А) и замена $1-учебный используют первую группу совпадения.

Пример показывает подготовленные учебные данные. Фактический результат зависит от переданных значений и доступных данных вашего процесса.

Что возвращает и как продолжить процесс

• «Результат» (result).
• «Количество замен» (count).
• «Текст изменен» (changed).

count отражает число сработавших замен, changed сравнивает итог с исходным текстом. Эти признаки могут различаться: замена фрагмента на тот же текст увеличивает счётчик, но не меняет содержимое. Ошибки шаблонов перечисляются в error.

Выход «Статус выполнения» проверяйте перед передачей результата дальше. При отрицательном статусе прочитайте «Описание ошибки» и направьте процесс на исправление исходных данных. Успешный статус подтверждает выполнение действия; содержательные признаки результата проверяйте отдельно.

Ограничения и разбор ошибок

Пары SEARCH/REPLACE выполняются последовательно. В режиме plain поиск буквальный, regex использует шаблон. IGNORE_CASE по умолчанию N, лимит 0 означает отсутствие ограничения. Ошибка одного шаблона фиксируется отдельно; итог может быть частичным.

Пустой поиск пропускается. Ссылки $1 и ${1} относятся к группам в регулярном режиме, $$ обозначает буквальный знак доллара. Не передавайте неподготовленные сложные шаблоны из клиентского ввода; согласуйте их до использования в процессе.