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
- Introduction
- Connect
- Disconnect
- PutRecord
- PutListRecords
- PutFileFragment
- MergeFileFragments
1. Introduction
motivations..
2. Connect
Summary and Usage Notes
This verb is used to get authentication from the HUB server.
Arguments
- providerId a required
argument that specifies the provider ID (registered from IndonesiaDLN Hub
servers).
- epochTime a required
argiment that specifies the seconds since the epoch when the request is
generated.
- providerSerialNumber a required
argument that specifies the encripted serial number. Encription is using md5(providerSerialNumber-epochTime)
based on the md5 Message-Digest algorithm.
Error and Exception Conditions
- badArgument
- noRecordsMatch
- badSerialNumber
- badEpochTime
- systemError
Response Format
The response must include one instance of the following elements:
- sessionId - connection session
Identifier for the client that is generated by the Hub server.
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
- sessionId a required
argument that specifies the connection session id.
Error and Exception Conditions
- badArgument -
- noSessionsMatch -
Response Format
The response must include one instance of the following elements:
- status - connection session
Identifier for the client that is generated by the Hub server.
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
- sessionId a required
argument that specifies the connection sessionId.
The sessionId is assigned when the
last time server performs the Connect request.
- identifier a required
argument that specifies the unique identifier of the item in the
repository from which the record must be disseminated.
- metadataPrefix a required
argument that specifies the metadataPrefix
of the format that should be included in the metadata part of the returned
record .
Error and Exception Conditions
Response Format
The response must include one instance of the following elements:
- status - connection session
Identifier for the client that is generated by the Hub server.
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
- PHPSESSID a required
argument that specifies the connection sessionId.
The sessionId is assigned when the
last time server performs the Connect request.
- countRecords a required
argument that specifies the number of records that will be posted.
- metadataPrefix a required
argument that specifies the metadataPrefix
of the format that should be included in the metadata part of the returned
record .
Error and Exception Conditions
Response Format
The response must include one instance of the following elements:
- status - connection session
Identifier for the client that is generated by the Hub server.
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