Aller au contenu

Téléversement des métadonnées

Les métadonnées permettent de décrire les données diffusées sur la plateforme : la source, la date et la méthode d'acquisition... Ces fichiers au format XML peuvent se référencer les uns les autres à l'aide d'un identifiant unique au sein de la plateforme : le file identifier. Deux "niveaux" de métadonnées sont gérées par l'utilisateur de l'entrepôt : la métadonnée de lot (dataset) et la métadonnée de produit (serie). Les métadonnées de services sont assumées par le gestionnaire de la plateforme.

Téléversement d'une nouvelle métadonnée

Le fichier de métadonnée :

  • doit être un fichier XML valide
  • doit avoir son file identifier défini au xpath : gmd:MD_Metadata / gmd:fileIdentifier / gco:CharacterString : si celui ci est déjà pris sur la plateforme, une erreur sera remontée
  • peut avoir son niveau défini au xpath : md:MD_Metadata / gmd:hierarchyLevel / gmd:MD_ScopeCode (valeur dataset ou series). S'il n'est pas défini, la métadonnée sera considérée comme étant de lot.

Exemple :

<metadonnee_lot.xml>

/datastores/{datastore}/metadata
  • file = <metadonnee_lot.xml>
  • type = ISOAP (non obligatoire, ISOAP par défaut, valeurs possibles : ISOAP, INSPIRE)
{
    "type": "ISOAP",
    "level": "DATASET",
    "file_identifier": "IGNF_RGEALTIr_2-0_ASC_5M_LAMB93_IGN69_D074.xml",
    "endpoints": [],
    "_id": "{metadata}"
}

À ce stade, elle n'est accessible que par l'API Entrepôt, aux membres de la communauté, via son identifiant.

Modification d'une métadonnée

Il est possible de modifier le fichier XML correspondant à une métadonnée. Le file identifier ne doit pas changer, et si la métadonnée est déjà publiée, la modification est reportée au niveau des catalogues.

<metadonnee_lot.xml>

/datastores/{datastore}/metadata/{metadata}
  • file = <metadonnee_lot.xml>
{
    "type": "ISOAP",
    "level": "DATASET",
    "file_identifier": "IGNF_RGEALTIr_2-0_ASC_5M_LAMB93_IGN69_D074.xml",
    "endpoints": [],
    "_id": "{metadata}"
}