0

6 La navigation dans le manuel de Kentika est réservée aux utilisateurs identifiés



Serveur OAI-PMH

#OAI

Serveur (ou entrepôt) OAI-PMH

Préambule

OAI-PMH : Open Archives Initiative - Protocol for Metadata Harvesting. Cette fonction a pour objectif de permettre à un "Moissonneur" d'obtenir le contenu d'un catalogue à partir de requêtes simples.

Pour que la base soit accessible en OAI, il suffit que des requêtes avec l'attribut OAI existent et que la base soit accessible sur internet via le serveur http intégré (OAI en intranet ne présenterait que peu d'intérêt).​

Dialogue de paramétrage

Les informations de paramétrage sont saisies dans le dialogue ci-dessous :

Données de description du serveur OAI

baseURL : URL de base des 6 requêtes. Par défaut : http:// suivi de l'adresse IP du serveur puis /OAI

repositoryIdentifier : identification de votre base de données

repositoryName : nom de votre base de données

adminEmail : email de l'administrateur de votre base de données

earliestDatestamp : date de votre notice bibliographique la plus ancienne

deletedRecord : no, l'application ne maintient pas d'information sur les enregistrements supprimés

granularity : non modifiable, indique le niveau de finesse d'expression des dates.

Pour plus d'informations sur la saisie de ces informations, reportez vous aux spécifications.

