logo

Публикация модуля и приложения

Вы можете публиковать модули как по отдельности, так и целым приложением. Модули публикуются по отдельности, если были внесены изменения в одном модуле и требуется проверить его функционал. При финальной проверке приложения рекомендуется выполнять публикацию приложения целиком.

В папке с модулем размещается папка с окончанием *.Runtime, в которой находится файл ModuleInfo.md. В этом файле содержится информация о модуле: его версия, название, отображаемое имя, поддерживаемые редакции. При публикации модуля его версия автоматически инкрементируется и изменяется в этом файле.

Можно выделить следующие варианты публикации.

1. Публикация модуля через командную строку:

elma-cli publish module --name EleWise.ELMA.ModuleExample

Требуется перечислить имена модулей через точку с запятой:

elma-cli publish module --name EleWise.ELMA.ModuleExample;EleWise.ELMA.ModuleExample2

Если указать параметр --version, будет выгружена конкретная версия модуля.

После публикации модуля пакет elma4 сохраняется в папке Deploy внутри приложения.

2. Публикация модуля через графический интерфейс.

Чтобы опубликовать модуль, наведите курсор на его название и нажмите кнопку, которая расположена справа от кнопки "плюс".

В этом случае после публикации версия модуля инкрементируется автоматически. Пакет elma4 попадает сохраняется в папке Deploy внутри приложения.

3. Публикация приложения через командную строку:

elma-cli publish app --name EleWise.ELMA.MyFirstApplication --ver 1.0.0.0 --author ELMA –samever

В этом случае выгрузится приложение версии 1.0.0.0. Все внутренние модули будут также версии 1.0.0.0 из-за параметра --samever, автором модуля будет ELMA.

После публикации приложения пакет elma4 сохраняется в папке Deploy внутри приложения.

4. Публикация приложения через графический интерфейс.

Публикация происходит с параметрами по умолчанию и с учетом описания модуля в файле ModuleInfo.md.

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

После публикации приложения пакет elma4 сохраняется в папке Deploy внутри приложения.

Чтобы выполнить публикацию в файл подобно консольной команде, нажмите кнопку Опубликовать в файл.

Чтобы кнопка Опубликовать в ELMA была активна и публикация выполнилась сразу с публикацией на сервере, настройте интеграцию с ELMA4. Для этого в файле appsettings.json в секции IntegrationElma заполните параметры:

  • ElmaURL — веб-адрес ELMA4;
  • Login — пользователь, от имени которого выполняется интеграция;
  • Password — пароль пользователя;
  • ApplicationToken — токен можно найти следующим образом:

1) Перейдите в сервер разработки, нажмите F12 и перейдите на вкладку Network.

2) Откройте компонент или структуру обмена данными, созданные ранее.

3) На вкладке Network выберите любой запрос, просмотрите его Headers/RequestHeaders, найдите ApplicationToken.

После сохранения изменений остановите сервер и запустите его заново. Указанные значения параметров сохраняются в файле application.info и будут использоваться в качестве значений по умолчанию.

Публикация комплексного BpmApp, содержащего интерфейсы и серверные пакеты

При разработке интерфейсов на сервере могут использоваться модели (сущности, документы, перечисления и пр.), сформированные в модулях ELMA, которые разработаны с помощью плагина к Visual Studio. Чтобы использовать такие модули, требуется:

  1. Выгрузить компонент в виде elma4.
  2. Добавить его в репозиторий модулей.
  3. Добавить ссылку на такой модуль в модуле, который создан на сервере разработки.

Когда разработка завершена, модуль с интерфейсами и модуль с моделями можно упаковать в единый пакет. Для этого достаточно опубликовать приложение с использованием командной строки и указать параметр --ed <Список идентификаторов зависимостей>, где в качестве зависимостей указать идентификаторы пакетов с моделями, которые использовались при разработке приложения.