Перейти к основному содержимому

Сценарий разработки сервиса бизнес-логики

к сведению

Этот сценарий рассматривает разработку сервиса бизнес-логики на языке C# в Visual Studio.

Предварительные требования​

На вашем компьютере установлен Visual Studio 2022 с рабочими нагрузками ASP.NET и разработка веб-приложений и Разработка классических приложений .NET.

Вы вошли в AdminTools.

Этапы​

Последовательность этапов этого сценария может варьироваться. Например, вы можете сначала создать проект в Visual Studio для разработки сервиса бизнес-логики, а затем зарегистрировать сервис бизнес-логики в консоли администрирования.

Разработка сервиса бизнес-логики включает следующие этапы:

  1. Регистрация сервиса бизнес-логики в консоли администрирования

    На странице https://<Platform_instance_URL>/admin/services вы регистрируете новый сервис типа Product.

  2. Настройка сервиса бизнес-логики в консоли администрирования

    На странице https://<Platform_instance_URL>/admin/services в списке сервисов вы выбираете новый зарегистрированный сервис и указываете его параметры.

  3. Подготовка шаблона для разработки сервиса бизнес-логики

    Вы разрабатываете сервис бизнес-логики на основе шаблона, подготовленного разработчиками Платформы. Шаблон сервиса бизнес-логики создан на основе шаблона, который используется для микросервисов Платформы.

    По ссылке https://nexus.platform-md.ru/repository/platform-raw/template/<архив-шаблона>.zip вы скачиваете архивный файл, содержащий шаблон сервиса. Далее вы помещаете этот архивный файл в папку с шаблонами для Visual Studio %USERPROFILE%/Документы/Visual Studio 2022/Templates/ProjectTemplates/Visual C# и извлекаете файлы из архива.

    Доступ к данным по ссылке https://nexus.platform-md.ru/repository/platform-raw/template/<Platform_version>/<ServiceTemplate_CSharp>.zip возможен только для авторизованных пользователей. Если вы приобрели Платформу, в Службе технической поддержки вы можете запросить учетные данные для доступа. Вы можете обратиться в Службу технической поддержки по электронной почте по адресу MDSupport@rosatom.ru. В сообщении электронной почты вам необходимо указать название компании, которую вы представляете.

  4. Создание проекта в Visual Studio для разработки сервиса бизнес-логики

    Вы запускаете Visual Studio и создаете проект на основе шаблона сервиса бизнес-логики.

  5. Обновление NuGet-пакетов в проекте для разработки сервиса бизнес-логики

    Поскольку разработчики Платформы периодически изменяют NuGet-пакеты для управления регистрацией сервиса, вы обновляете NuGet-пакеты в созданном в Visual Studio проекте.

  6. Ознакомление со структурой проекта в Visual Studio и изменение отдельных файлов

    Проект в Visual Studio, созданный на основе шаблона сервиса, имеет определенную структуру. Классы, описанные в проекте, позволяют изменять определенные параметры разрабатываемого сервиса бизнес-логики.

    Например, для выполнения сервисных задач бизнес процессов в проекте на основе шаблона сервиса бизнес-логики вы можете подключить Camunda Zeebe.

  7. Разработка кода сервиса бизнес-логики

    В настроенном в Visual Studio проекте вы разрабатываете код сервиса бизнес-логики, который реализует логику работы разрабатываемого приложения.

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

  8. Разработка модульных тестов для сервиса бизнес-логики

    В Visual Studio вы создаете проект с модульными тестами для сервиса бизнес-логики и разрабатываете тесты.

  9. Настройка межсервисного взаимодействия для сервиса бизнес-логики

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

Результаты​

Разработанный сервис бизнес-логики доступен на сервере Платформы. При разработке приложения в DevTools на этапе разработки интерфейса приложения вы можете использовать разработанный сервис бизнес-логики.