Identifier : chaque enregistrement (ou notice) aura un identifiant unique. Ce dernier sera composé de deux parties : un identifiant propre à la base de données (KENTIKA_mabase dans l'exemple ci-dessus, la valeur par défaut étant "ALEX_" suivi de la signature de votre base de données) suivi du signe : puis du numéro d'enregistrement (Record_Num) sans le suffixe de table (03).

Exemple : la fiche document ayant pour Record_Num "12303" aurait pour Identifier OAI "KENTIKA_mabase:123".

Les 6 "verbes" de l'OAI.

Après avoir effectué les réglages décrits ci-dessous, le résultat des requêtes OAI peut être visualisé dans votre navigateur grâce au pop-up menu apparaissant en cliquant sur le bouton situé en bas à droite du dialogue (en regard de l'intitulé : "Tester").

Identify

​

http://.../OAI?verb=Identify

​

Identification de l'entrepôt OAI.

​

<?xml version="1.0" encoding="UTF-8"?>

<OAI-PMH xmlns="http://www.openarchives.org/OAI/2.0/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.openarchives.org/OAI/2.0/ http://www.openarchives.org/OAI/2.0/OAI-PMH.xsd">

<responseDate>2007-12-18T18:58:55Z</responseDate>

<request verb="Identify">OAI </request>

<Identify>

<repositoryName>KentikaDemonstrator </repositoryName>

<baseURL>OAI </baseURL>

<protocolVersion>2.0</protocolVersion>

<adminEmail>admin@kentika.net </adminEmail>

<earliestDatestamp>1921-01-01 </earliestDatestamp>

<deletedRecord>no </deletedRecord>

<granularity>YYYY-MM-DD </granularity>

<description>

<oai-identifier xmlns="http://www.openarchives.org/OAI/2.0/oai-identifier" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.openarchives.org/OAI/2.0/oai-identifier http://www.openarchives.org/OAI/2.0/oai-identifier.xsd">

<scheme>oai</scheme>

<repositoryIdentifier>KENTIKA_BASE </repositoryIdentifier>

<delimiter>:</delimiter>

<sampleIdentifier>KENTIKA_mabase:123 </sampleIdentifier>

</oai-identifier>

</description>

</Identify>

</OAI-PMH>

ListSets

http://.../OAI?verb=ListSets

Liste des "sets disponibles. Les sets OAI sont des requêtes ayant l'attribut OAI. Le nom de la requête est le "setSpec ", le commentaire associé est le "setName "

<?xml version="1.0" encoding="UTF-8"?>

<OAI-PMH xmlns="http://www.openarchives.org/OAI/2.0/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.openarchives.org/OAI/2.0/ http://www.openarchives.org/OAI/2.0/OAI-PMH.xsd">

<responseDate>2007-12-19T08:40:30Z</responseDate>

<request verb="ListSets">OAI</request>

<ListSets>

<set>

<setSpec>Articles </setSpec>

<setName>Les nouveaux articles de la base </setName>

</set>

<set>

<setSpec>Ouvrages </setSpec>

<setName>Base d'ouvrages </setName>

</set>

</ListSets>

</OAI-PMH>

ListMetadataFormats

http://.../OAI?verb=ListMetadataFormats&set=Articles

Le schéma supporté ici est le dublin core dont l'alimentation peut être personnalisée.

<?xml version="1.0" encoding="UTF-8"?>

<OAI-PMH xmlns="http://www.openarchives.org/OAI/2.0/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.openarchives.org/OAI/2.0/ http://www.openarchives.org/OAI/2.0/OAI-PMH.xsd">

<responseDate>2007-12-19T08:43:18Z</responseDate>

<request verb="ListMetadataFormats" set="Articles">OAI</request>

<ListMetadataFormats>

<metadataFormat>

<metadataPrefix>oai_dc </metadataPrefix>

<schema>http://www.openarchives.org/OAI/2.0/oai_dc.xsd </schema>

<metadataNamespace>http://www.openarchives.org/OAI/2.0/oai_dc/</metadataNamespace>

</metadataFormat>

</ListMetadataFormats>

</OAI-PMH>

ListIdendifiers

http://.../OAI?verb=ListIdentifiers&set=Articles&metadataPrefix=oai_dc

Fournit l'ensemble des identifiers d'un set. Le moissonneur peut ensuite demander les enregistrements qu'il n'aurait pas encore référencé. Une fourchette de dates optionnelles peut être précisée dans l'URL (paramêtres : from et until , provoque une sélection dans le set des enregistrements dont la date d'indexation est supérieure ou égale à celle indiquée en "from" et / ou inférieure ou égale à celle éventuellement indiquée en "until").

<?xml version="1.0" encoding="UTF-8"?>

<OAI-PMH xmlns="http://www.openarchives.org/OAI/2.0/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.openarchives.org/OAI/2.0/ http://www.openarchives.org/OAI/2.0/OAI-PMH.xsd">

<responseDate>2007-12-19T10:01:13Z</responseDate>

<request verb="ListIdentifiers " metadataPrefix="oai_dc " set="Articles "> http://192.168.0.20/OAI</request>

<ListIdentifiers>

...

<header>

<identifier>KENTIKA_mabase:21393 </identifier>

<datestamp>2005-09-01</datestamp>

<setSpec>Articles</setSpec>

</header>

...

</ListIdentifiers>

</OAI-PMH>

ListRecords

http://.../OAI?verb=ListRecords&set=Articles&metadataPrefix=oai_dc

Fournit l'ensemble des metadonnées dublin core pour les enregistrements appartenant au set demandé. Une fourchette de dates peut être précisée (cf ci-dessus).

<?xml version="1.0" encoding="UTF-8"?>

<OAI-PMH xmlns="http://www.openarchives.org/OAI/2.0/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.openarchives.org/OAI/2.0/ http://www.openarchives.org/OAI/2.0/OAI-PMH.xsd">

<responseDate>2007-12-19T10:09:25Z</responseDate>

<request verb="ListRecords " metadataPrefix="oai_dc " set="Articles "> http://.../OAI</request>

<ListRecords>

...

<record>

<header>

<identifier>KENTIKA_mabase:21393 </identifier>

<datestamp>2005-09-01</datestamp>

<setSpec>Articles</setSpec>

</header>

<metadata >

<oai_dc :dc xmlns:oai_dc="http://www.openarchives.org/OAI/2.0/oai_dc/" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.openarchives.org/OAI/2.0/oai_dc/ http://www.openarchives.org/OAI/2.0/oai_dc.xsd">

<dc:title >Dur, dur, les s&#233;ries chronologiques !!</dc:title >

<dc:subject >fili&#232;re d'enseignement</dc:subject >

<dc:description >Centre Interuniversitaire de Calcul de Grenoble</dc:description >

<dc:date >1993-08-18</dc:date >

<dc:type >Article</dc:type >

<dc:identifier >http://.../Record.htm?record=19112202124919304849</dc:identifier >

<dc:language >Fran&#231;ais</dc:language >

</oai_dc:dc >

</metadata >

</record>

...

</ListRecords>

</OAI-PMH>

GetRecord

http://.../OAI?verb=GetRecord&set=Articles&metadataPrefix=oai_dc&identifier=KENTIKA_mabase:21393

Idem ci-dessus pour une enregistrement dont l'identifiant est fourni en paramètre "Identifier".

<?xml version="1.0" encoding="UTF-8"?>

<OAI-PMH xmlns="http://www.openarchives.org/OAI/2.0/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.openarchives.org/OAI/2.0/ http://www.openarchives.org/OAI/2.0/OAI-PMH.xsd">

<responseDate>2007-12-19T10:22:04Z</responseDate>

<request verb="GetRecord " identifier="KENTIKA_mabase:21393 " metadataPrefix="oai_dc " set="Articles ">http://.../OAI</request>

<GetRecord>

<record>

<header>

<identifier>KENTIKA_mabase:21393 </identifier>

<datestamp>2005-09-01</datestamp>

<setSpec>Articles</setSpec>

</header>

<metadata >

<oai_dc :dc xmlns:oai_dc="http://www.openarchives.org/OAI/2.0/oai_dc/" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.openarchives.org/OAI/2.0/oai_dc/ http://www.openarchives.org/OAI/2.0/oai_dc.xsd">

<dc:title >Dur, dur, les s&#233;ries chronologiques !!</dc:title >

<dc:subject >fili&#232;re d'enseignement</dc:subject >

<dc:description >Centre Interuniversitaire de Calcul de Grenoble</dc:description >

<dc:date >1993-08-18</dc:date >

<dc:type >Article</dc:type >

<dc:identifier >http://.../Record.htm?record=19112202124919304849</dc:identifier >

<dc:language >Fran&#231;ais</dc:language >

</oai_dc:dc >

</metadata >

</record>

</GetRecord>

</OAI-PMH>