Reo.Core.DataImport 10.0.210

Reo.Core.DataImport

Описание пакета

Reo.Core.DataImport — это библиотека для импорта данных из файлов Excel и CSV с поддержкой валидации, обработки бизнес-логики и интеграции с контейнером зависимостей (DI). Пакет решает задачи автоматизации импорта данных, обеспечивая гибкую настройку структуры файлов, проверку обязательных полей и интеграцию с бизнес-процессами. Основные функции:

• Поддержка форматов XLSX и CSV.
• Валидация данных с использованием FluentValidation.
• Настройка отображения колонок файлов на свойства моделей.
• Обработка ошибок импорта и генерация отчетов.

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

1. IPrepareDataImportService<TView>

Интерфейс для подготовки данных из файла. Реализует логику чтения, валидации и преобразования данных в объекты модели.

2. IViewDefinitionService<TView>

Сервис для определения структуры данных, отображающий колонки файла на свойства модели. Использует CellDefinition для описания обязательных полей и заголовков.

3. CellDefinition

Класс, описывающий ячейку файла: имя заголовка и флаг обязательности. Используется для проверки заполнения полей.

4. BaseDataImportView

Базовый класс для моделей данных, содержащий методы валидации и обработки ошибок.

5. ServiceCollectionExtensions

Методы расширения для регистрации сервисов в DI-контейнере (например, AddReoDataImport).

Требования

• .NET: Совместим с .NET Standard 2.0 и выше (включая .NET 5+ и .NET Core 3.1).
• Зависимости:
  • FluentValidation для валидации.
  • EPPlus для работы с XLSX-файлами.
  • CsvHelper для обработки CSV.

Установка

Используйте следующие команды для установки через NuGet:

Install-Package Reo.Core.DataImport

или

dotnet add package Reo.Core.DataImport

Настройка

Регистрация в ASP.NET Core

Добавьте сервисы в 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
}

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

Пример 1: Подготовка данных из файла

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));
}

Пример 2: Валидация модели

public class MyValidator : AbstractValidator<MyDataView>
{
 public MyValidator()
 {
 RuleFor(x => x.Name).NotEmpty().WithMessage("Имя не может быть пустым.");
 RuleFor(x => x.Email).EmailAddress().WithMessage("Неверный формат email.");
 }
}

Пример 3: Обработка бизнес-логики

public class MyBusinessHandleService : IBusinessHandleService<MyDataView, Guid>
{
 public Task HandleAsync(MyDataView data, Guid id)
 {
 // Реализуйте логику сохранения данных в БД или другую систему.
 return Task.CompletedTask;
 }
}

Лицензия

Данный пакет распространяется под лицензией MIT.