Tisa.FakeXrm.Core 2025.9.10.1120

Tisa.FakeXrm.Core

Общие классы и компоненты для тестирования плагинов Dynamics CRM с использованием платформы .NET Core и библиотеки FakeXrmEasy.

Описание

Tisa.FakeXrm.Core предоставляет набор инструментов для упрощения написания unit-тестов и интеграционных тестов для плагинов Microsoft Dynamics 365 (CRM). Пакет построен на основе библиотеки FakeXrmEasy и расширяет её функциональность дополнительными вспомогательными классами, исполнителями и расширениями.

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

• Базовые классы для тестирования: XrmAbstractTest, XrmUnitTest, XrmIntegrationTest
• Исполнители запросов: Поддержка различных операций CRM (SetState, Assign, ExecuteMultiple, работа с временными зонами)
• Расширения контекста: Удобные методы для работы с IXrmFakedContext и XrmFakedPluginExecutionContext
• Сериализация контекста: Десериализация контекста выполнения плагина из XML
• Работа с общими переменными: Управление общими параметрами контекста выполнения

Установка

dotnet add package Tisa.FakeXrm.Core

Требования

• .NET 8.0, .NET 9.0 или .NET 10.0
• FakeXrmEasy (включается автоматически как зависимость)

Быстрый старт

Unit-тестирование плагина

using Tisa.FakeXrm.Core.Primitives;
using Microsoft.Xrm.Sdk;
using FakeXrmEasy.Plugins;

public class MyPluginTest : XrmUnitTest
{
    [Fact]
    public void TestPluginExecution()
    {
        // Создание тестовых данных
        var account = new Entity("account")
        {
            Id = Guid.NewGuid(),
            ["name"] = "Test Account"
        };
        Context.Initialize(account);

        // Создание контекста выполнения плагина
        var pluginContext = CreateXrmFakedPluginExecutionContext(
            messageName: "Create",
            stepStage: ProcessingStepStage.Postoperation
        );
        pluginContext.InputParameters["Target"] = account;

        // Выполнение плагина
        ExecutePlugin<MyPlugin>(pluginContext);

        // Проверка результатов
        var updatedAccount = Context.GetEntityById("account", account.Id);
        Assert.NotNull(updatedAccount);
    }
}

Интеграционное тестирование

using Tisa.FakeXrm.Core.Primitives;

public class MyIntegrationTest : XrmIntegrationTest
{
    public MyIntegrationTest() : base("MSCRM")
    {
        // Конструктор автоматически подключается к CRM
        // используя строку подключения из appsettings.json
    }

    [Fact]
    public void TestWithRealCrm()
    {
        var account = new Entity("account")
        {
            ["name"] = "Integration Test Account"
        };
        var accountId = OrganizationService.Create(account);

        Assert.NotEqual(Guid.Empty, accountId);
    }
}

Работа с контекстом

// Инициализация контекста из XML
var xmlEntities = @"<ArrayOfEntity>...</ArrayOfEntity>";
Context.Init(xmlEntities);

// Добавление сущностей с проверкой уникальности
var entity = new Entity("contact") { Id = Guid.NewGuid() };
Context.AppendEntitiy(entity);

// Работа с общими переменными
Context.SetCommonVariable(pluginContext, "MyVariable", "MyValue");
var value = Context.GetCommonVariable(pluginContext, "MyVariable");

Десериализация контекста плагина

var pluginContextXml = @"<PluginExecutionContext>...</PluginExecutionContext>";
var pluginContext = DeserializePluginExecutionContext(pluginContextXml);
ExecutePlugin<MyPlugin>(pluginContext);

Основные компоненты

Primitives

• XrmAbstractTest: Базовый абстрактный класс для тестов с общими методами создания и десериализации контекста
• XrmUnitTest: Класс для unit-тестов с использованием FakeXrmEasy
• XrmIntegrationTest: Класс для интеграционных тестов с реальным подключением к CRM

Executors

• FakeSetStateExecutor: Исполнитель для запросов SetState
• FakeAssignExecutor: Исполнитель для запросов Assign
• FakeExecuteMultipleExecutor: Исполнитель для запросов ExecuteMultiple
• FakeLocalTimeFromUtcTimeExecutor: Исполнитель для конвертации времени из UTC в локальное
• FakeUtcTimeFromLocalTimeExecutor: Исполнитель для конвертации времени из локального в UTC

Extensions

• XrmFakedContextHelper: Расширения для работы с контекстом FakeXrmEasy
• XrmFakedPluginExecutionContextHelper: Расширения для работы с контекстом выполнения плагина
• GuidExtension: Расширения для работы с Guid

Helpers

• PluginExecutionContextExtensions: Методы расширения для преобразования контекста плагина
• Serializer: Класс для сериализации и десериализации данных

Лицензия

Copyright © 2025 ТИСА. Все права защищены.

Контакты

• Веб-сайт: http://oootisa.ru
• Email: tisa@oootisa.ru