Téléversement d’une métadonnée

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 : gmd: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 XML - 28.4 Ko

metadonnee_produit.xml XML - 29.7 Ko

📄 <metadonnee_lot.xml>

https://data.geopf.fr/api/datastores/{datastore}/metadata

{
    "type": "ISOAP",
    "open_data": false,
    "level": "DATASET",
    "file_identifier": "IGNF_RGEALTIr_2-0_ASC_5M_LAMB93_IGN69_D074.xml",
    "tags": {},
    "endpoints": [],
    "_id": "{metadata}"
}

Notez que :

• Pour que la métadonnée soit intégrée dans le catalogue INSPIRE, il suffit de l’indiquer dans l’attribut type ("type": "INSPIRE"). Elle sera alors moissonnée par le Géocatalogue.
• Pour que la métadonnée soit moissonnée par le site data.gouv.fr, il suffit de l’indiquer dans l’attribut open_data ("open_data": true).

À ce stade, elle n’est accessible que par l’API Entrepôt, aux membres de la communauté, via son identifiant. L’étape suivante est la publication d’une métadonnée.

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 propagée au niveau des catalogues.

📄 <metadonnee_lot.xml>

https://data.geopf.fr/api/datastores/{datastore}/metadata/{metadata}

{
    "type": "ISOAP",
    "level": "DATASET",
    "file_identifier": "IGNF_RGEALTIr_2-0_ASC_5M_LAMB93_IGN69_D074.xml",
    "endpoints": [],
    "_id": "{metadata}"
}

Modification des attributs d’une métadonnée #

Il est possible de modifier les attributs (type et open_data) d’une métadonnée déjà existante.

https://data.geopf.fr/api/datastores/{datastore}/metadata/{metadata}

{
    "type": "INSPIRE",
    "open_data": true
}

{
    "type": "INSPIRE",
    "open_data": true,
    "level": "DATASET",
    "file_identifier": "IGNF_RGEALTIr_2-0_ASC_5M_LAMB93_IGN69_D074.xml",
    "tags": {},
    "endpoints": [],
    "_id": "{metadata}"
}

La métadonnée doit être republiée par la suite afin de répercuter les modifications au niveau des services de catalogage.