|
|
| (25 intermediate revisions by 2 users not shown) |
| Line 1: |
Line 1: |
| This page proves an overview of the API calls you can use to access the data in a DataObj. The example framing this is that of an export plugin.
| | #REDIRECT [[Accessing Metadata Fields]] |
| | |
| == The Plugin ==
| |
| | |
| Below is a very simple export plugin, which outputs a single eprint or list of eprints as Text citations.
| |
| | |
| <pre>
| |
| package EPrints::Plugin::Export::Text;
| |
| | |
| use EPrints::Plugin::Export::TextFile;
| |
| | |
| @ISA = ( "EPrints::Plugin::Export::TextFile" );
| |
| | |
| use strict;
| |
| | |
| sub new
| |
| {
| |
| my( $class, %opts ) = @_;
| |
| | |
| my $self = $class->SUPER::new( %opts );
| |
| | |
| $self->{name} = "ASCII Citation";
| |
| $self->{accept} = [ 'dataobj/eprint', 'list/eprint' ];
| |
| $self->{visible} = "all";
| |
| | |
| return $self;
| |
| }
| |
| | |
| | |
| sub output_dataobj
| |
| {
| |
| my( $plugin, $dataobj ) = @_;
| |
| | |
| my $cite = $dataobj->render_citation;
| |
| | |
| return EPrints::Utils::tree_to_utf8( $cite )."\n\n";
| |
| }
| |
| | |
| 1;
| |
| </pre>
| |
| | |
| Note the output_dataobj function. In an export plugin, this will be called on every item in the list that is being exported, and the results for all items aggregated and outputted.
| |
| | |
| There are two function calls of particular interest that aid in retrieving and managing data:
| |
| | |
| <pre>
| |
| my $cite = $dataobj->render_citation;
| |
| </pre>
| |
| | |
| This returns an HTML DOM object containing the citation of the dataobj as specified in the configuration files (see cfg/citations/eprint/default.xml). Given an HTML DOM object, the following call will convert it into a string:
| |
| | |
| <pre>
| |
| my $text = EPrints::Utils::tree_to_utf8( $html_dom )
| |
| </pre>
| |
| | |
| == Accessing Metadata ==
| |
| | |
| A number of functions exist to aid in accessing and rendering values in a dataobj.
| |
| | |
| <pre>
| |
| my $title = $dataobj->value('title');
| |
| </pre>
| |
| | |
| $title will now be a scalar containing the value stored in the title field of the dataobj. A function is provided to enable testing first:
| |
| | |
| <pre>
| |
| if ($dataobj->is_set('title'))
| |
| {
| |
| $title = $dataobj->value('title');
| |
| }
| |
| </pre>
| |
| | |
| It is also possible to find out the fields that an item does have by querying the item's dataset:
| |
| | |
| <pre>
| |
| my $ds = $dataobj->dataset;
| |
| my @fields = $ds->fields;
| |
| my %fieldvalues
| |
| foreach my $field (@field)
| |
| {
| |
| my $fieldname = $field->name;
| |
| if ($dataobj->is_set($fieldname))
| |
| {
| |
| $fieldvalues{$fieldname} = $dataobj->value($fieldname);
| |
| }
| |
| }
| |
| </pre>
| |
| | |
| == The Structure of Values ==
| |
| | |
| On an eprint, the title is generally a simple metadata field. When $dataobj->value is called, it returns a scalar value.
| |
| | |
| EPrints has four types of metadata field:
| |
| | |
| * Simple
| |
| * Compound
| |
| * Multiple
| |
| * Multiple Compound
| |