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 :
- mets :
- mods :
- 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
- GetRecord : extraction depuis l'entrepôt des documents dont l'identifiant est oai:cenhtor-msh-lorraine.cnrs.fr:3672
- oai_dc :
- mets :
- mods :
- 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é :
- Sans clé API, vous pouvez faire un "GET " (obtenir les métadonnées) sur des ressources publiques. Par exemple : https://cenhtor-msh-lorraine.cnrs.fr/api/items/3672
- 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 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 :