Difference between revisions of "Contribute: Plugins/ExportPluginsExcel"

From EPrints Documentation
Jump to: navigation, search
(Setting Up a Workbook)
(Handling DataObjs)
Line 158: Line 158:
  
 
=== Handling DataObjs ===
 
=== Handling DataObjs ===
 +
To start adding data to the Excel file we have to create a worksheet.
 
<pre>
 
<pre>
 
   my $worksheet = $workbook->add_worksheet();
 
   my $worksheet = $workbook->add_worksheet();
 +
</pre>
  
  my $i = 0;
+
To the first row of our worksheet we add the names of all the metadata fields that can be associated with eprints. We get the session associated with the plugin, and then the repository associated with that session. We then get the DataSet "archive" from that repository and call the get_fields method. That method returns an array of MetaField objects.
 +
<pre>
 
   my @fields =
 
   my @fields =
 
   $plugin->{session}->get_repository->get_dataset("archive")->get_fields;
 
   $plugin->{session}->get_repository->get_dataset("archive")->get_fields;
 +
</pre>
  
 +
Here we loop over each field and write it's name to our worksheet.
 +
<pre>
 
   foreach my $field (@fields)
 
   foreach my $field (@fields)
 
   {
 
   {
Line 170: Line 176:
 
     $i++;
 
     $i++;
 
   }
 
   }
 +
</pre>
  
  $i = 1;
+
We now loop over each DataObj in our list, and over each MetaField we found earlier.
 +
<pre>
 
   foreach my $dataobj ($opts{list}->get_records)
 
   foreach my $dataobj ($opts{list}->get_records)
 
   {
 
   {
Line 177: Line 185:
 
     foreach my $field (@fields)
 
     foreach my $field (@fields)
 
     {
 
     {
 +
</pre>
 +
 +
We only write something to the worksheet if the field can apply to the DataObj and is set. Scalar values are simply written to the worksheet.
 +
<pre>
 
       if ($dataobj->exists_and_set($field->get_name))
 
       if ($dataobj->exists_and_set($field->get_name))
      {
+
</pre>
 +
 
 +
The plugin handles fields which can take multiple values in a number of ways. 
 +
<pre>
 
         if ($field->get_property("multiple"))
 
         if ($field->get_property("multiple"))
        {
+
</pre>
 +
Names are handled specially and are formatted with the family name followed by a comma, the given name or initial and then a semi-colon.
 +
<pre>
 
           if ($field->{type} eq "name")
 
           if ($field->{type} eq "name")
 
           {
 
           {
Line 190: Line 207:
 
             $worksheet->write($i, $j, $namelist);
 
             $worksheet->write($i, $j, $namelist);
 
           }
 
           }
 +
</pre>
 +
Fields which have a compound type are not handled, and "COMPOUND" is written to the worksheet.
 +
<pre>
 
           elsif ($field->{type} eq "compound")
 
           elsif ($field->{type} eq "compound")
 
           {
 
           {
 
             $worksheet->write($i, $j, "COMPOUND");
 
             $worksheet->write($i, $j, "COMPOUND");
 
           }
 
           }
 +
</pre>
 +
For most multiple fields each value is taken and concatenated, separated by semi-colons.
 +
<pre>
 
           else
 
           else
 
           {
 
           {
Line 199: Line 222:
 
                         join(';',@{$dataobj->get_value($field->get_name)}));
 
                         join(';',@{$dataobj->get_value($field->get_name)}));
 
           }
 
           }
        }
 
        else {
 
          $worksheet->write($i, $j, $dataobj->get_value($field->get_name));
 
        }
 
      }
 
      $j++;
 
    }
 
    $i++;
 
  }
 
 
</pre>
 
</pre>
  

Revision as of 11:44, 3 September 2007

Export Plugin Tutorial 4: Excel

In this tutorial and the next one we'll look at exporting files in non-text formats. Here we will explore exporting metadata in Excel format (pre Microsoft Office 2007 which uses an XML based format).

To prepare for this tutorial you should install the Spreadsheet::Excel module. The following command as root, or using sudo should work.

cpan Spreadsheet::Excel

Excel.pm

package EPrints::Plugin::Export::MyPlugins::Excel;

@ISA = ("EPrints::Plugin::Export");

use strict;
use Spreadsheet::WriteExcel;

sub new
{
  my ($class, %opts) = @_;
  my $self = $class->SUPER::new(%opts);

  $self->{name} = "Excel";
  $self->{accept} = ['list/eprint'];
  $self->{visible} = "all";
  $self->{suffix} = ".xls";
  $self->{mimetype} = "application/vnd.ms-excel";

  return $self;
}

