Activer le dépôt OAI

Dans cette page vous trouverez des informations sur la façon dont fonctionne Koha comme dépôt OAI.

:!: Paramétrage préalable : pour que votre catalogue soit dépôt OAI, vous devez avoir défini ou activé les préférences systèmes présentes dans Plus -> Administration -> Préférences système, onglet Webservices et les sets

Le fichier /cgi-bin/koha/oai.pl de votre installation comprend les paramètres et les requêtes permettant de faire fonctionner le dépôt.

Le format des métadonnées est oai_dc.

L'adresse url de votre dépôt est :

http://adresse_de_l'opac/cgi-bin/koha/oai.pl

Vous pouvez donc tester votre dépôt à l'aide des requêtes utilisant les verbes possibles en OAI :

identification du dépôt

http://adresse_de_l'opac/cgi-bin/koha/oai.pl?verb=Identify

Donne en résultat par exemple :

<Identify>
<repositoryName>Bibliothèque de Floreville</repositoryName>
<protocolVersion>2.0</protocolVersion>
<adminEmail>adminkoha@xxxx.fr</adminEmail>
<earliestDatestamp>1970-01-01T00:00:00Z</earliestDatestamp>
<deletedRecord>no</deletedRecord>
<granularity>YYYY-MM-DD</granularity>
...etc...
  • repositoryName est le nom de la bibliothèque défini dans la préférence système LibraryName
  • adminEmail l'adresse définie dans la préférence système KohaAdminEmailAddress
  • earliestDatestamp : date de création / modification de la notice biblio
  • deletedRecord : no : indique que le dépôt ne gère pas les notices supprimées (donc ne fournit dans le record aucune indication sur le statut supprimé ou non de l'enregistrement)
  • granularity : granularité à prendre en compte pour les moissonnages sélectifs en fonction de la date (pour les critères from et until)

liste des formats de métadonnées possibles

seulement oai_dc pour cette version de Koha

http://adresse_de_l'opac/cgi-bin/koha/oai.pl?verb=ListMetadataFormats

liste des SETS définis

http://adresse_de_l'opac/cgi-bin/koha/oai.pl?verb=ListSets

liste des identifiants

http://adresse_de_l'opac/cgi-bin/koha/oai.pl?verb=ListIdentifiers&metadataPrefix=oai_dc

= liste des identifiers, c'est à dire des identifiants des enregistrements (limitée à OAI-PMH:MaxCount identifiers simultanés) ; l'identifier est basé sur le contenu de la préférence système OAI-PMH:archiveID et le numéro d'identification de la notice dans Koha (biblionumber).

Liste des identifiers ajoutés ou modifiés dans l'intervalle de dates fourni :

http://adresse_de_l'opac/cgi-bin/koha/oai.pl?verb=ListIdentifiers&from=2011-07-12&until=2011-07-13&metadataPrefix=oai_dc

: liste des identifiers ajoutés ou modifiés dans l'intervalle de dates fourni

Liste des identifiers pour un set donné

(ici pour le set constans)

http://adresse_de_l'opac/cgi-bin/koha/oai.pl?verb=ListIdentifiers&metadataPrefix=oai_dc&set=constans

Par exemple :

<request verb="ListIdentifiers" metadataPrefix="oai_dc" set="constans">
http://catalogue.devunilim.biblibre.com/cgi-bin/koha/oai.pl
</request>
<ListIdentifiers>
<header>
<identifier>KOHA-OAI-TEST:7183</identifier>
<datestamp>2011-07-12T19:43:44Z</datestamp>
</header>
<header>
<identifier>KOHA-OAI-TEST:8826</identifier>
<datestamp>2011-07-12T19:44:49Z</datestamp>
</header>

liste des enregistrements

http://adresse_de_l'opac/cgi-bin/koha/oai.pl?verb=ListRecords&metadataPrefix=oai_dc

(limitée à OAI-PMH:MaxCount enregistrements simultanés)

détail d'un enregistrement (notice)

http://adresse_de_l'opac/cgi-bin/koha/oai.pl?verb=GetRecord&identifier=KOHA-OAI-TEST:6&metadataPrefix=oai_dc

= enregistrement d'une notice (ici, celle dont le biblionumber est 6)

Les enregistrements sont fournis au format Dublin_Core (DC) ; la conversion à partir des notices en marc est faite via la feuille de style UNIMARCslim2OAIDC.xsl.

FIXME Certains éléments sont "en dur" dans la feuille de style XSLT : ex la cote dans LOC pour les différents exemplaires.

L'accès à la notice dans le dépôt (URI de la ressource dans le dépôt) est :

<dc:identifier>http://adresse_de_l'opac/bib/190899</dc:identifier>

Ce qui est pris en compte ici pour la racine de l'URI est le contenu de la préférence système OPACBaseURL.

search?q=%20oai&amp;btnI=lucky