Utilisation du serveur OAI

Utilisation du serveur OAI-PMH d'IdRef
Version : 06-10-2016
Utilisation du serveur OAI-PMH d'IdRef
Version : 06-10-2016
Table des matières
1. Le protocole OAI-PMH d’IdRef ............................................................................................1
2. Pourquoi utiliser ce serveur OAI-PMH ? ................................................................................2
2.1. Pour disséminer les métadonnées d’autorité .................................................................2
2.2. Pour récupérer les métadonnées d’autorité ...................................................................2
3. Accès au serveur OAI-PMH d’IdRef ......................................................................................3
3.1. Comment, par exemple, récupérer le fichier ou set « Personnes ? ..................................3
3.2. Les limites .................................................................................................................3
4. Panorama des transactions .....................................................................................................5
4.1. Identify ......................................................................................................................5
4.2. ListMetadataFormats ..................................................................................................5
4.3. ListSets .....................................................................................................................5
4.4. ListIdentifiers ............................................................................................................5
4.5. GetRecord .................................................................................................................6
4.6. ListRecords ...............................................................................................................6
5. Les verbes du réservoir OAI d’IdRef ......................................................................................7
5.1. Identify ......................................................................................................................7
5.2. ListMetadataFormats ..................................................................................................7
5.3. ListSets .....................................................................................................................7
5.4. ListIdentifiers ............................................................................................................7
5.5. GetRecord .................................................................................................................7
5.6. ListRecords ...............................................................................................................7
ii
Utilisation du serveur OAI-PMH d'IdRef
Version : 06-10-2016
Chapitre 1. Le protocole OAI-PMH
d’IdRef
Le réservoir OAI-PMH d’IdRef met à la disposition de l'ensemble de la communauté les métadonnées
d’autorité des référentiels IdRef.
OAI-PMH (Open archives initiative protocole for metadata harvesting) vise à demander de l’information
à travers quelques requêtes à un serveur d’archives ouvertes.
Les échanges se font du client vers le serveur.
Attention :
- ce n’est pas un protocole de recherche. Il n’y a pas d’interface compréhensible pour un humain.
- les opérations sont limitées : on s’intéresse à un différentiel, à ce qui a « poussé » entre telle et telle date
par exemple.
1
Utilisation du serveur OAI-PMH d'IdRef
Version : 06-10-2016
Chapitre 2. Pourquoi utiliser ce serveur
OAI-PMH ?
2.1. Pour disséminer les métadonnées
d’autorité
Le serveur OAI-PMH d’IdRef doit être déclaré sur votre moteur de recherche OAISTER.
2.2. Pour récupérer les métadonnées d’autorité
Le serveur récupère les métadonnées des référentiels d’autorité par type d’autorité.
2
Utilisation du serveur OAI-PMH d'IdRef
Version : 06-10-2016
Chapitre 3. Accès au serveur OAI-PMH
d’IdRef
URL d’accès
Le serveur OAI-PMH d’IdRef est accessible à l’adresse suivante, incluant la gestion des resumption
tokens :
http://www.idref.fr/OAI/oai.jsp? [http://www.idref.fr/OAI/oai.jsp]
Les données du serveur OAI-PMH d’IdRef sont des données réelles : ce sont les autorités.
Les données sont présentées à travers un type de set unique :
• Type d’autorité
Vous pouvez récupérer les données dans deux les formats :
• Dublin Core
• Marc/XML
3.1. Comment, par exemple, récupérer le fichier
ou set « Personnes ?
Pour récupérer les fichiers des autorités « Personnes » décrit dans les métadonnées, votre client OAI doit :
1- Récupérer les métadonnées au format MarcXML
2- Ouvrir ces métadonnées afin d'y retrouver l'URL d’accès de la notice d’autorité
3- Utiliser cette URL (via une requête http) pour récupérer le fichier de la notice.
3.2. Les limites
Le protocole ne concerne que les métadonnées, pas les documents.
L’organisation de la « collection » est définie a priori.
L’entrée définie est le type d’autorité. Il existe donc 9 « sets », un set pour chaque type d’autorité et un
pour toutes les autorités.
• Personne
3
Utilisation du serveur OAI-PMH d'IdRef
Version : 06-10-2016
• Collectivité
• Famille
• Titre
• Titre uniforme
• Nom commun
• Nom géographique
• Nom de marque
• Bibliothèque
Le client ne peut pas croiser les « sets ».
4
Utilisation du serveur OAI-PMH d'IdRef
Version : 06-10-2016
Chapitre 4. Panorama des transactions
6 types de transaction sont possibles, nommées « verbes ». Vous trouverez en partie 4, le détail des 6
verbes OAI avec des exemples sur la déclinaison de formats, le choix des dates ou la sélection par sets
OAI.
4.1. Identify
• le client demande au serveur : Qui es-tu ? Qu’as-tu à m’offrir ?
• Le serveur d’IdRef répond : voilà mon nom, mon URL, je peux t’offrir l’accès aux métadonnées des
autorités.
http://www.idref.fr/OAI/oai.jsp?verb=Identify
4.2. ListMetadataFormats
• le client demande au serveur : quelle langue parles-tu ? dans quels formats peux-tu me donner ce que je
te demande ?
• le serveur d’IdRef répond : je suis multilingue : ma langue maternelle est le MarcXML, mais je peux
parler aussi le Dublin Core :
http://www.idref.fr/OAI/oai.jsp?verb=ListMetadataFormats
4.3. ListSets
• le client demande au serveur : Comment es-tu organisé ? Comment vais-je retrouver un document dans
tes rayonnages virtuels ?
• le serveur d’IdRef répond : ma collection est organisée par type d’autorité.
http://www.idref.fr/OAI/oai.jsp?verb=ListSets
4.4. ListIdentifiers
• le client demande au serveur : donne-moi les identifiants des autorités Personnes, au format MarcXML
• le serveur d’IdRef répond : voilà la liste demandée. Dedans, il y a notamment la notice 030097118
http://www.idref.fr/OAI/oai.jsp?verb=ListIdentifiers&metadataPrefix=oai_dc&set=a
5
Utilisation du serveur OAI-PMH d'IdRef
Version : 06-10-2016
4.5. GetRecord
• le client demande au serveur : donne-moi le contenu des métadonnées de la notice 029307058 en
MarcXML
• le serveur d’IdRef répond : voilà le contenu en MarcXML
http://www.idref.fr/OAI/oai.jsp?verb=GetRecord&metadataPrefix=oai_dc&identifier=oai:IdRefOAIServ
er.fr:029307058
4.6. ListRecords
• le client demande au serveur : je suis déjà venu le 1er septembre 2014. Donne-moi tout ce que tu as de
neuf concernant les Personnes.
http://www.idref.fr/OAI/oai.jsp?verb=ListRecords&from=2015-01-20&metadataPrefix=marc-xml&set=a
• le serveur d’IdRef répond : j’en ai 6 622 à te donner. Voilà le contenu des 100 premiers et un jeton
(resumptionToken) pour recevoir les 6 522 suivants.
<resumptionToken
completeListSize="6622"
cursor="110">9999-12-31%7C2015-01-20%7Ca%7Cmarc-xml%7C183164822%7C2015-01-27T11%3A
37%3A23Z%7C6622%7C110
</resumptionToken>
• le client demande au serveur : voilà le jeton pour recevoir les suivants.
http://www.idref.fr/OAI/oai.jsp?verb=ListRecords&resumptionToken=183164822
• le serveur d’IdRef répond : voilà le contenu des pages suivantes. C’est terminé.
Le resumptionToken change à chaque nouvelle requête. Pour parcourir une liste de plus de 100 résultats,
un programme doit aller chercher le « jeton » renvoyé dans la réponse xml, et le renvoyer à nouveau pour
obtenir la suite de la liste.
6
Utilisation du serveur OAI-PMH d'IdRef
Version : 06-10-2016
Chapitre 5. Les verbes du réservoir OAI
d’IdRef
5.1. Identify
Identification du serveur OAI-PMH d’IdRef :
http://www.idref.fr/OAI/oai.jsp?verb=Identify
5.2. ListMetadataFormats
Liste des formats disponibles :
http://www.idref.fr/OAI/oai.jsp?verb=ListMetadataFormats
5.3. ListSets
Liste des sets de sélection disponibles :
http://www.idref.fr/OAI/oai.jsp?verb=ListSets
5.4. ListIdentifiers
Décharger les identifiants pour les Personnes :
http://www.idref.fr/OAI/oai.jsp?verb=ListIdentifiers&metadataPrefix=oai_dc&set=a
Décharger les identifiants pour les Collectivités ajoutées ou mises à jour dans le réservoir depuis le 1er
septembre 2014 :
http://www.idref.fr/OAI/oai.jsp?verb=ListIdentifiers&from=2014-09-01&metadataPrefix=marc-xml&set
=b
5.5. GetRecord
Décharger les métadonnées de l’autorité Personne ayant comme PPN 029307058 en format Dublin Core :
http://www.idref.fr/OAI/oai.jsp?verb=GetRecord&metadataPrefix=oai_dc&identifier=oai:IdRefOAIServ
er.fr:029307058
Décharger les métadonnées de l’autorité Personne ayant comme PPN 029307058 en format MarcXML :
http://www.idref.fr/OAI/oai.jsp?verb=GetRecord&metadataPrefix=marc-xml&identifier=oai:IdRefOAISe
rver.fr:029307058
5.6. ListRecords
7
Utilisation du serveur OAI-PMH d'IdRef
Version : 06-10-2016
Décharger en format MarcXML les notices Personnes ajoutées ou mises à jour dans le réservoir depuis le
1er septembre 2014 :
http://www.idref.fr/OAI/oai.jsp?verb=ListRecords&from=2014-09-01&metadataPrefix=marc-xml&set=a
Décharger en format MarcXML les notices Personnes ajoutées ou mises à jour dans le réservoir entre le
1er septembre 2014 et le 31 décembre 2014 :
http://www.idref.fr/OAI/oai.jsp?verb=ListRecords&from=2014-09-01&until=2014-12-31&metadataPrefi
x=marc-xml&set=a
8