gorbenko.pavel
24d2cd7a6a
GET api/reports/vacancies?from=&to= отдаёт лист «Список вакансий (все)» по образцу ручного отчёта HR: те же шестнадцать колонок, разделители по объектам, двойная нумерация, итоги формулами. Данные — из двух форм портала: «Заявка на подбор» даёт вакансию, «Приём на работу» — её закрытие (связь по SelectionRequestId + SelectionRequestListId). Рекрутёр и дата закрытия берутся из фазы «Исполнение» парного списка «— согласование»: в самой заявке их нет. Период отбирает заявки по «Дате подачи заявки» с откатом на Created — поле заполняется руками и часто пустое. Заявки на приём периодом не ограничены: приём по вакансии из начала интервала мог оформляться уже после его конца. Колонка «Комментарии» остаётся пустой — в ручном отчёте это пометки рекрутёра, которым в заявках пока негде храниться. Генерация — ClosedXML (MIT): нужны стили, формулы и autofilter, а EPPlus с v5 под Polyform Noncommercial. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
55 lines
2.6 KiB
C#
55 lines
2.6 KiB
C#
using System.Globalization;
|
||
using Microsoft.AspNetCore.Authorization;
|
||
using Microsoft.AspNetCore.Mvc;
|
||
using Microsoft.Net.Http.Headers;
|
||
using Tnsu.ApprovalRoute.Api.Auth;
|
||
using Tnsu.ApprovalRoute.Application.Reports;
|
||
|
||
namespace Tnsu.ApprovalRoute.Api.Controllers;
|
||
|
||
/// <summary>
|
||
/// Выгрузки отчётов файлами. В отличие от остальных контроллеров отдаёт не
|
||
/// ApiResponse, а сам файл: получатель — кнопка «скачать» в портале и Power
|
||
/// Automate, обоим нужен готовый xlsx, а не JSON с телом в base64.
|
||
/// </summary>
|
||
[ApiController]
|
||
[Authorize(Policy = AuthPolicies.Any)]
|
||
[Route("api/reports")]
|
||
public sealed class ReportsController(VacancyReportService vacancies) : ControllerBase
|
||
{
|
||
private const string XlsxContentType =
|
||
"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
|
||
|
||
/// <summary>
|
||
/// Отчёт по вакансиям за период — лист «Список вакансий (все)» по данным
|
||
/// заявок на подбор и на приём.
|
||
///
|
||
/// Период отбирает заявки по «Дате подачи заявки» (колонка H отчёта). Заявки
|
||
/// на приём периодом НЕ ограничены: у вакансии, поданной в начале интервала,
|
||
/// приём мог оформляться уже после его конца.
|
||
/// </summary>
|
||
[HttpGet("vacancies")]
|
||
[Produces(XlsxContentType)]
|
||
[ProducesResponseType(StatusCodes.Status200OK)]
|
||
[ProducesResponseType(StatusCodes.Status400BadRequest)]
|
||
public async Task<IActionResult> Vacancies(
|
||
[FromQuery] DateOnly from, [FromQuery] DateOnly to, CancellationToken ct = default)
|
||
{
|
||
var result = await vacancies.GetAsync(from, to, ct);
|
||
if (result.IsFailed)
|
||
return BadRequest(new { errors = result.Errors.Select(e => e.Message) });
|
||
|
||
var report = result.Value;
|
||
var file = VacancyReportWorkbook.Build(report);
|
||
|
||
// Имя файла с кириллицей и пробелами — через ContentDispositionHeaderValue:
|
||
// он сам добавит filename* в RFC 5987, иначе браузер сохранит файл
|
||
// с искажённым именем.
|
||
var disposition = new ContentDispositionHeaderValue("attachment");
|
||
disposition.SetHttpFileName(VacancyReportWorkbook.FileName(report));
|
||
Response.Headers.ContentDisposition = disposition.ToString();
|
||
|
||
return File(file, XlsxContentType);
|
||
}
|
||
}
|