# Массовый редактор документов и товаров

Раздел **Документы → Массовый редактор** изменяет большой набор записей через
тот же штатный сервис сохранения, который используют редактор документа, JSON
API, импорт и быстрое заполнение товаров.

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

У товара могут отличаться **Заголовок документа** и название на витрине.
Заголовок относится к основной записи AVE.cms, а публичное название берётся из
поля, назначенного в настройках товарного каталога. После выбора рубрики
массовый редактор помечает такие поля подписью **витрина: название товара на
сайте**, **витрина: текущая цена** и так далее. Для изменения данных на сайте
выбирайте помеченное поле. Сохранение такого поля сразу пересобирает товарный
индекс и очищает связанный публичный кеш.

| Действие | Поведение |
| --- | --- |
| Заполнить пустые | Записывает значение только туда, где поле пустое. |
| Установить значение | Заменяет текущее значение у всех документов набора. |
| Очистить | Сохраняет пустое значение. Обязательное поле может остановить конкретный документ валидацией. |
| Найти и заменить | Заменяет точное вхождение внутри выбранного текстового значения. |
| Перенести в рубрику | Меняет рубрику и переносит поля с одинаковым системным именем и типом. |
| Опубликовать / снять | Меняет состояние документа. Системные главная и 404 пропускаются. |
| Пересчитать | Повторно применяет вычисляемые поля, сохранение, кеш, JSON-снимок и модульные индексы. |

## Порядок работы

1. Выберите контур, рубрику, состояние и при необходимости поиск.
2. Выберите действие. Для поля рубрики обязательно укажите одну рубрику.
3. Нажмите **Проверить изменения**.
4. Проверьте первые 20 примеров «было → станет» и общее количество.
5. Нажмите **Применить ко всему набору**.

Предпросмотр сохраняет на сервере точный список ID на два часа. Изменение формы
после проверки не меняет уже подготовленный план. Один запуск обрабатывает до
5000 документов порциями по 20, показывает прогресс и может быть остановлен.

Для каждого реально изменённого документа создаётся ревизия, выполняются код
рубрики и document hooks, пересобираются кеш и JSON-снимок. Ошибка одного
документа записывается в журнал задания и не отменяет успешно обработанные
документы. Итог попадает в аудит.

При переносе поля сопоставляются только по непустому системному имени (alias) и
одинаковому типу. Несовпадающие значения остаются в ревизии исходного
документа, но в новой рубрике не создаются.