Merge branch 'description_api_chargement_donnees_entree' into 'develop'

[SOY]Description api chargement donnees entree

See merge request !6

CHANGELOG.md

@@ -4,6 +4,7 @@ Tous les changements de ce projet seront documentés dans ce document.
 
 ## [Non livré]
 - Intégrer des nouveaux impacts au référentiel -> [Issue1](https://gitlab-forge.din.developpement-durable.gouv.fr/pub/numeco/m4g/numecoeval/-/issues/1)
+- Defect: Mauvaise description de l'API de chargement des données d'entrées
 - Mise à jour de Java 17 vers 21 et des dépendances
 - Defect: Libellé erreur erroné quand donnée de référence manquante
 - Ajout du mode d'utilisation et taux d'utilisation

services/api-expositiondonneesentrees/src/main/resources/static/openapi.yaml

@@ -168,15 +168,25 @@ paths:
         - Imports
       summary: Soumission de données d'entrées au format CSV pour calcul d'indicateurs
       description: |
-        Endpoint de soumission des données d'entrées au format CSV pour le calcul d'indicateurs. \
-        La taille totale de tous les fichiers ne doit pas dépasser 10 Mo. \
-        Le séparateur des fichiers CSV est le point-virgule (;). \
-        Le Header du CSV des data centers est : nomCourtDatacenter;nomLongDatacenter;pue;localisation;nomSourceDonnee \
-        Le Header du CSV des équipements physiques est : modele;quantite;nomEquipementPhysique;type;statut;paysDUtilisation;utilisateur;dateAchat;dateRetrait;nbCoeur;nomCourtDatacenter;goTelecharge;modeUtilisation;tauxUtilisation;nbJourUtiliseAn;consoElecAnnuelle;nomSourceDonnee \
-        Le Header du CSV des équipements virtuels est : nomEquipementVirtuel;nomEquipementPhysique;vCPU;cluster;nomSourceDonnee;nomSourceEquipementPhysique;consoElecAnnuelle;typeEqv;capaciteStockage;cleRepartition \
-        Le Header du CSV des application est : nomApplication;typeEnvironnement;nomEquipementVirtuel;nomEquipementPhysique;domaine;sousDomaine;nomSourceDonnee;typeEqv;nomSourceEquipementVirtuel;capaciteStockage;cleRepartition \
-        Le Header du CSV de la messagerie est : nombreMailEmis;nombreMailEmisXDestinataires;volumeTotalMailEmis;MoisAnnee;nomSourceDonnee \
-        Le Header du CSV des entités est : nomEntite;nbCollaborateurs;responsableEntite;responsableNumeriqueResponsable;nomSourceDonnee
+        Endpoint de soumission des données d'entrées au format CSV pour le calcul d'indicateurs.  
+        
+        La taille totale de tous les fichiers ne doit pas dépasser 10 Mo. <br/>
+        
+        Le séparateur des fichiers CSV est le point-virgule (;).  <br/>
+        
+        Les colonnes facultatives sont notées entre parenthèses, toutes les autres sont obligatoires !  <br/>
+        
+        Le Header du CSV des data centers est : nomCourtDatacenter;nomLongDatacenter;pue;localisation;(nomEntite).  <br/> 
+        
+        Le Header du CSV des équipements physiques est : nomEquipementPhysique,modele;quantite;nomCourtDatacenter;dateAchat;dateRetrait;type;statut;paysDUtilisation;consoElecAnnuelle;utilisateur;(nomSourceDonnee);(nomEntite);nbCoeur;nbJourUtiliseAn;goTelecharge;(modeUtilisation);(tauxUtilisation).  <br/>
+        
+        Le Header du CSV des équipements virtuels est : nomEquipementVirtuel;nomEquipementPhysique;(nomSourceDonneeEquipementPhysique);(cleRepartition);vCPU;cluster;(consoElecAnnuelle);(typeEqv);(capaciteStockage);(nomEntite).  <br/>
+        
+        Le Header du CSV des application est : nomApplication;typeEnvironnement;(nomEquipementVirtuel);(nomSourceEquipementVirtuel);domaine;sousDomaine;(nomEntite);nomEquipementPhysique;(nomSourceDonnee).  <br/>
+        
+        Le Header du CSV de la messagerie est : nombreMailEmis;nombreMailEmisXDestinataires;volumeTotalMailEmis;MoisAnnee;(nomEntite).  <br/>
+        
+        Le Header du CSV des entités est : nomEntite;nbCollaborateurs;responsableEntite;responsableNumeriqueResponsable.  
 
       operationId: importCSV
       requestBody: