В ELMA365 можно управлять версиями разделов: создавать, хранить и восстанавливать их.
Версия раздела — это набор версий структур, входящих в его состав: приложений, страниц, виджетов и процессов. Если фиксируется версия раздела, сохраняются и новые версии его структур.
По умолчанию версия раздела создаётся автоматически только после его импорта, обновления или копирования. Если вы разрабатываете новый раздел с нуля и добавляете его в левое меню системы или изменяете структуры внутри раздела, его новая версия не будет создана.
Вы можете вручную зафиксировать версию раздела, например сохранить первый рабочий вариант нового раздела и затем продолжить его разработку.
В этой статье подробнее рассмотрим работу с версиями раздела. Про особенности версионирования структур в составе раздела читайте в статье «Версионность структур в ELMA365».
Работа с версиями в дереве конфигурации
Для работы с версиями раздела и его структур перейдите на страницу Администрирование > Инструменты разработчика и выберите пункт Управление версиями конфигурации.
Обратите внимание:
- версионирование структур доступно в системе, если включён фича-флаг allowVersionsSnapshots;
- страница Управление версиями конфигурации доступна начиная с версии системы 2026.3 и выше, если включён фича‑флаг exp_exchange_enable_packageVersions и выполнена миграция сервиса exchangeSrv.
Подробнее об активации фича-флагов в поставке On-Premises читайте в статьях «Изменение параметров ELMA365 Enterprise» и «Изменение параметров ELMA365 Standard». Если вы используете поставку SaaS, обратитесь к вашему менеджеру ELMA365.
На странице Управление версиями конфигурации размещено Дерево конфигурации. В нём отображаются системные и пользовательские разделы системы.
Содержимое каждого раздела можно развернуть и показать структуры, входящие в его состав. Каждый тип структуры обозначен в дереве определённым значком. Если навести курсор на значок, отобразится название его типа: раздел, приложение, страница, виджет или процесс.
Справа от названия раздела нажмите значок трёх точек, чтобы перейти к доступным действиям:
- Версии — открыть историю версий раздела;
- Зафиксировать версию — создать версию раздела.
Для структур, входящих в состав раздела, доступен только пункт Версии. Таким образом, вы можете перейти к истории версий любого элемента в дереве конфигурации.
Зафиксировать версию раздела
По умолчанию первая версия раздела создаётся автоматически только при копировании или импорте раздела из другой компании.
Вы можете вручную зафиксировать версию раздела в любой момент: на этапе разработки нового раздела, до и после внесения изменений в структуры готового раздела. Для этого:
- На странице Инструменты разработчика > Управление версиями конфигурации в дереве конфигурации выберите раздел, наведите курсор на значок трёх точек и нажмите Зафиксировать версию.
- В открывшемся окне вы увидите название текущей версии, если она была зафиксирована ранее. Заполните поля:
- Версия* — укажите название, которое отобразится в списке версий раздела. В дальнейшем при экспорте и импорте раздела в другую компанию это название позволит идентифицировать созданную версию, т. к. отобразится в окне запуска импорта, а также в списке версий импортированного раздела;
- Комментарий — укажите дополнительную информацию, которая отобразится в списке версий раздела.
- Нажмите Зафиксировать.
Просмотр истории и управление версиями раздела
Чтобы открыть список версий раздела, выберите его в дереве конфигурации, наведите курсор на значок трёх точек и нажмите Версии. В открывшемся окне для каждой версии отобразятся следующие данные:
- порядковый номер и название версии, заданное при её создании или редактировании;
- время фиксации версии;
- пользователь, создавший версию;
- комментарий.
Справа от выбранной версии нажмите значок трёх точек, чтобы открыть меню доступных действий:
- Редактировать — изменить название версии и комментарий к ней;
- Показать состав — отобразить в виде дерева состав версии раздела: приложения, страницы, виджеты и процессы;
- Сравнить с текущей — сравнить выбранную и текущую версии раздела;
- Восстановить версию — сделать выбранную версию текущей.
Отметка об изменении текущей версии раздела
В истории версий вы можете увидеть, соответствует текущая версия состоянию, в котором она была зафиксирована или нет. Текущая версия отмечается:
- значком галочки
— состав и версии приложений, страниц, виджетов и процессов внутри раздела не изменялись с момента фиксации версии; - значком восклицательного знака
— появились изменения в составе раздела:
- создано приложение или страница;
- изменена версия приложения или страницы, например, добавлено свойство в контекст приложения;
- опубликован виджет или процесс внутри раздела;
- удалена структура в разделе.
Если на момент восстановления архивной версии, экспорта или обновления раздела его текущая версия изменена, вы увидите предупреждение. Для дальнейшей корректной работы с версиями раздела зафиксируйте его текущую версию и затем продолжите запущенный процесс.
Сравнить версии раздела
Применив опцию Сравнить с текущей, вы увидите два дерева — выбранной и текущей версий раздела. Здесь доступны действия:
- развернуть структуру дерева, чтобы сопоставить состав двух версий раздела;
- сравнить версии любой структуры внутри раздела — отобразить в отдельном окне содержимое выбранной структуры из каждой версии в формате JSON. Для этого справа от структуры нажмите значок трёх точек и затем — Сравнить.
Восстановить версию раздела
Вы можете сделать текущей архивную версию раздела и восстановить состояние всех структур раздела на момент, когда была зафиксирована архивная версия. Для этого:
- В списке версий раздела выберите нужную, нажмите значок трёх точек и затем — Восстановить версию. Эта опция доступна также в окне сравнения версий раздела.
- В открывшемся окне подтвердите создание новой версии на основе выбранной.
- Выполнится проверка на наличие изменений в текущей версии. Если изменения есть, вы увидите предупреждение. Для корректной работы с версиями раздела в дальнейшем нажмите Зафиксировать версию.
- На следующем шаге выполнится восстановление версии раздела и версий его структур.
Информация о восстановленной версии будет указана в комментариях к созданной версии раздела и новым версиям его структур.
Мягкое удаление структуры раздела при восстановлении версии
Если структура раздела есть в текущей версии, но отсутствует в восстанавливаемой, она мягко удаляется. Это позволяет в дальнейшем восстанавливать версии раздела, в состав которых структура входит. Например, приложение добавлено в раздел и зафиксировано в его текущей версии. При этом в архивной версии, которую вы хотите восстановить, этого приложения ещё не было. Когда архивная версия станет текущей, приложение будет мягко удалено и не отобразится в левом меню раздела. Вы можете вручную вернуть приложение в состав раздела. Для этого в левом меню раздела нажмите значок гаечного ключа, в открывшемся окне перейдите на вкладку Корзина и нажмите Восстановить.
|
