Difference between revisions of "Oai.pl"

From EPrints Documentation
Jump to: navigation, search
(Added page about config file)
 
(Added actually file name in bold.)
 
Line 2: Line 2:
 
{{cfgd}}
 
{{cfgd}}
  
This file contains configuration for [[OAI]].  This defines an <code>$oai</code> hash reference, which is assigned to <code>$c->{oai}</code>.  This has the following configuration settings assigned to it.
+
'''oai.pl''' contains configuration for [[OAI]].  This defines an <code>$oai</code> hash reference, which is assigned to <code>$c->{oai}</code>.  This has the following configuration settings assigned to it.
 
* '''<code>$oai->{v2}->{archive_id}</code>''' - The archive ID to register the archive with OAI.  This is commented out by default and if used should be set to something unique list the archive's hostname.
 
* '''<code>$oai->{v2}->{archive_id}</code>''' - The archive ID to register the archive with OAI.  This is commented out by default and if used should be set to something unique list the archive's hostname.
 
* '''<code>$oai->{v2}->{base_url}</code>''' - The base URL for accessing OAI pages.  By default this is the path ''/cgi/oai2'' under the archive's HTTP or HTTPS base URL.
 
* '''<code>$oai->{v2}->{base_url}</code>''' - The base URL for accessing OAI pages.  By default this is the path ''/cgi/oai2'' under the archive's HTTP or HTTPS base URL.

Latest revision as of 10:49, 30 January 2022

EPrints 3 Reference: Directory Structure - Metadata Fields - Repository Configuration - XML Config Files - XML Export Format - EPrints data structure - Core API - Data Objects


Back to cfg.d

oai.pl contains configuration for OAI. This defines an $oai hash reference, which is assigned to $c->{oai}. This has the following configuration settings assigned to it.

  • $oai->{v2}->{archive_id} - The archive ID to register the archive with OAI. This is commented out by default and if used should be set to something unique list the archive's hostname.
  • $oai->{v2}->{base_url} - The base URL for accessing OAI pages. By default this is the path /cgi/oai2 under the archive's HTTP or HTTPS base URL.
  • $oai->{sets} - The types of sets to be made available for OAI-PMH. By default these are:
    1. status - Sets for the different values of the eprint's ispublished field.
    2. subjects - Sets for the different values of the eprint's subjects field.
    3. types - Sets for the different values of the eprint's type field.
  • $oai->{custom sets} - Specifications for custom sets to be made available for OAI-PMH. By default there is only one custom set Open Access DRIVERset, which contains all eprints where the full_text_status is set to public.
  • $oai->{filters} - Filters to exclude certain items from OAI set. E.g. not before a certain date.
  • $oai->{mime_types} - Maps document type to an appropriate MIME type.
  • $oai->{content} - Specify either some text or a URL link describing the content of the archive.
  • $oai->{metadata_policy} - Specify either some text or a URL link describing the metadata policy for the archive.
  • $oai->{data_policy} - Specify either some text or a URL link describing the data policy for the archive.
  • $oai->{submission_policy} - Specify either some text or a URL link describing the submission policy for the archive.
  • $oai->{comments} - Specify some comments to describe anything not covered in the content or policies text / URLs.