Поддержка версионности позволяет создавать историю версий структуры и восстанавливать предыдущий вариант настроек, например при возникновении ошибки в текущей версии.
В ELMA365 версии создаются для следующих структур:
- раздел;
- страница раздела;
- приложение и его страница;
- контракт и его страница;
- компонент Отчет;
- форма, настроенная в дизайнере интерфейсов;
- виджет;
- бизнес-процесс
- шаблон документа;
- дело в настройках номенклатуры.
начало внимание
Чтобы активировать сохранение версий для структур системы, включите фича-флаг allowVersionsSnapshots. Подробнее читайте в статьях «Изменение параметров ELMA365 Enterprise» и «Изменение параметров ELMA365 Standard». Если вы используете поставку SaaS, для включения фича‑флага обратитесь к вашему менеджеру ELMA365.
конец внимание
Когда создаётся версия структуры
Новая версия структуры автоматически создаётся в следующих случаях:
- Для раздела — версия создаётся, если он импортирован, обновлён или скопирован. При этом добавляются и новые версии структур раздела: приложений, страниц, виджетов и процессов. Также версию раздела можно зафиксировать вручную.
- Если вы сохраняете изменения в настройках структур, которые приведены в таблице ниже.
Структура |
Настройки, при изменении которых создаётся версия |
Страница раздела |
|
Приложение |
|
Страница приложения |
Настройки приложения (отдельные опции). Подробнее о том, какие опции создают версию приложения или страницы, читайте в статье «Настройка приложений». |
Контракт и его страница |
Подробнее о том, какие опции создают версию контракта или его страницы, читайте в статье «Настройки контракта». |
Отчет |
Подробнее о том, какие опции создают версию отчёта, читайте в статье «Создать и настроить отчёт». |
Дело в настройках номенклатуры |
- Для структур в составе решения — если вы импортируете или обновляете решение и при этом настройки загружаемой версии структуры отличаются от её текущей версии. Не применяется к версии раздела в составе решения.
- При публикации изменений формы приложения или виджета в дизайнере интерфейсов.
- При публикации процесса в дизайнере бизнес-процессов. Если отредактирована форма, используемая в бизнес-процессе, её новая версия добавится после публикации процесса.
- Если вы добавляете или изменяете шаблон документа — файл с заданным синтаксисом для подстановки переменных, который можно использовать в бизнес‑процессе.
Первая версия сохраняется при создании структуры или первом сохранении изменений в одной из настроек уже существующей структуры, кроме:
- формы, виджета и процесса — их версии создаются только после публикации структуры;
- раздела — про особенности создания версий для раздела читайте в статье «Управление версиями конфигурации».
Пример создания версии для приложения
После этого в системе создаётся версия приложения Договоры. Она включает в себя контекст приложения с тем набором свойств и их настроек, каким он был на момент сохранения формы приложения. |
Про особенности сохранения переменных в контексте версий приложения читайте в статье «Вкладка „ Контекст“».
История версий структуры
Вы можете ознакомиться с историей версий, сравнить их, загрузить версию в виде файла формата .е365, восстановить предыдущую версию и т. д.
Работа с версиями раздела и входящих в его состав приложений, страниц, виджетов и процессов доступна в разделе Администрирование > Инструменты разработчика.
Также вы можете открыть список версий в настройках следующих структур:
- Для страницы раздела.
В меню настроек раздела выберите пункт Дополнительно > История версий страницы. Здесь сохраняется история редактирования опций в окне Настройки раздела.
- Для приложения и его страницы.
В меню настроек приложения выберите пункт Дополнительные > История версий:
- на вкладке Приложение доступны версии приложения;
- на вкладке Страница — версии страницы приложения, которые создаются независимо от версий приложения и хранят историю редактирования определённых настроек приложения.
- Для контракта и его страницы.
В меню настроек контракта выберите пункт История версий:
- на вкладке Контракт доступны версии контракта;
- на вкладке Страница — версии страницы контракта, которые создаются независимо от версий контракта и хранят историю редактирования определённых настроек контракта.
- Для отчёта.
В списке настроек отчёта выберите пункт Дополнительно > История версий.
- Для формы, настроенной в дизайнере интерфейсов.
Откройте форму в дизайнере интерфейсов и перейдите на вкладку История. Здесь хранятся все опубликованные, а также снятые с публикации версии формы.
- Для пользовательского виджета.
В конструкторе пользовательского виджета перейдите на вкладку История. Здесь хранятся все опубликованные, а также снятые с публикации версии виджета.
- Для бизнес-процесса.
В дизайнере бизнес-процессов перейдите на вкладку Настройки > История версий. Здесь хранятся все опубликованные версии процесса.
- Для шаблона документа.
В зависимости от того, где создан шаблон, перейдите:
- в раздел Администрирование > Шаблоны документов;
- в меню настроек раздела или приложения. Затем выберите пункт Шаблоны документов.
На открывшейся странице нажмите на значок трёх точек напротив нужной записи, а затем — История версий.
- Для дела в настройках номенклатуры.
Перейдите в раздел Администрирование > Настройки номенклатуры, выберите дело и напротив его названия нажмите значок трёх точек, а затем — История версий.
Текущая версия структуры обозначена значком 
. Вы можете просмотреть дату и автора изменений, при сохранении которых создана версия, а также комментарий.
Если версия структуры создана в процессе импорта или обновления, комментарий сформируется автоматически с указанием выполненного процесса: Импорт или Обновление.
Действия с версиями структуры
Чтобы открыть меню допустимых действий с версией, выберите её в списке и нажмите значок три точки. Вы можете:
- Сравнить с текущей — просмотреть прежнюю и текущую версии в формате JSON;
- Скачать файл — загрузить версию в виде файла формата .е365. Такие файлы версий можно сравнить во внешнем текстовом редакторе, например в Visual Studio Code. Не применяется для версий раздела;
- Удалить версию — доступно только для предыдущих версий. Позволяет очистить историю и удалить ненужные версии безвозвратно. Не применяется для разделов, форм, виджетов, бизнес-процессов и дел номенклатуры;
- Снять с публикации — используется для опубликованных версий формы и виджета;
- Восстановить версию — сделать текущей одну из предыдущих версий. Например, если возникла ошибка и у вас нет времени на её решение, вы можете откатить текущую версию. При этом создётся новая версия. Например, текущая версия имеет номер 4, и вы хотите восстановить версию 2. Тогда создаётся версия 5, идентичная версии 2.
Сравнить версии структуры
Чтобы просмотреть различия версий:
- В строке с целевой версией, которую хотите восстановить, нажмите значок три точки и выберите Сравнить с текущей.
- Откроется вкладка side-by-side, на которой размещено содержание двух версий в формате JSON. Различия на ней выделены цветом.
- Вы можете сразу отобразить только различия версий. Для этого перейдите на вкладку inline. Здесь красным цветом подсвечено содержимое текущей версии, зелёным — целевой версии.
- Чтобы сделать целевую версию текущей, на любой вкладке нажмите Восстановить версию.