Applications aggregate versioned objects in the system (these are, for example, tables, columns, scripts, widgets). They are intended to hoard some functionality that can be contributed into the system as a single entity. All the objects in the application have the same value in the application_id field.
Role required: admin.
Как создать
To create an application and to add it into the repository, please complete the steps below:
- Add a new application:
- Click on the gear icon at the top right to enter the admin preferences;
- Click on the icon on the right to the application selection choice list;
- Click New, fill in the form and click Save.
- Name - the name of the application created;
- Version - application version;
- Prefix table - prefixes of the tables that are created within of this application.
- When creating an application, a configuration pack will be automatically created that is named Default 1, bound to this application and containing one or more VCS-records.
- Developer responsible for this application has to configure its structure and to set up the logic. Note: all necessary tables must be versioned (the is_vcs_enabled attribute must be equal to true);
- After that, finish the development with the configuration pack completing. For this, please complete the steps below:
- Click on the gear icon at the top right to enter the admin preferences;
- Select your application in the Application choice list;
- Click the icon on the right to the Configuration Pack choice list;
- Change the configuration pack state to Completed and click Save;
Application
Приложение – совокупность версионируемых объектов в системе (таблицы, колонки, скрипты, виджеты). Цель Приложения – аккумулировать в себе объединенную неким общим признаком функциональность для дальнейшего добавления в систему в качестве единого целого. Все объекты в приложении объединены полем application_id. Конфиг-пак всегда относится к какому-то Приложению, равно как и записи в нём.
В системе всегда есть как минимум одно приложение и один локалпак, в котором фиксируются изменения записей в версионируемых таблицах, т.е. приложение "по умолчанию" и локалпак "по умолчанию".
Приложений, как и привязанных к ним локалпаков, может быть несколько. Локалпаков в составе одного приложения может быть больше одного.
Рассмотрим кейс
В системе создано несколько приложений:
Application 1, Application 2, Application 3.
В каждом из них создано по 3 локалпака. В итоге структура имеет такой вид:
- Application 1
- Localpack 1
- Localpack 2 – is_default
- Localpack 3
- Application 2
- Localpack 4 – is_default
- Localpack 5
- Localpack 6
- Application 3
- Localpack 7
- Localpack 8
- Localpack 9 – is_default
В таком случае допустимо установить флаг is_default на один локалпак в рамках каждого приложения. В итоге в системе может быть теоретически более одного локалпака «по умолчанию», но в каждый момент времени может быть выбран только один.
В аппликейшенах используется полиси
Политика защиты (Policy) используется для защиты конфигурационных данных платформы или бизнес-приложений, чувствительных к изменениям. У каждой записи в системе указано одно из трёх значений Policy, представленных ниже.
Как создать приложение
Для создания приложения необходимо проделать следующие действия:
- Создать новое приложение:
- Зайти в настройки администратора, нажав шестеренку сверху справа;
- Нажать иконку рядом со списком выбора приложений;
- Нажать кнопку New на форме;
- Заполнить форму:
- Name / Наименование – наименование создаваемого приложения;
- Version / Версия – версия приложения;
- Prefix table / Таблица префиксов – префиксы таблиц, создаваемые в рамках данного приложения.
- При создании приложения автоматически будет создан локалпак с названием Default 1, привязанный к этому приложению и содержащий VCS-запись о нём. Состояние локалпака: is_default, In Progress.
- Для того, чтобы изменения конкретного Разработчика Бизнес-Решения (РБР) писались в этот локал-пак, он должен выбрать его у себя в настройках (если так сделают несколько разработчиков, в один и тот же локалпак будут писаться изменения нескольких разработчиков. Так реализована совместная работа в рамках локалпака).
- Далее РБР должен создать структуру приложения, настроить его логику, следя, чтобы на всех необходимых таблицах было включено версионирование (флаг is_vcs_enabled = TRUE).
- После завершения разработки локалпак переводится в статус Completed:
- Зайти в настройки администратора, нажав шестеренку сверху справа;
- Нажать на иконку рядом со списком выбора «Configuration Pack / Конфигурационный пакет»;
- Изменить статус в списке выбора «State / Статус» на «Completed / Завершено». После этого появляется возможность экспортировать локалпак в архивный файл формата .sop.
- Далее необходимо произвести тестирование установки этого приложения на различных серверах с различными сочетаниями других приложений. Методика установки приложения будет рассмотрена далее в рамках данной инструкции.
- При наличии каких-либо дефектов необходимо:
- Перевести локалпак в статус In Progress;
- Провести доработку, необходимую для их устранения;
- Повторно перевести локалпак в статус Completed и выгрузить .sop-файл.
- Файл .sop с приложением отправляется в репозиторий приложений.