3 # This file is part of Koha.
5 # Koha is free software; you can redistribute it and/or modify it under the
6 # terms of the GNU General Public License as published by the Free Software
7 # Foundation; either version 2 of the License, or (at your option) any later
10 # Koha is distributed in the hope that it will be useful, but WITHOUT ANY
11 # WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
12 # A PARTICULAR PURPOSE. See the GNU General Public License for more details.
14 # You should have received a copy of the GNU General Public License along with
15 # Koha; if not, write to the Free Software Foundation, Inc., 59 Temple Place,
16 # Suite 330, Boston, MA 02111-1307 USA
19 #use warnings; FIXME - Bug 2505
22 use C4::Biblio; # GetMarcFromKohaField, GetBiblioData
23 use C4::Koha; # getFacets
25 use C4::Search::PazPar2;
27 use C4::Dates qw(format_date);
28 use C4::Members qw(GetHideLostItemsPreference);
31 use C4::Reserves; # GetReserveStatus
39 use Encode qw/decode_utf8/;
41 use vars qw($VERSION @ISA @EXPORT @EXPORT_OK %EXPORT_TAGS $DEBUG);
43 # set the version for version checking
45 $VERSION = 3.07.00.049;
46 $DEBUG = ($ENV{DEBUG}) ? 1 : 0;
51 C4::Search - Functions for searching the Koha catalog.
55 See opac/opac-search.pl or catalogue/search.pl for example of usage
59 This module provides searching functions for Koha's bibliographic databases
74 &enabled_staff_search_views
78 # make all your functions, whether exported or not;
82 ($biblionumber,$biblionumber,$title) = FindDuplicate($record);
84 This function attempts to find duplicate records using a hard-coded, fairly simplistic algorithm
90 my $dbh = C4::Context->dbh;
91 my $result = TransformMarcToKoha( $dbh, $record, '' );
96 my ( $biblionumber, $title );
98 # search duplicate on ISBN, easy and fast..
100 if ( $result->{isbn} ) {
101 $result->{isbn} =~ s/\(.*$//;
102 $result->{isbn} =~ s/\s+$//;
103 $query = "isbn:$result->{isbn}";
107 $QParser = C4::Context->queryparser if (C4::Context->preference('UseQueryParser'));
113 $titleindex = 'title|exact';
114 $authorindex = 'author|exact';
116 $QParser->custom_data->{'QueryAutoTruncate'} = C4::Context->preference('QueryAutoTruncate');
118 $titleindex = 'ti,ext';
119 $authorindex = 'au,ext';
123 $result->{title} =~ s /\\//g;
124 $result->{title} =~ s /\"//g;
125 $result->{title} =~ s /\(//g;
126 $result->{title} =~ s /\)//g;
128 # FIXME: instead of removing operators, could just do
129 # quotes around the value
130 $result->{title} =~ s/(and|or|not)//g;
131 $query = "$titleindex:\"$result->{title}\"";
132 if ( $result->{author} ) {
133 $result->{author} =~ s /\\//g;
134 $result->{author} =~ s /\"//g;
135 $result->{author} =~ s /\(//g;
136 $result->{author} =~ s /\)//g;
138 # remove valid operators
139 $result->{author} =~ s/(and|or|not)//g;
140 $query .= " $op $authorindex:\"$result->{author}\"";
144 my ( $error, $searchresults, undef ) = SimpleSearch($query); # FIXME :: hardcoded !
146 if (!defined $error) {
147 foreach my $possible_duplicate_record (@{$searchresults}) {
149 MARC::Record->new_from_usmarc($possible_duplicate_record);
150 my $result = TransformMarcToKoha( $dbh, $marcrecord, '' );
152 # FIXME :: why 2 $biblionumber ?
154 push @results, $result->{'biblionumber'};
155 push @results, $result->{'title'};
164 ( $error, $results, $total_hits ) = SimpleSearch( $query, $offset, $max_results, [@servers] );
166 This function provides a simple search API on the bibliographic catalog
172 * $query can be a simple keyword or a complete CCL query
173 * @servers is optional. Defaults to biblioserver as found in koha-conf.xml
174 * $offset - If present, represents the number of records at the beggining to omit. Defaults to 0
175 * $max_results - if present, determines the maximum number of records to fetch. undef is All. defaults to undef.
180 Returns an array consisting of three elements
181 * $error is undefined unless an error is detected
182 * $results is a reference to an array of records.
183 * $total_hits is the number of hits that would have been returned with no limit
185 If an error is returned the two other return elements are undefined. If error itself is undefined
186 the other two elements are always defined
188 =item C<usage in the script:>
192 my ( $error, $marcresults, $total_hits ) = SimpleSearch($query);
194 if (defined $error) {
195 $template->param(query_error => $error);
196 warn "error: ".$error;
197 output_html_with_http_headers $input, $cookie, $template->output;
201 my $hits = @{$marcresults};
204 for my $r ( @{$marcresults} ) {
205 my $marcrecord = MARC::File::USMARC::decode($r);
206 my $biblio = TransformMarcToKoha(C4::Context->dbh,$marcrecord,q{});
208 #build the iarray of hashs for the template.
210 title => $biblio->{'title'},
211 subtitle => $biblio->{'subtitle'},
212 biblionumber => $biblio->{'biblionumber'},
213 author => $biblio->{'author'},
214 publishercode => $biblio->{'publishercode'},
215 publicationyear => $biblio->{'publicationyear'},
220 $template->param(result=>\@results);
225 my ( $query, $offset, $max_results, $servers ) = @_;
227 return ( 'No query entered', undef, undef ) unless $query;
228 # FIXME hardcoded value. See catalog/search.pl & opac-search.pl too.
229 my @servers = defined ( $servers ) ? @$servers : ( 'biblioserver' );
237 $QParser = C4::Context->queryparser if (C4::Context->preference('UseQueryParser') && ! ($query =~ m/\w,\w|\w=\w/));
239 $QParser->custom_data->{'QueryAutoTruncate'} = C4::Context->preference('QueryAutoTruncate');
242 # Initialize & Search Zebra
243 for ( my $i = 0 ; $i < @servers ; $i++ ) {
245 $zconns[$i] = C4::Context->Zconn( $servers[$i], 1 );
248 $QParser->parse( $query );
249 $query = $QParser->target_syntax($servers[$i]);
250 $zoom_queries[$i] = new ZOOM::Query::PQF( $query, $zconns[$i]);
253 $zoom_queries[$i] = new ZOOM::Query::CCL2RPN( $query, $zconns[$i]);
255 $tmpresults[$i] = $zconns[$i]->search( $zoom_queries[$i] );
259 $zconns[$i]->errmsg() . " ("
260 . $zconns[$i]->errcode() . ") "
261 . $zconns[$i]->addinfo() . " "
262 . $zconns[$i]->diagset();
264 return ( $error, undef, undef ) if $zconns[$i]->errcode();
268 # caught a ZOOM::Exception
272 . $@->addinfo() . " "
274 warn $error." for query: $query";
275 return ( $error, undef, undef );
284 my $first_record = defined($offset) ? $offset + 1 : 1;
285 my $hits = $tmpresults[ $i - 1 ]->size();
286 $total_hits += $hits;
287 my $last_record = $hits;
288 if ( defined $max_results && $offset + $max_results < $hits ) {
289 $last_record = $offset + $max_results;
292 for my $j ( $first_record .. $last_record ) {
294 $tmpresults[ $i - 1 ]->record( $j - 1 )->raw()
296 push @{$results}, $record;
301 foreach my $zoom_query (@zoom_queries) {
302 $zoom_query->destroy();
305 return ( undef, $results, $total_hits );
310 ( undef, $results_hashref, \@facets_loop ) = getRecords (
312 $koha_query, $simple_query, $sort_by_ref, $servers_ref,
313 $results_per_page, $offset, $expanded_facet, $branches,$itemtypes,
317 The all singing, all dancing, multi-server, asynchronous, scanning,
318 searching, record nabbing, facet-building
320 See verbse embedded documentation.
326 $koha_query, $simple_query, $sort_by_ref, $servers_ref,
327 $results_per_page, $offset, $expanded_facet, $branches,
328 $itemtypes, $query_type, $scan, $opac
331 my @servers = @$servers_ref;
332 my @sort_by = @$sort_by_ref;
334 # Initialize variables for the ZOOM connection and results object
338 my $results_hashref = ();
340 # Initialize variables for the faceted results objects
341 my $facets_counter = ();
342 my $facets_info = ();
343 my $facets = getFacets();
344 my $facets_maxrecs = C4::Context->preference('maxRecordsForFacets')||20;
346 my @facets_loop; # stores the ref to array of hashes for template facets loop
348 ### LOOP THROUGH THE SERVERS
349 for ( my $i = 0 ; $i < @servers ; $i++ ) {
350 $zconns[$i] = C4::Context->Zconn( $servers[$i], 1 );
352 # perform the search, create the results objects
353 # if this is a local search, use the $koha-query, if it's a federated one, use the federated-query
354 my $query_to_use = ($servers[$i] =~ /biblioserver/) ? $koha_query : $simple_query;
356 #$query_to_use = $simple_query if $scan;
357 warn $simple_query if ( $scan and $DEBUG );
359 # Check if we've got a query_type defined, if so, use it
362 if ($query_type =~ /^ccl/) {
363 $query_to_use =~ s/\:/\=/g; # change : to = last minute (FIXME)
364 $results[$i] = $zconns[$i]->search(new ZOOM::Query::CCL2RPN($query_to_use, $zconns[$i]));
365 } elsif ($query_type =~ /^cql/) {
366 $results[$i] = $zconns[$i]->search(new ZOOM::Query::CQL($query_to_use, $zconns[$i]));
367 } elsif ($query_type =~ /^pqf/) {
368 $results[$i] = $zconns[$i]->search(new ZOOM::Query::PQF($query_to_use, $zconns[$i]));
370 warn "Unknown query_type '$query_type'. Results undetermined.";
373 $results[$i] = $zconns[$i]->scan( new ZOOM::Query::CCL2RPN($query_to_use, $zconns[$i]));
375 $results[$i] = $zconns[$i]->search(new ZOOM::Query::CCL2RPN($query_to_use, $zconns[$i]));
379 warn "WARNING: query problem with $query_to_use " . $@;
382 # Concatenate the sort_by limits and pass them to the results object
383 # Note: sort will override rank
385 foreach my $sort (@sort_by) {
386 if ( $sort eq "author_az" || $sort eq "author_asc" ) {
387 $sort_by .= "1=1003 <i ";
389 elsif ( $sort eq "author_za" || $sort eq "author_dsc" ) {
390 $sort_by .= "1=1003 >i ";
392 elsif ( $sort eq "popularity_asc" ) {
393 $sort_by .= "1=9003 <i ";
395 elsif ( $sort eq "popularity_dsc" ) {
396 $sort_by .= "1=9003 >i ";
398 elsif ( $sort eq "call_number_asc" ) {
399 $sort_by .= "1=8007 <i ";
401 elsif ( $sort eq "call_number_dsc" ) {
402 $sort_by .= "1=8007 >i ";
404 elsif ( $sort eq "pubdate_asc" ) {
405 $sort_by .= "1=31 <i ";
407 elsif ( $sort eq "pubdate_dsc" ) {
408 $sort_by .= "1=31 >i ";
410 elsif ( $sort eq "acqdate_asc" ) {
411 $sort_by .= "1=32 <i ";
413 elsif ( $sort eq "acqdate_dsc" ) {
414 $sort_by .= "1=32 >i ";
416 elsif ( $sort eq "title_az" || $sort eq "title_asc" ) {
417 $sort_by .= "1=4 <i ";
419 elsif ( $sort eq "title_za" || $sort eq "title_dsc" ) {
420 $sort_by .= "1=4 >i ";
423 warn "Ignoring unrecognized sort '$sort' requested" if $sort_by;
426 if ( $sort_by && !$scan && $results[$i] ) {
427 if ( $results[$i]->sort( "yaz", $sort_by ) < 0 ) {
428 warn "WARNING sort $sort_by failed";
431 } # finished looping through servers
433 # The big moment: asynchronously retrieve results from all servers
438 my ( $i, $size ) = @_;
441 # loop through the results
442 $results_hash->{'hits'} = $size;
444 if ( $offset + $results_per_page <= $size ) {
445 $times = $offset + $results_per_page;
450 for ( my $j = $offset ; $j < $times ; $j++ ) {
454 ## Check if it's an index scan
456 my ( $term, $occ ) = $results[ $i - 1 ]->term($j);
458 # here we create a minimal MARC record and hand it off to the
459 # template just like a normal result ... perhaps not ideal, but
461 my $tmprecord = MARC::Record->new();
462 $tmprecord->encoding('UTF-8');
466 # the minimal record in author/title (depending on MARC flavour)
467 if ( C4::Context->preference("marcflavour") eq
470 $tmptitle = MARC::Field->new(
475 $tmprecord->append_fields($tmptitle);
479 MARC::Field->new( '245', ' ', ' ', a => $term, );
481 MARC::Field->new( '100', ' ', ' ', a => $occ, );
482 $tmprecord->append_fields($tmptitle);
483 $tmprecord->append_fields($tmpauthor);
485 $results_hash->{'RECORDS'}[$j] =
486 $tmprecord->as_usmarc();
491 $record = $results[ $i - 1 ]->record($j)->raw();
493 # warn "RECORD $j:".$record;
494 $results_hash->{'RECORDS'}[$j] = $record;
498 $results_hashref->{ $servers[ $i - 1 ] } = $results_hash;
500 # Fill the facets while we're looping, but only for the biblioserver and not for a scan
501 if ( !$scan && $servers[ $i - 1 ] =~ /biblioserver/ ) {
504 $size > $facets_maxrecs ? $facets_maxrecs : $size;
505 for my $facet (@$facets) {
506 for ( my $j = 0 ; $j < $jmax ; $j++ ) {
507 my $render_record = decode_utf8(
508 $results[ $i - 1 ]->record($j)->render());
510 foreach my $tag ( @{ $facet->{tags} } ) {
513 my $tag_num = substr( $tag, 0, 3 );
514 my $letters = substr( $tag, 3 );
516 '\n' . $tag_num . ' ([^z][^\n]+)';
517 $field_pattern = '\n' . $tag_num . ' ([^\n]+)'
518 if ( int($tag_num) < 10 );
520 ( $render_record =~ /$field_pattern/g );
521 foreach my $field_token (@field_tokens) {
522 my @subf = ( $field_token =~
523 /\$([a-zA-Z0-9]) ([^\$]+)/g );
525 for ( my $i = 0 ; $i < @subf ; $i += 2 ) {
526 if ( $letters =~ $subf[$i] ) {
527 my $value = $subf[ $i + 1 ];
530 push @values, $value;
533 my $data = join( $facet->{sep}, @values );
534 unless ( $data ~~ @used_datas ) {
535 $facets_counter->{ $facet->{idx} }
537 push @used_datas, $data;
542 $facets_info->{ $facet->{idx} }->{label_value} =
544 $facets_info->{ $facet->{idx} }->{expanded} =
549 # warn "connection ", $i-1, ": $size hits";
550 # warn $results[$i-1]->record(0)->render() if $size > 0;
553 if ( $servers[ $i - 1 ] =~ /biblioserver/ ) {
555 sort { $facets_counter->{$b} <=> $facets_counter->{$a} }
556 keys %$facets_counter
560 my $number_of_facets;
561 my @this_facets_array;
564 $facets_counter->{$link_value}
565 ->{$b} <=> $facets_counter->{$link_value}
567 } keys %{ $facets_counter->{$link_value} }
571 if ( ( $number_of_facets <= 5 )
572 || ( $expanded_facet eq $link_value )
573 || ( $facets_info->{$link_value}->{'expanded'} )
577 # Sanitize the link value : parenthesis, question and exclamation mark will cause errors with CCL
578 my $facet_link_value = $one_facet;
579 $facet_link_value =~ s/[()!?¡¿؟]/ /g;
581 # fix the length that will display in the label,
582 my $facet_label_value = $one_facet;
583 my $facet_max_length = C4::Context->preference(
584 'FacetLabelTruncationLength')
587 substr( $one_facet, 0, $facet_max_length )
589 if length($facet_label_value) >
592 # if it's a branch, label by the name, not the code,
593 if ( $link_value =~ /branch/ ) {
594 if ( defined $branches
595 && ref($branches) eq "HASH"
596 && defined $branches->{$one_facet}
597 && ref( $branches->{$one_facet} ) eq
601 $branches->{$one_facet}
605 $facet_label_value = "*";
609 # if it's a itemtype, label by the name, not the code,
610 if ( $link_value =~ /itype/ ) {
611 if ( defined $itemtypes
612 && ref($itemtypes) eq "HASH"
613 && defined $itemtypes->{$one_facet}
614 && ref( $itemtypes->{$one_facet} ) eq
618 $itemtypes->{$one_facet}
623 # also, if it's a location code, use the name instead of the code
624 if ( $link_value =~ /location/ ) {
626 GetKohaAuthorisedValueLib( 'LOC',
630 # but we're down with the whole label being in the link's title.
631 push @this_facets_array,
634 $facets_counter->{$link_value}
636 facet_label_value => $facet_label_value,
637 facet_title_value => $one_facet,
638 facet_link_value => $facet_link_value,
639 type_link_value => $link_value,
641 if ($facet_label_value);
645 # handle expanded option
646 unless ( $facets_info->{$link_value}->{'expanded'} ) {
648 if ( ( $number_of_facets > 5 )
649 && ( $expanded_facet ne $link_value ) );
653 type_link_value => $link_value,
654 type_id => $link_value . "_id",
656 . $facets_info->{$link_value}->{'label_value'} =>
658 facets => \@this_facets_array,
659 expandable => $expandable,
660 expand => $link_value,
664 $facets_info->{$link_value}->{'label_value'} =~
667 and ( C4::Context->preference('singleBranchMode') )
673 return ( undef, $results_hashref, \@facets_loop );
678 $koha_query, $simple_query, $sort_by_ref, $servers_ref,
679 $results_per_page, $offset, $expanded_facet, $branches,
683 my $paz = C4::Search::PazPar2->new(C4::Context->config('pazpar2url'));
685 $paz->search($simple_query);
686 sleep 1; # FIXME: WHY?
689 my $results_hashref = {};
690 my $stats = XMLin($paz->stat);
691 my $results = XMLin($paz->show($offset, $results_per_page, 'work-title:1'), forcearray => 1);
693 # for a grouped search result, the number of hits
694 # is the number of groups returned; 'bib_hits' will have
695 # the total number of bibs.
696 $results_hashref->{'biblioserver'}->{'hits'} = $results->{'merged'}->[0];
697 $results_hashref->{'biblioserver'}->{'bib_hits'} = $stats->{'hits'};
699 HIT: foreach my $hit (@{ $results->{'hit'} }) {
700 my $recid = $hit->{recid}->[0];
702 my $work_title = $hit->{'md-work-title'}->[0];
704 if (exists $hit->{'md-work-author'}) {
705 $work_author = $hit->{'md-work-author'}->[0];
707 my $group_label = (defined $work_author) ? "$work_title / $work_author" : $work_title;
709 my $result_group = {};
710 $result_group->{'group_label'} = $group_label;
711 $result_group->{'group_merge_key'} = $recid;
714 if (exists $hit->{count}) {
715 $count = $hit->{count}->[0];
717 $result_group->{'group_count'} = $count;
719 for (my $i = 0; $i < $count; $i++) {
720 # FIXME -- may need to worry about diacritics here
721 my $rec = $paz->record($recid, $i);
722 push @{ $result_group->{'RECORDS'} }, $rec;
725 push @{ $results_hashref->{'biblioserver'}->{'GROUPS'} }, $result_group;
728 # pass through facets
729 my $termlist_xml = $paz->termlist('author,subject');
730 my $terms = XMLin($termlist_xml, forcearray => 1);
731 my @facets_loop = ();
732 #die Dumper($results);
733 # foreach my $list (sort keys %{ $terms->{'list'} }) {
735 # foreach my $facet (sort @{ $terms->{'list'}->{$list}->{'term'} } ) {
737 # facet_label_value => $facet->{'name'}->[0],
740 # push @facets_loop, ( {
741 # type_label => $list,
742 # facets => \@facets,
746 return ( undef, $results_hashref, \@facets_loop );
750 sub _remove_stopwords {
751 my ( $operand, $index ) = @_;
752 my @stopwords_removed;
754 # phrase and exact-qualified indexes shouldn't have stopwords removed
755 if ( $index !~ m/,(phr|ext)/ ) {
757 # remove stopwords from operand : parse all stopwords & remove them (case insensitive)
758 # we use IsAlpha unicode definition, to deal correctly with diacritics.
759 # otherwise, a French word like "leçon" woudl be split into "le" "çon", "le"
760 # is a stopword, we'd get "çon" and wouldn't find anything...
762 foreach ( keys %{ C4::Context->stopwords } ) {
763 next if ( $_ =~ /(and|or|not)/ ); # don't remove operators
764 if ( my ($matched) = ($operand =~
765 /([^\X\p{isAlnum}]\Q$_\E[^\X\p{isAlnum}]|[^\X\p{isAlnum}]\Q$_\E$|^\Q$_\E[^\X\p{isAlnum}])/gi))
767 $operand =~ s/\Q$matched\E/ /gi;
768 push @stopwords_removed, $_;
772 return ( $operand, \@stopwords_removed );
776 sub _detect_truncation {
777 my ( $operand, $index ) = @_;
778 my ( @nontruncated, @righttruncated, @lefttruncated, @rightlefttruncated,
781 my @wordlist = split( /\s/, $operand );
782 foreach my $word (@wordlist) {
783 if ( $word =~ s/^\*([^\*]+)\*$/$1/ ) {
784 push @rightlefttruncated, $word;
786 elsif ( $word =~ s/^\*([^\*]+)$/$1/ ) {
787 push @lefttruncated, $word;
789 elsif ( $word =~ s/^([^\*]+)\*$/$1/ ) {
790 push @righttruncated, $word;
792 elsif ( index( $word, "*" ) < 0 ) {
793 push @nontruncated, $word;
796 push @regexpr, $word;
800 \@nontruncated, \@righttruncated, \@lefttruncated,
801 \@rightlefttruncated, \@regexpr
806 sub _build_stemmed_operand {
807 my ($operand,$lang) = @_;
808 require Lingua::Stem::Snowball ;
809 my $stemmed_operand=q{};
811 # If operand contains a digit, it is almost certainly an identifier, and should
812 # not be stemmed. This is particularly relevant for ISBNs and ISSNs, which
813 # can contain the letter "X" - for example, _build_stemmend_operand would reduce
814 # "014100018X" to "x ", which for a MARC21 database would bring up irrelevant
815 # results (e.g., "23 x 29 cm." from the 300$c). Bug 2098.
816 return $operand if $operand =~ /\d/;
818 # FIXME: the locale should be set based on the user's language and/or search choice
820 # Make sure we only use the first two letters from the language code
821 $lang = lc(substr($lang, 0, 2));
822 # The language codes for the two variants of Norwegian will now be "nb" and "nn",
823 # none of which Lingua::Stem::Snowball can use, so we need to "translate" them
824 if ($lang eq 'nb' || $lang eq 'nn') {
827 my $stemmer = Lingua::Stem::Snowball->new( lang => $lang,
828 encoding => "UTF-8" );
830 my @words = split( / /, $operand );
831 my @stems = $stemmer->stem(\@words);
832 for my $stem (@stems) {
833 $stemmed_operand .= "$stem";
834 $stemmed_operand .= "?"
835 unless ( $stem =~ /(and$|or$|not$)/ ) || ( length($stem) < 3 );
836 $stemmed_operand .= " ";
838 warn "STEMMED OPERAND: $stemmed_operand" if $DEBUG;
839 return $stemmed_operand;
843 sub _build_weighted_query {
845 # FIELD WEIGHTING - This is largely experimental stuff. What I'm committing works
846 # pretty well but could work much better if we had a smarter query parser
847 my ( $operand, $stemmed_operand, $index ) = @_;
848 my $stemming = C4::Context->preference("QueryStemming") || 0;
849 my $weight_fields = C4::Context->preference("QueryWeightFields") || 0;
850 my $fuzzy_enabled = C4::Context->preference("QueryFuzzy") || 0;
851 $operand =~ s/"/ /g; # Bug 7518: searches with quotation marks don't work
853 my $weighted_query .= "(rk=("; # Specifies that we're applying rank
855 # Keyword, or, no index specified
856 if ( ( $index eq 'kw' ) || ( !$index ) ) {
858 "Title-cover,ext,r1=\"$operand\""; # exact title-cover
859 $weighted_query .= " or ti,ext,r2=\"$operand\""; # exact title
860 $weighted_query .= " or Title-cover,phr,r3=\"$operand\""; # phrase title
861 #$weighted_query .= " or any,ext,r4=$operand"; # exact any
862 #$weighted_query .=" or kw,wrdl,r5=\"$operand\""; # word list any
863 $weighted_query .= " or wrdl,fuzzy,r8=\"$operand\""
864 if $fuzzy_enabled; # add fuzzy, word list
865 $weighted_query .= " or wrdl,right-Truncation,r9=\"$stemmed_operand\""
866 if ( $stemming and $stemmed_operand )
867 ; # add stemming, right truncation
868 $weighted_query .= " or wrdl,r9=\"$operand\"";
870 # embedded sorting: 0 a-z; 1 z-a
871 # $weighted_query .= ") or (sort1,aut=1";
874 # Barcode searches should skip this process
875 elsif ( $index eq 'bc' ) {
876 $weighted_query .= "bc=\"$operand\"";
879 # Authority-number searches should skip this process
880 elsif ( $index eq 'an' ) {
881 $weighted_query .= "an=\"$operand\"";
884 # If the index already has more than one qualifier, wrap the operand
885 # in quotes and pass it back (assumption is that the user knows what they
886 # are doing and won't appreciate us mucking up their query
887 elsif ( $index =~ ',' ) {
888 $weighted_query .= " $index=\"$operand\"";
891 #TODO: build better cases based on specific search indexes
893 $weighted_query .= " $index,ext,r1=\"$operand\""; # exact index
894 #$weighted_query .= " or (title-sort-az=0 or $index,startswithnt,st-word,r3=$operand #)";
895 $weighted_query .= " or $index,phr,r3=\"$operand\""; # phrase index
896 $weighted_query .= " or $index,wrdl,r6=\"$operand\""; # word list index
897 $weighted_query .= " or $index,wrdl,fuzzy,r8=\"$operand\""
898 if $fuzzy_enabled; # add fuzzy, word list
899 $weighted_query .= " or $index,wrdl,rt,r9=\"$stemmed_operand\""
900 if ( $stemming and $stemmed_operand ); # add stemming, right truncation
903 $weighted_query .= "))"; # close rank specification
904 return $weighted_query;
909 Return an array with available indexes.
931 'Author-personal-bibliography',
941 'Chronological-subdivision',
951 'Conference-name-heading',
952 'Conference-name-see',
953 'Conference-name-seealso',
958 'Corporate-name-heading',
959 'Corporate-name-see',
960 'Corporate-name-seealso',
962 'date-entered-on-file',
963 'Date-of-acquisition',
964 'Date-of-publication',
965 'Dewey-classification',
972 'Geographic-subdivision',
975 'Heading-use-main-or-added-entry',
976 'Heading-use-series-added-entry ',
977 'Heading-use-subject-added-entry',
995 'Local-classification',
998 'Match-heading-see-from',
1006 'Name-geographic-heading',
1007 'Name-geographic-see',
1008 'Name-geographic-seealso',
1016 'Personal-name-heading',
1017 'Personal-name-see',
1018 'Personal-name-seealso',
1020 'Place-publication',
1025 'Record-control-number',
1036 'Subject-heading-thesaurus',
1037 'Subject-name-personal',
1038 'Subject-subdivision',
1048 'Term-genre-form-heading',
1049 'Term-genre-form-see',
1050 'Term-genre-form-seealso',
1057 'Title-uniform-heading',
1058 'Title-uniform-see',
1059 'Title-uniform-seealso',
1069 'classification-source',
1071 'coded-location-qualifier',
1082 'Local-classification',
1085 'materials-specified',
1094 'replacementpricedate',
1109 =head2 _handle_exploding_index
1111 my $query = _handle_exploding_index($index, $term)
1113 Callback routine to generate the search for "exploding" indexes (i.e.
1114 those indexes which are turned into multiple or-connected searches based
1119 sub _handle_exploding_index {
1120 my ($QParser, $filter, $params, $negate, $server) = @_;
1121 my $index = $filter;
1122 my $term = join(' ', @$params);
1124 return unless ($index =~ m/(su-br|su-na|su-rl)/ && $term);
1126 my $marcflavour = C4::Context->preference('marcflavour');
1128 my $codesubfield = $marcflavour eq 'UNIMARC' ? '5' : 'w';
1129 my $wantedcodes = '';
1130 my @subqueries = ( "\@attr 1=Subject \@attr 4=1 \"$term\"");
1131 my ($error, $results, $total_hits) = SimpleSearch( "he:$term", undef, undef, [ "authorityserver" ] );
1132 foreach my $auth (@$results) {
1133 my $record = MARC::Record->new_from_usmarc($auth);
1134 my @references = $record->field('5..');
1136 if ($index eq 'su-br') {
1138 } elsif ($index eq 'su-na') {
1140 } elsif ($index eq 'su-rl') {
1143 foreach my $reference (@references) {
1144 my $codes = $reference->subfield($codesubfield);
1145 push @subqueries, '@attr 1=Subject @attr 4=1 "' . $reference->as_string('abcdefghijlmnopqrstuvxyz') . '"' if (($codes && $codes eq $wantedcodes) || !$wantedcodes);
1149 my $query = ' @or ' x (scalar(@subqueries) - 1) . join(' ', @subqueries);
1155 ( $operators, $operands, $indexes, $limits,
1156 $sort_by, $scan, $lang ) =
1157 buildQuery ( $operators, $operands, $indexes, $limits, $sort_by, $scan, $lang);
1159 Shim function to ease the transition from buildQuery to a new QueryParser.
1160 This function is called at the beginning of buildQuery, and modifies
1161 buildQuery's input. If it can handle the input, it returns a query that
1162 buildQuery will not try to parse.
1166 my ( $operators, $operands, $indexes, $limits, $sort_by, $scan, $lang) = @_;
1168 my @operators = $operators ? @$operators : ();
1169 my @indexes = $indexes ? @$indexes : ();
1170 my @operands = $operands ? @$operands : ();
1171 my @limits = $limits ? @$limits : ();
1172 my @sort_by = $sort_by ? @$sort_by : ();
1174 my $query = $operands[0];
1180 $QParser = C4::Context->queryparser if (C4::Context->preference('UseQueryParser') || $query =~ s/^qp=//);
1181 undef $QParser if ($query =~ m/^(ccl=|pqf=|cql=)/ || grep (/\w,\w|\w=\w/, @operands, @indexes) );
1182 undef $QParser if (scalar @limits > 0);
1186 $QParser->custom_data->{'QueryAutoTruncate'} = C4::Context->preference('QueryAutoTruncate');
1188 for ( my $ii = 0 ; $ii <= @operands ; $ii++ ) {
1189 next unless $operands[$ii];
1190 $query .= $operators[ $ii - 1 ] eq 'or' ? ' || ' : ' && '
1192 if ( $operands[$ii] =~ /^[^"]\W*[-|_\w]*:\w.*[^"]$/ ) {
1193 $query .= $operands[$ii];
1195 elsif ( $indexes[$ii] =~ m/su-/ ) {
1196 $query .= $indexes[$ii] . '(' . $operands[$ii] . ')';
1200 ( $indexes[$ii] ? "$indexes[$ii]:" : '' ) . $operands[$ii];
1203 foreach my $limit (@limits) {
1205 if ( scalar(@sort_by) > 0 ) {
1207 '#(' . join( '|', @{ $QParser->modifiers } ) . ')';
1208 $query =~ s/$modifier_re//g;
1209 foreach my $modifier (@sort_by) {
1210 $query .= " #$modifier";
1214 $query_desc = $query;
1215 $query_desc =~ s/\s+/ /g;
1216 if ( C4::Context->preference("QueryWeightFields") ) {
1218 $QParser->add_bib1_filter_map( 'su-br' => 'biblioserver' =>
1219 { 'target_syntax_callback' => \&_handle_exploding_index } );
1220 $QParser->add_bib1_filter_map( 'su-na' => 'biblioserver' =>
1221 { 'target_syntax_callback' => \&_handle_exploding_index } );
1222 $QParser->add_bib1_filter_map( 'su-rl' => 'biblioserver' =>
1223 { 'target_syntax_callback' => \&_handle_exploding_index } );
1224 $QParser->parse($query);
1225 $operands[0] = "pqf=" . $QParser->target_syntax('biblioserver');
1228 require Koha::QueryParser::Driver::PQF;
1229 my $modifier_re = '#(' . join( '|', @{Koha::QueryParser::Driver::PQF->modifiers}) . ')';
1230 s/$modifier_re//g for @operands;
1233 return ( $operators, \@operands, $indexes, $limits, $sort_by, $scan, $lang, $query_desc);
1239 $simple_query, $query_cgi,
1240 $query_desc, $limit,
1241 $limit_cgi, $limit_desc,
1242 $stopwords_removed, $query_type ) = buildQuery ( $operators, $operands, $indexes, $limits, $sort_by, $scan, $lang);
1244 Build queries and limits in CCL, CGI, Human,
1245 handle truncation, stemming, field weighting, stopwords, fuzziness, etc.
1247 See verbose embedded documentation.
1253 my ( $operators, $operands, $indexes, $limits, $sort_by, $scan, $lang) = @_;
1255 warn "---------\nEnter buildQuery\n---------" if $DEBUG;
1258 ( $operators, $operands, $indexes, $limits, $sort_by, $scan, $lang, $query_desc) = parseQuery($operators, $operands, $indexes, $limits, $sort_by, $scan, $lang);
1261 my @operators = $operators ? @$operators : ();
1262 my @indexes = $indexes ? @$indexes : ();
1263 my @operands = $operands ? @$operands : ();
1264 my @limits = $limits ? @$limits : ();
1265 my @sort_by = $sort_by ? @$sort_by : ();
1267 my $stemming = C4::Context->preference("QueryStemming") || 0;
1268 my $auto_truncation = C4::Context->preference("QueryAutoTruncate") || 0;
1269 my $weight_fields = C4::Context->preference("QueryWeightFields") || 0;
1270 my $fuzzy_enabled = C4::Context->preference("QueryFuzzy") || 0;
1271 my $remove_stopwords = C4::Context->preference("QueryRemoveStopwords") || 0;
1273 my $query = $operands[0];
1274 my $simple_query = $operands[0];
1276 # initialize the variables we're passing back
1284 my $stopwords_removed; # flag to determine if stopwords have been removed
1287 my $cclindexes = getIndexes();
1288 if ( $query !~ /\s*(ccl=|pqf=|cql=)/ ) {
1289 while ( !$cclq && $query =~ /(?:^|\W)([\w-]+)(,[\w-]+)*[:=]/g ) {
1291 $cclq = grep { lc($_) eq $dx } @$cclindexes;
1293 $query = "ccl=$query" if $cclq;
1296 # for handling ccl, cql, pqf queries in diagnostic mode, skip the rest of the steps
1298 if ( $query =~ /^ccl=/ ) {
1300 # This is needed otherwise ccl= and &limit won't work together, and
1301 # this happens when selecting a subject on the opac-detail page
1302 @limits = grep {!/^$/} @limits;
1304 $q .= ' and '.join(' and ', @limits);
1306 return ( undef, $q, $q, "q=ccl=".uri_escape($q), $q, '', '', '', '', 'ccl' );
1308 if ( $query =~ /^cql=/ ) {
1309 return ( undef, $', $', "q=cql=".uri_escape($'), $', '', '', '', '', 'cql' );
1311 if ( $query =~ /^pqf=/ ) {
1313 $query_cgi = "q=".uri_escape($query_desc);
1316 $query_cgi = "q=pqf=".uri_escape($');
1318 return ( undef, $', $', $query_cgi, $query_desc, '', '', '', '', 'pqf' );
1321 # pass nested queries directly
1322 # FIXME: need better handling of some of these variables in this case
1323 # Nested queries aren't handled well and this implementation is flawed and causes users to be
1324 # unable to search for anything containing () commenting out, will be rewritten for 3.4.0
1325 # if ( $query =~ /(\(|\))/ ) {
1327 # undef, $query, $simple_query, $query_cgi,
1328 # $query, $limit, $limit_cgi, $limit_desc,
1329 # $stopwords_removed, 'ccl'
1333 # Form-based queries are non-nested and fixed depth, so we can easily modify the incoming
1334 # query operands and indexes and add stemming, truncation, field weighting, etc.
1335 # Once we do so, we'll end up with a value in $query, just like if we had an
1336 # incoming $query from the user
1339 ; # clear it out so we can populate properly with field-weighted, stemmed, etc. query
1340 my $previous_operand
1341 ; # a flag used to keep track if there was a previous query
1342 # if there was, we can apply the current operator
1344 for ( my $i = 0 ; $i <= @operands ; $i++ ) {
1346 # COMBINE OPERANDS, INDEXES AND OPERATORS
1347 if ( $operands[$i] ) {
1348 $operands[$i]=~s/^\s+//;
1350 # A flag to determine whether or not to add the index to the query
1353 # If the user is sophisticated enough to specify an index, turn off field weighting, stemming, and stopword handling
1354 if ( $operands[$i] =~ /\w(:|=)/ || $scan ) {
1357 $remove_stopwords = 0;
1359 $operands[$i] =~ s/\?/{?}/g; # need to escape question marks
1361 my $operand = $operands[$i];
1362 my $index = $indexes[$i];
1364 # Add index-specific attributes
1365 # Date of Publication
1366 if ( $index eq 'yr' ) {
1367 $index .= ",st-numeric";
1369 $stemming = $auto_truncation = $weight_fields = $fuzzy_enabled = $remove_stopwords = 0;
1372 # Date of Acquisition
1373 elsif ( $index eq 'acqdate' ) {
1374 $index .= ",st-date-normalized";
1376 $stemming = $auto_truncation = $weight_fields = $fuzzy_enabled = $remove_stopwords = 0;
1378 # ISBN,ISSN,Standard Number, don't need special treatment
1379 elsif ( $index eq 'nb' || $index eq 'ns' ) {
1381 $stemming, $auto_truncation,
1382 $weight_fields, $fuzzy_enabled,
1384 ) = ( 0, 0, 0, 0, 0 );
1392 # Set default structure attribute (word list)
1393 my $struct_attr = q{};
1394 unless ( $indexes_set || !$index || $index =~ /,(st-|phr|ext|wrdl)/ || $index =~ /^(nb|ns)$/ ) {
1395 $struct_attr = ",wrdl";
1398 # Some helpful index variants
1399 my $index_plus = $index . $struct_attr . ':';
1400 my $index_plus_comma = $index . $struct_attr . ',';
1403 if ($remove_stopwords) {
1404 ( $operand, $stopwords_removed ) =
1405 _remove_stopwords( $operand, $index );
1406 warn "OPERAND w/out STOPWORDS: >$operand<" if $DEBUG;
1407 warn "REMOVED STOPWORDS: @$stopwords_removed"
1408 if ( $stopwords_removed && $DEBUG );
1411 if ($auto_truncation){
1412 unless ( $index =~ /,(st-|phr|ext)/ ) {
1413 #FIXME only valid with LTR scripts
1414 $operand=join(" ",map{
1415 (index($_,"*")>0?"$_":"$_*")
1416 }split (/\s+/,$operand));
1417 warn $operand if $DEBUG;
1422 my $truncated_operand;
1423 my( $nontruncated, $righttruncated, $lefttruncated,
1424 $rightlefttruncated, $regexpr
1425 ) = _detect_truncation( $operand, $index );
1427 "TRUNCATION: NON:>@$nontruncated< RIGHT:>@$righttruncated< LEFT:>@$lefttruncated< RIGHTLEFT:>@$rightlefttruncated< REGEX:>@$regexpr<"
1432 scalar(@$righttruncated) + scalar(@$lefttruncated) +
1433 scalar(@$rightlefttruncated) > 0 )
1436 # Don't field weight or add the index to the query, we do it here
1438 undef $weight_fields;
1439 my $previous_truncation_operand;
1440 if (scalar @$nontruncated) {
1441 $truncated_operand .= "$index_plus @$nontruncated ";
1442 $previous_truncation_operand = 1;
1444 if (scalar @$righttruncated) {
1445 $truncated_operand .= "and " if $previous_truncation_operand;
1446 $truncated_operand .= $index_plus_comma . "rtrn:@$righttruncated ";
1447 $previous_truncation_operand = 1;
1449 if (scalar @$lefttruncated) {
1450 $truncated_operand .= "and " if $previous_truncation_operand;
1451 $truncated_operand .= $index_plus_comma . "ltrn:@$lefttruncated ";
1452 $previous_truncation_operand = 1;
1454 if (scalar @$rightlefttruncated) {
1455 $truncated_operand .= "and " if $previous_truncation_operand;
1456 $truncated_operand .= $index_plus_comma . "rltrn:@$rightlefttruncated ";
1457 $previous_truncation_operand = 1;
1460 $operand = $truncated_operand if $truncated_operand;
1461 warn "TRUNCATED OPERAND: >$truncated_operand<" if $DEBUG;
1464 my $stemmed_operand;
1465 $stemmed_operand = _build_stemmed_operand($operand, $lang)
1468 warn "STEMMED OPERAND: >$stemmed_operand<" if $DEBUG;
1470 # Handle Field Weighting
1471 my $weighted_operand;
1472 if ($weight_fields) {
1473 $weighted_operand = _build_weighted_query( $operand, $stemmed_operand, $index );
1474 $operand = $weighted_operand;
1478 warn "FIELD WEIGHTED OPERAND: >$weighted_operand<" if $DEBUG;
1480 # If there's a previous operand, we need to add an operator
1481 if ($previous_operand) {
1483 # User-specified operator
1484 if ( $operators[ $i - 1 ] ) {
1485 $query .= " $operators[$i-1] ";
1486 $query .= " $index_plus " unless $indexes_set;
1487 $query .= " $operand";
1488 $query_cgi .= "&op=".uri_escape($operators[$i-1]);
1489 $query_cgi .= "&idx=".uri_escape($index) if $index;
1490 $query_cgi .= "&q=".uri_escape($operands[$i]) if $operands[$i];
1492 " $operators[$i-1] $index_plus $operands[$i]";
1495 # Default operator is and
1498 $query .= "$index_plus " unless $indexes_set;
1499 $query .= "$operand";
1500 $query_cgi .= "&op=and&idx=".uri_escape($index) if $index;
1501 $query_cgi .= "&q=".uri_escape($operands[$i]) if $operands[$i];
1502 $query_desc .= " and $index_plus $operands[$i]";
1506 # There isn't a pervious operand, don't need an operator
1509 # Field-weighted queries already have indexes set
1510 $query .= " $index_plus " unless $indexes_set;
1512 $query_desc .= " $index_plus $operands[$i]";
1513 $query_cgi .= "&idx=".uri_escape($index) if $index;
1514 $query_cgi .= "&q=".uri_escape($operands[$i]) if $operands[$i];
1515 $previous_operand = 1;
1520 warn "QUERY BEFORE LIMITS: >$query<" if $DEBUG;
1523 my %group_OR_limits;
1524 my $availability_limit;
1525 foreach my $this_limit (@limits) {
1526 next unless $this_limit;
1527 if ( $this_limit =~ /available/ ) {
1529 ## 'available' is defined as (items.onloan is NULL) and (items.itemlost = 0)
1531 ## all records not indexed in the onloan register (zebra) and all records with a value of lost equal to 0
1532 $availability_limit .=
1533 "( ( allrecords,AlwaysMatches='' not onloan,AlwaysMatches='') and (lost,st-numeric=0) )"; #or ( allrecords,AlwaysMatches='' not lost,AlwaysMatches='')) )";
1534 $limit_cgi .= "&limit=available";
1538 # group_OR_limits, prefixed by mc-
1539 # OR every member of the group
1540 elsif ( $this_limit =~ /mc/ ) {
1541 my ($k,$v) = split(/:/, $this_limit,2);
1542 if ( $k !~ /mc-i(tem)?type/ ) {
1543 # in case the mc-ccode value has complicating chars like ()'s inside it we wrap in quotes
1544 $this_limit =~ tr/"//d;
1545 $this_limit = $k.":\"".$v."\"";
1548 $group_OR_limits{$k} .= " or " if $group_OR_limits{$k};
1549 $limit_desc .= " or " if $group_OR_limits{$k};
1550 $group_OR_limits{$k} .= "$this_limit";
1551 $limit_cgi .= "&limit=$this_limit";
1552 $limit_desc .= " $this_limit";
1555 # Regular old limits
1557 $limit .= " and " if $limit || $query;
1558 $limit .= "$this_limit";
1559 $limit_cgi .= "&limit=$this_limit";
1560 if ($this_limit =~ /^branch:(.+)/) {
1561 my $branchcode = $1;
1562 my $branchname = GetBranchName($branchcode);
1563 if (defined $branchname) {
1564 $limit_desc .= " branch:$branchname";
1566 $limit_desc .= " $this_limit";
1569 $limit_desc .= " $this_limit";
1573 foreach my $k (keys (%group_OR_limits)) {
1574 $limit .= " and " if ( $query || $limit );
1575 $limit .= "($group_OR_limits{$k})";
1577 if ($availability_limit) {
1578 $limit .= " and " if ( $query || $limit );
1579 $limit .= "($availability_limit)";
1582 # Normalize the query and limit strings
1583 # This is flawed , means we can't search anything with : in it
1584 # if user wants to do ccl or cql, start the query with that
1585 # $query =~ s/:/=/g;
1586 $query =~ s/(?<=(ti|au|pb|su|an|kw|mc|nb|ns)):/=/g;
1587 $query =~ s/(?<=(wrdl)):/=/g;
1588 $query =~ s/(?<=(trn|phr)):/=/g;
1590 for ( $query, $query_desc, $limit, $limit_desc ) {
1591 s/ +/ /g; # remove extra spaces
1592 s/^ //g; # remove any beginning spaces
1593 s/ $//g; # remove any ending spaces
1594 s/==/=/g; # remove double == from query
1596 $query_cgi =~ s/^&//; # remove unnecessary & from beginning of the query cgi
1598 for ($query_cgi,$simple_query) {
1601 # append the limit to the query
1602 $query .= " " . $limit;
1606 warn "QUERY:" . $query;
1607 warn "QUERY CGI:" . $query_cgi;
1608 warn "QUERY DESC:" . $query_desc;
1609 warn "LIMIT:" . $limit;
1610 warn "LIMIT CGI:" . $limit_cgi;
1611 warn "LIMIT DESC:" . $limit_desc;
1612 warn "---------\nLeave buildQuery\n---------";
1615 undef, $query, $simple_query, $query_cgi,
1616 $query_desc, $limit, $limit_cgi, $limit_desc,
1617 $stopwords_removed, $query_type
1621 =head2 searchResults
1623 my @search_results = searchResults($search_context, $searchdesc, $hits,
1624 $results_per_page, $offset, $scan,
1627 Format results in a form suitable for passing to the template
1631 # IMO this subroutine is pretty messy still -- it's responsible for
1632 # building the HTML output for the template
1634 my ( $search_context, $searchdesc, $hits, $results_per_page, $offset, $scan, $marcresults ) = @_;
1635 my $dbh = C4::Context->dbh;
1640 $search_context = 'opac' if !$search_context || $search_context ne 'intranet';
1641 my ($is_opac, $hidelostitems);
1642 if ($search_context eq 'opac') {
1643 $hidelostitems = C4::Context->preference('hidelostitems');
1647 #Build branchnames hash
1649 #get branch information.....
1651 my $bsth =$dbh->prepare("SELECT branchcode,branchname FROM branches"); # FIXME : use C4::Branch::GetBranches
1653 while ( my $bdata = $bsth->fetchrow_hashref ) {
1654 $branches{ $bdata->{'branchcode'} } = $bdata->{'branchname'};
1656 # FIXME - We build an authorised values hash here, using the default framework
1657 # though it is possible to have different authvals for different fws.
1659 my $shelflocations =GetKohaAuthorisedValues('items.location','');
1661 # get notforloan authorised value list (see $shelflocations FIXME)
1662 my $notforloan_authorised_value = GetAuthValCode('items.notforloan','');
1664 #Build itemtype hash
1665 #find itemtype & itemtype image
1669 "SELECT itemtype,description,imageurl,summary,notforloan FROM itemtypes"
1672 while ( my $bdata = $bsth->fetchrow_hashref ) {
1673 foreach (qw(description imageurl summary notforloan)) {
1674 $itemtypes{ $bdata->{'itemtype'} }->{$_} = $bdata->{$_};
1678 #search item field code
1679 my ($itemtag, undef) = &GetMarcFromKohaField( "items.itemnumber", "" );
1681 ## find column names of items related to MARC
1682 my $sth2 = $dbh->prepare("SHOW COLUMNS FROM items");
1684 my %subfieldstosearch;
1685 while ( ( my $column ) = $sth2->fetchrow ) {
1686 my ( $tagfield, $tagsubfield ) =
1687 &GetMarcFromKohaField( "items." . $column, "" );
1688 if ( defined $tagsubfield ) {
1689 $subfieldstosearch{$column} = $tagsubfield;
1693 # handle which records to actually retrieve
1695 if ( $hits && $offset + $results_per_page <= $hits ) {
1696 $times = $offset + $results_per_page;
1699 $times = $hits; # FIXME: if $hits is undefined, why do we want to equal it?
1702 my $marcflavour = C4::Context->preference("marcflavour");
1703 # We get the biblionumber position in MARC
1704 my ($bibliotag,$bibliosubf)=GetMarcFromKohaField('biblio.biblionumber','');
1706 # loop through all of the records we've retrieved
1707 for ( my $i = $offset ; $i <= $times - 1 ; $i++ ) {
1708 my $marcrecord = eval { MARC::File::USMARC::decode( $marcresults->[$i] ); };
1710 warn "ERROR DECODING RECORD - $@: " . $marcresults->[$i];
1717 ? GetFrameworkCode($marcrecord->field($bibliotag)->data)
1718 : GetFrameworkCode($marcrecord->subfield($bibliotag,$bibliosubf));
1719 my $oldbiblio = TransformMarcToKoha( $dbh, $marcrecord, $fw );
1720 $oldbiblio->{subtitle} = GetRecordValue('subtitle', $marcrecord, $fw);
1721 $oldbiblio->{result_number} = $i + 1;
1723 # add imageurl to itemtype if there is one
1724 $oldbiblio->{imageurl} = getitemtypeimagelocation( $search_context, $itemtypes{ $oldbiblio->{itemtype} }->{imageurl} );
1726 $oldbiblio->{'authorised_value_images'} = ($search_context eq 'opac' && C4::Context->preference('AuthorisedValueImages')) || ($search_context eq 'intranet' && C4::Context->preference('StaffAuthorisedValueImages')) ? C4::Items::get_authorised_value_images( C4::Biblio::get_biblio_authorised_values( $oldbiblio->{'biblionumber'}, $marcrecord ) ) : [];
1727 $oldbiblio->{normalized_upc} = GetNormalizedUPC( $marcrecord,$marcflavour);
1728 $oldbiblio->{normalized_ean} = GetNormalizedEAN( $marcrecord,$marcflavour);
1729 $oldbiblio->{normalized_oclc} = GetNormalizedOCLCNumber($marcrecord,$marcflavour);
1730 $oldbiblio->{normalized_isbn} = GetNormalizedISBN(undef,$marcrecord,$marcflavour);
1731 $oldbiblio->{content_identifier_exists} = 1 if ($oldbiblio->{normalized_isbn} or $oldbiblio->{normalized_oclc} or $oldbiblio->{normalized_ean} or $oldbiblio->{normalized_upc});
1733 # edition information, if any
1734 $oldbiblio->{edition} = $oldbiblio->{editionstatement};
1735 $oldbiblio->{description} = $itemtypes{ $oldbiblio->{itemtype} }->{description};
1736 # Build summary if there is one (the summary is defined in the itemtypes table)
1737 # FIXME: is this used anywhere, I think it can be commented out? -- JF
1738 if ( $itemtypes{ $oldbiblio->{itemtype} }->{summary} ) {
1739 my $summary = $itemtypes{ $oldbiblio->{itemtype} }->{summary};
1740 my @fields = $marcrecord->fields();
1743 foreach my $line ( "$summary\n" =~ /(.*)\n/g ){
1745 foreach my $tag ( $line =~ /\[(\d{3}[\w|\d])\]/ ) {
1746 $tag =~ /(.{3})(.)/;
1747 if($marcrecord->field($1)){
1748 my @abc = $marcrecord->field($1)->subfield($2);
1749 $tags->{$tag} = $#abc + 1 ;
1753 # We catch how many times to repeat this line
1755 foreach my $tag (keys(%$tags)){
1756 $max = $tags->{$tag} if($tags->{$tag} > $max);
1759 # we replace, and repeat each line
1760 for (my $i = 0 ; $i < $max ; $i++){
1761 my $newline = $line;
1763 foreach my $tag ( $newline =~ /\[(\d{3}[\w|\d])\]/g ) {
1764 $tag =~ /(.{3})(.)/;
1766 if($marcrecord->field($1)){
1767 my @repl = $marcrecord->field($1)->subfield($2);
1768 my $subfieldvalue = $repl[$i];
1770 if (! utf8::is_utf8($subfieldvalue)) {
1771 utf8::decode($subfieldvalue);
1774 $newline =~ s/\[$tag\]/$subfieldvalue/g;
1777 $newsummary .= "$newline\n";
1781 $newsummary =~ s/\[(.*?)]//g;
1782 $newsummary =~ s/\n/<br\/>/g;
1783 $oldbiblio->{summary} = $newsummary;
1786 # Pull out the items fields
1787 my @fields = $marcrecord->field($itemtag);
1788 my $marcflavor = C4::Context->preference("marcflavour");
1789 # adding linked items that belong to host records
1790 my $analyticsfield = '773';
1791 if ($marcflavor eq 'MARC21' || $marcflavor eq 'NORMARC') {
1792 $analyticsfield = '773';
1793 } elsif ($marcflavor eq 'UNIMARC') {
1794 $analyticsfield = '461';
1796 foreach my $hostfield ( $marcrecord->field($analyticsfield)) {
1797 my $hostbiblionumber = $hostfield->subfield("0");
1798 my $linkeditemnumber = $hostfield->subfield("9");
1799 if(!$hostbiblionumber eq undef){
1800 my $hostbiblio = GetMarcBiblio($hostbiblionumber, 1);
1801 my ($itemfield, undef) = GetMarcFromKohaField( 'items.itemnumber', GetFrameworkCode($hostbiblionumber) );
1802 if(!$hostbiblio eq undef){
1803 my @hostitems = $hostbiblio->field($itemfield);
1804 foreach my $hostitem (@hostitems){
1805 if ($hostitem->subfield("9") eq $linkeditemnumber){
1806 my $linkeditem =$hostitem;
1807 # append linked items if they exist
1808 if (!$linkeditem eq undef){
1809 push (@fields, $linkeditem);}
1816 # Setting item statuses for display
1817 my @available_items_loop;
1818 my @onloan_items_loop;
1819 my @other_items_loop;
1821 my $available_items;
1825 my $ordered_count = 0;
1826 my $available_count = 0;
1827 my $onloan_count = 0;
1828 my $longoverdue_count = 0;
1829 my $other_count = 0;
1830 my $wthdrawn_count = 0;
1831 my $itemlost_count = 0;
1832 my $hideatopac_count = 0;
1833 my $itembinding_count = 0;
1834 my $itemdamaged_count = 0;
1835 my $item_in_transit_count = 0;
1836 my $can_place_holds = 0;
1837 my $item_onhold_count = 0;
1838 my $items_count = scalar(@fields);
1839 my $maxitems_pref = C4::Context->preference('maxItemsinSearchResults');
1840 my $maxitems = $maxitems_pref ? $maxitems_pref - 1 : 1;
1841 my @hiddenitems; # hidden itemnumbers based on OpacHiddenItems syspref
1843 # loop through every item
1844 foreach my $field (@fields) {
1847 # populate the items hash
1848 foreach my $code ( keys %subfieldstosearch ) {
1849 $item->{$code} = $field->subfield( $subfieldstosearch{$code} );
1851 $item->{description} = $itemtypes{ $item->{itype} }{description};
1855 # hidden because lost
1856 if ($hidelostitems && $item->{itemlost}) {
1857 $hideatopac_count++;
1860 # hidden based on OpacHiddenItems syspref
1861 my @hi = C4::Items::GetHiddenItemnumbers($item);
1863 push @hiddenitems, @hi;
1864 $hideatopac_count++;
1869 my $hbranch = C4::Context->preference('HomeOrHoldingBranch') eq 'homebranch' ? 'homebranch' : 'holdingbranch';
1870 my $otherbranch = C4::Context->preference('HomeOrHoldingBranch') eq 'homebranch' ? 'holdingbranch' : 'homebranch';
1872 # set item's branch name, use HomeOrHoldingBranch syspref first, fall back to the other one
1873 if ($item->{$hbranch}) {
1874 $item->{'branchname'} = $branches{$item->{$hbranch}};
1876 elsif ($item->{$otherbranch}) { # Last resort
1877 $item->{'branchname'} = $branches{$item->{$otherbranch}};
1880 my $prefix = $item->{$hbranch} . '--' . $item->{location} . $item->{itype} . $item->{itemcallnumber};
1881 # For each grouping of items (onloan, available, unavailable), we build a key to store relevant info about that item
1882 my $userenv = C4::Context->userenv;
1883 if ( $item->{onloan} && !(C4::Members::GetHideLostItemsPreference($userenv->{'number'}) && $item->{itemlost}) ) {
1885 my $key = $prefix . $item->{onloan} . $item->{barcode};
1886 $onloan_items->{$key}->{due_date} = format_date($item->{onloan});
1887 $onloan_items->{$key}->{count}++ if $item->{$hbranch};
1888 $onloan_items->{$key}->{branchname} = $item->{branchname};
1889 $onloan_items->{$key}->{location} = $shelflocations->{ $item->{location} };
1890 $onloan_items->{$key}->{itemcallnumber} = $item->{itemcallnumber};
1891 $onloan_items->{$key}->{description} = $item->{description};
1892 $onloan_items->{$key}->{imageurl} = getitemtypeimagelocation( $search_context, $itemtypes{ $item->{itype} }->{imageurl} );
1893 # if something's checked out and lost, mark it as 'long overdue'
1894 if ( $item->{itemlost} ) {
1895 $onloan_items->{$prefix}->{longoverdue}++;
1896 $longoverdue_count++;
1897 } else { # can place holds as long as item isn't lost
1898 $can_place_holds = 1;
1902 # items not on loan, but still unavailable ( lost, withdrawn, damaged )
1906 if ( $item->{notforloan} < 0 ) {
1910 # is item in transit?
1911 my $transfertwhen = '';
1912 my ($transfertfrom, $transfertto);
1914 # is item on the reserve shelf?
1915 my $reservestatus = '';
1917 unless ($item->{wthdrawn}
1918 || $item->{itemlost}
1920 || $item->{notforloan}
1921 || $items_count > 20) {
1923 # A couple heuristics to limit how many times
1924 # we query the database for item transfer information, sacrificing
1925 # accuracy in some cases for speed;
1927 # 1. don't query if item has one of the other statuses
1928 # 2. don't check transit status if the bib has
1929 # more than 20 items
1931 # FIXME: to avoid having the query the database like this, and to make
1932 # the in transit status count as unavailable for search limiting,
1933 # should map transit status to record indexed in Zebra.
1935 ($transfertwhen, $transfertfrom, $transfertto) = C4::Circulation::GetTransfers($item->{itemnumber});
1936 $reservestatus = C4::Reserves::GetReserveStatus( $item->{itemnumber}, $oldbiblio->{biblionumber} );
1939 # item is withdrawn, lost, damaged, not for loan, reserved or in transit
1940 if ( $item->{wthdrawn}
1941 || $item->{itemlost}
1943 || $item->{notforloan}
1944 || $reservestatus eq 'Waiting'
1945 || ($transfertwhen ne ''))
1947 $wthdrawn_count++ if $item->{wthdrawn};
1948 $itemlost_count++ if $item->{itemlost};
1949 $itemdamaged_count++ if $item->{damaged};
1950 $item_in_transit_count++ if $transfertwhen ne '';
1951 $item_onhold_count++ if $reservestatus eq 'Waiting';
1952 $item->{status} = $item->{wthdrawn} . "-" . $item->{itemlost} . "-" . $item->{damaged} . "-" . $item->{notforloan};
1954 # can place a hold on a item if
1955 # not lost nor withdrawn
1956 # not damaged unless AllowHoldsOnDamagedItems is true
1957 # item is either for loan or on order (notforloan < 0)
1958 $can_place_holds = 1
1961 && !$item->{wthdrawn}
1962 && ( !$item->{damaged} || C4::Context->preference('AllowHoldsOnDamagedItems') )
1963 && ( !$item->{notforloan} || $item->{notforloan} < 0 )
1968 my $key = $prefix . $item->{status};
1969 foreach (qw(wthdrawn itemlost damaged branchname itemcallnumber)) {
1970 $other_items->{$key}->{$_} = $item->{$_};
1972 $other_items->{$key}->{intransit} = ( $transfertwhen ne '' ) ? 1 : 0;
1973 $other_items->{$key}->{onhold} = ($reservestatus) ? 1 : 0;
1974 $other_items->{$key}->{notforloan} = GetAuthorisedValueDesc('','',$item->{notforloan},'','',$notforloan_authorised_value) if $notforloan_authorised_value and $item->{notforloan};
1975 $other_items->{$key}->{count}++ if $item->{$hbranch};
1976 $other_items->{$key}->{location} = $shelflocations->{ $item->{location} };
1977 $other_items->{$key}->{description} = $item->{description};
1978 $other_items->{$key}->{imageurl} = getitemtypeimagelocation( $search_context, $itemtypes{ $item->{itype} }->{imageurl} );
1982 $can_place_holds = 1;
1984 $available_items->{$prefix}->{count}++ if $item->{$hbranch};
1985 foreach (qw(branchname itemcallnumber description)) {
1986 $available_items->{$prefix}->{$_} = $item->{$_};
1988 $available_items->{$prefix}->{location} = $shelflocations->{ $item->{location} };
1989 $available_items->{$prefix}->{imageurl} = getitemtypeimagelocation( $search_context, $itemtypes{ $item->{itype} }->{imageurl} );
1992 } # notforloan, item level and biblioitem level
1994 # if all items are hidden, do not show the record
1995 if ($items_count > 0 && $hideatopac_count == $items_count) {
1999 my ( $availableitemscount, $onloanitemscount, $otheritemscount );
2000 for my $key ( sort keys %$onloan_items ) {
2001 (++$onloanitemscount > $maxitems) and last;
2002 push @onloan_items_loop, $onloan_items->{$key};
2004 for my $key ( sort keys %$other_items ) {
2005 (++$otheritemscount > $maxitems) and last;
2006 push @other_items_loop, $other_items->{$key};
2008 for my $key ( sort keys %$available_items ) {
2009 (++$availableitemscount > $maxitems) and last;
2010 push @available_items_loop, $available_items->{$key}
2013 # XSLT processing of some stuff
2015 SetUTF8Flag($marcrecord);
2016 warn $marcrecord->as_formatted if $DEBUG;
2017 my $interface = $search_context eq 'opac' ? 'OPAC' : '';
2018 if (!$scan && C4::Context->preference($interface . "XSLTResultsDisplay")) {
2019 $oldbiblio->{XSLTResultsRecord} = XSLTParse4Display($oldbiblio->{biblionumber}, $marcrecord, $interface."XSLTResultsDisplay", 1, \@hiddenitems);
2020 # the last parameter tells Koha to clean up the problematic ampersand entities that Zebra outputs
2023 # if biblio level itypes are used and itemtype is notforloan, it can't be reserved either
2024 if (!C4::Context->preference("item-level_itypes")) {
2025 if ($itemtypes{ $oldbiblio->{itemtype} }->{notforloan}) {
2026 $can_place_holds = 0;
2029 $oldbiblio->{norequests} = 1 unless $can_place_holds;
2030 $oldbiblio->{itemsplural} = 1 if $items_count > 1;
2031 $oldbiblio->{items_count} = $items_count;
2032 $oldbiblio->{available_items_loop} = \@available_items_loop;
2033 $oldbiblio->{onloan_items_loop} = \@onloan_items_loop;
2034 $oldbiblio->{other_items_loop} = \@other_items_loop;
2035 $oldbiblio->{availablecount} = $available_count;
2036 $oldbiblio->{availableplural} = 1 if $available_count > 1;
2037 $oldbiblio->{onloancount} = $onloan_count;
2038 $oldbiblio->{onloanplural} = 1 if $onloan_count > 1;
2039 $oldbiblio->{othercount} = $other_count;
2040 $oldbiblio->{otherplural} = 1 if $other_count > 1;
2041 $oldbiblio->{wthdrawncount} = $wthdrawn_count;
2042 $oldbiblio->{itemlostcount} = $itemlost_count;
2043 $oldbiblio->{damagedcount} = $itemdamaged_count;
2044 $oldbiblio->{intransitcount} = $item_in_transit_count;
2045 $oldbiblio->{onholdcount} = $item_onhold_count;
2046 $oldbiblio->{orderedcount} = $ordered_count;
2048 if (C4::Context->preference("AlternateHoldingsField") && $items_count == 0) {
2049 my $fieldspec = C4::Context->preference("AlternateHoldingsField");
2050 my $subfields = substr $fieldspec, 3;
2051 my $holdingsep = C4::Context->preference("AlternateHoldingsSeparator") || ' ';
2052 my @alternateholdingsinfo = ();
2053 my @holdingsfields = $marcrecord->field(substr $fieldspec, 0, 3);
2054 my $alternateholdingscount = 0;
2056 for my $field (@holdingsfields) {
2057 my %holding = ( holding => '' );
2058 my $havesubfield = 0;
2059 for my $subfield ($field->subfields()) {
2060 if ((index $subfields, $$subfield[0]) >= 0) {
2061 $holding{'holding'} .= $holdingsep if (length $holding{'holding'} > 0);
2062 $holding{'holding'} .= $$subfield[1];
2066 if ($havesubfield) {
2067 push(@alternateholdingsinfo, \%holding);
2068 $alternateholdingscount++;
2072 $oldbiblio->{'ALTERNATEHOLDINGS'} = \@alternateholdingsinfo;
2073 $oldbiblio->{'alternateholdings_count'} = $alternateholdingscount;
2076 push( @newresults, $oldbiblio );
2082 =head2 SearchAcquisitions
2083 Search for acquisitions
2086 sub SearchAcquisitions{
2087 my ($datebegin, $dateend, $itemtypes,$criteria, $orderby) = @_;
2089 my $dbh=C4::Context->dbh;
2090 # Variable initialization
2094 LEFT JOIN biblioitems ON biblioitems.biblionumber=biblio.biblionumber
2095 LEFT JOIN items ON items.biblionumber=biblio.biblionumber
2096 WHERE dateaccessioned BETWEEN ? AND ?
2099 my (@params,@loopcriteria);
2101 push @params, $datebegin->output("iso");
2102 push @params, $dateend->output("iso");
2104 if (scalar(@$itemtypes)>0 and $criteria ne "itemtype" ){
2105 if(C4::Context->preference("item-level_itypes")){
2106 $str .= "AND items.itype IN (?".( ',?' x scalar @$itemtypes - 1 ).") ";
2108 $str .= "AND biblioitems.itemtype IN (?".( ',?' x scalar @$itemtypes - 1 ).") ";
2110 push @params, @$itemtypes;
2113 if ($criteria =~/itemtype/){
2114 if(C4::Context->preference("item-level_itypes")){
2115 $str .= "AND items.itype=? ";
2117 $str .= "AND biblioitems.itemtype=? ";
2120 if(scalar(@$itemtypes) == 0){
2121 my $itypes = GetItemTypes();
2122 for my $key (keys %$itypes){
2123 push @$itemtypes, $key;
2127 @loopcriteria= @$itemtypes;
2128 }elsif ($criteria=~/itemcallnumber/){
2129 $str .= "AND (items.itemcallnumber LIKE CONCAT(?,'%')
2130 OR items.itemcallnumber is NULL
2131 OR items.itemcallnumber = '')";
2133 @loopcriteria = ("AA".."ZZ", "") unless (scalar(@loopcriteria)>0);
2135 $str .= "AND biblio.title LIKE CONCAT(?,'%') ";
2136 @loopcriteria = ("A".."z") unless (scalar(@loopcriteria)>0);
2139 if ($orderby =~ /date_desc/){
2140 $str.=" ORDER BY dateaccessioned DESC";
2142 $str.=" ORDER BY title";
2145 my $qdataacquisitions=$dbh->prepare($str);
2147 my @loopacquisitions;
2148 foreach my $value(@loopcriteria){
2149 push @params,$value;
2151 $cell{"title"}=$value;
2152 $cell{"titlecode"}=$value;
2154 eval{$qdataacquisitions->execute(@params);};
2156 if ($@){ warn "recentacquisitions Error :$@";}
2159 while (my $data=$qdataacquisitions->fetchrow_hashref){
2160 push @loopdata, {"summary"=>GetBiblioSummary( $data->{'marcxml'} ) };
2162 $cell{"loopdata"}=\@loopdata;
2164 push @loopacquisitions,\%cell if (scalar(@{$cell{loopdata}})>0);
2167 $qdataacquisitions->finish;
2168 return \@loopacquisitions;
2171 =head2 enabled_staff_search_views
2173 %hash = enabled_staff_search_views()
2175 This function returns a hash that contains three flags obtained from the system
2176 preferences, used to determine whether a particular staff search results view
2181 =item C<Output arg:>
2183 * $hash{can_view_MARC} is true only if the MARC view is enabled
2184 * $hash{can_view_ISBD} is true only if the ISBD view is enabled
2185 * $hash{can_view_labeledMARC} is true only if the Labeled MARC view is enabled
2187 =item C<usage in the script:>
2191 $template->param ( C4::Search::enabled_staff_search_views );
2195 sub enabled_staff_search_views
2198 can_view_MARC => C4::Context->preference('viewMARC'), # 1 if the staff search allows the MARC view
2199 can_view_ISBD => C4::Context->preference('viewISBD'), # 1 if the staff search allows the ISBD view
2200 can_view_labeledMARC => C4::Context->preference('viewLabeledMARC'), # 1 if the staff search allows the Labeled MARC view
2204 sub AddSearchHistory{
2205 my ($borrowernumber,$session,$query_desc,$query_cgi, $total)=@_;
2206 my $dbh = C4::Context->dbh;
2208 # Add the request the user just made
2209 my $sql = "INSERT INTO search_history(userid, sessionid, query_desc, query_cgi, total, time) VALUES(?, ?, ?, ?, ?, NOW())";
2210 my $sth = $dbh->prepare($sql);
2211 $sth->execute($borrowernumber, $session, $query_desc, $query_cgi, $total);
2212 return $dbh->last_insert_id(undef, 'search_history', undef,undef,undef);
2215 sub GetSearchHistory{
2216 my ($borrowernumber,$session)=@_;
2217 my $dbh = C4::Context->dbh;
2219 # Add the request the user just made
2220 my $query = "SELECT FROM search_history WHERE (userid=? OR sessionid=?)";
2221 my $sth = $dbh->prepare($query);
2222 $sth->execute($borrowernumber, $session);
2223 return $sth->fetchall_hashref({});
2226 =head2 z3950_search_args
2228 $arrayref = z3950_search_args($matchpoints)
2230 This function returns an array reference that contains the search parameters to be
2231 passed to the Z39.50 search script (z3950_search.pl). The array elements
2232 are hash refs whose keys are name and value, and whose values are the
2233 name of a search parameter, the value of that search parameter and the URL encoded
2234 value of that parameter.
2236 The search parameter names are lccn, isbn, issn, title, author, dewey and subject.
2238 The search parameter values are obtained from the bibliographic record whose
2239 data is in a hash reference in $matchpoints, as returned by Biblio::GetBiblioData().
2241 If $matchpoints is a scalar, it is assumed to be an unnamed query descriptor, e.g.
2242 a general purpose search argument. In this case, the returned array contains only
2243 entry: the key is 'title' and the value is derived from $matchpoints.
2245 If a search parameter value is undefined or empty, it is not included in the returned
2248 The returned array reference may be passed directly to the template parameters.
2252 =item C<Output arg:>
2254 * $array containing hash refs as described above
2256 =item C<usage in the script:>
2260 $data = Biblio::GetBiblioData($bibno);
2261 $template->param ( MYLOOP => C4::Search::z3950_search_args($data) )
2265 $template->param ( MYLOOP => C4::Search::z3950_search_args($searchscalar) )
2269 sub z3950_search_args {
2271 my $isbn = Business::ISBN->new($bibrec);
2273 if (defined $isbn && $isbn->is_valid)
2275 $bibrec = { isbn => $bibrec } if !ref $bibrec;
2278 $bibrec = { title => $bibrec } if !ref $bibrec;
2281 for my $field (qw/ lccn isbn issn title author dewey subject /)
2283 push @$array, { name => $field, value => $bibrec->{$field} }
2284 if defined $bibrec->{$field};
2289 =head2 GetDistinctValues($field);
2291 C<$field> is a reference to the fields array
2295 sub GetDistinctValues {
2296 my ($fieldname,$string)=@_;
2297 # returns a reference to a hash of references to branches...
2298 if ($fieldname=~/\./){
2299 my ($table,$column)=split /\./, $fieldname;
2300 my $dbh = C4::Context->dbh;
2301 warn "select DISTINCT($column) as value, count(*) as cnt from $table group by lib order by $column " if $DEBUG;
2302 my $sth = $dbh->prepare("select DISTINCT($column) as value, count(*) as cnt from $table ".($string?" where $column like \"$string%\"":"")."group by value order by $column ");
2304 my $elements=$sth->fetchall_arrayref({});
2309 my @servers=qw<biblioserver authorityserver>;
2310 my (@zconns,@results);
2311 for ( my $i = 0 ; $i < @servers ; $i++ ) {
2312 $zconns[$i] = C4::Context->Zconn( $servers[$i], 1 );
2315 ZOOM::Query::CCL2RPN->new( qq"$fieldname $string", $zconns[$i])
2318 # The big moment: asynchronously retrieve results from all servers
2324 my ( $i, $size ) = @_;
2325 for ( my $j = 0 ; $j < $size ; $j++ ) {
2327 @hashscan{qw(value cnt)} =
2328 $results[ $i - 1 ]->display_term($j);
2329 push @elements, \%hashscan;
2337 =head2 _ZOOM_event_loop
2339 _ZOOM_event_loop(\@zconns, \@results, sub {
2340 my ( $i, $size ) = @_;
2344 Processes a ZOOM event loop and passes control to a closure for
2345 processing the results, and destroying the resultsets.
2349 sub _ZOOM_event_loop {
2350 my ($zconns, $results, $callback) = @_;
2351 while ( ( my $i = ZOOM::event( $zconns ) ) != 0 ) {
2352 my $ev = $zconns->[ $i - 1 ]->last_event();
2353 if ( $ev == ZOOM::Event::ZEND ) {
2354 next unless $results->[ $i - 1 ];
2355 my $size = $results->[ $i - 1 ]->size();
2357 $callback->($i, $size);
2362 foreach my $result (@$results) {
2368 END { } # module clean-up code here (global destructor)
2375 Koha Development Team <http://koha-community.org/>