sub output_list
{
  my ($plugin, %opts) = @_;
  my $workbook;

  my $output;
  open(my $FH,'>',\$output);

  if (defined $opts{"fh"})
  {
    $workbook = Spreadsheet::WriteExcel->new(\*{$opts{"fh"}});
    die("Unable to create spreadsheet: $!")unless defined $workbook;
  }
  else
  {
    $workbook = Spreadsheet::WriteExcel->new($FH);
    die("Unable to create spreadsheet: $!")unless defined $workbook;
  }

  my $worksheet = $workbook->add_worksheet();

  my $i = 0;
  my @fields =
  $plugin->{session}->get_repository->get_dataset("archive")->get_fields;

  foreach my $field (@fields)
  {
    $worksheet->write(0, $i, $field->get_name);
    $i++;
  }

  $i = 1;
  foreach my $dataobj ($opts{list}->get_records)
  {
    my $j = 0;
    foreach my $field (@fields)
    {
      if ($dataobj->exists_and_set($field->get_name))
      {
        if ($field->get_property("multiple"))
        {
          if ($field->{type} eq "name")
          {
            my $namelist = '';
            foreach my $name (@{$dataobj->get_value_raw($field->get_name)})
            {
              $namelist .= $name->{family} . "," . $name->{given} . ";";
            }
            $worksheet->write($i, $j, $namelist);
          }
          elsif ($field->{type} eq "compound")
          {
            $worksheet->write($i, $j, "COMPOUND");
          }
          else
          {
            $worksheet->write($i, $j,
                        join(';',@{$dataobj->get_value($field->get_name)}));
          }
        }
        else {
          $worksheet->write($i, $j, $dataobj->get_value($field->get_name));
        }
      }
      $j++;
    }
    $i++;
  }

  $workbook->close;

  if (defined $opts{"fh"})
  {
    return undef;
  }

  return $output;
}

1;

In More Detail

Modules

We need to import a module for creating Excel files.

use Spreadsheet::WriteExcel;

Constructor

For the sake of simplicity this plugin will only deal with lists of eprints. This avoids some code duplication, and it would be fairly easy to modify the plugin to deal with both individual eprints and lists of eprints sensibly.

  
  $self->{accept} = ['list/eprint'];

The file extension and MIME type are set to values appropriate for Excel files.

  $self->{suffix} = ".xls";
  $self->{mimetype} = "application/vnd.ms-excel";

List Handling

Setting Up a Workbook

Here we create a new Excel workbook. We start by creating a file handle using a scalar rather than a filename, this creates an in-memory file. Then depending on if a file handle has been supplied or not we create a workbook object that will be written to that file handle or the scalar file handle we just created.

  my $workbook;

  my $output;
  open(my $FH,'>',\$output);

  if (defined $opts{"fh"})
  {
    $workbook = Spreadsheet::WriteExcel->new(\*{$opts{"fh"}});
    die("Unable to create spreadsheet: $!")unless defined $workbook;
  }
  else
  {
    $workbook = Spreadsheet::WriteExcel->new($FH);
    die("Unable to create spreadsheet: $!")unless defined $workbook;
  }

Handling DataObjs

To start adding data to the Excel file we have to create a worksheet.

  my $worksheet = $workbook->add_worksheet();

To the first row of our worksheet we add the names of all the metadata fields that can be associated with eprints. We get the session associated with the plugin, and then the repository associated with that session. We then get the DataSet "archive" from that repository and call the get_fields method. That method returns an array of MetaField objects.

  my @fields =
  $plugin->{session}->get_repository->get_dataset("archive")->get_fields;

Here we loop over each field and write it's name to our worksheet.

  foreach my $field (@fields)
  {
    $worksheet->write(0, $i, $field->get_name);
    $i++;
  }

We now loop over each DataObj in our list, and over each MetaField we found earlier.

  foreach my $dataobj ($opts{list}->get_records)
  {
    my $j = 0;
    foreach my $field (@fields)
    {

We only write something to the worksheet if the field can apply to the DataObj and is set. Scalar values are simply written to the worksheet.

      if ($dataobj->exists_and_set($field->get_name))

The plugin handles fields which can take multiple values in a number of ways.

        if ($field->get_property("multiple"))

Names are handled specially and are formatted with the family name followed by a comma, the given name or initial and then a semi-colon.

          if ($field->{type} eq "name")
          {
            my $namelist = '';
            foreach my $name (@{$dataobj->get_value_raw($field->get_name)})
            {
              $namelist .= $name->{family} . "," . $name->{given} . ";";
            }
            $worksheet->write($i, $j, $namelist);
          }

Fields which have a compound type are not handled, and "COMPOUND" is written to the worksheet.

          elsif ($field->{type} eq "compound")
          {
            $worksheet->write($i, $j, "COMPOUND");
          }

For most multiple fields each value is taken and concatenated, separated by semi-colons.

          else
          {
            $worksheet->write($i, $j,
                        join(';',@{$dataobj->get_value($field->get_name)}));
          }

Finishing Up

  $workbook->close;

  if (defined $opts{"fh"})
  {
    return undef;
  }

  return $output;

Testing Your Plugin

Restart your webserver and test the plugin as in the previous tutorial.