Публикация модуля и приложения
Вы можете публиковать модули как по отдельности, так и целым приложением. Модули публикуются по отдельности, если были внесены изменения в одном модуле и требуется проверить его функционал. При финальной проверке приложения рекомендуется выполнять публикацию приложения целиком.
В папке с модулем размещается папка с окончанием *.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. Чтобы использовать такие модули, требуется:
- Выгрузить компонент в виде elma4.
- Добавить его в репозиторий модулей.
- Добавить ссылку на такой модуль в модуле, который создан на сервере разработки.
Когда разработка завершена, модуль с интерфейсами и модуль с моделями можно упаковать в единый пакет. Для этого достаточно опубликовать приложение с использованием командной строки и указать параметр --ed <Список идентификаторов зависимостей>, где в качестве зависимостей указать идентификаторы пакетов с моделями, которые использовались при разработке приложения.