[ELMA3] Обновление компонентов для перехода на ELMA4

При наличии BPM Apps, установленных из ELMA Store или разработанных самостоятельно, перед обновлением их требуется доработать и актуализировать для ELMA4 или получить новую версию из ELMA Store. При работе с компонентами из ELMA Store необходимо выпонить только те действия, которые описаны в пункте Обновление с установленными компонентами.

Подготовка компонентов в ELMA3 к обновлению и проверка условий выполнения перехода на ELMA4

Чтобы подготовить компоненты к обновлению и проверить, выполняются ли условия перехода на ELMA4, выполните следующие действия.

Шаг 1. Проверьте компоненты, установленные в ELMA3, на наличие зависимостей в конфигурационных файлах .nuspec пакетов .nupkg.

Это можно сделать двумя способами:

  • перейдите в папку ..\Общая папка с файлами системы ELMA\Packages и откройте файлы .nuspec кастомных компонентов при помощи текстового редактора. Проверьте их на наличие тэга <Dependencies>;
  • при наличии установленных компонентов откройте файл .elma3 в папке ..\Общая папка с файлами системы ELMA\Packages при помощи архиватора (7z, WinRAR). Внутри архива .elma3 найдите конфигурационный файл .elma3manifest и откройте его при помощи текстового редактора. Проверьте наличие тэга <Dependencies>.

Если тэг <Dependencies> присутствует и внутри него указаны зависимости, такой компонент нужно исправить в Visual Studio.

На рисунках ниже представлены примеры зависимостей в файле .nuspec и в файле .elma3manifest.

На этом рисунке выделен тэг, который нужно проверить. Именно он указан в конфигурационном файле .nuspec внутри пакета .nupkg.

Шаг 2.В Visual Studio в проекте компонента удалите все зависимости от пакетов в конфигурационном файле .nuspec и соберите новую версию пакетов .nupkg.

Шаг 3. Соберите пакет .elma3 новой версии, чтобы обновить установленный компонент. При сборке пакета .elma3 выберите зависимости от пакетов, которые были указаны в файле .nuspec пакета .nupkg. Подробнее о создании BPM Apps можно прочитать в справке по ELMA3.

Шаг 4. Обновите компоненты в ELMA на подготовленные.

Сборка компонентов для ELMA4

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

Шаг 1. Установите с нуля систему ELMA4. Используйте новую базу данных. Эта версия нужна для сборки модулей и указания ссылок на библиотеки новой версии.

Шаг 2. Установите новую версию ElmaPlugin для ELMA4.

Шаг 3. Переведите все проекты решения для компонента на Framework 4.8. Для этого откройте проект компонента, вызовите контекстное меню и выберите Свойства -> Приложение -> Целевая рабочая среда: .NET Framework 4.8.

Шаг 4. Добавьте путь до пакетов ELMA4 в NuGet VS. В Обозревателе решений вызовите контекстное меню проекта и выберите Управление пакетами Nuget... . Далее нажмите на значок шестеренки в правом верхнем углу.

Шаг 5. Добавьте новый источник пакетов и укажите в качестве источника папку ELMA4-Packages.

Шаг 6. Все ссылки на библиотеки в каждом проекте решения должны ссылаться на новые версии библиотек или пакетов. В проекте компонента укажите ссылки на библиотеки и обновите пакеты из ELMA4. Также необходимо обновить библиотеку System.Web.Mvc через пакеты. Для этого в Обозревателе решений вызовите контекстное меню проекта и нажмите Управление пакетами Nuget... . Далее выберите источник пакетов ELMA4. Найдите пакет Microsoft.AspNet.Mvc версии 5.2.3 и установите его.


Шаг 7. Проверьте ссылки в решении. Если в проекте имеется ссылка на библиотеку FluentNHibernate, измените ее на NHibernate из новой версии ELMA4. Если ссылка используется в сущности, сущность требуется пересохранить при помощи нового плагина.

Шаг 8. При наличии веб-проекта в контроллерах, где используется атрибут [ActionLinkArea], замените его на [RouteArea].

Шаг 9. При наличии ссылок на Microsoft.Web.Mvc, замените их на System.Web.Mvc.Html (для html.RenderPartial).

Шаг 10. Убедитесь, что в файлах .nuspec отсутствуют зависимости на пакеты <Dependencies></Dependencies>. При наличии удалите их.

Шаг 11. Соберите новую версию компонента. Рекомендуется ввести номер версии в формате 4.x.x.x, чтобы указать, что компонент относится к ELMA4. Кроме того, при сборке пакета .elma4 можно добавить зависимости от пакетов.

Обновление с установленными компонентами

Шаг 1. Проверьте модули, установленные в ELMA3, на наличие зависимостей в конфигурационных файлах .nuspec пакетов .nupkg. Подробнее о том, как это сделать, читайте в пункте Подготовка компонентов в ELMA3 к обновлению и проверка условий выполнения перехода на ELMA4.

Шаг 2. Скачайте или соберите все модули для ELMA4.

Шаг 3. Разместите пакеты .elma4 в папке ..\Общая папка с файлами системы ELMA\UserConfig\Packages.

Шаг 4. Запустите обновление с ELMA3 на ELMA4.