OAI-PMP: Open Archives Initiative - Protocol for Metadata Posting (Designed for IndonesiaDLN)

Protocol Version: 1.0-Beta of 2002-09-07
Document Version: 01/28/2003 04:13:49 PM

Editors

Ismail Fahmi < ismail@itb.ac.id > -- Knowledge Management Research Group ITB
Ruri Muharto < rurie@transport.itb.ac.id > -- Knowledge Management Research Group ITB
Donny Fauzan < donfau@kmrg.itb.ac.id > -- Knowledge Management Research Group ITB 

Table of Contents

  1. Introduction
  2. Connect
  3. Disconnect
  4. PutRecord
  5. PutListRecords
  6. PutFileFragment
  7. MergeFileFragments

1. Introduction

motivations..

 

2. Connect

Summary and Usage Notes

This verb is used to get authentication from the HUB server.

Arguments

Error and Exception Conditions

Response Format

The response must include one instance of the following elements:

Examples

Request

http://agri/OAI-PMP-script.php?
    verb=Connect&providerId=JBPTITBPP&providerSerialNumber=28H3oIZETdASw
    &epochTime=1031366328

Response

The provider ID or Serial Number is incorrect.

<?xml version="1.0" encoding="UTF-8"?> 
<OAI-PMP xmlns="http://www.indonesiadln.org/OAI/1.0/" 
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xsi:schemaLocation="http://www.indonesiadln.org/OAI/1.0/
     http://www.indonesiadln.org/OAI/1.0/OAI-PMP.xsd">
  <responseDate>2002-02-08T08:55:46Z</responseDate>
  <request verb="Connect" providerId="JBPTITBPP"
       providerSerialNumber="
28H3oIZETdASw"
       epochTime="
1031366328">http://agri/OAI-PMP-script.php</request> 
  <error code="noRecordsMatch">Incorrect ID or Serial Number</error>
</OAI-PMP>

The provider ID and Serial Number are correct and connection session is created.

<?xml version="1.0" encoding="UTF-8"?> 
<OAI-PMP xmlns="http://www.indonesiadln.org/OAI/1.0/" 
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xsi:schemaLocation="http://www.indonesiadln.org/OAI/1.0/
     http://www.indonesiadln.org/OAI/1.0/OAI-PMP.xsd">
  <responseDate>2002-02-08T08:55:46Z</responseDate>
  <request verb="Connect" 
       providerId="JBPTITBPP"
       providerSerialNumber="
28H3oIZETdASw"
       epochTime="
1031366328">http://agri/OAI-PMP-script.php</request> 
    <Connect>
        <sessionId>ca612fe33acc768d4aa2f5940238c8ae</sessionId>
    </Connect>
</OAI-PMP>

3. Disconnect

Summary and Usage Notes

This verb is used to disconnect from the HUB server.

Arguments

Error and Exception Conditions

Response Format

The response must include one instance of the following elements:

Examples

Request

http://agri/OAI-PMP-script.php?
    verb=Disconnect&sessionId=ca612fe33acc768d4aa2f5940238c8ae

Response

e provider ID or Serial Number is incorrect.

 

Currently is not implemented.

 

4. PutRecord

Summary and Usage Notes

This verb is used to post a record. The record could contain metadata of the digital archives, discussion message, provider information, or member information.

Arguments

Error and Exception Conditions

Response Format

The response must include one instance of the following elements:

Examples

Request

POST http://agri/OAI-PMP-script.php?
    verb=PutRecord&sessionId=ca612fe33acc768d4aa2f5940238c8ae
    &identifier=jbptitbpp-agriknow-mmedia-2002
    &metadataPrefix=dc_etd HTTP/1.0 \r\n

Content-type: application/x-www-form-urlencoded\r\n
Content-length: 345\r\n\r\n

