/* * API du serveur de l'application de digitalisation des EP * * API qui sra utilisée afin de faire communiquer le client et le serveur ainsi que le serveur et la boîte noire. * * OpenAPI spec version: 1.3.6 * * Generated by: https://github.com/swagger-api/swagger-codegen.git */ using System; using System.Collections.Generic; using Microsoft.AspNetCore.Mvc; using Swashbuckle.AspNetCore.Annotations; using Swashbuckle.AspNetCore.SwaggerGen; using Newtonsoft.Json; using System.ComponentModel.DataAnnotations; using IO.Swagger.Attributes; using IO.Swagger.Security; using Microsoft.AspNetCore.Authorization; using IO.Swagger.DTO; using IO.Swagger.Enum; using EPAServeur.Attributes; using EPAServeur.IServices; using Microsoft.Extensions.Logging; using Microsoft.AspNetCore.Hosting; using Microsoft.Extensions.Hosting; using Microsoft.AspNetCore.Http; using System.Threading.Tasks; using EPAServeur.Exceptions; using Microsoft.EntityFrameworkCore; using Microsoft.AspNetCore.Authentication.JwtBearer; namespace IO.Swagger.Controllers { /// /// /// [ApiController] public class EngagementsApiController : ControllerBase { private readonly IEngagementService engagementService; private readonly ILogger logger; private readonly IWebHostEnvironment env; public EngagementsApiController(IEngagementService _engagementService, ILogger _logger, IWebHostEnvironment _env) { engagementService = _engagementService; logger = _logger; env = _env; } /// /// /// /// Récupérer la liste des engagements. /// liste des ids des BU auxquelles les données sont rattachées /// Etats de l'engagement /// Indique si les données sont récupérées dans l'ordre croissant ou non /// Numéro de la page du tableau à afficher /// Nombre d’élément maximum à afficher dans le tableau /// Texte permettant de filtrer les données /// Colonne du tableau sur lequel le tri devra être effectué /// OK /// L'utilisateur souhaitant accéder à la ressource n'est pas authentifié /// L’utilisateur souhaitant accéder à la ressource n’a pas les droits d’accès suffisants /// Une erreur est survenue sur le serveur [HttpGet] [Route("/api/engagements")] [Authorize(AuthenticationSchemes = JwtBearerDefaults.AuthenticationScheme, Roles = "RH")] [ValidateModelState] [SwaggerOperation("GetEngagements")] [SwaggerResponse(statusCode: 200, type: typeof(List), description: "OK")] [SwaggerResponse(statusCode: 401, type: typeof(ErreurDTO), description: "L'utilisateur souhaitant accéder à la ressource n'est pas authentifié")] [SwaggerResponse(statusCode: 403, type: typeof(ErreurDTO), description: "L’utilisateur souhaitant accéder à la ressource n’a pas les droits d’accès suffisants")] [SwaggerResponse(statusCode: 500, type: typeof(ErreurDTO), description: "Une erreur est survenue sur le serveur")] public virtual async Task GetEngagements([FromQuery][CannotBeEmpty] List idBUs, [FromQuery]List etatsEngagement, [FromQuery]bool? asc, [FromQuery]int? numPage, [FromQuery][Range(5, 100)]int? parPAge, [FromQuery]string texte, [FromQuery]string tri) { if (env.IsDevelopment()) logger.LogInformation("Récupération de la liste des engagements."); IEnumerable engagements; try { engagements = await engagementService.GetEngagementsAsync(idBUs, etatsEngagement, asc, numPage, parPAge, texte, tri); } catch (Exception e) { logger.LogError(e.Message); ErreurDTO erreur = new ErreurDTO() { Code = StatusCodes.Status500InternalServerError, Message = "Une erreur inconnue est survenue sur le serveur." }; return StatusCode(erreur.Code.Value, erreur); } if (env.IsDevelopment()) logger.LogInformation("Liste des engagements récupérée."); return Ok(engagements); } /// /// /// /// Récupérer le nombre total d’engagements. /// liste des ids des BU auxquelles les données sont rattachées /// Etats de l'engagement /// Indique si les données sont récupérées dans l'ordre croissant ou non /// Numéro de la page du tableau à afficher /// Nombre d’élément maximum à afficher dans le tableau /// Texte permettant de filtrer les données /// Colonne du tableau sur lequel le tri devra être effectué /// OK /// L'utilisateur souhaitant accéder à la ressource n'est pas authentifié /// L’utilisateur souhaitant accéder à la ressource n’a pas les droits d’accès suffisants /// Une erreur est survenue sur le serveur [HttpGet] [Route("/api/engagements/count")] [Authorize(AuthenticationSchemes = JwtBearerDefaults.AuthenticationScheme, Roles = "RH")] [ValidateModelState] [SwaggerOperation("GetEngagementsCount")] [SwaggerResponse(statusCode: 200, type: typeof(long?), description: "OK")] [SwaggerResponse(statusCode: 401, type: typeof(ErreurDTO), description: "L'utilisateur souhaitant accéder à la ressource n'est pas authentifié")] [SwaggerResponse(statusCode: 403, type: typeof(ErreurDTO), description: "L’utilisateur souhaitant accéder à la ressource n’a pas les droits d’accès suffisants")] [SwaggerResponse(statusCode: 500, type: typeof(ErreurDTO), description: "Une erreur est survenue sur le serveur")] public virtual async Task GetEngagementsCount([FromQuery][CannotBeEmpty]List idBUs, [FromQuery]List etatsEngagement, [FromQuery]bool? asc, [FromQuery]int? numPage, [FromQuery][Range(5, 100)]int? parPAge, [FromQuery]string texte, [FromQuery]string tri) { if (env.IsDevelopment()) logger.LogInformation("Récupération du nombre total d'engagements."); long count; try { count = await engagementService.GetEngagementsCountAsync(idBUs, etatsEngagement, asc, numPage, parPAge, texte, tri); } catch (Exception e) { logger.LogError(e.Message); ErreurDTO erreur = new ErreurDTO() { Code = StatusCodes.Status500InternalServerError, Message = "Une erreur inconnue est survenue sur le serveur." }; return StatusCode(erreur.Code.Value, erreur); } if (env.IsDevelopment()) logger.LogInformation("Nombre total d'engagement récupéré."); return Ok(count); } /// /// /// /// Répondre à un engagement. /// /// Id d'un engagement /// Engagement modifié avec succès /// L'utilisateur souhaitant accéder à la ressource n'est pas authentifié /// L’utilisateur souhaitant accéder à la ressource n’a pas les droits d’accès suffisants /// La ressource n'a pas été trouvée /// L’opération ne peut pas être effectuée car certaines données sont manquantes /// Une erreur est survenue sur le serveur [HttpPut] [Route("/api/engagements/{idEngagement}")] [Authorize(AuthenticationSchemes = JwtBearerDefaults.AuthenticationScheme, Roles = "RH")] [ValidateModelState] [SwaggerOperation("UpdateEngagement")] [SwaggerResponse(statusCode: 200, type: typeof(EngagementDTO), description: "Engagement modifié avec succès")] [SwaggerResponse(statusCode: 401, type: typeof(ErreurDTO), description: "L'utilisateur souhaitant accéder à la ressource n'est pas authentifié")] [SwaggerResponse(statusCode: 403, type: typeof(ErreurDTO), description: "L’utilisateur souhaitant accéder à la ressource n’a pas les droits d’accès suffisants")] [SwaggerResponse(statusCode: 404, type: typeof(ErreurDTO), description: "La ressource n'a pas été trouvée")] [SwaggerResponse(statusCode: 415, type: typeof(ErreurDTO), description: "L’opération ne peut pas être effectuée car certaines données sont manquantes")] [SwaggerResponse(statusCode: 500, type: typeof(ErreurDTO), description: "Une erreur est survenue sur le serveur")] public virtual async Task UpdateEngagement([FromBody]EngagementDTO body, [FromRoute][Required]long idEngagement) { if (env.IsDevelopment()) logger.LogInformation("Mise à jour de l'engagement d'id {idEngagement}.", idEngagement); try { body = await engagementService.RepondreEngagementAsync(body, idEngagement); } catch (EngagementInvalidException e) { if (env.IsDevelopment()) logger.LogInformation(e.Message); ErreurDTO erreur = new ErreurDTO() { Code = StatusCodes.Status415UnsupportedMediaType, Message = e.Message, }; return StatusCode(erreur.Code.Value, erreur.Message); } catch (EngagementIncompatibleIdException e) { if (env.IsDevelopment()) logger.LogInformation(e.Message); ErreurDTO erreur = new ErreurDTO() { Code = StatusCodes.Status415UnsupportedMediaType, Message = e.Message, }; return StatusCode(erreur.Code.Value, erreur.Message); } catch (EngagementNotFoundException e) { if (env.IsDevelopment()) logger.LogInformation(e.Message); ErreurDTO erreur = new ErreurDTO() { Code = StatusCodes.Status404NotFound, Message = e.Message }; return NotFound(erreur); } catch (DbUpdateConcurrencyException e) { logger.LogError(e.Message); ErreurDTO erreur = new ErreurDTO() { Code = StatusCodes.Status500InternalServerError, Message = string.Format("L'engagement {0} n'a pas pu être supprimé car il est pris par une autre ressource.", idEngagement) }; return StatusCode(erreur.Code.Value, erreur); } catch (DbUpdateException e) { logger.LogError(e.Message); ErreurDTO erreur = new ErreurDTO() { Code = StatusCodes.Status500InternalServerError, Message = "Une erreur est survenue sur le serveur lors de la suppression de l'engagement." }; return StatusCode(erreur.Code.Value, erreur); } catch (Exception e) { logger.LogError(e.Message); ErreurDTO erreur = new ErreurDTO() { Code = StatusCodes.Status500InternalServerError, Message = "Une erreur inconnue est survenue sur le serveur." }; return StatusCode(erreur.Code.Value, erreur); } if (env.IsDevelopment()) logger.LogInformation("Update effectué avec succès."); return Ok(body); } } }