История версий

Раздел «История версий» — основной журнал модуля. Он показывает все сохранённые версии элементов, разделов и торговых предложений и позволяет перейти к просмотру, сравнению, восстановлению, скачиванию файлов и экспорту.

[Скриншот 1: общий журнал «История версий» с фильтром и колонками]

Фильтр журнала

Тип — ELEMENT, SECTION или OFFER.
ID сущности — внутренний ID элемента, раздела или предложения.
Инфоблок — ID инфоблока.
Действие — CREATE, UPDATE, DELETE, RESTORE или MANUAL.
Пользователь — ID пользователя, от имени которого зафиксировано изменение.
Дата с / Дата по — период создания версий.

Фильтры можно сочетать. Например, чтобы посмотреть все изменения конкретного товара за неделю, укажите тип ELEMENT, ID товара и диапазон дат.

Колонки таблицы

ID — внутренний номер записи версии.
Тип — тип объекта.
ID сущности — объект, которому принадлежит версия.
Инфоблок — источник объекта.
Версия — последовательный номер версии для конкретной сущности.
Дата — время создания снимка.
Пользователь — ID пользователя.
Действие — причина появления версии.
Снимок и Комментарий — дополнительные колонки, которые можно включить в таблице.

Что означают действия

CREATE — объект был создан.
UPDATE — объект был сохранён после изменения.
DELETE — снимок сделан перед удалением.
RESTORE — в истории зафиксирована операция восстановления.
MANUAL — ручная версия, в том числе базис или версия, созданная через программный интерфейс/импорт.

Действия со строкой

Просмотр

Открывает содержимое конкретной версии: основные сведения, поля, свойства и связанные файлы.

Сравнить с предыдущей

Доступно, когда у объекта есть предыдущая версия. Открывает визуальное сравнение двух последовательных состояний.

Восстановить

Заменяет текущее состояние объекта данными выбранной версии. Перед восстановлением всегда проверяйте сравнение.

Скачать файлы

Формирует ZIP с файлами, сохранёнными для выбранной версии. Если у версии нет файлов, содержимое архива будет соответствующим образом ограничено.

Экспорт версии

Формирует переносимый ZIP с данными версии и файлами для последующего импорта.

[Скриншот 2: контекстное меню версии с просмотром, сравнением, восстановлением и экспортом]

Групповые действия

В журнале можно отметить несколько строк и удалить их или экспортировать в ZIP. Кнопка «Экспорт» в верхнем меню работает интеллектуально: если строки отмечены — экспортируются они, если ничего не отмечено — экспортируется выборка по текущему фильтру.

Удаление версии необратимо. Если версия может понадобиться позже, сначала экспортируйте её.

Вкладка «История» в карточке объекта

При включённой настройке «Показывать вкладку История в карточке» последние версии отображаются непосредственно в карточке элемента или раздела. Там видно дату, действие, пользователя, краткое количество изменений и кнопки просмотра/сравнения/отката.

Во вкладке показывается не более 20 последних версий. Для полной истории используется кнопка «Открыть полную историю».

[Скриншот 3: вкладка «История» в карточке элемента]

Кнопка «Стереть версии кроме базисной»

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

Нумерация версий

Номер версии ведётся отдельно для каждой сущности. Поэтому версия №5 элемента 100 и версия №5 элемента 200 — разные записи. Для точных ссылок внутри модуля используется внутренний ID версии.

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

Удаление записей из общего журнала

Групповое действие «Удалить» удаляет выбранные записи истории. Оно не откатывает объект и не отменяет изменения — просто удаляет сохранённые версии. Если задача состоит в возврате данных, используйте «Восстановить», а не удаление.

Экспорт перед удалением

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

История после восстановления

Откат не должен восприниматься как «возврат времени назад» для самого журнала. История продолжает расти: операция восстановления фиксируется как новое действие. Это позволяет увидеть, что объект был возвращён к старому состоянию и когда это произошло.