Package Description
$ dotnet add package Reo.Core.DataImportReo.Core.DataImport — это библиотека для импорта данных из файлов Excel и CSV с поддержкой валидации, обработки
бизнес-логики и интеграции с контейнером зависимостей (DI). Пакет решает задачи автоматизации импорта данных,
обеспечивая гибкую настройку структуры файлов, проверку обязательных полей и интеграцию с бизнес-процессами. Основные
функции:
Интерфейс для подготовки данных из файла. Реализует логику чтения, валидации и преобразования данных в объекты модели.
Сервис для определения структуры данных, отображающий колонки файла на свойства модели. Использует CellDefinition для
описания обязательных полей и заголовков.
Класс, описывающий ячейку файла: имя заголовка и флаг обязательности. Используется для проверки заполнения полей.
Базовый класс для моделей данных, содержащий методы валидации и обработки ошибок.
Методы расширения для регистрации сервисов в DI-контейнере (например, AddReoDataImport).
Используйте следующие команды для установки через NuGet:
Install-Package Reo.Core.DataImport
или
dotnet add package Reo.Core.DataImport
Добавьте сервисы в Startup.cs или Program.cs:
services.AddReoDataImport<MyDataView, Guid, MyViewDefinitionService, MyBusinessHandleService, MyValidator, MyPostImportHandler>(configuration);
Где:
MyDataView — модель данных, наследующая BaseDataImportView.MyViewDefinitionService — реализация IViewDefinitionService<MyDataView>.MyValidator — валидатор, реализующий IValidator<MyDataView>.Если требуется настраивать поведение импорта (например, путь к шаблонам файлов), добавьте параметры в
appsettings.json:
"ReoDataImport": {
"TemplatePath": "Templates/",
"MaxRowsPerFile": 10000
}var prepareService = serviceProvider.GetRequiredService<IPrepareDataImportService<MyDataView>>();
var result = prepareService.Prepare("path/to/file.xlsx");
if (result.IsValid)
{
Console.WriteLine("Данные успешно загружены: " + result.Data.Count + " записей.");
}
else
{
Console.WriteLine("Ошибка: " + string.Join(", ", result.Errors));
}public class MyValidator : AbstractValidator<MyDataView>
{
public MyValidator()
{
RuleFor(x => x.Name).NotEmpty().WithMessage("Имя не может быть пустым.");
RuleFor(x => x.Email).EmailAddress().WithMessage("Неверный формат email.");
}
}public class MyBusinessHandleService : IBusinessHandleService<MyDataView, Guid>
{
public Task HandleAsync(MyDataView data, Guid id)
{
// Реализуйте логику сохранения данных в БД или другую систему.
return Task.CompletedTask;
}
}