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 des métadonnées au niveau d'un item (exemple : item n° 199) :
--------
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://image.hiscant.univ-lorraine.fr/items/browse?output=rss2
--------
OAI-PMH (Open Archives Initiative Protocol for Metadata Harvesting).
Le module OAI-PMH de ce site expose les 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 image.hiscant.univ-lorraine.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, vous devez utiliser l'URL
https://image.hiscant.univ-lorraine.fr/oai-pmh-repository/request et y ajouter l’une des 6 requêtes suivantes :
-
Identify : description de l'entrepôt :
https://image.hiscant.univ-lorraine.fr/oai-pmh-repository/request?verb=Identify
-
ListMetadataFormat : liste des formats selon lesquels le site expose ses métadonnées
https://image.hiscant.univ-lorraine.fr/oai-pmh-repository/request?verb=ListMetadataFormats
-
ListSets : structure, classification des métadonnées au sein de l'entrepôt
https://image.hiscant.univ-lorraine.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://statest.hiscant.univ-lorraine.fr/oai-pmh-repository/request?verb=ListIdentifiers&from=[date]&metadataPrefix=oai_dc
La liste des identifiants est exportable 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 04 09 2018 et le 22 10 2018
-
GetRecords : extraction des métadonnées d'une ressource depuis l'entrepôt
Remarque : l'identifiant d'une ressource est composé du nom de l’entrepôt où elle est stockée suivi de son numéro. Ici : oai:image.hiscant.univ-lorraine.fr:[numéro de la ressource]
Les métadonnées de la ressource sont exportables aux formats suivants :
oai_dc :
mets :
mods :
rdf :
--------
API REST
OMEKA propose une API REST qui permet de 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, il est possible de faire un "GET " (obtenir les métadonnées) sur des ressources publiques
Exemple de requête :
https://[nom_de_l_entrepôt]/api/items/[numero_de_la_ressource]
https://image.hiscant.univ-lorraine.fr/api/items/199
- Sans clé d'API, il n’est rien possible de 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 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://[nom_de_l_entrepôt]/api/items/?[numero_de_la_ressource]key
(key = la valeur de votre clé API)
Remarque : [numero_de_la_ressource] est un numéro interne, attribué à la ressource par Omeka
Pour toute information complémentaire, veuillez vous référer à la documentation de l'API :
https://omeka.org/classic/docs/Plugins/Omeka_API_Import/