<?xml version="1.0" encoding="UTF-8"?> 
<OAI-PMP xmlns="http://www.indonesiadln.org/OAI/1.0/" 
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xsi:schemaLocation="http://www.indonesiadln.org/OAI/1.0/
     http://www.indonesiadln.org/OAI/1.0/OAI-PMP.xsd">
  <requestDate>2002-02-08T08:55:46Z</requestDate>
  <PutRecord>
    <record>
       <header>
         <identifier>jbptitbpp-agriknow-mmedia-2002</identifier>
         <datestamp>2000-11-12</datestamp>
         <setSpec>multimedia</setSpec>
       </header>
       <metadata>
         <oai_dc:dc
             xmlns="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"> 
                     <title>Using Structural Metadata to Localize Experience of 
                     Digital Content</title>
          <creator>Dushay, Naomi</creator>
          <subject>Digital Libraries</subject>
          <description>With the increasing technical sophistication of 
              both information consumers and providers, there is increasing 
              demand for more meaningful experiences of digital information. 
              We present a framework that separates digital object 
              experience, or rendering, from digital object storage and 
              manipulation, so the rendering can be tailored to particular 
              communities of users. </description> 
          <description>Comment: 23 pages including 2 appendices, 8 
              figures</description> 
          <date>2001-12-14</date> 
         </oai_dc:dc>
       </metadata>
    </record>
  </PutRecord>
</OAI-PMP>

Response

?

5. PutListRecords

Summary and Usage Notes

This verb is used to post a list of records. The records could contain metadata of the digital archives, discussion message, provider information, or member information.

Arguments

Error and Exception Conditions

Response Format

The response must include one instance of the following elements:

Examples

Request

POST http://agri/OAI-PMP-script.php?
    verb=PutListRecords&PHPSESSID=ca612fe33acc768d4aa2f5940238c8ae
    &countRecords=2
    &metadataPrefix=dc_etd HTTP/1.0 \r\n

Content-type: application/x-www-form-urlencoded\r\n
Content-length: 345\r\n\r\n

<?xml version="1.0" encoding="UTF-8"?> 
<OAI-PMP xmlns="http://www.indonesiadln.org/OAI/1.0/" 
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xsi:schemaLocation="http://www.indonesiadln.org/OAI/1.0/
     http://www.indonesiadln.org/OAI/1.0/OAI-PMP.xsd">
  <requestDate>2002-02-08T08:55:46Z</requestDate>
  <PutListRecords>
    <record>
       <header>
         <identifier>jbptitbpp-agriknow-mmedia-2002</identifier>
         <datestamp>2000-11-12</datestamp>
         <setSpec>multimedia</setSpec>
       </header>
       <metadata>
         <oai_dc:dc
             xmlns="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"> 
                     <title>Using Structural Metadata to Localize Experience of 
                     Digital Content</title>
          <creator>Dushay, Naomi</creator>
          <subject>Digital Libraries</subject>
          <description>With the increasing technical sophistication of 
              both information consumers and providers, there is increasing 
              demand for more meaningful experiences of digital information. 
              We present a framework that separates digital object 
              experience, or rendering, from digital object storage and 
              manipulation, so the rendering can be tailored to particular 
              communities of users. </description> 
          <description>Comment: 23 pages including 2 appendices, 8 
              figures</description> 
          <date>2001-12-14</date> 
         </oai_dc:dc>
       </metadata>
    </record>
    <record>
       <header>
         <identifier>jbptitbpp-agriknow-mmedia-2002</identifier>
         <datestamp>2000-11-12</datestamp>
         <setSpec>multimedia</setSpec>
       </header>
       <metadata>
         <oai_dc:dc
             xmlns="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"> 
                     <title>Using Structural Metadata to Localize Experience of 
                     Digital Content</title>
          <creator>Dushay, Naomi</creator>
          <subject>Digital Libraries</subject>
          <description>With the increasing technical sophistication of 
              both information consumers and providers, there is increasing 
              demand for more meaningful experiences of digital information. 
              We present a framework that separates digital object 
              experience, or rendering, from digital object storage and 
              manipulation, so the rendering can be tailored to particular 
              communities of users. </description> 
          <description>Comment: 23 pages including 2 appendices, 8 
              figures</description> 
          <date>2001-12-14</date> 
         </oai_dc:dc>
       </metadata>
    </record>
  </PutListRecords>
</OAI-PMP>

Response