Exports
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 de métadonnées au niveau d'un item (exemple : item n° 58) :
----------
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. Il repose sur une requête utilisant le protocole « http ».
Par exemple : https://statest.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
- 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 utilisez l'URL de base https://statest.hiscant.univ-lorraine.fr/oai-pmh-repository/request et ajouter l'une des 6 requêtes suivantes :
- Identify : description de l'entrepôt :
https://statest.hiscant.univ-lorraine.fr/oai-pmh-repository/request?verb=Identify
- ListMetadataFormat : liste des formats selon lesquels le site expose ses métadonnées
https://statest.hiscant.univ-lorraine.fr/oai-pmh-repository/request?verb=ListMetadataFormats
- ListSets : structure, classification des métadonnées au sein de l'entrepôt
https://statest.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 27 09 2018 et le 01 09 2020
- GetRecord : extraction des métadonnées d'une ressource depuis l'entrepôt
L'identifiant d'une ressource est oai:statest.hiscant.univ-lorraine.fr:[numéro de la ressource]
- 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, vous pouvez faire un "GET " (obtenir les métadonnées) sur des ressources publiques.
Exemple : https://statest.hiscant.univ-lorraine.fr/api/items/589
- 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://statest.hiscant.univ-lorraine.fr/api/items/?589key (key = la valeur de votre clé API)
Remarque : 589 est l'identifiant 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