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

## Очистка стилей описаний товаров

Из «Качества каталога» кнопка **Очистить стили описаний** открывает массовый
редактор с действием **Удалить стили из описаний товаров**. Можно также выбрать
это действие в самом редакторе. Контур автоматически ограничивается товарами.
Выберите состояние (опубликованные, черновики или оба), рубрику при необходимости,
нажмите **Проверить изменения**, просмотрите количество и фрагменты HTML до/после,
затем подтвердите запуск. Предпросмотр ничего в товарах не меняет.

Удаляются все атрибуты `style`, включая `margin-left: 40px`, цвета и размеры.
Поле определяется ролью «Описание товара», без фиксированного ID; поля других
ролей, SEO, краткое описание и характеристики не меняются. Классы, заголовки
H1–H6 и элементы `<style>` эта операция не удаляет. Разметка нормализуется
HTML-парсером. Описания без inline-стилей не пересохраняются. Поэтому очередь
«Разметка описания» может остаться непустой после очистки, если там остались H1
или элементы `<style>`.

Обработка пакетами по 20, с ревизиями и штатным сбросом кеша. Удалённые
документы исключены. Требуются права управления документами и товарами.

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

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

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

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

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

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

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

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

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