Tisa.XrmCore 2025.9.9.410

Tisa.XrmCore

Описание

Tisa.XrmCore - это библиотека для .NET, предоставляющая клиент, совместимый с WS-Trust, для подключения к локальным экземплярам IFD Dynamics 365 из .NET Core. Библиотека создана на основе Microsoft.PowerPlatform.Dataverse.Client и предлагает альтернативную реализацию IOrganizationService с использованием WS-Trust.

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

• Подключение к Dynamics 365 по URL-адресу службы организации
• Аутентификация с использованием имени пользователя и пароля
• Поддержка WS-Trust протокола
• Асинхронные операции
• Поддержка .NET 8.0 и .NET 9.0

Установка

dotnet add package Tisa.XrmCore

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

using Tisa.XrmCore;

// Создание клиента для локального подключения
var client = new OnPremiseClient(
    organizationUrl: "https://your-org.crm.dynamics.com",
    username: "your-username",
    password: "your-password"
);

// Асинхронное подключение
await client.ConnectAsync();

// Использование клиента
var response = await client.ExecuteAsync(new WhoAmIRequest());

Поддерживаемые сценарии аутентификации

Локальное подключение (On-Premise)

var client = new OnPremiseClient(
    organizationUrl: "https://your-org.crm.dynamics.com",
    username: "your-username",
    password: "your-password"
);

AD Аутентификация

var client = new ADAuthClient(
    organizationUrl: "https://your-org.crm.dynamics.com",
    domain: "your-domain",
    username: "your-username",
    password: "your-password"
);

Claims-Based Аутентификация

var client = new ClaimsBasedAuthClient(
    organizationUrl: "https://your-org.crm.dynamics.com",
    username: "your-username",
    password: "your-password"
);

Расширенные возможности

Асинхронные операции

// Создание записи
var entity = new Entity("account");
entity["name"] = "Test Account";
var createResponse = await client.CreateAsync(entity);

// Обновление записи
entity["name"] = "Updated Account";
await client.UpdateAsync(entity);

// Удаление записи
await client.DeleteAsync("account", createResponse);

Обработка ошибок

try
{
    await client.ConnectAsync();
}
catch (XrmException ex)
{
    // Обработка ошибок подключения
    Console.WriteLine($"Ошибка подключения: {ex.Message}");
}

Требования

• .NET 8.0 или .NET 9.0
• Microsoft.PowerPlatform.Dataverse.Client 1.2.3 или выше
• Microsoft.IdentityModel.Protocols.WsTrust 6.8.0 или выше

Безопасность

При использовании библиотеки убедитесь, что:

• Используются безопасные методы хранения учетных данных
• Применяются последние обновления безопасности
• Соблюдаются рекомендации по безопасности Dynamics 365

Примеры использования

Создание и обновление записей

// Создание новой записи
var account = new Entity("account");
account["name"] = "Test Company";
account["telephone1"] = "123-456-7890";
var accountId = await client.CreateAsync(account);

// Обновление записи
account["name"] = "Updated Company";
await client.UpdateAsync(account);

Выполнение запросов

// Получение записей
var query = new QueryExpression("account");
query.ColumnSet = new ColumnSet("name", "telephone1");
var results = await client.RetrieveMultipleAsync(query);

foreach (var entity in results.Entities)
{
    Console.WriteLine($"Account: {entity["name"]}, Phone: {entity["telephone1"]}");
}

Рекомендации по использованию

1. Всегда используйте асинхронные методы для операций с CRM
2. Реализуйте правильную обработку ошибок
3. Используйте пулы подключений для оптимизации производительности
4. Следите за обновлениями библиотеки
5. Регулярно проверяйте логи на наличие ошибок

Отладка

Для отладки подключения можно использовать следующие методы:

// Включение подробного логирования
client.EnableTracing = true;

// Получение последней ошибки
var lastError = client.LastError;

Известные ограничения

• Поддерживается только WS-Trust аутентификация
• Требуется доступ к URL организации
• Не поддерживается OAuth аутентификация

Авторы

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

Лицензия

MIT License

Поддержка

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