Difference between revisions of "OAI FAQ"

From EPrints Documentation
Jump to: navigation, search
Line 1: Line 1:
What is OAI?
+
== What is OAI?==
 
See http://www.openarchives.org/
 
See http://www.openarchives.org/
  
What version of OAI does EPrints support?
+
== What version of OAI does EPrints support? ==
 
Version 1.1 and 2.0, although 1.1 is deprecated and we strongly recommend you do not use it.
 
Version 1.1 and 2.0, although 1.1 is deprecated and we strongly recommend you do not use it.
  
What is the OAI URL for my archive?
+
== What is the OAI URL for my archive? ==
 
It is the base URL of your archive plus /perl/oai2 eg. http://eprints.soton.ac.uk/perl/oai2
 
It is the base URL of your archive plus /perl/oai2 eg. http://eprints.soton.ac.uk/perl/oai2
  
When verifying/registering my archive OAI interface I get "empty resumpotion token" error.
+
== When verifying/registering my archive OAI interface I get "empty resumpotion token" error. ==
 
This is a known bug in 2.3 and should be fixed in the next release - see http://threader.ecs.soton.ac.uk/lists/eprints_tech/1926.html for a patch.
 
This is a known bug in 2.3 and should be fixed in the next release - see http://threader.ecs.soton.ac.uk/lists/eprints_tech/1926.html for a patch.
  
Line 27: Line 27:
 
There is a bug that strips all xmlns attributes from all XML output from eprints. This is good for XHTML but bad for everything else. It'll be fixed in the next release. If it's urgent search perl_lib/EPrints/XML.pm for the line which removes xmlns attributes and comment it out (add a # to the start of the line). It's a single line...
 
There is a bug that strips all xmlns attributes from all XML output from eprints. This is good for XHTML but bad for everything else. It'll be fixed in the next release. If it's urgent search perl_lib/EPrints/XML.pm for the line which removes xmlns attributes and comment it out (add a # to the start of the line). It's a single line...
  
                        next if( $name =~ m/^xmlns/ );
+
      next if( $name =~ m/^xmlns/ );

Revision as of 14:36, 2 March 2006

What is OAI?

See http://www.openarchives.org/

What version of OAI does EPrints support?

Version 1.1 and 2.0, although 1.1 is deprecated and we strongly recommend you do not use it.

What is the OAI URL for my archive?

It is the base URL of your archive plus /perl/oai2 eg. http://eprints.soton.ac.uk/perl/oai2

When verifying/registering my archive OAI interface I get "empty resumpotion token" error.

This is a known bug in 2.3 and should be fixed in the next release - see http://threader.ecs.soton.ac.uk/lists/eprints_tech/1926.html for a patch.

When verifying/registering my archive OAI interface I get a validation error because the "ListSets" response doesn\'t have any "Set" elements in it. Why is this? Probably a bug in the OAI configuration. In several releases we accidently left a "filter" on all the OAI output. If you have this in ArchiveOAIConfig?.pm:

$oai->{filters} = [
	{ meta_fields => [ "creators" ], value=>"harnad" }
# Example: don't export any OAI records from before 2003.
#	{ meta_fields => [ "date-effective" ], value=>"2003-" }
];

Then comment out (add a # at the start) the line with "harnad" in and restart the webserver.

I'm not sure this will resolve the problem. If not please email eprints support.

Problem validating OAI output from version 2.3.4 of eprints. There is a bug that strips all xmlns attributes from all XML output from eprints. This is good for XHTML but bad for everything else. It'll be fixed in the next release. If it's urgent search perl_lib/EPrints/XML.pm for the line which removes xmlns attributes and comment it out (add a # to the start of the line). It's a single line...

      next if( $name =~ m/^xmlns/ );