Skip to content

OAI PMH

Jump to bottom
Giulio edited this page Nov 18, 2017 · 25 revisions

OAI-PMH

E' un protocollo sviluppato dalla Open Archive Initiative per consentire l’interoperabilità tra repository.

Il Data provider espone i metadati strutturati tramite il protocollo OAI-PMH.

Il Service provider raccoglie i dati (harvesting) interrogando il modulo OAI-PMH del Data provider.

I record sono organizzati in dataset.

Interrogare un OAI Data provider

Il Data provider è interrogabile tramite 6 verbi:

  • Identify
  • ListMetadataFormats
  • ListSets
  • ListRecords
  • ListRecords (di un dataset)
  • GetRecord

Creiamo le URL per interrogare il Data provider

protocollo_HTTP + baseurl + ? + nome_parametro=valore_parametro&nome_parametro=valore_parametro&...

Protocollo HTTP

https:// oppure http://

PHAIDRA baseurl dell'oaiprovider

fc.cab.unipd.it/oaiprovider/

Catalogo baseurl dell'oaiprovider

catalogo.unipd.it/oai/oai2.php

Parametri della richiesta

Il carattere ?' indica che le coppie nome_parametro=valore_parametro saranno aggiunte alla richiesta e dovranno essere elaborate dal server che le riceve.

E' sempre presente il nome_parametro verb e quindi la coppia verb=valore_parametro

Possono essere presenti altre coppie nome_parametro=valore_parametro separate dal carattere '&' (AND logico).

Interroghiamo il Data provider ed analizziamo le risposte

Identify
PHAIDRA

https://fc.cab.unipd.it/oaiprovider/?verb=Identify

<?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>2017-11-17T16:03:16Z</responseDate>
  <request verb="Identify">https://fc.cab.unipd.it/oaiprovider/</request>
<Identify>
   <repositoryName>Phaidra UniPD</repositoryName>
   <baseURL>http://fc.cab.unipd.it/oaiprovider/</baseURL>
   <protocolVersion>2.0</protocolVersion>
   <adminEmail>[email protected]</adminEmail>
   <earliestDatestamp>2003-01-01T00:00:00Z</earliestDatestamp>
   <deletedRecord>transient</deletedRecord>
   <granularity>YYYY-MM-DDThh:mm:ssZ</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>cab.unipd.it</repositoryIdentifier>
         <delimiter>:</delimiter>
         <sampleIdentifier>oai:cab.unipd.it:o:123</sampleIdentifier>
      </oai-identifier>
   </description>
</Identify>
</OAI-PMH>
Catalogo

http://catalogo.unipd.it/oai/oai2.php?verb=Identify

<?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>2017-11-17T17:09:01Z</responseDate>
 <request verb="Identify">http://catalogo.unipd.it/oai/oai2.php</request>
 <Identify>
  <repositoryName>University of Padua - Italy</repositoryName>
  <baseURL>http://catalogo.unipd.it/oai/oai2.php</baseURL>
  <protocolVersion>2.0</protocolVersion>
  <adminEmail>[email protected]</adminEmail>
  <earliestDatestamp>1900-01-01T00:00:00Z</earliestDatestamp>
  <deletedRecord>transient</deletedRecord>
  <granularity>YYYY-MM-DDThh:mm:ssZ</granularity>
  <compression>gzip</compression>
  <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>unipd.it</repositoryIdentifier>
    <delimiter>:</delimiter>
    <sampleIdentifier>oai:unipd.it:SBP-000000001</sampleIdentifier>
   </oai-identifier>
  </description>
 </Identify>
</OAI-PMH>
ListMetadataFormats
PHAIDRA

https://fc.cab.unipd.it/oaiprovider/?verb=ListMetadataFormats

Catalogo

http://catalogo.unipd.it/oai/oai2.php?verb=ListMetadataFormats

ListSets
PHAIDRA

https://fc.cab.unipd.it/oaiprovider/?verb=ListSets

<?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>2017-11-17T17:16:13Z</responseDate>
  <request verb="ListSets">http://fc.cab.unipd.it/oaiprovider/</request>
<ListSets>
[...]
<set>
  <setSpec>PSMC</setSpec>
  <setName>Pergamene dall&apos;archivio di S. Maria delle Carceri</setName>
