koha-dev.rot13.org Git - srvgit/blob - C4/AuthoritiesMarc/MARC21.pm

   1 package C4::AuthoritiesMarc::MARC21;
   2
   3 # Copyright (C) 2007 LibLime
   4 #
   5 # This file is part of Koha.
   6 #
   7 # Koha is free software; you can redistribute it and/or modify it
   8 # under the terms of the GNU General Public License as published by
   9 # the Free Software Foundation; either version 3 of the License, or
  10 # (at your option) any later version.
  11 #
  12 # Koha is distributed in the hope that it will be useful, but
  13 # WITHOUT ANY WARRANTY; without even the implied warranty of
  14 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  15 # GNU General Public License for more details.
  16 #
  17 # You should have received a copy of the GNU General Public License
  18 # along with Koha; if not, see <http://www.gnu.org/licenses>.
  19
  20 use Modern::Perl;
  21
  22 =head1 NAME
  23
  24 C4::AuthoritiesMarc::MARC21
  25
  26 =head1 SYNOPSIS
  27
  28 use C4::AuthoritiesMarc::MARC21;
  29
  30 =head1 DESCRIPTION
  31
  32 This is a helper module providing functions used by
  33 C<C4::AuthoritiesMarc> to deal with behavior specific
  34 to MARC21 authority records (as opposed to other
  35 MARC formats).
  36
  37 Functions from this module generally should not be used
  38 directly; instead, use the appropriate function from
  39 C<C4::Authorities> that will dispatch the appropriate
  40 function based on the marcflavour system preference.
  41
  42 =head1 FUNCTIONS
  43
  44 =cut
  45
  46 =head2 get_heading_type_from_marc
  47
  48   my $auth_type = get_auth_type_from_marc($marc);
  49
  50 Given a MARC::Record object containing an authority record,
  51 determine its heading type (e.g., personal name, topical term,
  52 etc.).
  53
  54 =cut
  55
  56 =head2 default_auth_type_location
  57
  58   my ($tag, $subfield) = default_auth_type_location();
  59
  60 Get the tag and subfield used to store the heading type
  61 if not specified in the MARC framework.  For MARC21,
  62 this defaults to 942$a.
  63
  64 =cut
  65
  66 sub default_auth_type_location {
  67     return ('942', 'a');
  68 }
  69
  70 =head2 fix_marc21_auth_type_location
  71
  72   fix_marc21_auth_type_location($auth_marc, $auth_type_tag, $auth_type_subfield);
  73
  74 If the incoming C<MARC::Record> object has a 152$b, remove it.  If no
  75 field already exists that contains the specified C<$auth_type_tag>
  76 and C<$auth_type_subfield>, create a new field whose contents
  77 are the original contents of the 152$b.
  78
  79 This routine exists to deal with a historical problem: MARC21
  80 authority records in previous versions of Koha kept the
  81 authority type in the 152$b.  While the 152 may be OK for UNIMARC,
  82 a 9XX should have been used for MARC21.
  83
  84 This function is meant to be called from GetAuthority, GetAuthorityXML,
  85 and AddAuthority.
  86
  87 FIXME: This function should be removed once it's determined
  88        that no MARC21 users of Koha are using the 152$b
  89        to store the authority type.
  90
  91 =cut
  92
  93 sub fix_marc21_auth_type_location {
  94     my ($auth_marc, $auth_type_tag, $auth_type_subfield) = @_;
  95
  96     my $auth_type_code;
  97     return unless $auth_type_code = $auth_marc->subfield('152', 'b');
  98     $auth_marc->delete_field($auth_marc->field('152'));
  99     unless ($auth_marc->field($auth_type_tag) && $auth_marc->subfield($auth_type_tag, $auth_type_subfield)) {
 100         $auth_marc->add_fields($auth_type_tag,'','', $auth_type_subfield=>$auth_type_code);
 101     }
 102
 103 }
 104
 105 =head1 AUTHOR
 106
 107 Koha Development Team <http://koha-community.org/>
 108
 109 Galen Charlton <galen.charlton@liblime.com>
 110
 111 =cut
 112
 113 1;