Difference between revisions of "API:EPrints/Plugin/Import"

From EPrints Documentation
Jump to: navigation, search
Line 23: Line 23:
  
 
* accept
 
* accept
*: Array reference of acceptable MIME types.
+
: Array reference of acceptable MIME types.
  
 
* actions
 
* actions
*: Array reference of named actions.
+
: Array reference of named actions.
  
 
* advertise
 
* advertise
*: Boolean for whether to advertise this plugin to users.
+
: Boolean for whether to advertise this plugin to users.
  
 
* arguments
 
* arguments
*: Hash reference of supported arguments/default values.
+
: Hash reference of supported arguments/default values.
  
 
* Handler
 
* Handler
*: Reference to a handler class, typically [[API:EPrints/CLIProcessor|EPrints::CLIProcessor]] or [[API:EPrints/ScreenProcessor|EPrints::ScreenProcessor]].
+
: Reference to a handler class, typically [[API:EPrints/CLIProcessor|EPrints::CLIProcessor]] or [[API:EPrints/ScreenProcessor|EPrints::ScreenProcessor]].
  
 
* produce
 
* produce
*: Array reference of eprint types this plugin can produce.
+
: Array reference of eprint types this plugin can produce.
  
 
* screen
 
* screen
*: The screen id this plugin uses to provide its import UI.
+
: The screen id this plugin uses to provide its import UI.
  
 
* visible
 
* visible
*: "staff" (staff only) or "all" (anyone).
+
: "staff" (staff only) or "all" (anyone).
  
 
<!-- Edit below this comment -->
 
<!-- Edit below this comment -->
Line 94: Line 94:
 
<!-- Pod2Wiki=head_copyright -->
 
<!-- Pod2Wiki=head_copyright -->
 
==COPYRIGHT==
 
==COPYRIGHT==
Copyright 2000-2011 University of Southampton.
+
Copyright 2000-2012 University of Southampton.
  
 
This file is part of EPrints http://www.eprints.org/.
 
This file is part of EPrints http://www.eprints.org/.

Revision as of 08:58, 2 April 2012

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


API: Core API

Latest Source Code (3.4, 3.3) | Revision Log | Before editing this page please read Pod2Wiki


NAME

EPrints::Plugin::Import


METHODS

new

$plugin = EPrints::Plugin::Import->new( %opts )

Create a new Import plugin. Available options:

  • accept
Array reference of acceptable MIME types.
  • actions
Array reference of named actions.
  • advertise
Boolean for whether to advertise this plugin to users.
  • arguments
Hash reference of supported arguments/default values.
  • Handler
Reference to a handler class, typically EPrints::CLIProcessor or EPrints::ScreenProcessor.
  • produce
Array reference of eprint types this plugin can produce.
  • screen
The screen id this plugin uses to provide its import UI.
  • visible
"staff" (staff only) or "all" (anyone).


input_fh

$plugin->input_fh( fh => FILEHANDLE [, %opts] )

Import one or more objects from filehandle FILEHANDLE. FILEHANDLE should be set to binary semantics.

This method should by subclassed.


input_file

$plugin->input_file( filename => FILENAME [, %opts] )

Opens FILENAME for reading, sets binary semantics and calls input_fh to actually read the file.

This method may be subclassed (e.g. see EPrints::Plugin::Import::TextFile).


epdata_to_dataobj

$dataobj = $plugin->epdata_to_dataobj( $epdata, %opts )

Turn $epdata into a EPrints::DataObj with the dataset passed in %opts.

Calls handler to perform the actual creation.


COPYRIGHT

Copyright 2000-2012 University of Southampton.

This file is part of EPrints http://www.eprints.org/.

EPrints is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

EPrints is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with EPrints. If not, see http://www.gnu.org/licenses/.