Koha/MetadataRecord.pm

   1 package Koha::MetadataRecord;
   2
   3 # Copyright 2013 C & P Bibliography Services
   4 #
   5 # This file is part of Koha.
   6 #
   7 # Koha is free software; you can redistribute it and/or modify it under the
   8 # terms of the GNU General Public License as published by the Free Software
   9 # Foundation; either version 3 of the License, or (at your option) any later
  10 # version.
  11 #
  12 # Koha is distributed in the hope that it will be useful, but WITHOUT ANY
  13 # WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
  14 # A PARTICULAR PURPOSE.  See the GNU General Public License for more details.
  15 #
  16 # You should have received a copy of the GNU General Public License along
  17 # with Koha; if not, write to the Free Software Foundation, Inc.,
  18 # 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  19
  20 =head1 NAME
  21
  22 Koha::MetadataRecord - base class for metadata records
  23
  24 =head1 SYNOPSIS
  25
  26     my $record = new Koha::MetadataRecord({ 'record' => $record });
  27
  28 =head1 DESCRIPTION
  29
  30 Object-oriented class that encapsulates all metadata (i.e. bibliographic
  31 and authority) records in Koha.
  32
  33 =cut
  34
  35 use Modern::Perl;
  36
  37 use Carp;
  38 use Koha::Util::MARC;
  39
  40 use base qw(Class::Accessor);
  41
  42 __PACKAGE__->mk_accessors(qw( record schema format id ));
  43
  44
  45 =head2 new
  46
  47     my $metadata_record = new Koha::MetadataRecord({
  48                                 record => $record,
  49                                 schema => $schema,
  50                                 format => $format,
  51                                 id     => $id
  52                           });
  53
  54 Returns a Koha::MetadataRecord object encapsulating record metadata.
  55
  56 C<$record> is expected to be a deserialized object (for example
  57 a MARC::Record or XML::LibXML::Document object or JSON).
  58
  59 C<$schema> is used to describe the metadata schema (for example
  60 marc21, unimarc, dc, mods, etc).
  61
  62 C<$format> is used to specify the serialization format. It is important
  63 for Koha::RecordProcessor because it will pick the right Koha::Filter
  64 implementation based on this parameter. Valid values are:
  65
  66    MARC (for MARC::Record objects)
  67    XML  (for XML::LibXML::Document objects)
  68    JSON (for JSON objects)
  69
  70 (optional) C<$id> is used so the record carries its own id and Koha doesn't
  71 need to look for it inside the record.
  72
  73 =cut
  74
  75 sub new {
  76
  77     my $class  = shift;
  78     my $params = shift;
  79
  80     if (!defined $params->{ record }) {
  81         carp 'No record passed';
  82         return;
  83     }
  84
  85     if (!defined $params->{ schema }) {
  86         carp 'No schema passed';
  87         return;
  88     }
  89
  90     $params->{format} //= 'MARC';
  91     my $self = $class->SUPER::new($params);
  92
  93     bless $self, $class;
  94     return $self;
  95 }
  96
  97 =head2 createMergeHash
  98
  99 Create a hash for use when merging records. At the moment the only
 100 metadata schema supported is MARC.
 101
 102 =cut
 103
 104 sub createMergeHash {
 105     my ($self, $tagslib) = @_;
 106     if ($self->schema =~ m/marc/) {
 107         return Koha::Util::MARC::createMergeHash($self->record, $tagslib);
 108     }
 109 }
 110
 111 sub getKohaField {
 112     my ($self, $kohafield) = @_;
 113
 114     if ($self->schema =~ m/marc/) {
 115         my $relations = C4::Context->marcfromkohafield->{''};
 116         my $tagfield = $relations->{$kohafield};
 117
 118         return '' if ref($tagfield) ne 'ARRAY';
 119
 120         my ($tag, $subfield) = @$tagfield;
 121         my @kohafield;
 122         foreach my $field ( $self->record->field($tag) ) {
 123             if ( $field->tag() < 10 ) {
 124                 push @kohafield, $field->data();
 125             } else {
 126                 foreach my $contents ( $field->subfield($subfield) ) {
 127                     push @kohafield, $contents;
 128                 }
 129             }
 130         }
 131
 132         return join ' | ', @kohafield;
 133     }
 134 }
 135
 136 1;