Accueil > Exports

Exports

Il est possible d'exporter tout le corpus de ce site, ou des parties, ou notice par notice, selon plusieurs modalités (téléchargement, RSS, OAI-PMH, API) et formats (tsv, csv, atom, dcmes-xml, json, omeka-xml) à partir de son identifiant.

Remarque : si vous souhaitez utiliser les formats ".csv" et ".tsv", veuillez prendre contact avec l'administrateur du site via la page de contact

L'export de métadonnées publiques est possible aux formats Atom, dcmes-xml, json et omeka-xml.

Quelques exemples d'exports au niveau d'un item (exemple : item n° 3672) :

--------

Abonnements au Flux RSS

Il s’agit d’un abonnement aux mises à jour de la plateforme Omeka qui est pris en charge par un agrégateur (Tiny Tiny RSS par exemple), ou une application dédiée comme la messagerie web (Outlook, Zimbra, etc.).

Le flux RSS permet de rapatrier et d’afficher les actualités de la plateforme, d’automatiser la réception des nouveaux contenus et d’en prendre connaissance sans avoir à se rendre sur le site.

Remarque : le flux RSS permet de télécharger les contenus publics ou privés selon votre niveau de droit.

Le flux RSS repose sur une requête utilisant le protocole « http », par exemple :

https://cenhtor-msh-lorraine.cnrs.fr/items/browse?output=rss2

--------

OAI-PMH (Open Archives Initiative Protocol for Metadata Harvesting).

Le module OAI-PMH de ce site expose ses métadonnées dans plusieurs formats en XML. Pour effectuer le moissonnage, vous pouvez adresser plusieurs types de requêtes à l’entrepôt.

Remarque : qu’est-ce qu’une requête OAI-PMH ?

https://nom_de_l_entrepot/oai-pmh-repository/request?verb=GetRecord&identifier=oai:nom_de_l_entrepot:numero_de_la_ressource&metadataPrefix=oai_dc

-En noir : le chemin et l’action (l’identifiant cenhtor-msh-lorraine.cnrs.fr est à la fois un paramètre et un composant du chemin)

- En vert : les paramètres de la requête

-En rouge : la syntaxe. Le point d’interrogation « ? » matérialise le point de départ de la requête et l’esperluette « & » sert à séparer chacun des paramètres

Remarque : l’ordre dans lequel les paramètres sont énoncés après le point d’interrogation « ? » peut varier. Il est sans conséquence sur la réponse apportée

- En bleu : les valeurs des paramètres

Pour moissonner le réservoir de ce site, utilisez l'URL de base https://cenhtor-msh-lorraine.cnrs.fr/oai-pmh-repository/request et ajouter une des 6 requêtes :

  • Identify : description de l'entrepôt :

https://cenhtor-msh-lorraine.cnrs.fr/oai-pmh-repository/request?verb=Identify

  • ListMetadataFormat : liste des formats selon lesquels le site expose ses métadonnées

https://cenhtor-msh-lorraine.cnrs.fr/oai-pmh-repository/request?verb=ListMetadataFormats

  • ListSets : structure, classification des métadonnées au sein de l'entrepôt

https://cenhtor-msh-lorraine.cnrs.fr/oai-pmh-repository/request?verb=ListSets

  • ListIdentifiers : liste des identifiants des documents ajoutés dans l'entrepôt

Remarque sur la syntaxe générique : la date indiquée dans la requête doit être saisie conformément à la norme Iso-8601. Exemple : https://cenhtor-msh-lorraine.cnrs.fr/oai-pmh-repository/request?verb=ListIdentifiers&from=[date]&metadataPrefix=oai_dc

La liste des identifiants est disponible aux formats suivants :

  • oai_dc :

https://cenhtor-msh-lorraine.cnrs.fr/oai-pmh-repository/request?verb=ListIdentifiers&from=2018-09-27&metadataPrefix=oai_dc

  • mets :

https://cenhtor-msh-lorraine.cnrs.fr/oai-pmh-repository/request?verb=ListIdentifiers&from=2018-09-27&metadataPrefix=mets

  • mods :

https://cenhtor-msh-lorraine.cnrs.fr/oai-pmh-repository/request?verb=ListIdentifiers&from=2018-09-27&metadataPrefix=mods

  • rdf :

https://cenhtor-msh-lorraine.cnrs.fr/oai-pmh-repository/request?verb=ListIdentifiers&from=2018-09-27&metadataPrefix=rdf

  • ListRecords : extraction depuis l'entrepôt des documents enregistrés durant une période donnée : entre le 27 09 2018 et le 01 09 2020

https://cenhtor-msh-lorraine.cnrs.fr/oai-pmh-repository/request?verb=ListRecords&from=2018-09-27&until=2020-09-01&metadataPrefix=oai_dc

https://cenhtor-msh-lorraine.cnrs.fr/oai-pmh-repository/request?verb=GetRecord&identifier=oai:cenhtor-msh-lorraine.cnrs.fr:3672&metadataPrefix=oai_dc

  • mets :

https://cenhtor-msh-lorraine.cnrs.fr/oai-pmh-repository/request?verb=GetRecord&identifier=oai:cenhtor-msh-lorraine.cnrs.fr:3672&metadataPrefix=mets

  • mods :

https://cenhtor-msh-lorraine.cnrs.fr/oai-pmh-repository/request?verb=GetRecord&identifier=oai:cenhtor-msh-lorraine.cnrs.fr:3672&metadataPrefix=mods

  • rdf :

https://cenhtor-msh-lorraine.cnrs.fr/oai-pmh-repository/request?verb=GetRecord&identifier=oai:cenhtor-msh-lorraine.cnrs.fr:3672&metadataPrefix=rdf

 

--------

 API REST

OMEKA propose une API REST pour réaliser des exports de métadonnées au format Json.

Pour utiliser l'API, il faut installer un module selon votre navigateur (pour le navigateur Firefox vous pouvez par exemple installer le module RESTer).

L’utilisation de l’API REST d’OMEKA, propose deux types d'accès aux données de la base.

Selon les droits qui vous sont accordés vous disposez ou non d'une clé :

  • Pour réaliser des opérations sur des ressources privées, il faut que l'administrateur du site OMEKA vous attribue une clé API. Il faut alors ajouter la valeur de cette clé dans la requête. Exemple de requête réalisée avec une clé API : https://cenhtor-msh-lorraine.cnrs.fr/api/items/?3672key (key = la valeur de votre clé API)

Remarque : 3672 est l'identifiant interne attribué à la ressource par Omeka

Pour toute information complémentaire, se référer à la documentation de l'API :

https://omeka.org/classic/docs/Plugins/Omeka_API_Import/