Обезличить текст по точным правилам замены

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

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

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

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

Обычная последовательная замена может повторно изменить уже подставленную маску. Этот робот ищет все заданные фрагменты в исходном тексте и применяет выбранную политику пересечений. Он скрывает только явно перечисленные значения и не распознаёт персональные сведения автоматически.

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

Поле	Как заполнить
Исходный текст (TEXT)	Необязательное поле. по умолчанию ``
Точные правила JSON (RULES)	Обязательное поле
Пересекающиеся совпадения (MATCH_POLICY)	Обязательное поле. Не заменять при пересечениях (reject_overlaps); Левое совпадение, при равном начале: длинное (leftmost_longest)

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

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

1. Передайте исходный текст и массив правил. Каждое правило содержит ровно id, find и replacement; id и искомые фрагменты должны быть уникальными.
2. Выберите политику пересечений. reject_overlaps отменяет весь результат, если совпадения перекрываются. leftmost_longest выбирает левое, а при одинаковом начале более длинное совпадение.
3. Используйте точное написание find с нужным регистром. Для скрытия нескольких вариантов имени перечислите их отдельными правилами.
4. После выполнения проверьте статус и «Правила применены». Перед отправкой результата изучите число замен и пересечения. Пустой результат при отмене не заменяет исходник для отправки.

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

Точные правила JSON (RULES)

[
  {
    "id": "person",
    "find": "Анна",
    "replacement": "[Клиент]"
  }
]

До 100 правил с ровно этими тремя ключами. id и find уникальны, find непустой. replacement может быть пустой строкой для удаления. [] допустим, но ничего не скрывает.

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

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

TEXT: «Анна согласовала заказ». RULES: [{"id":"person","find":"Анна","replacement":"[Клиент]"}], MATCH_POLICY=reject_overlaps. Ожидается «[Клиент] согласовала заказ», valid включён, применена одна замена. Если два правила перекрывают один фрагмент, при reject_overlaps valid выключится, reason будет overlap и результат останется пустым.

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

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

• «Текст после замены» (result).
• «Правила применены» (valid).
• «ok/overlap» (reason).
• «Применено замен» (appliedCount).
• «Были пересечения» (hasOverlaps).
• «Пропущено совпадений» (skippedCount).
• «Число замен каждого правила JSON» (ruleCountsJson).
• «Позиции замен JSON» (auditJson).
• «Аудит ограничен» (auditTruncated).
• «Примеры пересечений JSON» (overlapSamplesJson).

«Применено замен» и счётчики правил помогают увидеть, какие маски сработали. Аудит содержит позиции и ID правил без исходных фрагментов; нумерация символов начинается с нуля. Если аудит ограничен, не трактуйте его как полный перечень замен.

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

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

RULES: [{"id":"person","find":"Иван Иванов","replacement":"[Клиент]"}]. Совпадения буквальные и чувствительны к регистру; регулярные выражения не исполняются. Все совпадения ищутся в исходном тексте, результаты замен повторно не обрабатываются. MATCH_POLICY выбирается явно: reject_overlaps отменяет весь результат при пересечениях, leftmost_longest выбирает самое левое совпадение, при общем начале: самое длинное, затем пропускает пересечения. Только точные переданные фрагменты скрываются; неуказанные персональные сведения автоматически не обнаруживаются. До 100 правил с уникальными id и find; текст до 100000 символов, find/replacement до 1000, до 10000 совпадений, результат до 1 МБ. Аудит содержит первые 1000 позиций по символам от нуля и ID правил, без исходных фрагментов. Пустой текст/словарь допустимы. При reject_overlaps valid=N, result пустой, замен нет.

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