MAJ des urls pour la partie formation en fonction des spécifications techniques

openapi.yaml

@@ -134,37 +134,31 @@ paths:
   #  $ref: ./paths/demandeformation/themes.yaml
 
   #Formation
-  /formations:
+  /formation:
     $ref: ./paths/formation/formations.yaml
-  /formations/{idFormation}:
-    $ref: ./paths/formation/formationById.yaml
-  /formations/{idFormation}/update:
-    $ref: ./paths/formation/updateFormation.yaml
-  /formations/{idFormation}/supprimer:
-    $ref: ./paths/formation/supprimerFormation.yaml
-  /formations/prochaines:
-    $ref: ./paths/formation/prochainesFormations.yaml
-  /formations/realisees:
-    $ref: ./paths/formation/formationsRealisees.yaml
-  /formations/annulees:
-    $ref: ./paths/formation/formationsAnnulees.yaml
+  /formation/count:
+    $ref: ./paths/formation/formationsCount.yaml
+  /formation/{idFormation}:
+    $ref: ./paths/formation/formationId.yaml
+  
   
   #OrigineFormation
-  /originesFormation:
+  /originesformation:
     $ref: ./paths/formation/originesFormation.yaml
   
   #StatutFormation
-  /statutsFormation:
+  /statutsformation:
     $ref: ./paths/formation/statutsFormation.yaml
     
   #ModeFormation
-  /modesFormation:
+  /modesformation:
     $ref: ./paths/formation/modesFormation.yaml
     
   #TypeFormation
-  /typesFormation:
+  /typesformation:
     $ref: ./paths/formation/typesFormation.yaml
   
+
   #ParticipationFormation et évaluation
   /participations/{idCollaborateur}:
     $ref: ./paths/participationformation/participationsCollaborateur.yaml

parameters/query/dateDebut.yaml

@@ -4,5 +4,5 @@ schema:
   type: string
   format: date-time
   default: null
-description: Date permettant de filtrer par date de début
+description: Date à partir de laquelle les données son récupérées
 required: false

parameters/query/dateFin.yaml

@@ -4,5 +4,5 @@ schema:
   type: string
   format: date-time
   default: null
-description: Date permettant de filtrer par date de fin
+description: Date jusqu'à laquelle les données sont récupérées
 required: false

parameters/query/idStatuts.yaml

@@ -0,0 +1,9 @@
+in: query 
+name: idStatuts
+schema:
+  type: array
+  items: 
+    type: integer
+  default: null
+required: false
+description: liste des ids des statuts des formations à récupérer

paths/formation/formationId.yaml

@@ -0,0 +1,73 @@
+get:
+  tags:
+    - formations
+  operationId: getFormationById
+  description: Récupérer une formation par son id
+  parameters:
+    - $ref: ../../parameters/path/idFormation.yaml
+  responses:
+    '200':
+      $ref: ../../responses/formation/getFormation.yaml
+
+    '401':
+      $ref: ../../responses/erreur/unauthorized.yaml
+
+    '403':
+      $ref: ../../responses/erreur/forbidden.yaml
+
+    '404':
+      $ref: ../../responses/erreur/notFound.yaml
+
+    '500':
+      $ref: ../../responses/erreur/internalServerError.yaml
+
+put:
+  tags:
+    - formations
+  operationId: updateFormation
+  description: Mettre à jour une formation
+  parameters:
+    - $ref: ../../parameters/path/idFormation.yaml
+  requestBody:
+    $ref: ../../requestbodies/formation.yaml
+  responses:
+    '200':
+      $ref: ../../responses/formation/updateFormation.yaml
+
+    '401':
+      $ref: ../../responses/erreur/unauthorized.yaml
+
+    '403':
+      $ref: ../../responses/erreur/forbidden.yaml
+
+    '404':
+      $ref: ../../responses/erreur/notFound.yaml
+
+    '415':
+      $ref: ../../responses/erreur/unsupportedMediaType.yaml
+
+    '500':
+      $ref: ../../responses/erreur/internalServerError.yaml
+
+delete:
+  tags:
+    - formations
+  operationId: deleteFormation
+  description: Supprimer une formation
+  parameters:
+    - $ref: ../../parameters/path/idFormation.yaml
+  responses:
+    '204':
+      $ref: ../../responses/formation/formationSupprimee.yaml
+
+    '401':
+      $ref: ../../responses/erreur/unauthorized.yaml
+
+    '403':
+      $ref: ../../responses/erreur/forbidden.yaml
+
+    '404':
+      $ref: ../../responses/erreur/notFound.yaml
+
+    '500':
+      $ref: ../../responses/erreur/internalServerError.yaml

