Différences

Ci-dessous, les différences entre deux révisions de la page.

--- sian:2022:oai_pmh [2022/11/23 22:47] – créée fabien.rico
+++ sian:2022:oai_pmh [2022/11/24 10:19] (Version actuelle) – [TP découverte de l'API OAI-PMH] fabien.rico
@@ Ligne 1: / Ligne 1: @@
 ====== TP découverte de l'API OAI-PMH ======
-OAI-PMH est un protocole d'interrogation de données documentaires. Il permet une interrogation via une API WEB d'un entrepôt.
+OAI-PMH est un protocole d'interrogation de données documentaires. Il permet l'interrogation d'un //entrepôt// via une API WEB.
 Il y a plusieurs interrogations possibles (les //verb//)
-- ''ListSets'' pour obtenir la liste des ensembles de documents
+  * ''ListSets'' pour obtenir la liste des ensembles de documents
-- ''ListRecords'' pour obtenir les métadonnées de documents
+  * ''ListRecords'' pour obtenir les métadonnées de documents
-- ...
+  * ...
+Voir des explication détaillées ici [[https://fr.wikipedia.org/wiki/Open_Archives_Initiative_Protocol_for_Metadata_Harvesting|la description ici]] ou [[https://www.bnf.fr/fr/protocole-oai-pmh|à la BFN]]
+Le résultat d'une intérrogation est sous la forme de  XML. Le forma de description des document peut parfois être choisi, les plus utilisés sont ''lom'' (le plus complet) ou ''oai_dc'' ou Dublin Core (le plus courant).
+===== Utilisation directe de l'API =====
+Vous allez testez l'api de openedition [[https://www.openedition.org/8883|ici]]
+  * Suivez les liens ''Lister les enregistrements'' et ''Lister les sets''. En regardant l'URL, comment choisit-on ce qui est demandé ?
+  * Combien y a-t-il d'enregistrements ? Comment faire pour avoir les suivant ? Faites la requête pour avoir la seconde page.
+  * Listez les enregistrements du premier journal présenté dans les ''sets''.
+===== Utilisation d'un client python =====
+Il est possible de lire directement les résultats du dépots OAI_PMH mais cela suppose de traiter le XML ce qui n'est pas simple.
+C'est pourquoi, nous allons utiliser la librairie [[https://sickle.readthedocs.io/en/latest/|sickle]] qui permet l'interrogation
+et le traitement des données Dublin Core
+  * Installez la librairie via pip
+  * Utilisez la librairie pour afficher les titres des 20 premiers documents du dépôt.
+  * Interrogez ''openedition'' pour avoir la liste des documents de cette année. Combien y en a-t-il ?
+==== Récupération des dates d'un journal ====
+Vous devez faire un script python qui récupère tous les articles de la revue ''XVII-XVIII'' "revue de la société d’études anglo-américaines des XVIIe et XVIIIe siècles". Qui compte le nombre d'article par an et le nombre d'article en accès ouvert.
+Pour vous aider:
+  * les dates de parution peuvent se lire dans le champ ''datestamp'' de l'entête,
+  * l'accès de l'article est dans le champs ''dc:rights'' des métadonnées.
-Voir [[https://fr.wikipedia.org/wiki/Open_Archives_Initiative_Protocol_for_Metadata_Harvesting|la description ici]] ou [[https://www.bnf.fr/fr/protocole-oai-pmh|à la BFN]]