Implementation Guidelines for the Open Archives Initiative Protocol for Metadata Harvesting

OAI logo

XML Schema to describe content and policies of repositories in the e-print community

  Protocol Version 2.0 of 2002-06-14
Document Version 2003/11/21T19:15:00Z
http://www.openarchives.org/OAI/2.0/guidelines-eprints.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).

XML Schema to describe content and policies of repositories in the e-print community

The eprints container is used by the e-print community to describe the content and policies of repositories.

eprints description container

<schema xmlns="http://www.w3.org/2001/XMLSchema"
           xmlns:eprints="http://www.openarchives.org/OAI/1.1/eprints"
           targetNamespace="http://www.openarchives.org/OAI/1.1/eprints"
           elementFormDefault="qualified"
           attributeFormDefault="unqualified">

    <annotation>
     <documentation>
      Schema for description section of Identify reply, defined by the e-print community.
      the Open Archives Initiative. 2000. 
      Validated at http://www.w3.org/2001/webdata/xsv on 05-09-2001.
     </documentation>
    </annotation>

  <element name="eprints" type="eprints:eprintsDescriptionType"/>

  <complexType name="eprintsDescriptionType">
   <sequence>
    <!--    ....   -->
    <!-- "content" : Text and/or a URL linking to text describing the content of the repository.     -->
    <!-- It would be appropriate to indicate the language(s) of the metadata/data in the repository. -->
    <!--    ....   -->
    <element name="content"  minOccurs="0" maxOccurs="1" type="eprints:TextURLType"/>
    <!--    ....   -->
    <!-- "metadataPolicy" : Text and/or a URL linking to text describing policies relating to the use of metadata  -->  
    <!-- harvested through the OAI interface.  -->  
    <!--    ....   -->   
    <element name="metadataPolicy"  minOccurs="1" maxOccurs="1" type="eprints:TextURLType"/>
    <!--    ....   -->
    <!-- "dataPolicy" : Text and/or a URL linking to text describing policies relating to the data  -->  
    <!-- held in the repository.  This may also describe policies regarding downloading data (full-content). -->  
    <!--    ....   -->  
    <element name="dataPolicy"  minOccurs="1" maxOccurs="1" type="eprints:TextURLType"/>
    <!--    ....   -->
    <!-- "submissionPolicy" : Text and/or a URL linking to text describing policies relating to -->
    <!-- the submission of content to the repository (or other accession mechanisms).  -->  
    <!--    ....   -->  
    <element name="submissionPolicy"  minOccurs="0" maxOccurs="1" type="eprints:TextURLType"/>
    <!--    ....   -->  
    <!-- "comment" : Text and/or a URL linking to text describing anything else that is -->
    <!-- not covered by the fields above. It would be appropriate to include additional -->  
    <!-- contact details (additional to the adminEmail that is part of the response to the Identify request). -->  
    <!--    ....   --> 
    <element name="comment"  minOccurs="0" maxOccurs="unbounded" type="string"/>
   </sequence>
  </complexType>

  <complexType name="TextURLType">
  <choice minOccurs="0" maxOccurs="unbounded">
    <element name="URL" minOccurs="0" maxOccurs="unbounded" type="anyURI"/>
    <element name="text" minOccurs="0" maxOccurs="unbounded" type="string"/>
  </choice>
  </complexType>

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

Examples

The following examples are excerpts from Identify responses which may contain zero or more <description> containers.

<description>
  <eprints xmlns="http://www.openarchives.org/OAI/1.1/eprints"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:schemaLocation="http://www.openarchives.org/OAI/1.1/eprints         
      http://www.openarchives.org/OAI/1.1/eprints.xsd">
   <content>
     <URL>http://arXiv.org/arXiv_content.htm</URL>
   </content>
   <metadataPolicy>
     <text>Metadata can be used by commercial and non-commercial 
           service providers</text>
     <URL>http://arXiv.org/arXiv_metadata_use.htm</URL>
   </metadataPolicy>
   <dataPolicy>
     <text>Full content, i.e. preprints may not be harvested by robots</text>
   </dataPolicy>
   <submissionPolicy>
     <URL>http://arXiv.org/arXiv_submission.htm</URL>
   </submissionPolicy>
 </eprints>
</description>
<description>
  <eprints xmlns="http://www.openarchives.org/OAI/1.1/eprints" 
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
      xsi:schemaLocation="http://www.openarchives.org/OAI/1.1/eprints 
      http://www.openarchives.org/OAI/1.1/eprints.xsd">
    <content>
      <text>Serveur de Th&#232;ses du CCSD-CNRS</text>
    </content>
    <metadataPolicy>
      <text>CCSD metadata are freely accessible to all, under the following conditions:
 (1) The full name of the author and (2) the full bibliographic reference information
 for the thesis must always co-appear prominently with any redisplay of
 the metadata, in any medium. The metadata may not be offered for sale.</text>
    </metadataPolicy>
    <dataPolicy>
      <text>CCSD full-text thesis are freely accessible to all under the following conditions:
 (1) The full name of the author and (2) the full bibliographic reference information
 for the thesis must always co-appear prominently with redisplay of the text, in any medium.
 The text may not be offered for sale.</text>
    </dataPolicy>
    <submissionPolicy>
      <text>Submissions are made by Faculty and EPST members.</text>
    </submissionPolicy>
    <comment>System is EPrints Version 1.1.1 (23/01/2001) with 
    french language (http://www.eprints.org/)</comment>
  </eprints>
</description>

Acknowledgements

Support for the development of the OAI-PMH and for other Open Archives Initiative activities comes from the Digital Library Federation, the Coalition for Networked Information, and 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

2003-11-21: Corrected minor errors (typo and incorrect use of named instead of numeric entity in example).
2002-06-14: Release of this document, combined with the release of OAI-PMH version 2.0.