Les métadonnées
Les métadonnées sont des entités indépendantes, permettant à l'utilisateur d'alimenter un catalogue de référencement des données, d'en gérer la diffusion via son état de publication. Une métadonnée correspond à un fichier XML, accompagné de son type. Le niveau (lot ou produit) et le fileIdentifier sont extraits du fichier au moment du téléversement.
D'un point de vue modèle, une metadata appartient à un datastore.
Téléverser une nouvelle métadonnée
Créer une nouvelle annexe se fait via l'appel à POST /datastores/{id}/metadata, en mettant dans le corps de la requête le fichier à téléverser, et en précisant en paramètres le type. Cela a pour effet de créer une entité metadata. Les informations de niveau et de fileIdentifier sont extraits et le fichier est transmis au catalogue GeoNetwork. La métadonnée n'est pas publiée à son téléversement.
Téléversement d'une métadonnée existante
Il est possible de modifier le fichier correspondant à la métadonnée, via l'API PUT /datastores/{id}/metadata/{id}. Le fichier téléversé va alors écraser l'ancien, au niveau des services de catalogage. Le fileIdentifier ne peut pas changer. Il est impossible de modifier le type ou le statut de publication.
Modification des informations de l'annexe
L'état de publication d'une annexe peuvent être modifiés via l'API PATCH /datastores/{id}/metadata/{id}.
Publication ou dépublication massive
Il est possible de modifier l'état de publication de plusieurs métadonnées en un seul appel, en filtrant sur les fileIdentifier :
POST /datastores/{id}/metadata/publication: Publie toutes les métadonnées ayant le fileIdentifier fournis dans le corps de la requêtePOST /datastores/{id}/metadata/unpublication: Dépublie toutes les métadonnées ayant le fileIdentifier fournis dans le corps de la requête
Publier revenant à passer l'état de publication à true, dépublier revenant à passer l'état de publication à false. Ce nouvel état de publication est répercuté au niveau des services de catalogage.
Suppression d'une métadonnée
Une métadonnée peut à tout moment être supprimée via l'API DELETE /datastores/{id}/metadata/{id} si elle est dépubliée.
Parcours des annexes
Récupérer une liste de métadonnées
L'API GET /datastores/{id}/metadata permet de récupérer l'ensemble des métadonnées (avec pagination) disponibles dans l'entrepôt. Pour cibler plus précisément les métadonnées voulues, plusieurs filtres, qui se cumulent, sont possibles :
file_identifier=string: fileIdentifier, avec joker possibletype=string: le type de métadonnéelevel=string: lot ou produit
Voir les informations d'une métadonnée
Pour obtenir toutes les informations disponibles sur une métadonnée, on utilise l'API GET /datastores/{id}/metadata/{id}. Il faut que l'entrepôt soit le propriétaire de la métadonnée.