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).

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° 1909) :

--------

Abonnement 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://ccj-corea.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 kaleidomed-mmsh.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://ccj-corea.cnrs.fr/oai-pmh-repository/request et ajouter une des 6 requêtes :

  • Identify : description de l'entrepôt :

https://ccj-corea.cnrs.fr/oai-pmh-repository/request?verb=Identify

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

https://ccj-corea.cnrs.fr/oai-pmh-repository/request?verb=ListMetadataFormats

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

https://ccj-corea.cnrs.fr/oai-pmh-repository/request?verb=ListSets

  • ListIdentifiers : liste des identifiants des documents ajoutés dans l'entrepôt depuis une date donnée

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://ccj-corea.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://ccj-corea.cnrs.fr/oai-pmh-repository/request?verb=ListIdentifiers&from=2018-09-27&metadataPrefix=oai_dc

  • mets :

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

  • mods :

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

  • rdf :

https://ccj-corea.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://ccj-corea.cnrs.fr/oai-pmh-repository/request?verb=ListRecords&from=2018-09-27&until=2020-09-01&metadataPrefix=oai_dc

https://ccj-corea.cnrs.fr/oai-pmh-repository/request?verb=GetRecord&identifier=oai:ccj-corea.cnrs.fr:1909&metadataPrefix=oai_dc

  • mets :

https://ccj-corea.cnrs.fr/oai-pmh-repository/request?verb=GetRecord&identifier=oai:ccj-corea.cnrs.fr:1909&metadataPrefix=mets

  • mods :

https://ccj-corea.cnrs.fr/oai-pmh-repository/request?verb=GetRecord&identifier=oai:ccj-corea.cnrs.fr:1909&metadataPrefix=mods

  • rdf :

https://ccj-corea.cnrs.fr/oai-pmh-repository/request?verb=GetRecord&identifier=oai:ccj-corea.cnrs.fr:1909&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, par exemple RESTer pour le navigateur Firefox, ou Talend API Tester pour Chrome.

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é :

  • Sans clé API, vous pouvez faire un "GET " (obtenir les métadonnées) sur des ressources publiques  https://ccj-corea.cnrs.fr/api/items/1909 
  • Sans clé d'API vous ne pouvez rien faire sur des ressources privées

  • 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 dans la requête la valeur de cette clé. Exemple de requête réalisée avec une clé API : https://ccj-corea.cnrs.fr/api/items/?1909key (key = la valeur de votre clé API)

Remarque : 1909 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/