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

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

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

В ELMA365 версии создаются для следующих структур:

  • приложение и его страница;
  • контракт и его страница;
  • страница раздела;
  • форма приложения, виджет;
  • бизнес-процесс.

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

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

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

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

Новая версия структуры автоматически создаётся в следующих случаях:

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

Структура

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

Приложение

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

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

Настройки приложения (отдельные опции).

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

Контракт и его страница

  • Настройки контракта;
  • Поля контракта;
  • изменения в приложениях-источниках, если создаётся новая версия приложения.

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

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

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

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

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

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

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

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

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

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

elma365-structure-versioning-2

  1. Для контракта и его страницы — в меню настроек контракта выберите пункт История версий:
  • на вкладке Приложение доступны версии контракта;
  • на вкладке Страница — версии страницы контракта, которые создаются независимо от версий контракта и хранят историю редактирования определённых настроек контракта.
  1. Для страницы раздела — в меню в настроек раздела выберите пункт Дополнительно > История версий страницы. Здесь сохраняется история редактирования опций в окне Настройки раздела;
  2. Для формы приложения или виджета — в дизайнере интерфейсов откройте вкладку История. Здесь хранятся все опубликованные, а также снятые с публикации версии формы или виджета.
  3. Для бизнес-процесса — в дизайнере бизнес-процессов перейдите на вкладку История > История версий. Здесь хранятся все опубликованные версии процесса.

Текущая версия структуры обозначена значком 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. Чтобы сделать целевую версию текущей, на любой вкладке нажмите Восстановить версию.