3 # Copyright (C) 2008 LibLime
5 # This file is part of Koha.
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 2 of the License, or (at your option) any later
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.
16 # You should have received a copy of the GNU General Public License along with
17 # Koha; if not, write to the Free Software Foundation, Inc., 59 Temple Place,
18 # Suite 330, Boston, MA 02111-1307 USA
24 use C4
::Heading
::MARC21
;
36 my $heading = C4::Heading->new_from_bib_field($field);
37 my $thesaurus = $heading->thesaurus();
38 my $type = $heading->type();
39 my $display_heading = $heading->display();
40 my $search_string = $heading->search_string();
44 C<C4::Heading> implements a simple class to representing
45 headings found in bibliographic and authority records.
49 =head2 new_from_bib_field
53 my $heading = C4::Heading->new_from_bib_field($field[, $marc_flavour]);
57 Given a C<MARC::Field> object containing a heading from a
58 bib record, create a C<C4::Heading> object.
60 The optional second parameter is the MARC flavour (i.e., MARC21
61 or UNIMARC); if this parameter is not supplied, it is
62 taken from the Koha application context.
64 If the MARC field supplied is not a valid heading, undef
69 sub new_from_bib_field
{
72 my $marcflavour = @_ ?
shift : C4
::Context
->preference('marcflavour');
74 my $marc_handler = _marc_format_handler
($marcflavour);
76 my $tag = $field->tag();
77 return unless $marc_handler->valid_bib_heading_tag($tag);
80 ($self->{'auth_type'}, $self->{'subject_added_entry'}, $self->{'series_added_entry'}, $self->{'main_entry'},
81 $self->{'thesaurus'}, $self->{'search_form'}, $self->{'display_form'}) =
82 $marc_handler->parse_heading($field);
92 my $display = $heading->display_form();
96 Return the "canonical" display form of the heading.
102 return $self->{'display_form'};
109 my $authorities = $heading->authorities;
113 Return a list of authority records for this
120 my $query = qq(Match
-heading
,ext
="$self->{'search_form'}");
121 $query .= $self->_query_limiters();
122 my ($error, $results, $total_hits) = SimpleSearch
( $query, undef, undef, [ "authorityserver" ] );
126 =head2 preferred_authorities
130 my $preferred_authorities = $heading->preferred_authorities;
134 Return a list of authority records for headings
135 that are a preferred form of the heading.
139 sub preferred_authorities
{
141 my $query = "Match-heading-see-from,ext='$self->{'search_form'}'";
142 $query .= $self->_query_limiters();
143 my ($error, $results, $total_hits) = SimpleSearch
( $query, undef, undef, [ "authorityserver" ] );
147 =head1 INTERNAL METHODS
149 =head2 _query_limiters
153 sub _query_limiters
{
156 my $limiters = " AND at='$self->{'auth_type'}'";
157 if ($self->{'subject_added_entry'}) {
158 $limiters .= " AND Heading-use-subject-added-entry=a"; # FIXME -- is this properly in C4::Heading::MARC21?
159 $limiters .= " AND Subject-heading-thesaurus=$self->{'thesaurus'}";
161 if ($self->{'series_added_entry'}) {
162 $limiters .= " AND Heading-use-series-added-entry=a"; # FIXME -- is this properly in C4::Heading::MARC21?
164 if (not $self->{'subject_added_entry'} and not $self->{'series_added_entry'}) {
165 $limiters .= " AND Heading-use-main-or-added-entry=a" # FIXME -- is this properly in C4::Heading::MARC21?
170 =head1 INTERNAL FUNCTIONS
172 =head2 _marc_format_handler
174 Returns a C4::Heading::MARC21 or C4::Heading::UNIMARC object
175 depending on the selected MARC flavour.
179 sub _marc_format_handler
{
180 my $marcflavour = shift;
182 if ($marcflavour eq 'UNIMARC') {
183 return C4
::Heading
::UNIMARC
->new();
185 return C4
::Heading
::MARC21
->new();
192 Koha Developement team <info@koha.org>
194 Galen Charlton <galen.charlton@liblime.com>