paths/formation/formationbyid.yaml

@@ -1,16 +0,0 @@
-get:
-  tags:
-    - formations
-  operationId: getFormationById
-  description: Récupérer une formation par son id
-  parameters:
-    - $ref: ../../parameters/path/idFormation.yaml
-  responses:
-    '200':
-      $ref: ../../responses/formation/getFormation.yaml
-
-    '403':
-      $ref: ../../responses/erreur/forbidden.yaml
-
-    '404':
-      $ref: ../../responses/erreur/notFound.yaml

paths/formation/formations.yaml

@@ -4,20 +4,28 @@ get:
   operationId: getFormations
   description: Récupérer la liste des formations
   parameters:
-    - $ref: ../../parameters/query/asc.yaml
     - $ref: ../../parameters/query/idAgence.yaml
+    - $ref: ../../parameters/query/idStatuts.yaml
+    - $ref: ../../parameters/query/asc.yaml
     - $ref: ../../parameters/query/numPage.yaml
     - $ref: ../../parameters/query/parPage.yaml
-    - $ref: ../../parameters/query/statutformation.yaml
     - $ref: ../../parameters/query/texte.yaml
     - $ref: ../../parameters/query/tri.yaml
+    - $ref: ../../parameters/query/dateDebut.yaml
+    - $ref: ../../parameters/query/dateFin.yaml
   responses:
     '200':
       $ref: ../../responses/formation/getListeFormations.yaml
 
+    '401':
+      $ref: ../../responses/erreur/unauthorized.yaml
+
     '403':
       $ref: ../../responses/erreur/forbidden.yaml
 
+    '500':
+      $ref: ../../responses/erreur/internalServerError.yaml
+
 post:
   tags:
     - formations
@@ -29,5 +37,14 @@ post:
     '201':
       $ref: ../../responses/formation/formationCreee.yaml
 
+    '401':
+      $ref: ../../responses/erreur/unauthorized.yaml
+
     '403':
-      $ref: ../../responses/erreur/forbidden.yaml
+      $ref: ../../responses/erreur/forbidden.yaml
+
+    '415':
+      $ref: ../../responses/erreur/unsupportedMediaType.yaml
+
+    '500':
+      $ref: ../../responses/erreur/internalServerError.yaml

paths/formation/formationsAnnulees.yaml

@@ -1,21 +0,0 @@
-get:
-  tags:
-    - formations
-  operationId: getFormationAnnulees
-  description: Récupérer les formations annulées
-  parameters:
-    - $ref: ../../parameters/query/asc.yaml
-    - $ref: ../../parameters/query/idAgence.yaml
-    - $ref: ../../parameters/query/numPage.yaml
-    - $ref: ../../parameters/query/parPage.yaml
-    - $ref: ../../parameters/query/texte.yaml
-    - $ref: ../../parameters/query/tri.yaml
-  responses:
-    '200':
-      $ref: ../../responses/formation/getListeFormations.yaml
-
-    '403':
-      $ref: ../../responses/erreur/forbidden.yaml
-
-    '404':
-      $ref: ../../responses/erreur/notFound.yaml

paths/formation/formationsCount.yaml

