Архитектура и системные требования / Версионность структур в ELMA365

Версионность структур в ELMA365

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

В этой статье рассмотрим версионность, которая поддерживается в системе, начиная с версии системы 2025.5, для следующих структур:

  • приложение — новая версия создаётся при изменении определённых его настроек. Например, если добавлена или удалена переменная в контексте приложения;
  • страница приложения — версия создаётся, если изменяются Настройки приложения. Таким образом, версия страницы приложения хранит определённое название и описание приложения, ссылку на него и другие опции, которые можно изменять в окне настроек приложения;
  • страница раздела версия создаётся, если изменяются Настройки раздела.

В настройках структуры вы можете посмотреть список её версий, сравнить их и заменить текущую версию на одну из предыдущих.

начало внимание

Чтобы активировать сохранение версий для приложения и страницы раздела, включите фича-флаг allowVersionsSnapshots. Подробнее читайте в статьях «Изменение параметров ELMA365 Enterprise» и «Изменение параметров ELMA365 Standard». Если вы используете поставку SaaS, для включения фича‑флага обратитесь к вашему менеджеру ELMA365.

конец внимание

Когда создаётся версия структуры

Новая версия приложения, его страницы или страницы раздела автоматически создаётся в следующих случаях:

  1. Если вы сохраняете изменения в настройках структуры, которые приведены в таблице ниже.

Структура

Настройки, при изменении которых создаётся версия

Приложение

  • Настройка формы;
  • Название элемента;
  • Иерархический справочник;
  • Поле "Статус";
  • Нумератор;
  • Настройки подписи;
  • Настройки архивации;
  • Печатная форма

Страница приложения

Настройки приложения

Страница раздела

Настройки раздела

  1. Если вы импортируете или обновляете раздел или решение, и при этом настройки загружаемой версии структуры отличаются от её текущей версии.

Первая версия сохраняется при добавлении нового приложения или раздела или первом сохранении изменений в одной из настроек уже существующей структуры.

Пример создания версии для приложения

Про особенности сохранения переменных в контексте версий приложения читайте в статье «Вкладка „ Контекст“».

История версий структуры

Вы можете ознакомиться с историей версий, сравнить их, загрузить версию в виде файла формата .е365, восстановить предыдущую версию и т. д.

Для этого справа от названия структуры нажмите значок шестерёнки и выберите:

  • для приложения — пункт Дополнительные > История версий:
    • на вкладке Приложение доступны версии приложения;
    • на вкладке Страница — версии страницы приложения, в которых сохраняется история редактирования опций в окне Настройки приложения. Эти версии создаются независимо от версий приложения;

elma365-structure-versioning-2

  • для страницы раздела — пункт Дополнительно > История версий страницы. Здесь сохраняется история редактирования опций в окне Настройки раздела.

Текущая версия структуры обозначена значком elma365-structure-versioning-3. Вы можете просмотреть дату и автора изменений, при сохранении которых создана версия, а также комментарий.

Если версия структуры создана в процессе импорта или обновления, комментарий сформируется автоматически с указанием выполненного процесса: Импорт или Обновление.

Действия с версиями структуры

Чтобы открыть меню допустимых действий с версией, выберите в списке строку и справа нажмите значок три точки. Вы можете просмотреть дополнительную информацию, а также:

  • Сравнить с текущей — просмотреть прежнюю и текущую версии в формате JSON;
  • Скачать файл — загрузить версию в виде файла формата .е365. Такие файлы версий можно сравнить во внешнем текстовом редакторе, например в Visual Studio Code;
  • Удалить версию — действие доступно только для предыдущих версий. Позволяет очистить историю и удалить ненужные версии безвозвратно;
  • Восстановить версию — сделать текущей одну из предыдущих версий. Например, если возникла ошибка и у вас нет времени на её решение, вы можете откатить текущую версию. При этом создётся новая версия. Например, текущая версия имеет номер 4, и вы хотите восстановить версию 2. Тогда создаётся версия 5, идентичная версии 2.

Сравнить версии структуры

Чтобы просмотреть различия версий:

  1. В строке с целевой версией, которую хотите восстановить, нажмите значок три точки и выберите Сравнить с текущей.
  2. Откроется вкладка side-by-side, на которой размещено содержание двух версий в формате JSON. Различия на ней выделены цветом.

elma365-structure-versioning-4

  1. Вы можете сразу отобразить только различия версий. Для этого перейдите на вкладку inline. Здесь красным цветом подсвечено содержимое текущей версии, зелёным — целевой версии.

elma365-structure-versioning-5

  1. Чтобы сделать целевую версию текущей, на любой вкладке нажмите Восстановить версию.