Implementation Guidelines for the Open Archives Initiative Protocol for Metadata Harvesting

OAI logo

XML Schema for Gateway Descriptions

  Protocol Version 2.0 of 2002-06-14
Document Version 2004/03/18T16:04:00Z
http://www.openarchives.org/OAI/2.0/guidelines-gateway.htm

Editors

The OAI Executive:
Herbert Van de Sompel <herbertv@lanl.gov> -- Los Alamos National Laboratory - Research Library
Carl Lagoze <lagoze@cs.cornell.edu> -- Cornell University - Computing and Information Science

From the OAI Technical Committee:
Michael Nelson <mln@cs.odu.edu> -- Old Dominion University - Dept of Computer Science
Simeon Warner <simeon@cs.cornell.edu> -- Cornell University - Computing and Information Science

This document is one part of the Implementation Guidelines that accompany the Open Archives Initiative Protocol for Metadata Harvesting (OAI-PMH).

1. Introduction

A gateway  is a service that allows OAI-PMH access to data that are ordinarily accessible only through other protocols (e.g., Z39.50, Dienst). A notable example of a gateway is a Static Repository Gateway that provides OAI-PMH access to Static Repositories. The gateway container is used to provide information about a gateway. A gateway may include a gateway container as part of the description block in the OAI-PMH Identify response. A gateway must not embed more than one gateway container in an Identify response.

2. The gateway container

The gateway container consists of XML elements that describe the gateway itself. The gateway container must include one instance of each of the following elements:

The gateway container must include one or more instance of the following element:

The gateway container may include one instance of each of the following elements:

XML Schema for Gateway Descriptions
<?xml version="1.0" encoding="UTF-8"?>
<schema targetNamespace="http://www.openarchives.org/OAI/2.0/gateway/"
  xmlns="http://www.w3.org/2001/XMLSchema" 
  xmlns:oai="http://www.openarchives.org/OAI/2.0/"
  xmlns:gateway="http://www.openarchives.org/OAI/2.0/gateway/" 
  elementFormDefault="qualified" attributeFormDefault="unqualified">

  <import namespace="http://www.openarchives.org/OAI/2.0/" 
          schemaLocation="http://www.openarchives.org/OAI/2.0/OAI-PMH.xsd"/>

  <annotation>
    <documentation>
      Schema for gateways between OAI-PMH and other protocols / formats
      $Date: 2003/10/10 17:09:06 $ 
    </documentation>
  </annotation>

  <element name="gateway">
    <complexType>
      <sequence>
        <element name="source" type="string"/>
        <element name="gatewayDescription" type="anyURI"/>
        <element name="gatewayAdmin" maxOccurs="unbounded" 
                 type="oai:emailType"/>
        <element name="gatewayURL" minOccurs="0" type="anyURI"/>
        <element name="gatewayNotes" minOccurs="0" type="anyURI"/>
      </sequence>
    </complexType>
  </element>

</schema>
This Schema is available at http://www.openarchives.org/OAI/2.0/gateway.xsd

3. Examples

The following example shows a gateway container returned in a description block in the response to an Identify request issued against a gateway that converts between the Dienst protocol and the OAI-PMH.

Example Gateway Container for a Dienst-OAI Gateway
<?xml version="1.0" encoding="UTF-8"?>
<gateway xmlns="http://www.openarchives.org/OAI/2.0/gateway/"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://www.openarchives.org/OAI/2.0/gateway/
                      http://www.openarchives.org/OAI/2.0/gateway.xsd">
  <source>http://foo.edu/Dienst/</source>
  <gatewayDescription>http://cs-tr.cs.cornell.edu/Dienst/UI/2.0/Describe/ncstrl.cornell/TR94-1418</gatewayDescription>
  <gatewayAdmin>admin@bar.edu</gatewayAdmin>
  <gatewayAdmin>admin-alternative@bar.edu</gatewayAdmin>
  <gatewayURL>http://bar.edu/oai-gateway/2.0/</gatewayURL>
  <gatewayNotes>http://bar.edu/oai-gateway/notes.html</gatewayNotes>
</gateway>

The following example shows a gateway container returned in a description block in the response to an Identify request issued against a gateway that converts between the Static Repository Format and the OAI-PMH.

Example Gateway Container for a Static Repository Gateway
<?xml version="1.0" encoding="UTF-8"?>
<gateway xmlns="http://www.openarchives.org/OAI/2.0/gateway/"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://www.openarchives.org/OAI/2.0/gateway/
                      http://www.openarchives.org/OAI/2.0/gateway.xsd">
  <source>http://an.oai.org/ma/mini.xml</source>
  <gatewayDescription>http://www.openarchives.org/OAI/2.0/guidelines-static-repository.htm</gatewayDescription>
  <gatewayAdmin>pat@institution.org</gatewayAdmin>
  <gatewayURL>http://bar.edu/oai-gateway/2.0/</gatewayURL>
  <gatewayNotes>http://gateway.institution.org/oai/</gatewayNotes>
</gateway>

Acknowledgements

Support for the development of the OAI-PMH and for other Open Archives Initiative activities comes from the National Science Foundation through Grant No. IIS-9817416. Individuals who have played a significant role in the development of OAI-PMH version 2.0 are acknowledged in the protocol document.

Document History

2004-04-23: Released with Specification for an OAI Static Repository and an OAI Static Repository Gateway.
2003-10-10: Beta release.
2002-11-13: Alpha release.
2002-11-08: First version of this document.