@@ -0,0 +1,27 @@
+get:
+  tags:
+    - formations
+  operationId: getFormationsCount
+  description: Récupérer le nombre total de formations
+  parameters:
+    - $ref: ../../parameters/query/idAgence.yaml
+    - $ref: ../../parameters/query/idStatuts.yaml
+    - $ref: ../../parameters/query/asc.yaml
+    - $ref: ../../parameters/query/numPage.yaml
+    - $ref: ../../parameters/query/parPage.yaml
+    - $ref: ../../parameters/query/texte.yaml
+    - $ref: ../../parameters/query/tri.yaml
+    - $ref: ../../parameters/query/dateDebut.yaml
+    - $ref: ../../parameters/query/dateFin.yaml
+  responses:
+    '200':
+      $ref: ../../responses/formation/getcountformation.yaml
+
+    '401':
+      $ref: ../../responses/erreur/unauthorized.yaml
+
+    '403':
+      $ref: ../../responses/erreur/forbidden.yaml
+
+    '500':
+      $ref: ../../responses/erreur/internalServerError.yaml

paths/formation/formationsRealisees.yaml

@@ -1,21 +0,0 @@
-get:
-  tags:
-    - formations
-  operationId: getFormationRealisee
-  description: Récupérer les formations réalisées
-  parameters:
-    - $ref: ../../parameters/query/asc.yaml
-    - $ref: ../../parameters/query/idAgence.yaml
-    - $ref: ../../parameters/query/numPage.yaml
-    - $ref: ../../parameters/query/parPage.yaml
-    - $ref: ../../parameters/query/texte.yaml
-    - $ref: ../../parameters/query/tri.yaml
-  responses:
-    '200':
-      $ref: ../../responses/formation/getListeFormations.yaml
-
-    '403':
-      $ref: ../../responses/erreur/forbidden.yaml
-
-    '404':
-      $ref: ../../responses/erreur/notFound.yaml

paths/formation/prochainesformations.yaml

@@ -1,21 +0,0 @@
-get:
-  tags:
-    - formations
-  operationId: getProchainesFormation
-  description: Récupérer les formations plannifié et replannifié
-  parameters:
-    - $ref: ../../parameters/query/asc.yaml
-    - $ref: ../../parameters/query/idAgence.yaml
-    - $ref: ../../parameters/query/numPage.yaml
-    - $ref: ../../parameters/query/parPage.yaml
-    - $ref: ../../parameters/query/texte.yaml
-    - $ref: ../../parameters/query/tri.yaml
-  responses:
-    '200':
-      $ref: ../../responses/formation/getListeFormations.yaml
-
-    '403':
-      $ref: ../../responses/erreur/forbidden.yaml
-
-    '404':
-      $ref: ../../responses/erreur/notFound.yaml

paths/formation/supprimerFormation.yaml

@@ -1,13 +0,0 @@
-delete:
-  tags:
-    - formations
-  operationId: deleteFormation
-  description: Supprimer une formation
-  parameters:
-    - $ref: ../../parameters/path/idFormation.yaml
-  responses:
-    '204':
-      $ref: ../../responses/formation/formationSupprimee.yaml
-
-    '403':
-      $ref: ../../responses/erreur/forbidden.yaml

paths/formation/updateFormation.yaml

@@ -1,18 +0,0 @@
-put:
-  tags:
-    - formations
-  operationId: updateFormation
-  description: Mettre à jour une formation
-  parameters:
-    - $ref: ../../parameters/path/idFormation.yaml
-  requestBody:
-    $ref: ../../requestbodies/formation.yaml
-  responses:
-    '200':
-      $ref: ../../responses/formation/updateFormation.yaml
-
-    '201':
-      $ref: ../../responses/formation/formationCreee.yaml
-
-    '403':
-      $ref: ../../responses/erreur/forbidden.yaml

responses/formation/getcountformation.yaml

@@ -0,0 +1,7 @@
+description: OK
+content:
+  application/json:
+    schema:
+      type: integer
+      format: int64
+      description: Nombre total de formations