Установка модуля SenDev: iBlock History - контроль изменений инфоблоков

Эта инструкция описывает установку версии 0.9.802 и первоначальную подготовку модуля к работе. Установка выполняется стандартным способом через административную часть 1С-Битрикс.

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

[Скриншот 1: страница установки модуля в административной части 1С-Битрикс]

Перед установкой

• Сделайте штатную резервную копию сайта и базы данных, если модуль устанавливается на рабочий проект.
• Убедитесь, что используется модуль «Информационные блоки». Без него история элементов и разделов работать не будет.
• Если планируется версионирование торговых предложений, на сайте должен использоваться каталог с SKU.
• Оцените свободное место в файловом хранилище. При работе с изображениями и документами модуль создаёт копии файлов для версий.
• Устанавливайте модуль под учётной записью администратора.

Установка

1. Откройте раздел установки решений в административной части 1С-Битрикс.
2. Запустите установку SenDev: iBlock History - контроль изменений инфоблоков.
3. Дождитесь сообщения об успешной установке.
4. Вернитесь в административную часть и откройте раздел «Контент → История инфоблоков».
5. Перейдите в «Настройки» и сохраните параметры, подходящие для вашего проекта.

Отдельного мастера с выбором параметров во время установки в версии 0.9.802 нет. После завершения установки используется стандартный набор значений, а рабочие настройки меняются на странице «Настройки».

[Скриншот 2: меню «История инфоблоков» после успешной установки]

Что включено по умолчанию

• версионирование элементов — включено;
• версионирование разделов — включено;
• версионирование торговых предложений — включено;
• создание версий при добавлении, изменении и удалении — включено;
• режим «Только значимые изменения» — включён;
• вкладка «История» в карточке элемента/раздела — включена;
• архивирование заменяемых файлов — включено;
• срок хранения файлов в архиве устаревших — 30 дней;
• ограничение по количеству и возрасту версий — не задано;
• запись действий в журнал событий — включена;
• подробное отладочное логирование — выключено.

Обязательный шаг для существующего сайта — создание базиса

Модуль начинает автоматически фиксировать изменения после установки, но у уже существующих объектов нет исходного снимка. Поэтому после настройки рекомендуется открыть страницу «Создать базис» и сохранить базисное состояние элементов и разделов. Тогда первое последующее изменение можно будет сравнить с состоянием сайта на момент подключения модуля.

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

Проверка после установки

1. Откройте «Диагностику». Убедитесь, что таблицы доступны и нет ошибок записи в файловое хранилище.
2. Откройте «Создать базис» и создайте базис хотя бы для одного тестового инфоблока.
3. Отредактируйте тестовый элемент и сохраните его.
4. Откройте элемент повторно и найдите вкладку «История».
5. Проверьте, что появилась новая версия и показано количество изменённых полей/свойств.
6. Откройте сравнение и убедитесь, что изменения отображаются корректно.

[Скриншот 3: диагностика после установки: версии, файлы и отсутствие критических проблем]

Удаление модуля

При удалении модуль поддерживает вариант сохранения данных. Если выбран режим сохранения данных, таблицы с историей можно оставить для последующей установки. Если данные не сохранять, служебные таблицы удаляются вместе с модулем. Перед полным удалением при необходимости сделайте экспорт важных версий.

После обновления версии

После обновления откройте «Диагностику», проверьте текущие настройки и выполните тестовое сохранение элемента. Если обновление затрагивало хранение файлов или восстановление, дополнительно проверьте откат на тестовом объекте.

Права доступа после установки

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

Где хранятся файлы

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

При переносе сайта на другой сервер переносите каталог upload вместе с базой данных. Одна только база не содержит всех физических копий документов и изображений.

Первый рабочий день после установки

1. Сохраните настройки.
2. Создайте базис для одного небольшого инфоблока.
3. Измените тестовый элемент два раза, чтобы получить несколько последовательных версий.
4. Проверьте сравнение первой и последней версии.
5. Замените тестовое изображение и убедитесь, что файл отображается в сохранённой версии.
6. Выполните откат.
7. После успешного теста создавайте базис для остальных рабочих инфоблоков.

Что не нужно делать сразу

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