Ajout du statut UNPUBLISHED pour les offres + Évolutions de l’API d’Extraction + Corrections de bugs sur l’entrepôt
Modifié le
Ajout du statut UNPUBLISHED pour les offres, evolutions de l’API d’Extraction, ajout de filtres sur la route du catalogue des organisations, modification du retour lors de la création d’un accès à une clé, corrections de bugs de l’entrepôt
Changements #
Ajout du statut UNPUBLISHED pour les offres #
Afin de gérer la désactivation de couches sans les supprimer (pour en garder l’ID, les permissions et les statistiques), on ajoute un statut UNPUBLISHED aux offres. Ce statut implique les nouveaux comportement suivants :
- DELETE sur une offre en statut
PUBLISHED: l’offre passe enUNPUBLISHINGpuis enUNPUBLISHEDune fois la dépublication terminé. À ce moment, l’offre n’est plus accessible (absent de la réponse auGetCapabilitiespar exemple) mais n’est pas encore supprimé de l’entrepôt - Si on fait un PUT sur une offre
UNPUBLISHED, l’offre passe enPUBLISHINGpuis enPUBLISHEDune fois la publication terminée. L’offre est de nouveau disponible comme après une publication classique - Si on fait de nouveau un DELETE sur une offre
UNPUBLISHED, l’offre est supprimée avec toutes ses dépendances (accès et permission)
Ainsi, si on souhaite supprimer une offre, il faudra faire 2 DELETE successifs sur celle-ci. De même pour supprimer une configuration, il faudra bien faire 2 DELETE sur son offre avant de pouvoir supprimer la configuration.
De plus, il sera impossible de créer une nouvelle offre sur un endpoint s’il existe déjà une autre offre en UNPUBLISHED pour la même configuration sur cet endpoint.
Evolutions sur l’API d’Extraction #
- Ajout d’un
jobNamedans les jobs d’extraction : ce champ permettra de donner un nom personnalisable au job. Pour la routePOST /extraction/processes/{processID}/execution, il est possible de définir cejobNamedans la partieoutput. Ce qui donne cet exemple type de body :
{
"inputs":{
"compression":"7zip",
"relations":{
"region":{
"attributes":[
"code",
"nom",
"code_insee"
],
"filters":"WHERE nom IN (’Île-de-France’, ’Auvergne-Rhône-Alpes’, ’Provence-Alpes-Côte d’Azur’)"
},
"commune":{
"attributes":[
"code",
"nom_com",
"code_insee"
],
"filters":"WHERE code_insee == ’75013’"
}
},
"srs":"EPSG:4326",
"format":"PARQUET",
"append":true,
"retentionDuration":24
},
"outputs":{
"logs":{
},
"summary":{
},
"extractedData":{
},
"jobName": "Nom personnalisé",
}
}
- Ajout d’une route de restitution des paramètres d’execution d’un job :
GET /extraction/jobs/{job}/inputs. Cette route restitue la totalité des inputs utilisé lors de la création du job avec la routePOST /extraction/processes/{processID}/execution. L’objectif est de permettre aux consommateurs de l’API de retrouver les paramètres exacts ayant servi à générer une extraction sans avoir à les conserver côté client. Cela faciliterait la duplication et ou modification d’un ancien paramétrage pour recréer une nouvelle extraction.
Ajout de filtres sur la route du catalogue des organisations #
Pour la route GET /catalogs/organizations, ces filtres ont été ajoutés :
- name
- siren
- siret
- tva_intracom
Modification du retour lors de la création d’un accès à une clé #
Lorsque l’on fait la requête POST /users/me/keys/{id}/accesses, nous avons un actuellement un retour vide en 204.
Le retour va être modifié et sera un JSON de description de l’accès créé (la réponse sera du même type que la route GET /users/me/keys/{keys}/accesses/{access}).
Corrections de bugs #
- [Entrepôt] Correction de la lenteur parfois observée sur les requêtes
GET /datastores/{datastore} - [Entrepôt] Correction d’un bug à la récupération des logs de vérification lorsque ceux-ci faisaient plus de 2 Mo
- [Entrepôt] Correction d’un bug lors de l’utilisation du
created_bypour la requêteGET /datastores/{datastore}/processings/executions/{execution}dans le Swagger. Cela renvoyait une réponse vide. - [Entrepôt] Correction des valeurs d’utilisation des endpoints affiché dans la description d’un datastore qui pouvait être incohérentes
- [Entrepôt] Correction d’un bug où la modification d’un document personnel avec la requête
PUT users/me/documents/{id_document}ne modifiait pas systématiquement le fichier - [Entrepôt] Correction d’une erreur lors de l’utilisation du paramètre
fieldsavec le fitremetadatasur les requêtesGET datastores/{datastore}/configurations