</set>
</ListSets>
</OAI-PMH>
Catalogo

http://catalogo.unipd.it/oai/oai2.php?verb=ListSets

ListRecords
PHAIDRA

http://fc.cab.unipd.it/oaiprovider/?verb=ListRecords&metadataPrefix=oai_dc

CATALOGO
ListRecords (di un dataset)

Dobbiamo fornire il parametro che identifica il dataset di cui si vogliono ottenere i record

  • nome_parametro set
  • valore_parametro set_spec
PHAIDRA

http://fc.cab.unipd.it/oaiprovider/?verb=ListRecords&set=PSMC&metadataPrefix=oai_dc

CATALOGO
GetRecord

Dobbiamo fornire il parametro che identifica il record

  • nome_parametro identifier
  • valore_parametro oai_record_identifier
PHAIDRA

http://fc.cab.unipd.it/oaiprovider/?verb=GetRecord&metadataPrefix=oai_dc&identifier=info:fedora/oai:cab.unipd.it:o:145514

<?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>2017-11-17T17:28:18Z</responseDate>
  <request verb="GetRecord" identifier="info:fedora/oai:cab.unipd.it:o:145514" metadataPrefix="oai_dc">http://fc.cab.unipd.it/oaiprovider/</request>
<GetRecord>
<record>
  <header>
    <identifier>info:fedora/oai:cab.unipd.it:o:145514</identifier>
    <datestamp>2017-10-23T08:14:59Z</datestamp>
    <setSpec>PSMC</setSpec>
  </header>
  <metadata>

<oai_dc:dc 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" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:oai_dc="http://www.openarchives.org/OAI/2.0/oai_dc/">
  <dc:rights>All rights reserved</dc:rights>
  <dc:source>Biblioteca di Storia, Perg.Sto.4</dc:source>
  <dc:coverage xml:lang="ita">XIII, 1200, Italia, Veneto, Padova</dc:coverage>
  <dc:language>lat</dc:language>
  <dc:subject xml:lang="ita">Pergamena, Uberto, S. Maria di Montagnana, Gerardo, Padova, S. Maria delle Carceri, Giovanni, Livaldo</dc:subject>
  <dc:description xml:lang="ita">Recto.

Uberto chierico, sindaco e procuratore della chiesa di S. Maria di Montagnana, con il consenso dei suoi fratres, rinuncia all’appello da lui stesso presentato contro la sentenza emanata da Gerardo, vescovo di Padova, a favore della chiesa di S. Maria delle Carceri sulle decime novalium di Montagnana, riservandosi tuttavia lo ius in quartisio e ne promette l’osservanza a don Giovanni, preposto della controparte, con la fideiussione di prete Damiano. Lo stesso giorno, il medesimo ripete l’identico atto a d. Livaldo, priore della chiesa di S. Maria delle Carceri. Il 12 aprile successivo confermano e consentono due altri chierici di S. Maria di Montagnana.

Originale  (A).

“Le pergamene del Dipartimento di Storia dell’Università di Padova 1199-1236” p. 32-34
http://catalogo.unipd.it/F?func=find-c&amp;ccl_term=IDN=PUV0777252&amp;local_base=SBP01</dc:description>
  <dc:identifier>hdl:11168/11.145514</dc:identifier>
  <dc:identifier>http://phaidra.cab.unipd.it/o:145514</dc:identifier>
  <dc:format>image/jpeg (467030 bytes)</dc:format>
  <dc:format>manuscript (width: 160 mm, height: 270 mm)</dc:format>
  <dc:relation>http://phaidra.cab.unipd.it/o:145556</dc:relation>
  <dc:relation>http://phaidra.cab.unipd.it/o:152073</dc:relation>
  <dc:title xml:lang="ita">1200 marzo 8, S. Maria delle Carceri, in capitulo </dc:title>
  <dc:type xml:lang="eng">Image</dc:type>
  <dc:publisher>PHAIDRA University of Padova</dc:publisher>
  <dc:contributor>Università di Padova - Biblioteca di Storia (Digitiser)</dc:contributor>
</oai_dc:dc>
  </metadata>
</record>

</GetRecord></OAI-PMH>
CATALOGO
Clone this wiki locally