Tisa.XrmApp 2025.9.9.410

Tisa.XrmApp

Базовые классы и компоненты приложений ТИСА для работы с использованием .NET Core.

Описание

Tisa.XrmApp - это базовый пакет для разработки приложений, работающих с Microsoft Dynamics 365/XRM. Пакет предоставляет набор базовых классов, интерфейсов и компонентов для быстрой разработки приложений, интегрирующихся с Dynamics 365.

Требования

• .NET 8.0 или выше
• Microsoft Dynamics 365/XRM
• Visual Studio 2022 или выше

Установка

dotnet add package Tisa.XrmApp

Основные возможности

• Базовые классы для работы с XRM
• Middleware для обработки запросов
• Система аутентификации
• Обработка ошибок
• Установка сервисов
• Общие компоненты для работы с Dynamics 365

Структура проекта

Tisa.XrmApp/
├── Authentication/     # Компоненты аутентификации
├── Common/            # Общие компоненты
├── Errors/            # Обработка ошибок
├── Events/            # Обработчики событий
├── Headers/           # Работа с HTTP заголовками
├── Middleware/        # Middleware компоненты
├── Services/          # Базовые сервисы
├── ServiceInstallers/ # Установщики сервисов
└── Shared/            # Общие ресурсы

Использование

Базовая настройка

public class Startup
{
    public void ConfigureServices(IServiceCollection services)
    {
        services.AddTisaXrmApp();
    }

    public void Configure(IApplicationBuilder app)
    {
        app.UseTisaXrmApp();
    }
}

Настройка аутентификации

services.AddTisaXrmAppAuthentication(options =>
{
    options.Authority = "https://your-authority";
    options.ClientId = "your-client-id";
    options.ClientSecret = "your-client-secret";
});

Использование базовых сервисов

public class YourService
{
    private readonly IXrmService _xrmService;

    public YourService(IXrmService xrmService)
    {
        _xrmService = xrmService;
    }

    public async Task<Entity> GetEntityAsync(string entityName, Guid id)
    {
        return await _xrmService.RetrieveAsync(entityName, id);
    }
}

Разработка

Требования к разработке

1. Соблюдение правил кодирования C#
2. Использование async/await для асинхронных операций
3. Документирование публичных API
4. Написание unit-тестов
5. Следование принципам SOLID

Настройка окружения разработки

1. Клонируйте репозиторий
2. Установите зависимости:

   dotnet restore
   

3. Соберите проект:

   dotnet build
   

4. Запустите тесты:

   dotnet test
   

Правила коммитов

• Используйте осмысленные сообщения коммитов
• Следуйте соглашению Conventional Commits
• Каждый коммит должен содержать только связанные изменения

Тестирование

Для тестирования используется FakeXrmEasy:

[TestClass]
public class YourTestClass
{
    private IXrmFakedContext _context;
    private IOrganizationService _service;

    [TestInitialize]
    public void Initialize()
    {
        _context = new XrmFakedContext();
        _service = _context.GetOrganizationService();
    }

    [TestMethod]
    public void YourTestMethod()
    {
        // Тестовый код
    }
}

Авторы

Команда разработчиков TISA

Лицензия

MIT License

Поддержка

Для получения поддержки или сообщения об ошибках, пожалуйста, напишите нам на support@tisn.ru