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
40 use vars qw($VERSION @ISA @EXPORT @EXPORT_OK %EXPORT_TAGS $DEBUG);
42 # set the version for version checking
44 $VERSION = 3.07.00.049;
45 $DEBUG = ($ENV{DEBUG}) ? 1 : 0;
50 C4::Search - Functions for searching the Koha catalog.
54 See opac/opac-search.pl or catalogue/search.pl for example of usage
58 This module provides searching functions for Koha's bibliographic databases
73 &enabled_staff_search_views
77 # make all your functions, whether exported or not;
81 ($biblionumber,$biblionumber,$title) = FindDuplicate($record);
83 This function attempts to find duplicate records using a hard-coded, fairly simplistic algorithm
89 my $dbh = C4::Context->dbh;
90 my $result = TransformMarcToKoha( $dbh, $record, '' );
95 my ( $biblionumber, $title );
97 # search duplicate on ISBN, easy and fast..
99 if ( $result->{isbn} ) {
100 $result->{isbn} =~ s/\(.*$//;
101 $result->{isbn} =~ s/\s+$//;
102 $query = "isbn:$result->{isbn}";
106 $QParser = C4::Context->queryparser if (C4::Context->preference('UseQueryParser'));
112 $titleindex = 'title|exact';
113 $authorindex = 'author|exact';
115 $QParser->custom_data->{'QueryAutoTruncate'} = C4::Context->preference('QueryAutoTruncate');
117 $titleindex = 'ti,ext';
118 $authorindex = 'au,ext';
122 $result->{title} =~ s /\\//g;
123 $result->{title} =~ s /\"//g;
124 $result->{title} =~ s /\(//g;
125 $result->{title} =~ s /\)//g;
127 # FIXME: instead of removing operators, could just do
128 # quotes around the value
129 $result->{title} =~ s/(and|or|not)//g;
130 $query = "$titleindex:\"$result->{title}\"";
131 if ( $result->{author} ) {
132 $result->{author} =~ s /\\//g;
133 $result->{author} =~ s /\"//g;
134 $result->{author} =~ s /\(//g;
135 $result->{author} =~ s /\)//g;
137 # remove valid operators
138 $result->{author} =~ s/(and|or|not)//g;
139 $query .= " $op $authorindex:\"$result->{author}\"";
143 my ( $error, $searchresults, undef ) = SimpleSearch($query); # FIXME :: hardcoded !
145 if (!defined $error) {
146 foreach my $possible_duplicate_record (@{$searchresults}) {
148 MARC::Record->new_from_usmarc($possible_duplicate_record);
149 my $result = TransformMarcToKoha( $dbh, $marcrecord, '' );
151 # FIXME :: why 2 $biblionumber ?
153 push @results, $result->{'biblionumber'};
154 push @results, $result->{'title'};
163 ( $error, $results, $total_hits ) = SimpleSearch( $query, $offset, $max_results, [@servers] );
165 This function provides a simple search API on the bibliographic catalog
171 * $query can be a simple keyword or a complete CCL query
172 * @servers is optional. Defaults to biblioserver as found in koha-conf.xml
173 * $offset - If present, represents the number of records at the beggining to omit. Defaults to 0
174 * $max_results - if present, determines the maximum number of records to fetch. undef is All. defaults to undef.
179 Returns an array consisting of three elements
180 * $error is undefined unless an error is detected
181 * $results is a reference to an array of records.
182 * $total_hits is the number of hits that would have been returned with no limit
184 If an error is returned the two other return elements are undefined. If error itself is undefined
185 the other two elements are always defined
187 =item C<usage in the script:>
191 my ( $error, $marcresults, $total_hits ) = SimpleSearch($query);
193 if (defined $error) {
194 $template->param(query_error => $error);
195 warn "error: ".$error;
196 output_html_with_http_headers $input, $cookie, $template->output;
200 my $hits = @{$marcresults};
203 for my $r ( @{$marcresults} ) {
204 my $marcrecord = MARC::File::USMARC::decode($r);
205 my $biblio = TransformMarcToKoha(C4::Context->dbh,$marcrecord,q{});
207 #build the iarray of hashs for the template.
209 title => $biblio->{'title'},
210 subtitle => $biblio->{'subtitle'},
211 biblionumber => $biblio->{'biblionumber'},
212 author => $biblio->{'author'},
213 publishercode => $biblio->{'publishercode'},
214 publicationyear => $biblio->{'publicationyear'},
219 $template->param(result=>\@results);
224 my ( $query, $offset, $max_results, $servers ) = @_;
226 return ( 'No query entered', undef, undef ) unless $query;
227 # FIXME hardcoded value. See catalog/search.pl & opac-search.pl too.
228 my @servers = defined ( $servers ) ? @$servers : ( 'biblioserver' );
236 $QParser = C4::Context->queryparser if (C4::Context->preference('UseQueryParser') && ! ($query =~ m/\w,\w|\w=\w/));
238 $QParser->custom_data->{'QueryAutoTruncate'} = C4::Context->preference('QueryAutoTruncate');
241 # Initialize & Search Zebra
242 for ( my $i = 0 ; $i < @servers ; $i++ ) {
244 $zconns[$i] = C4::Context->Zconn( $servers[$i], 1 );
247 $QParser->parse( $query );
248 $query = $QParser->target_syntax($servers[$i]);
249 $zoom_queries[$i] = new ZOOM::Query::PQF( $query, $zconns[$i]);
252 $zoom_queries[$i] = new ZOOM::Query::CCL2RPN( $query, $zconns[$i]);
254 $tmpresults[$i] = $zconns[$i]->search( $zoom_queries[$i] );
258 $zconns[$i]->errmsg() . " ("
259 . $zconns[$i]->errcode() . ") "
260 . $zconns[$i]->addinfo() . " "
261 . $zconns[$i]->diagset();
263 return ( $error, undef, undef ) if $zconns[$i]->errcode();
267 # caught a ZOOM::Exception
271 . $@->addinfo() . " "
273 warn $error." for query: $query";
274 return ( $error, undef, undef );
283 my $first_record = defined($offset) ? $offset + 1 : 1;
284 my $hits = $tmpresults[ $i - 1 ]->size();
285 $total_hits += $hits;
286 my $last_record = $hits;
287 if ( defined $max_results && $offset + $max_results < $hits ) {
288 $last_record = $offset + $max_results;
291 for my $j ( $first_record .. $last_record ) {
293 $tmpresults[ $i - 1 ]->record( $j - 1 )->raw()
295 push @{$results}, $record;
300 foreach my $zoom_query (@zoom_queries) {
301 $zoom_query->destroy();
304 return ( undef, $results, $total_hits );
309 ( undef, $results_hashref, \@facets_loop ) = getRecords (
311 $koha_query, $simple_query, $sort_by_ref, $servers_ref,
312 $results_per_page, $offset, $expanded_facet, $branches,$itemtypes,
316 The all singing, all dancing, multi-server, asynchronous, scanning,
317 searching, record nabbing, facet-building
319 See verbse embedded documentation.
325 $koha_query, $simple_query, $sort_by_ref, $servers_ref,
326 $results_per_page, $offset, $expanded_facet, $branches,
327 $itemtypes, $query_type, $scan, $opac
330 my @servers = @$servers_ref;
331 my @sort_by = @$sort_by_ref;
333 # Initialize variables for the ZOOM connection and results object
337 my $results_hashref = ();
339 # Initialize variables for the faceted results objects
340 my $facets_counter = ();
341 my $facets_info = ();
342 my $facets = getFacets();
343 my $facets_maxrecs = C4::Context->preference('maxRecordsForFacets')||20;
345 my @facets_loop; # stores the ref to array of hashes for template facets loop
347 ### LOOP THROUGH THE SERVERS
348 for ( my $i = 0 ; $i < @servers ; $i++ ) {
349 $zconns[$i] = C4::Context->Zconn( $servers[$i], 1 );
351 # perform the search, create the results objects
352 # if this is a local search, use the $koha-query, if it's a federated one, use the federated-query
353 my $query_to_use = ($servers[$i] =~ /biblioserver/) ? $koha_query : $simple_query;
355 #$query_to_use = $simple_query if $scan;
356 warn $simple_query if ( $scan and $DEBUG );
358 # Check if we've got a query_type defined, if so, use it
361 if ($query_type =~ /^ccl/) {
362 $query_to_use =~ s/\:/\=/g; # change : to = last minute (FIXME)
363 $results[$i] = $zconns[$i]->search(new ZOOM::Query::CCL2RPN($query_to_use, $zconns[$i]));
364 } elsif ($query_type =~ /^cql/) {
365 $results[$i] = $zconns[$i]->search(new ZOOM::Query::CQL($query_to_use, $zconns[$i]));
366 } elsif ($query_type =~ /^pqf/) {
367 $results[$i] = $zconns[$i]->search(new ZOOM::Query::PQF($query_to_use, $zconns[$i]));
369 warn "Unknown query_type '$query_type'. Results undetermined.";
372 $results[$i] = $zconns[$i]->scan( new ZOOM::Query::CCL2RPN($query_to_use, $zconns[$i]));
374 $results[$i] = $zconns[$i]->search(new ZOOM::Query::CCL2RPN($query_to_use, $zconns[$i]));
378 warn "WARNING: query problem with $query_to_use " . $@;
381 # Concatenate the sort_by limits and pass them to the results object
382 # Note: sort will override rank
384 foreach my $sort (@sort_by) {
385 if ( $sort eq "author_az" || $sort eq "author_asc" ) {
386 $sort_by .= "1=1003 <i ";
388 elsif ( $sort eq "author_za" || $sort eq "author_dsc" ) {
389 $sort_by .= "1=1003 >i ";
391 elsif ( $sort eq "popularity_asc" ) {
392 $sort_by .= "1=9003 <i ";
394 elsif ( $sort eq "popularity_dsc" ) {
395 $sort_by .= "1=9003 >i ";
397 elsif ( $sort eq "call_number_asc" ) {
398 $sort_by .= "1=8007 <i ";
400 elsif ( $sort eq "call_number_dsc" ) {
401 $sort_by .= "1=8007 >i ";
403 elsif ( $sort eq "pubdate_asc" ) {
404 $sort_by .= "1=31 <i ";
406 elsif ( $sort eq "pubdate_dsc" ) {
407 $sort_by .= "1=31 >i ";
409 elsif ( $sort eq "acqdate_asc" ) {
410 $sort_by .= "1=32 <i ";
412 elsif ( $sort eq "acqdate_dsc" ) {
413 $sort_by .= "1=32 >i ";
415 elsif ( $sort eq "title_az" || $sort eq "title_asc" ) {
416 $sort_by .= "1=4 <i ";
418 elsif ( $sort eq "title_za" || $sort eq "title_dsc" ) {
419 $sort_by .= "1=4 >i ";
422 warn "Ignoring unrecognized sort '$sort' requested" if $sort_by;
425 if ($sort_by && !$scan) {
426 if ( $results[$i]->sort( "yaz", $sort_by ) < 0 ) {
427 warn "WARNING sort $sort_by failed";
430 } # finished looping through servers
432 # The big moment: asynchronously retrieve results from all servers
437 my ( $i, $size ) = @_;
440 # loop through the results
441 $results_hash->{'hits'} = $size;
443 if ( $offset + $results_per_page <= $size ) {
444 $times = $offset + $results_per_page;
449 for ( my $j = $offset ; $j < $times ; $j++ ) {
453 ## Check if it's an index scan
455 my ( $term, $occ ) = $results[ $i - 1 ]->term($j);
457 # here we create a minimal MARC record and hand it off to the
458 # template just like a normal result ... perhaps not ideal, but
460 my $tmprecord = MARC::Record->new();
461 $tmprecord->encoding('UTF-8');
465 # the minimal record in author/title (depending on MARC flavour)
466 if ( C4::Context->preference("marcflavour") eq
469 $tmptitle = MARC::Field->new(
474 $tmprecord->append_fields($tmptitle);
478 MARC::Field->new( '245', ' ', ' ', a => $term, );
480 MARC::Field->new( '100', ' ', ' ', a => $occ, );
481 $tmprecord->append_fields($tmptitle);
482 $tmprecord->append_fields($tmpauthor);
484 $results_hash->{'RECORDS'}[$j] =
485 $tmprecord->as_usmarc();
490 $record = $results[ $i - 1 ]->record($j)->raw();
492 # warn "RECORD $j:".$record;
493 $results_hash->{'RECORDS'}[$j] = $record;
497 $results_hashref->{ $servers[ $i - 1 ] } = $results_hash;
499 # Fill the facets while we're looping, but only for the biblioserver and not for a scan
500 if ( !$scan && $servers[ $i - 1 ] =~ /biblioserver/ ) {
503 $size > $facets_maxrecs ? $facets_maxrecs : $size;
504 for my $facet (@$facets) {
505 for ( my $j = 0 ; $j < $jmax ; $j++ ) {
507 $results[ $i - 1 ]->record($j)->render();
509 foreach my $tag ( @{ $facet->{tags} } ) {
512 my $tag_num = substr( $tag, 0, 3 );
513 my $letters = substr( $tag, 3 );
515 '\n' . $tag_num . ' ([^z][^\n]+)';
516 $field_pattern = '\n' . $tag_num . ' ([^\n]+)'
517 if ( int($tag_num) < 10 );
519 ( $render_record =~ /$field_pattern/g );
520 foreach my $field_token (@field_tokens) {
521 my @subf = ( $field_token =~
522 /\$([a-zA-Z0-9]) ([^\$]+)/g );
524 for ( my $i = 0 ; $i < @subf ; $i += 2 ) {
525 if ( $letters =~ $subf[$i] ) {
526 my $value = $subf[ $i + 1 ];
529 push @values, $value;
532 my $data = join( $facet->{sep}, @values );
533 unless ( $data ~~ @used_datas ) {
534 $facets_counter->{ $facet->{idx} }
536 push @used_datas, $data;
541 $facets_info->{ $facet->{idx} }->{label_value} =
543 $facets_info->{ $facet->{idx} }->{expanded} =
548 # warn "connection ", $i-1, ": $size hits";
549 # warn $results[$i-1]->record(0)->render() if $size > 0;
552 if ( $servers[ $i - 1 ] =~ /biblioserver/ ) {
554 sort { $facets_counter->{$b} <=> $facets_counter->{$a} }
555 keys %$facets_counter
559 my $number_of_facets;
560 my @this_facets_array;
563 $facets_counter->{$link_value}
564 ->{$b} <=> $facets_counter->{$link_value}
566 } keys %{ $facets_counter->{$link_value} }
570 if ( ( $number_of_facets < 6 )
571 || ( $expanded_facet eq $link_value )
572 || ( $facets_info->{$link_value}->{'expanded'} )
576 # Sanitize the link value : parenthesis, question and exclamation mark will cause errors with CCL
577 my $facet_link_value = $one_facet;
578 $facet_link_value =~ s/[()!?¡¿؟]/ /g;
580 # fix the length that will display in the label,
581 my $facet_label_value = $one_facet;
582 my $facet_max_length = C4::Context->preference(
583 'FacetLabelTruncationLength')
586 substr( $one_facet, 0, $facet_max_length )
588 if length($facet_label_value) >
591 # if it's a branch, label by the name, not the code,
592 if ( $link_value =~ /branch/ ) {
593 if ( defined $branches
594 && ref($branches) eq "HASH"
595 && defined $branches->{$one_facet}
596 && ref( $branches->{$one_facet} ) eq
600 $branches->{$one_facet}
604 $facet_label_value = "*";
608 # if it's a itemtype, label by the name, not the code,
609 if ( $link_value =~ /itype/ ) {
610 if ( defined $itemtypes
611 && ref($itemtypes) eq "HASH"
612 && defined $itemtypes->{$one_facet}
613 && ref( $itemtypes->{$one_facet} ) eq
617 $itemtypes->{$one_facet}
622 # also, if it's a location code, use the name instead of the code
623 if ( $link_value =~ /location/ ) {
625 GetKohaAuthorisedValueLib( 'LOC',
629 # but we're down with the whole label being in the link's title.
630 push @this_facets_array,
633 $facets_counter->{$link_value}
635 facet_label_value => $facet_label_value,
636 facet_title_value => $one_facet,
637 facet_link_value => $facet_link_value,
638 type_link_value => $link_value,
640 if ($facet_label_value);
644 # handle expanded option
645 unless ( $facets_info->{$link_value}->{'expanded'} ) {
647 if ( ( $number_of_facets > 6 )
648 && ( $expanded_facet ne $link_value ) );
652 type_link_value => $link_value,
653 type_id => $link_value . "_id",
655 . $facets_info->{$link_value}->{'label_value'} =>
657 facets => \@this_facets_array,
658 expandable => $expandable,
659 expand => $link_value,
663 $facets_info->{$link_value}->{'label_value'} =~
666 and ( C4::Context->preference('singleBranchMode') )
672 return ( undef, $results_hashref, \@facets_loop );
677 $koha_query, $simple_query, $sort_by_ref, $servers_ref,
678 $results_per_page, $offset, $expanded_facet, $branches,
682 my $paz = C4::Search::PazPar2->new(C4::Context->config('pazpar2url'));
684 $paz->search($simple_query);
685 sleep 1; # FIXME: WHY?
688 my $results_hashref = {};
689 my $stats = XMLin($paz->stat);
690 my $results = XMLin($paz->show($offset, $results_per_page, 'work-title:1'), forcearray => 1);
692 # for a grouped search result, the number of hits
693 # is the number of groups returned; 'bib_hits' will have
694 # the total number of bibs.
695 $results_hashref->{'biblioserver'}->{'hits'} = $results->{'merged'}->[0];
696 $results_hashref->{'biblioserver'}->{'bib_hits'} = $stats->{'hits'};
698 HIT: foreach my $hit (@{ $results->{'hit'} }) {
699 my $recid = $hit->{recid}->[0];
701 my $work_title = $hit->{'md-work-title'}->[0];
703 if (exists $hit->{'md-work-author'}) {
704 $work_author = $hit->{'md-work-author'}->[0];
706 my $group_label = (defined $work_author) ? "$work_title / $work_author" : $work_title;
708 my $result_group = {};
709 $result_group->{'group_label'} = $group_label;
710 $result_group->{'group_merge_key'} = $recid;
713 if (exists $hit->{count}) {
714 $count = $hit->{count}->[0];
716 $result_group->{'group_count'} = $count;
718 for (my $i = 0; $i < $count; $i++) {
719 # FIXME -- may need to worry about diacritics here
720 my $rec = $paz->record($recid, $i);
721 push @{ $result_group->{'RECORDS'} }, $rec;
724 push @{ $results_hashref->{'biblioserver'}->{'GROUPS'} }, $result_group;
727 # pass through facets
728 my $termlist_xml = $paz->termlist('author,subject');
729 my $terms = XMLin($termlist_xml, forcearray => 1);
730 my @facets_loop = ();
731 #die Dumper($results);
732 # foreach my $list (sort keys %{ $terms->{'list'} }) {
734 # foreach my $facet (sort @{ $terms->{'list'}->{$list}->{'term'} } ) {
736 # facet_label_value => $facet->{'name'}->[0],
739 # push @facets_loop, ( {
740 # type_label => $list,
741 # facets => \@facets,
745 return ( undef, $results_hashref, \@facets_loop );
749 sub _remove_stopwords {
750 my ( $operand, $index ) = @_;
751 my @stopwords_removed;
753 # phrase and exact-qualified indexes shouldn't have stopwords removed
754 if ( $index !~ m/phr|ext/ ) {
756 # remove stopwords from operand : parse all stopwords & remove them (case insensitive)
757 # we use IsAlpha unicode definition, to deal correctly with diacritics.
758 # otherwise, a French word like "leçon" woudl be split into "le" "çon", "le"
759 # is a stopword, we'd get "çon" and wouldn't find anything...
761 foreach ( keys %{ C4::Context->stopwords } ) {
762 next if ( $_ =~ /(and|or|not)/ ); # don't remove operators
763 if ( my ($matched) = ($operand =~
764 /([^\X\p{isAlnum}]\Q$_\E[^\X\p{isAlnum}]|[^\X\p{isAlnum}]\Q$_\E$|^\Q$_\E[^\X\p{isAlnum}])/gi))
766 $operand =~ s/\Q$matched\E/ /gi;
767 push @stopwords_removed, $_;
771 return ( $operand, \@stopwords_removed );
775 sub _detect_truncation {
776 my ( $operand, $index ) = @_;
777 my ( @nontruncated, @righttruncated, @lefttruncated, @rightlefttruncated,
780 my @wordlist = split( /\s/, $operand );
781 foreach my $word (@wordlist) {
782 if ( $word =~ s/^\*([^\*]+)\*$/$1/ ) {
783 push @rightlefttruncated, $word;
785 elsif ( $word =~ s/^\*([^\*]+)$/$1/ ) {
786 push @lefttruncated, $word;
788 elsif ( $word =~ s/^([^\*]+)\*$/$1/ ) {
789 push @righttruncated, $word;
791 elsif ( index( $word, "*" ) < 0 ) {
792 push @nontruncated, $word;
795 push @regexpr, $word;
799 \@nontruncated, \@righttruncated, \@lefttruncated,
800 \@rightlefttruncated, \@regexpr
805 sub _build_stemmed_operand {
806 my ($operand,$lang) = @_;
807 require Lingua::Stem::Snowball ;
808 my $stemmed_operand=q{};
810 # If operand contains a digit, it is almost certainly an identifier, and should
811 # not be stemmed. This is particularly relevant for ISBNs and ISSNs, which
812 # can contain the letter "X" - for example, _build_stemmend_operand would reduce
813 # "014100018X" to "x ", which for a MARC21 database would bring up irrelevant
814 # results (e.g., "23 x 29 cm." from the 300$c). Bug 2098.
815 return $operand if $operand =~ /\d/;
817 # FIXME: the locale should be set based on the user's language and/or search choice
819 # Make sure we only use the first two letters from the language code
820 $lang = lc(substr($lang, 0, 2));
821 # The language codes for the two variants of Norwegian will now be "nb" and "nn",
822 # none of which Lingua::Stem::Snowball can use, so we need to "translate" them
823 if ($lang eq 'nb' || $lang eq 'nn') {
826 my $stemmer = Lingua::Stem::Snowball->new( lang => $lang,
827 encoding => "UTF-8" );
829 my @words = split( / /, $operand );
830 my @stems = $stemmer->stem(\@words);
831 for my $stem (@stems) {
832 $stemmed_operand .= "$stem";
833 $stemmed_operand .= "?"
834 unless ( $stem =~ /(and$|or$|not$)/ ) || ( length($stem) < 3 );
835 $stemmed_operand .= " ";
837 warn "STEMMED OPERAND: $stemmed_operand" if $DEBUG;
838 return $stemmed_operand;
842 sub _build_weighted_query {
844 # FIELD WEIGHTING - This is largely experimental stuff. What I'm committing works
845 # pretty well but could work much better if we had a smarter query parser
846 my ( $operand, $stemmed_operand, $index ) = @_;
847 my $stemming = C4::Context->preference("QueryStemming") || 0;
848 my $weight_fields = C4::Context->preference("QueryWeightFields") || 0;
849 my $fuzzy_enabled = C4::Context->preference("QueryFuzzy") || 0;
851 my $weighted_query .= "(rk=("; # Specifies that we're applying rank
853 # Keyword, or, no index specified
854 if ( ( $index eq 'kw' ) || ( !$index ) ) {
856 "Title-cover,ext,r1=\"$operand\""; # exact title-cover
857 $weighted_query .= " or ti,ext,r2=\"$operand\""; # exact title
858 $weighted_query .= " or Title-cover,phr,r3=\"$operand\""; # phrase title
859 #$weighted_query .= " or any,ext,r4=$operand"; # exact any
860 #$weighted_query .=" or kw,wrdl,r5=\"$operand\""; # word list any
861 $weighted_query .= " or wrdl,fuzzy,r8=\"$operand\""
862 if $fuzzy_enabled; # add fuzzy, word list
863 $weighted_query .= " or wrdl,right-Truncation,r9=\"$stemmed_operand\""
864 if ( $stemming and $stemmed_operand )
865 ; # add stemming, right truncation
866 $weighted_query .= " or wrdl,r9=\"$operand\"";
868 # embedded sorting: 0 a-z; 1 z-a
869 # $weighted_query .= ") or (sort1,aut=1";
872 # Barcode searches should skip this process
873 elsif ( $index eq 'bc' ) {
874 $weighted_query .= "bc=\"$operand\"";
877 # Authority-number searches should skip this process
878 elsif ( $index eq 'an' ) {
879 $weighted_query .= "an=\"$operand\"";
882 # If the index already has more than one qualifier, wrap the operand
883 # in quotes and pass it back (assumption is that the user knows what they
884 # are doing and won't appreciate us mucking up their query
885 elsif ( $index =~ ',' ) {
886 $weighted_query .= " $index=\"$operand\"";
889 #TODO: build better cases based on specific search indexes
891 $weighted_query .= " $index,ext,r1=\"$operand\""; # exact index
892 #$weighted_query .= " or (title-sort-az=0 or $index,startswithnt,st-word,r3=$operand #)";
893 $weighted_query .= " or $index,phr,r3=\"$operand\""; # phrase index
894 $weighted_query .= " or $index,wrdl,r6=\"$operand\""; # word list index
895 $weighted_query .= " or $index,wrdl,fuzzy,r8=\"$operand\""
896 if $fuzzy_enabled; # add fuzzy, word list
897 $weighted_query .= " or $index,wrdl,rt,r9=\"$stemmed_operand\""
898 if ( $stemming and $stemmed_operand ); # add stemming, right truncation
901 $weighted_query .= "))"; # close rank specification
902 return $weighted_query;
907 Return an array with available indexes.
929 'Author-personal-bibliography',
939 'Chronological-subdivision',
949 'Conference-name-heading',
950 'Conference-name-see',
951 'Conference-name-seealso',
956 'Corporate-name-heading',
957 'Corporate-name-see',
958 'Corporate-name-seealso',
959 'Country-publication',
961 'date-entered-on-file',
962 'Date-of-acquisition',
963 'Date-of-publication',
964 'Dewey-classification',
971 'Geographic-subdivision',
974 'Heading-use-main-or-added-entry',
975 'Heading-use-series-added-entry ',
976 'Heading-use-subject-added-entry',
994 'Local-classification',
997 'Match-heading-see-from',
1005 'Name-geographic-heading',
1006 'Name-geographic-see',
1007 'Name-geographic-seealso',
1015 'Personal-name-heading',
1016 'Personal-name-see',
1017 'Personal-name-seealso',
1019 'Place-publication',
1024 'Record-control-number',
1035 'Subject-heading-thesaurus',
1036 'Subject-name-personal',
1037 'Subject-subdivision',
1047 'Term-genre-form-heading',
1048 'Term-genre-form-see',
1049 'Term-genre-form-seealso',
1056 'Title-uniform-heading',
1057 'Title-uniform-see',
1058 'Title-uniform-seealso',
1068 'classification-source',
1070 'coded-location-qualifier',
1081 'Local-classification',
1084 'materials-specified',
1093 'replacementpricedate',
1108 =head2 _handle_exploding_index
1110 my $query = _handle_exploding_index($index, $term)
1112 Callback routine to generate the search for "exploding" indexes (i.e.
1113 those indexes which are turned into multiple or-connected searches based
1118 sub _handle_exploding_index {
1119 my ($QParser, $filter, $params, $negate, $server) = @_;
1120 my $index = $filter;
1121 my $term = join(' ', @$params);
1123 return unless ($index =~ m/(su-br|su-na|su-rl)/ && $term);
1125 my $marcflavour = C4::Context->preference('marcflavour');
1127 my $codesubfield = $marcflavour eq 'UNIMARC' ? '5' : 'w';
1128 my $wantedcodes = '';
1129 my @subqueries = ( "\@attr 1=Subject \@attr 4=1 \"$term\"");
1130 my ($error, $results, $total_hits) = SimpleSearch( "he:$term", undef, undef, [ "authorityserver" ] );
1131 foreach my $auth (@$results) {
1132 my $record = MARC::Record->new_from_usmarc($auth);
1133 my @references = $record->field('5..');
1135 if ($index eq 'su-br') {
1137 } elsif ($index eq 'su-na') {
1139 } elsif ($index eq 'su-rl') {
1142 foreach my $reference (@references) {
1143 my $codes = $reference->subfield($codesubfield);
1144 push @subqueries, '@attr 1=Subject @attr 4=1 "' . $reference->as_string('abcdefghijlmnopqrstuvxyz') . '"' if (($codes && $codes eq $wantedcodes) || !$wantedcodes);
1148 my $query = ' @or ' x (scalar(@subqueries) - 1) . join(' ', @subqueries);
1154 ( $operators, $operands, $indexes, $limits,
1155 $sort_by, $scan, $lang ) =
1156 buildQuery ( $operators, $operands, $indexes, $limits, $sort_by, $scan, $lang);
1158 Shim function to ease the transition from buildQuery to a new QueryParser.
1159 This function is called at the beginning of buildQuery, and modifies
1160 buildQuery's input. If it can handle the input, it returns a query that
1161 buildQuery will not try to parse.
1165 my ( $operators, $operands, $indexes, $limits, $sort_by, $scan, $lang) = @_;
1167 my @operators = $operators ? @$operators : ();
1168 my @indexes = $indexes ? @$indexes : ();
1169 my @operands = $operands ? @$operands : ();
1170 my @limits = $limits ? @$limits : ();
1171 my @sort_by = $sort_by ? @$sort_by : ();
1173 my $query = $operands[0];
1179 $QParser = C4::Context->queryparser if (C4::Context->preference('UseQueryParser') || $query =~ s/^qp=//);
1180 undef $QParser if ($query =~ m/^(ccl=|pqf=|cql=)/ || grep (/\w,\w|\w=\w/, @operands, @indexes) );
1181 undef $QParser if (scalar @limits > 0);
1185 $QParser->custom_data->{'QueryAutoTruncate'} = C4::Context->preference('QueryAutoTruncate');
1187 for ( my $ii = 0 ; $ii <= @operands ; $ii++ ) {
1188 next unless $operands[$ii];
1189 $query .= $operators[ $ii - 1 ] eq 'or' ? ' || ' : ' && '
1191 if ( $indexes[$ii] =~ m/su-/ ) {
1192 $query .= $indexes[$ii] . '(' . $operands[$ii] . ')';
1196 ( $indexes[$ii] ? "$indexes[$ii]:" : '' ) . $operands[$ii];
1199 foreach my $limit (@limits) {
1201 if ( scalar(@sort_by) > 0 ) {
1203 '#(' . join( '|', @{ $QParser->modifiers } ) . ')';
1204 $query =~ s/$modifier_re//g;
1205 foreach my $modifier (@sort_by) {
1206 $query .= " #$modifier";
1210 $query_desc = $query;
1211 $query_desc =~ s/\s+/ /g;
1212 if ( C4::Context->preference("QueryWeightFields") ) {
1214 $QParser->add_bib1_filter_map( 'su-br' => 'biblioserver' =>
1215 { 'target_syntax_callback' => \&_handle_exploding_index } );
1216 $QParser->add_bib1_filter_map( 'su-na' => 'biblioserver' =>
1217 { 'target_syntax_callback' => \&_handle_exploding_index } );
1218 $QParser->add_bib1_filter_map( 'su-rl' => 'biblioserver' =>
1219 { 'target_syntax_callback' => \&_handle_exploding_index } );
1220 $QParser->parse($query);
1221 $operands[0] = "pqf=" . $QParser->target_syntax('biblioserver');
1224 require Koha::QueryParser::Driver::PQF;
1225 my $modifier_re = '#(' . join( '|', @{Koha::QueryParser::Driver::PQF->modifiers}) . ')';
1226 s/$modifier_re//g for @operands;
1229 return ( $operators, \@operands, $indexes, $limits, $sort_by, $scan, $lang, $query_desc);
1235 $simple_query, $query_cgi,
1236 $query_desc, $limit,
1237 $limit_cgi, $limit_desc,
1238 $stopwords_removed, $query_type ) = buildQuery ( $operators, $operands, $indexes, $limits, $sort_by, $scan, $lang);
1240 Build queries and limits in CCL, CGI, Human,
1241 handle truncation, stemming, field weighting, stopwords, fuzziness, etc.
1243 See verbose embedded documentation.
1249 my ( $operators, $operands, $indexes, $limits, $sort_by, $scan, $lang) = @_;
1251 warn "---------\nEnter buildQuery\n---------" if $DEBUG;
1254 ( $operators, $operands, $indexes, $limits, $sort_by, $scan, $lang, $query_desc) = parseQuery($operators, $operands, $indexes, $limits, $sort_by, $scan, $lang);
1257 my @operators = $operators ? @$operators : ();
1258 my @indexes = $indexes ? @$indexes : ();
1259 my @operands = $operands ? @$operands : ();
1260 my @limits = $limits ? @$limits : ();
1261 my @sort_by = $sort_by ? @$sort_by : ();
1263 my $stemming = C4::Context->preference("QueryStemming") || 0;
1264 my $auto_truncation = C4::Context->preference("QueryAutoTruncate") || 0;
1265 my $weight_fields = C4::Context->preference("QueryWeightFields") || 0;
1266 my $fuzzy_enabled = C4::Context->preference("QueryFuzzy") || 0;
1267 my $remove_stopwords = C4::Context->preference("QueryRemoveStopwords") || 0;
1269 my $query = $operands[0];
1270 my $simple_query = $operands[0];
1272 # initialize the variables we're passing back
1280 my $stopwords_removed; # flag to determine if stopwords have been removed
1283 my $cclindexes = getIndexes();
1284 if ( $query !~ /\s*ccl=/ ) {
1285 while ( !$cclq && $query =~ /(?:^|\W)([\w-]+)(,[\w-]+)*[:=]/g ) {
1287 $cclq = grep { lc($_) eq $dx } @$cclindexes;
1289 $query = "ccl=$query" if $cclq;
1292 # for handling ccl, cql, pqf queries in diagnostic mode, skip the rest of the steps
1294 if ( $query =~ /^ccl=/ ) {
1296 # This is needed otherwise ccl= and &limit won't work together, and
1297 # this happens when selecting a subject on the opac-detail page
1298 @limits = grep {!/^$/} @limits;
1300 $q .= ' and '.join(' and ', @limits);
1302 return ( undef, $q, $q, "q=ccl=".uri_escape($q), $q, '', '', '', '', 'ccl' );
1304 if ( $query =~ /^cql=/ ) {
1305 return ( undef, $', $', "q=cql=".uri_escape($'), $', '', '', '', '', 'cql' );
1307 if ( $query =~ /^pqf=/ ) {
1309 $query_cgi = "q=".uri_escape($query_desc);
1312 $query_cgi = "q=pqf=".uri_escape($');
1314 return ( undef, $', $', $query_cgi, $query_desc, '', '', '', '', 'pqf' );
1317 # pass nested queries directly
1318 # FIXME: need better handling of some of these variables in this case
1319 # Nested queries aren't handled well and this implementation is flawed and causes users to be
1320 # unable to search for anything containing () commenting out, will be rewritten for 3.4.0
1321 # if ( $query =~ /(\(|\))/ ) {
1323 # undef, $query, $simple_query, $query_cgi,
1324 # $query, $limit, $limit_cgi, $limit_desc,
1325 # $stopwords_removed, 'ccl'
1329 # Form-based queries are non-nested and fixed depth, so we can easily modify the incoming
1330 # query operands and indexes and add stemming, truncation, field weighting, etc.
1331 # Once we do so, we'll end up with a value in $query, just like if we had an
1332 # incoming $query from the user
1335 ; # clear it out so we can populate properly with field-weighted, stemmed, etc. query
1336 my $previous_operand
1337 ; # a flag used to keep track if there was a previous query
1338 # if there was, we can apply the current operator
1340 for ( my $i = 0 ; $i <= @operands ; $i++ ) {
1342 # COMBINE OPERANDS, INDEXES AND OPERATORS
1343 if ( $operands[$i] ) {
1344 $operands[$i]=~s/^\s+//;
1346 # A flag to determine whether or not to add the index to the query
1349 # If the user is sophisticated enough to specify an index, turn off field weighting, stemming, and stopword handling
1350 if ( $operands[$i] =~ /\w(:|=)/ || $scan ) {
1353 $remove_stopwords = 0;
1355 $operands[$i] =~ s/\?/{?}/g; # need to escape question marks
1357 my $operand = $operands[$i];
1358 my $index = $indexes[$i];
1360 # Add index-specific attributes
1361 # Date of Publication
1362 if ( $index eq 'yr' ) {
1363 $index .= ",st-numeric";
1365 $stemming = $auto_truncation = $weight_fields = $fuzzy_enabled = $remove_stopwords = 0;
1368 # Date of Acquisition
1369 elsif ( $index eq 'acqdate' ) {
1370 $index .= ",st-date-normalized";
1372 $stemming = $auto_truncation = $weight_fields = $fuzzy_enabled = $remove_stopwords = 0;
1374 # ISBN,ISSN,Standard Number, don't need special treatment
1375 elsif ( $index eq 'nb' || $index eq 'ns' ) {
1377 $stemming, $auto_truncation,
1378 $weight_fields, $fuzzy_enabled,
1380 ) = ( 0, 0, 0, 0, 0 );
1388 # Set default structure attribute (word list)
1389 my $struct_attr = q{};
1390 unless ( $indexes_set || !$index || $index =~ /(st-|phr|ext|wrdl|nb|ns)/ ) {
1391 $struct_attr = ",wrdl";
1394 # Some helpful index variants
1395 my $index_plus = $index . $struct_attr . ':';
1396 my $index_plus_comma = $index . $struct_attr . ',';
1399 if ($remove_stopwords) {
1400 ( $operand, $stopwords_removed ) =
1401 _remove_stopwords( $operand, $index );
1402 warn "OPERAND w/out STOPWORDS: >$operand<" if $DEBUG;
1403 warn "REMOVED STOPWORDS: @$stopwords_removed"
1404 if ( $stopwords_removed && $DEBUG );
1407 if ($auto_truncation){
1408 unless ( $index =~ /(st-|phr|ext)/ ) {
1409 #FIXME only valid with LTR scripts
1410 $operand=join(" ",map{
1411 (index($_,"*")>0?"$_":"$_*")
1412 }split (/\s+/,$operand));
1413 warn $operand if $DEBUG;
1418 my $truncated_operand;
1419 my( $nontruncated, $righttruncated, $lefttruncated,
1420 $rightlefttruncated, $regexpr
1421 ) = _detect_truncation( $operand, $index );
1423 "TRUNCATION: NON:>@$nontruncated< RIGHT:>@$righttruncated< LEFT:>@$lefttruncated< RIGHTLEFT:>@$rightlefttruncated< REGEX:>@$regexpr<"
1428 scalar(@$righttruncated) + scalar(@$lefttruncated) +
1429 scalar(@$rightlefttruncated) > 0 )
1432 # Don't field weight or add the index to the query, we do it here
1434 undef $weight_fields;
1435 my $previous_truncation_operand;
1436 if (scalar @$nontruncated) {
1437 $truncated_operand .= "$index_plus @$nontruncated ";
1438 $previous_truncation_operand = 1;
1440 if (scalar @$righttruncated) {
1441 $truncated_operand .= "and " if $previous_truncation_operand;
1442 $truncated_operand .= $index_plus_comma . "rtrn:@$righttruncated ";
1443 $previous_truncation_operand = 1;
1445 if (scalar @$lefttruncated) {
1446 $truncated_operand .= "and " if $previous_truncation_operand;
1447 $truncated_operand .= $index_plus_comma . "ltrn:@$lefttruncated ";
1448 $previous_truncation_operand = 1;
1450 if (scalar @$rightlefttruncated) {
1451 $truncated_operand .= "and " if $previous_truncation_operand;
1452 $truncated_operand .= $index_plus_comma . "rltrn:@$rightlefttruncated ";
1453 $previous_truncation_operand = 1;
1456 $operand = $truncated_operand if $truncated_operand;
1457 warn "TRUNCATED OPERAND: >$truncated_operand<" if $DEBUG;
1460 my $stemmed_operand;
1461 $stemmed_operand = _build_stemmed_operand($operand, $lang)
1464 warn "STEMMED OPERAND: >$stemmed_operand<" if $DEBUG;
1466 # Handle Field Weighting
1467 my $weighted_operand;
1468 if ($weight_fields) {
1469 $weighted_operand = _build_weighted_query( $operand, $stemmed_operand, $index );
1470 $operand = $weighted_operand;
1474 warn "FIELD WEIGHTED OPERAND: >$weighted_operand<" if $DEBUG;
1476 # If there's a previous operand, we need to add an operator
1477 if ($previous_operand) {
1479 # User-specified operator
1480 if ( $operators[ $i - 1 ] ) {
1481 $query .= " $operators[$i-1] ";
1482 $query .= " $index_plus " unless $indexes_set;
1483 $query .= " $operand";
1484 $query_cgi .= "&op=".uri_escape($operators[$i-1]);
1485 $query_cgi .= "&idx=".uri_escape($index) if $index;
1486 $query_cgi .= "&q=".uri_escape($operands[$i]) if $operands[$i];
1488 " $operators[$i-1] $index_plus $operands[$i]";
1491 # Default operator is and
1494 $query .= "$index_plus " unless $indexes_set;
1495 $query .= "$operand";
1496 $query_cgi .= "&op=and&idx=".uri_escape($index) if $index;
1497 $query_cgi .= "&q=".uri_escape($operands[$i]) if $operands[$i];
1498 $query_desc .= " and $index_plus $operands[$i]";
1502 # There isn't a pervious operand, don't need an operator
1505 # Field-weighted queries already have indexes set
1506 $query .= " $index_plus " unless $indexes_set;
1508 $query_desc .= " $index_plus $operands[$i]";
1509 $query_cgi .= "&idx=".uri_escape($index) if $index;
1510 $query_cgi .= "&q=".uri_escape($operands[$i]) if $operands[$i];
1511 $previous_operand = 1;
1516 warn "QUERY BEFORE LIMITS: >$query<" if $DEBUG;
1519 my %group_OR_limits;
1520 my $availability_limit;
1521 foreach my $this_limit (@limits) {
1522 next unless $this_limit;
1523 if ( $this_limit =~ /available/ ) {
1525 ## 'available' is defined as (items.onloan is NULL) and (items.itemlost = 0)
1527 ## all records not indexed in the onloan register (zebra) and all records with a value of lost equal to 0
1528 $availability_limit .=
1529 "( ( allrecords,AlwaysMatches='' not onloan,AlwaysMatches='') and (lost,st-numeric=0) )"; #or ( allrecords,AlwaysMatches='' not lost,AlwaysMatches='')) )";
1530 $limit_cgi .= "&limit=available";
1534 # group_OR_limits, prefixed by mc-
1535 # OR every member of the group
1536 elsif ( $this_limit =~ /mc/ ) {
1537 my ($k,$v) = split(/:/, $this_limit,2);
1538 if ( $k !~ /mc-i(tem)?type/ ) {
1539 # in case the mc-ccode value has complicating chars like ()'s inside it we wrap in quotes
1540 $this_limit =~ tr/"//d;
1541 $this_limit = $k.":\"".$v."\"";
1544 $group_OR_limits{$k} .= " or " if $group_OR_limits{$k};
1545 $limit_desc .= " or " if $group_OR_limits{$k};
1546 $group_OR_limits{$k} .= "$this_limit";
1547 $limit_cgi .= "&limit=$this_limit";
1548 $limit_desc .= " $this_limit";
1551 # Regular old limits
1553 $limit .= " and " if $limit || $query;
1554 $limit .= "$this_limit";
1555 $limit_cgi .= "&limit=$this_limit";
1556 if ($this_limit =~ /^branch:(.+)/) {
1557 my $branchcode = $1;
1558 my $branchname = GetBranchName($branchcode);
1559 if (defined $branchname) {
1560 $limit_desc .= " branch:$branchname";
1562 $limit_desc .= " $this_limit";
1565 $limit_desc .= " $this_limit";
1569 foreach my $k (keys (%group_OR_limits)) {
1570 $limit .= " and " if ( $query || $limit );
1571 $limit .= "($group_OR_limits{$k})";
1573 if ($availability_limit) {
1574 $limit .= " and " if ( $query || $limit );
1575 $limit .= "($availability_limit)";
1578 # Normalize the query and limit strings
1579 # This is flawed , means we can't search anything with : in it
1580 # if user wants to do ccl or cql, start the query with that
1581 # $query =~ s/:/=/g;
1582 $query =~ s/(?<=(ti|au|pb|su|an|kw|mc|nb|ns)):/=/g;
1583 $query =~ s/(?<=(wrdl)):/=/g;
1584 $query =~ s/(?<=(trn|phr)):/=/g;
1586 for ( $query, $query_desc, $limit, $limit_desc ) {
1587 s/ +/ /g; # remove extra spaces
1588 s/^ //g; # remove any beginning spaces
1589 s/ $//g; # remove any ending spaces
1590 s/==/=/g; # remove double == from query
1592 $query_cgi =~ s/^&//; # remove unnecessary & from beginning of the query cgi
1594 for ($query_cgi,$simple_query) {
1597 # append the limit to the query
1598 $query .= " " . $limit;
1602 warn "QUERY:" . $query;
1603 warn "QUERY CGI:" . $query_cgi;
1604 warn "QUERY DESC:" . $query_desc;
1605 warn "LIMIT:" . $limit;
1606 warn "LIMIT CGI:" . $limit_cgi;
1607 warn "LIMIT DESC:" . $limit_desc;
1608 warn "---------\nLeave buildQuery\n---------";
1611 undef, $query, $simple_query, $query_cgi,
1612 $query_desc, $limit, $limit_cgi, $limit_desc,
1613 $stopwords_removed, $query_type
1617 =head2 searchResults
1619 my @search_results = searchResults($search_context, $searchdesc, $hits,
1620 $results_per_page, $offset, $scan,
1623 Format results in a form suitable for passing to the template
1627 # IMO this subroutine is pretty messy still -- it's responsible for
1628 # building the HTML output for the template
1630 my ( $search_context, $searchdesc, $hits, $results_per_page, $offset, $scan, $marcresults ) = @_;
1631 my $dbh = C4::Context->dbh;
1636 $search_context = 'opac' if !$search_context || $search_context ne 'intranet';
1637 my ($is_opac, $hidelostitems);
1638 if ($search_context eq 'opac') {
1639 $hidelostitems = C4::Context->preference('hidelostitems');
1643 #Build branchnames hash
1645 #get branch information.....
1647 my $bsth =$dbh->prepare("SELECT branchcode,branchname FROM branches"); # FIXME : use C4::Branch::GetBranches
1649 while ( my $bdata = $bsth->fetchrow_hashref ) {
1650 $branches{ $bdata->{'branchcode'} } = $bdata->{'branchname'};
1652 # FIXME - We build an authorised values hash here, using the default framework
1653 # though it is possible to have different authvals for different fws.
1655 my $shelflocations =GetKohaAuthorisedValues('items.location','');
1657 # get notforloan authorised value list (see $shelflocations FIXME)
1658 my $notforloan_authorised_value = GetAuthValCode('items.notforloan','');
1660 #Build itemtype hash
1661 #find itemtype & itemtype image
1665 "SELECT itemtype,description,imageurl,summary,notforloan FROM itemtypes"
1668 while ( my $bdata = $bsth->fetchrow_hashref ) {
1669 foreach (qw(description imageurl summary notforloan)) {
1670 $itemtypes{ $bdata->{'itemtype'} }->{$_} = $bdata->{$_};
1674 #search item field code
1675 my ($itemtag, undef) = &GetMarcFromKohaField( "items.itemnumber", "" );
1677 ## find column names of items related to MARC
1678 my $sth2 = $dbh->prepare("SHOW COLUMNS FROM items");
1680 my %subfieldstosearch;
1681 while ( ( my $column ) = $sth2->fetchrow ) {
1682 my ( $tagfield, $tagsubfield ) =
1683 &GetMarcFromKohaField( "items." . $column, "" );
1684 $subfieldstosearch{$column} = $tagsubfield;
1687 # handle which records to actually retrieve
1689 if ( $hits && $offset + $results_per_page <= $hits ) {
1690 $times = $offset + $results_per_page;
1693 $times = $hits; # FIXME: if $hits is undefined, why do we want to equal it?
1696 my $marcflavour = C4::Context->preference("marcflavour");
1697 # We get the biblionumber position in MARC
1698 my ($bibliotag,$bibliosubf)=GetMarcFromKohaField('biblio.biblionumber','');
1700 # loop through all of the records we've retrieved
1701 for ( my $i = $offset ; $i <= $times - 1 ; $i++ ) {
1702 my $marcrecord = MARC::File::USMARC::decode( $marcresults->[$i] );
1706 ? GetFrameworkCode($marcrecord->field($bibliotag)->data)
1707 : GetFrameworkCode($marcrecord->subfield($bibliotag,$bibliosubf));
1708 my $oldbiblio = TransformMarcToKoha( $dbh, $marcrecord, $fw );
1709 $oldbiblio->{subtitle} = GetRecordValue('subtitle', $marcrecord, $fw);
1710 $oldbiblio->{result_number} = $i + 1;
1712 # add imageurl to itemtype if there is one
1713 $oldbiblio->{imageurl} = getitemtypeimagelocation( $search_context, $itemtypes{ $oldbiblio->{itemtype} }->{imageurl} );
1715 $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 ) ) : [];
1716 $oldbiblio->{normalized_upc} = GetNormalizedUPC( $marcrecord,$marcflavour);
1717 $oldbiblio->{normalized_ean} = GetNormalizedEAN( $marcrecord,$marcflavour);
1718 $oldbiblio->{normalized_oclc} = GetNormalizedOCLCNumber($marcrecord,$marcflavour);
1719 $oldbiblio->{normalized_isbn} = GetNormalizedISBN(undef,$marcrecord,$marcflavour);
1720 $oldbiblio->{content_identifier_exists} = 1 if ($oldbiblio->{normalized_isbn} or $oldbiblio->{normalized_oclc} or $oldbiblio->{normalized_ean} or $oldbiblio->{normalized_upc});
1722 # edition information, if any
1723 $oldbiblio->{edition} = $oldbiblio->{editionstatement};
1724 $oldbiblio->{description} = $itemtypes{ $oldbiblio->{itemtype} }->{description};
1725 # Build summary if there is one (the summary is defined in the itemtypes table)
1726 # FIXME: is this used anywhere, I think it can be commented out? -- JF
1727 if ( $itemtypes{ $oldbiblio->{itemtype} }->{summary} ) {
1728 my $summary = $itemtypes{ $oldbiblio->{itemtype} }->{summary};
1729 my @fields = $marcrecord->fields();
1732 foreach my $line ( "$summary\n" =~ /(.*)\n/g ){
1734 foreach my $tag ( $line =~ /\[(\d{3}[\w|\d])\]/ ) {
1735 $tag =~ /(.{3})(.)/;
1736 if($marcrecord->field($1)){
1737 my @abc = $marcrecord->field($1)->subfield($2);
1738 $tags->{$tag} = $#abc + 1 ;
1742 # We catch how many times to repeat this line
1744 foreach my $tag (keys(%$tags)){
1745 $max = $tags->{$tag} if($tags->{$tag} > $max);
1748 # we replace, and repeat each line
1749 for (my $i = 0 ; $i < $max ; $i++){
1750 my $newline = $line;
1752 foreach my $tag ( $newline =~ /\[(\d{3}[\w|\d])\]/g ) {
1753 $tag =~ /(.{3})(.)/;
1755 if($marcrecord->field($1)){
1756 my @repl = $marcrecord->field($1)->subfield($2);
1757 my $subfieldvalue = $repl[$i];
1759 if (! utf8::is_utf8($subfieldvalue)) {
1760 utf8::decode($subfieldvalue);
1763 $newline =~ s/\[$tag\]/$subfieldvalue/g;
1766 $newsummary .= "$newline\n";
1770 $newsummary =~ s/\[(.*?)]//g;
1771 $newsummary =~ s/\n/<br\/>/g;
1772 $oldbiblio->{summary} = $newsummary;
1775 # Pull out the items fields
1776 my @fields = $marcrecord->field($itemtag);
1777 my $marcflavor = C4::Context->preference("marcflavour");
1778 # adding linked items that belong to host records
1779 my $analyticsfield = '773';
1780 if ($marcflavor eq 'MARC21' || $marcflavor eq 'NORMARC') {
1781 $analyticsfield = '773';
1782 } elsif ($marcflavor eq 'UNIMARC') {
1783 $analyticsfield = '461';
1785 foreach my $hostfield ( $marcrecord->field($analyticsfield)) {
1786 my $hostbiblionumber = $hostfield->subfield("0");
1787 my $linkeditemnumber = $hostfield->subfield("9");
1788 if(!$hostbiblionumber eq undef){
1789 my $hostbiblio = GetMarcBiblio($hostbiblionumber, 1);
1790 my ($itemfield, undef) = GetMarcFromKohaField( 'items.itemnumber', GetFrameworkCode($hostbiblionumber) );
1791 if(!$hostbiblio eq undef){
1792 my @hostitems = $hostbiblio->field($itemfield);
1793 foreach my $hostitem (@hostitems){
1794 if ($hostitem->subfield("9") eq $linkeditemnumber){
1795 my $linkeditem =$hostitem;
1796 # append linked items if they exist
1797 if (!$linkeditem eq undef){
1798 push (@fields, $linkeditem);}
1805 # Setting item statuses for display
1806 my @available_items_loop;
1807 my @onloan_items_loop;
1808 my @other_items_loop;
1810 my $available_items;
1814 my $ordered_count = 0;
1815 my $available_count = 0;
1816 my $onloan_count = 0;
1817 my $longoverdue_count = 0;
1818 my $other_count = 0;
1819 my $withdrawn_count = 0;
1820 my $itemlost_count = 0;
1821 my $hideatopac_count = 0;
1822 my $itembinding_count = 0;
1823 my $itemdamaged_count = 0;
1824 my $item_in_transit_count = 0;
1825 my $can_place_holds = 0;
1826 my $item_onhold_count = 0;
1827 my $items_count = scalar(@fields);
1828 my $maxitems_pref = C4::Context->preference('maxItemsinSearchResults');
1829 my $maxitems = $maxitems_pref ? $maxitems_pref - 1 : 1;
1830 my @hiddenitems; # hidden itemnumbers based on OpacHiddenItems syspref
1832 # loop through every item
1833 foreach my $field (@fields) {
1836 # populate the items hash
1837 foreach my $code ( keys %subfieldstosearch ) {
1838 $item->{$code} = $field->subfield( $subfieldstosearch{$code} );
1840 $item->{description} = $itemtypes{ $item->{itype} }{description};
1844 # hidden because lost
1845 if ($hidelostitems && $item->{itemlost}) {
1846 $hideatopac_count++;
1849 # hidden based on OpacHiddenItems syspref
1850 my @hi = C4::Items::GetHiddenItemnumbers($item);
1852 push @hiddenitems, @hi;
1853 $hideatopac_count++;
1858 my $hbranch = C4::Context->preference('HomeOrHoldingBranch') eq 'homebranch' ? 'homebranch' : 'holdingbranch';
1859 my $otherbranch = C4::Context->preference('HomeOrHoldingBranch') eq 'homebranch' ? 'holdingbranch' : 'homebranch';
1861 # set item's branch name, use HomeOrHoldingBranch syspref first, fall back to the other one
1862 if ($item->{$hbranch}) {
1863 $item->{'branchname'} = $branches{$item->{$hbranch}};
1865 elsif ($item->{$otherbranch}) { # Last resort
1866 $item->{'branchname'} = $branches{$item->{$otherbranch}};
1869 my $prefix = $item->{$hbranch} . '--' . $item->{location} . $item->{itype} . $item->{itemcallnumber};
1870 # For each grouping of items (onloan, available, unavailable), we build a key to store relevant info about that item
1871 my $userenv = C4::Context->userenv;
1872 if ( $item->{onloan} && !(C4::Members::GetHideLostItemsPreference($userenv->{'number'}) && $item->{itemlost}) ) {
1874 my $key = $prefix . $item->{onloan} . $item->{barcode};
1875 $onloan_items->{$key}->{due_date} = format_date($item->{onloan});
1876 $onloan_items->{$key}->{count}++ if $item->{$hbranch};
1877 $onloan_items->{$key}->{branchname} = $item->{branchname};
1878 $onloan_items->{$key}->{location} = $shelflocations->{ $item->{location} };
1879 $onloan_items->{$key}->{itemcallnumber} = $item->{itemcallnumber};
1880 $onloan_items->{$key}->{description} = $item->{description};
1881 $onloan_items->{$key}->{imageurl} = getitemtypeimagelocation( $search_context, $itemtypes{ $item->{itype} }->{imageurl} );
1882 # if something's checked out and lost, mark it as 'long overdue'
1883 if ( $item->{itemlost} ) {
1884 $onloan_items->{$prefix}->{longoverdue}++;
1885 $longoverdue_count++;
1886 } else { # can place holds as long as item isn't lost
1887 $can_place_holds = 1;
1891 # items not on loan, but still unavailable ( lost, withdrawn, damaged )
1895 if ( $item->{notforloan} < 0 ) {
1899 # is item in transit?
1900 my $transfertwhen = '';
1901 my ($transfertfrom, $transfertto);
1903 # is item on the reserve shelf?
1904 my $reservestatus = '';
1906 unless ($item->{withdrawn}
1907 || $item->{itemlost}
1909 || $item->{notforloan}
1910 || $items_count > 20) {
1912 # A couple heuristics to limit how many times
1913 # we query the database for item transfer information, sacrificing
1914 # accuracy in some cases for speed;
1916 # 1. don't query if item has one of the other statuses
1917 # 2. don't check transit status if the bib has
1918 # more than 20 items
1920 # FIXME: to avoid having the query the database like this, and to make
1921 # the in transit status count as unavailable for search limiting,
1922 # should map transit status to record indexed in Zebra.
1924 ($transfertwhen, $transfertfrom, $transfertto) = C4::Circulation::GetTransfers($item->{itemnumber});
1925 $reservestatus = C4::Reserves::GetReserveStatus( $item->{itemnumber}, $oldbiblio->{biblionumber} );
1928 # item is withdrawn, lost, damaged, not for loan, reserved or in transit
1929 if ( $item->{withdrawn}
1930 || $item->{itemlost}
1932 || $item->{notforloan}
1933 || $reservestatus eq 'Waiting'
1934 || ($transfertwhen ne ''))
1936 $withdrawn_count++ if $item->{withdrawn};
1937 $itemlost_count++ if $item->{itemlost};
1938 $itemdamaged_count++ if $item->{damaged};
1939 $item_in_transit_count++ if $transfertwhen ne '';
1940 $item_onhold_count++ if $reservestatus eq 'Waiting';
1941 $item->{status} = $item->{withdrawn} . "-" . $item->{itemlost} . "-" . $item->{damaged} . "-" . $item->{notforloan};
1943 # can place a hold on a item if
1944 # not lost nor withdrawn
1945 # not damaged unless AllowHoldsOnDamagedItems is true
1946 # item is either for loan or on order (notforloan < 0)
1947 $can_place_holds = 1
1950 && !$item->{withdrawn}
1951 && ( !$item->{damaged} || C4::Context->preference('AllowHoldsOnDamagedItems') )
1952 && ( !$item->{notforloan} || $item->{notforloan} < 0 )
1957 my $key = $prefix . $item->{status};
1958 foreach (qw(withdrawn itemlost damaged branchname itemcallnumber)) {
1959 $other_items->{$key}->{$_} = $item->{$_};
1961 $other_items->{$key}->{intransit} = ( $transfertwhen ne '' ) ? 1 : 0;
1962 $other_items->{$key}->{onhold} = ($reservestatus) ? 1 : 0;
1963 $other_items->{$key}->{notforloan} = GetAuthorisedValueDesc('','',$item->{notforloan},'','',$notforloan_authorised_value) if $notforloan_authorised_value and $item->{notforloan};
1964 $other_items->{$key}->{count}++ if $item->{$hbranch};
1965 $other_items->{$key}->{location} = $shelflocations->{ $item->{location} };
1966 $other_items->{$key}->{description} = $item->{description};
1967 $other_items->{$key}->{imageurl} = getitemtypeimagelocation( $search_context, $itemtypes{ $item->{itype} }->{imageurl} );
1971 $can_place_holds = 1;
1973 $available_items->{$prefix}->{count}++ if $item->{$hbranch};
1974 foreach (qw(branchname itemcallnumber description)) {
1975 $available_items->{$prefix}->{$_} = $item->{$_};
1977 $available_items->{$prefix}->{location} = $shelflocations->{ $item->{location} };
1978 $available_items->{$prefix}->{imageurl} = getitemtypeimagelocation( $search_context, $itemtypes{ $item->{itype} }->{imageurl} );
1981 } # notforloan, item level and biblioitem level
1983 # if all items are hidden, do not show the record
1984 if ($items_count > 0 && $hideatopac_count == $items_count) {
1988 my ( $availableitemscount, $onloanitemscount, $otheritemscount );
1989 for my $key ( sort keys %$onloan_items ) {
1990 (++$onloanitemscount > $maxitems) and last;
1991 push @onloan_items_loop, $onloan_items->{$key};
1993 for my $key ( sort keys %$other_items ) {
1994 (++$otheritemscount > $maxitems) and last;
1995 push @other_items_loop, $other_items->{$key};
1997 for my $key ( sort keys %$available_items ) {
1998 (++$availableitemscount > $maxitems) and last;
1999 push @available_items_loop, $available_items->{$key}
2002 # XSLT processing of some stuff
2004 SetUTF8Flag($marcrecord);
2005 warn $marcrecord->as_formatted if $DEBUG;
2006 my $interface = $search_context eq 'opac' ? 'OPAC' : '';
2007 if (!$scan && C4::Context->preference($interface . "XSLTResultsDisplay")) {
2008 $oldbiblio->{XSLTResultsRecord} = XSLTParse4Display($oldbiblio->{biblionumber}, $marcrecord, $interface."XSLTResultsDisplay", 1, \@hiddenitems);
2009 # the last parameter tells Koha to clean up the problematic ampersand entities that Zebra outputs
2012 # if biblio level itypes are used and itemtype is notforloan, it can't be reserved either
2013 if (!C4::Context->preference("item-level_itypes")) {
2014 if ($itemtypes{ $oldbiblio->{itemtype} }->{notforloan}) {
2015 $can_place_holds = 0;
2018 $oldbiblio->{norequests} = 1 unless $can_place_holds;
2019 $oldbiblio->{itemsplural} = 1 if $items_count > 1;
2020 $oldbiblio->{items_count} = $items_count;
2021 $oldbiblio->{available_items_loop} = \@available_items_loop;
2022 $oldbiblio->{onloan_items_loop} = \@onloan_items_loop;
2023 $oldbiblio->{other_items_loop} = \@other_items_loop;
2024 $oldbiblio->{availablecount} = $available_count;
2025 $oldbiblio->{availableplural} = 1 if $available_count > 1;
2026 $oldbiblio->{onloancount} = $onloan_count;
2027 $oldbiblio->{onloanplural} = 1 if $onloan_count > 1;
2028 $oldbiblio->{othercount} = $other_count;
2029 $oldbiblio->{otherplural} = 1 if $other_count > 1;
2030 $oldbiblio->{withdrawncount} = $withdrawn_count;
2031 $oldbiblio->{itemlostcount} = $itemlost_count;
2032 $oldbiblio->{damagedcount} = $itemdamaged_count;
2033 $oldbiblio->{intransitcount} = $item_in_transit_count;
2034 $oldbiblio->{onholdcount} = $item_onhold_count;
2035 $oldbiblio->{orderedcount} = $ordered_count;
2037 if (C4::Context->preference("AlternateHoldingsField") && $items_count == 0) {
2038 my $fieldspec = C4::Context->preference("AlternateHoldingsField");
2039 my $subfields = substr $fieldspec, 3;
2040 my $holdingsep = C4::Context->preference("AlternateHoldingsSeparator") || ' ';
2041 my @alternateholdingsinfo = ();
2042 my @holdingsfields = $marcrecord->field(substr $fieldspec, 0, 3);
2043 my $alternateholdingscount = 0;
2045 for my $field (@holdingsfields) {
2046 my %holding = ( holding => '' );
2047 my $havesubfield = 0;
2048 for my $subfield ($field->subfields()) {
2049 if ((index $subfields, $$subfield[0]) >= 0) {
2050 $holding{'holding'} .= $holdingsep if (length $holding{'holding'} > 0);
2051 $holding{'holding'} .= $$subfield[1];
2055 if ($havesubfield) {
2056 push(@alternateholdingsinfo, \%holding);
2057 $alternateholdingscount++;
2061 $oldbiblio->{'ALTERNATEHOLDINGS'} = \@alternateholdingsinfo;
2062 $oldbiblio->{'alternateholdings_count'} = $alternateholdingscount;
2065 push( @newresults, $oldbiblio );
2071 =head2 SearchAcquisitions
2072 Search for acquisitions
2075 sub SearchAcquisitions{
2076 my ($datebegin, $dateend, $itemtypes,$criteria, $orderby) = @_;
2078 my $dbh=C4::Context->dbh;
2079 # Variable initialization
2083 LEFT JOIN biblioitems ON biblioitems.biblionumber=biblio.biblionumber
2084 LEFT JOIN items ON items.biblionumber=biblio.biblionumber
2085 WHERE dateaccessioned BETWEEN ? AND ?
2088 my (@params,@loopcriteria);
2090 push @params, $datebegin->output("iso");
2091 push @params, $dateend->output("iso");
2093 if (scalar(@$itemtypes)>0 and $criteria ne "itemtype" ){
2094 if(C4::Context->preference("item-level_itypes")){
2095 $str .= "AND items.itype IN (?".( ',?' x scalar @$itemtypes - 1 ).") ";
2097 $str .= "AND biblioitems.itemtype IN (?".( ',?' x scalar @$itemtypes - 1 ).") ";
2099 push @params, @$itemtypes;
2102 if ($criteria =~/itemtype/){
2103 if(C4::Context->preference("item-level_itypes")){
2104 $str .= "AND items.itype=? ";
2106 $str .= "AND biblioitems.itemtype=? ";
2109 if(scalar(@$itemtypes) == 0){
2110 my $itypes = GetItemTypes();
2111 for my $key (keys %$itypes){
2112 push @$itemtypes, $key;
2116 @loopcriteria= @$itemtypes;
2117 }elsif ($criteria=~/itemcallnumber/){
2118 $str .= "AND (items.itemcallnumber LIKE CONCAT(?,'%')
2119 OR items.itemcallnumber is NULL
2120 OR items.itemcallnumber = '')";
2122 @loopcriteria = ("AA".."ZZ", "") unless (scalar(@loopcriteria)>0);
2124 $str .= "AND biblio.title LIKE CONCAT(?,'%') ";
2125 @loopcriteria = ("A".."z") unless (scalar(@loopcriteria)>0);
2128 if ($orderby =~ /date_desc/){
2129 $str.=" ORDER BY dateaccessioned DESC";
2131 $str.=" ORDER BY title";
2134 my $qdataacquisitions=$dbh->prepare($str);
2136 my @loopacquisitions;
2137 foreach my $value(@loopcriteria){
2138 push @params,$value;
2140 $cell{"title"}=$value;
2141 $cell{"titlecode"}=$value;
2143 eval{$qdataacquisitions->execute(@params);};
2145 if ($@){ warn "recentacquisitions Error :$@";}
2148 while (my $data=$qdataacquisitions->fetchrow_hashref){
2149 push @loopdata, {"summary"=>GetBiblioSummary( $data->{'marcxml'} ) };
2151 $cell{"loopdata"}=\@loopdata;
2153 push @loopacquisitions,\%cell if (scalar(@{$cell{loopdata}})>0);
2156 $qdataacquisitions->finish;
2157 return \@loopacquisitions;
2160 =head2 enabled_staff_search_views
2162 %hash = enabled_staff_search_views()
2164 This function returns a hash that contains three flags obtained from the system
2165 preferences, used to determine whether a particular staff search results view
2170 =item C<Output arg:>
2172 * $hash{can_view_MARC} is true only if the MARC view is enabled
2173 * $hash{can_view_ISBD} is true only if the ISBD view is enabled
2174 * $hash{can_view_labeledMARC} is true only if the Labeled MARC view is enabled
2176 =item C<usage in the script:>
2180 $template->param ( C4::Search::enabled_staff_search_views );
2184 sub enabled_staff_search_views
2187 can_view_MARC => C4::Context->preference('viewMARC'), # 1 if the staff search allows the MARC view
2188 can_view_ISBD => C4::Context->preference('viewISBD'), # 1 if the staff search allows the ISBD view
2189 can_view_labeledMARC => C4::Context->preference('viewLabeledMARC'), # 1 if the staff search allows the Labeled MARC view
2193 sub AddSearchHistory{
2194 my ($borrowernumber,$session,$query_desc,$query_cgi, $total)=@_;
2195 my $dbh = C4::Context->dbh;
2197 # Add the request the user just made
2198 my $sql = "INSERT INTO search_history(userid, sessionid, query_desc, query_cgi, total, time) VALUES(?, ?, ?, ?, ?, NOW())";
2199 my $sth = $dbh->prepare($sql);
2200 $sth->execute($borrowernumber, $session, $query_desc, $query_cgi, $total);
2201 return $dbh->last_insert_id(undef, 'search_history', undef,undef,undef);
2204 sub GetSearchHistory{
2205 my ($borrowernumber,$session)=@_;
2206 my $dbh = C4::Context->dbh;
2208 # Add the request the user just made
2209 my $query = "SELECT FROM search_history WHERE (userid=? OR sessionid=?)";
2210 my $sth = $dbh->prepare($query);
2211 $sth->execute($borrowernumber, $session);
2212 return $sth->fetchall_hashref({});
2215 sub PurgeSearchHistory{
2216 my ($pSearchhistory)=@_;
2217 my $dbh = C4::Context->dbh;
2218 my $sth = $dbh->prepare("DELETE FROM search_history WHERE time < DATE_SUB( NOW(), INTERVAL ? DAY )");
2219 $sth->execute($pSearchhistory) or die $dbh->errstr;
2222 =head2 z3950_search_args
2224 $arrayref = z3950_search_args($matchpoints)
2226 This function returns an array reference that contains the search parameters to be
2227 passed to the Z39.50 search script (z3950_search.pl). The array elements
2228 are hash refs whose keys are name, value and encvalue, and whose values are the
2229 name of a search parameter, the value of that search parameter and the URL encoded
2230 value of that parameter.
2232 The search parameter names are lccn, isbn, issn, title, author, dewey and subject.
2234 The search parameter values are obtained from the bibliographic record whose
2235 data is in a hash reference in $matchpoints, as returned by Biblio::GetBiblioData().
2237 If $matchpoints is a scalar, it is assumed to be an unnamed query descriptor, e.g.
2238 a general purpose search argument. In this case, the returned array contains only
2239 entry: the key is 'title' and the value and encvalue are derived from $matchpoints.
2241 If a search parameter value is undefined or empty, it is not included in the returned
2244 The returned array reference may be passed directly to the template parameters.
2248 =item C<Output arg:>
2250 * $array containing hash refs as described above
2252 =item C<usage in the script:>
2256 $data = Biblio::GetBiblioData($bibno);
2257 $template->param ( MYLOOP => C4::Search::z3950_search_args($data) )
2261 $template->param ( MYLOOP => C4::Search::z3950_search_args($searchscalar) )
2265 sub z3950_search_args {
2267 my $isbn = Business::ISBN->new($bibrec);
2269 if (defined $isbn && $isbn->is_valid)
2271 $bibrec = { isbn => $bibrec } if !ref $bibrec;
2274 $bibrec = { title => $bibrec } if !ref $bibrec;
2277 for my $field (qw/ lccn isbn issn title author dewey subject /)
2279 my $encvalue = URI::Escape::uri_escape_utf8($bibrec->{$field});
2280 push @$array, { name=>$field, value=>$bibrec->{$field}, encvalue=>$encvalue } if defined $bibrec->{$field};
2285 =head2 GetDistinctValues($field);
2287 C<$field> is a reference to the fields array
2291 sub GetDistinctValues {
2292 my ($fieldname,$string)=@_;
2293 # returns a reference to a hash of references to branches...
2294 if ($fieldname=~/\./){
2295 my ($table,$column)=split /\./, $fieldname;
2296 my $dbh = C4::Context->dbh;
2297 warn "select DISTINCT($column) as value, count(*) as cnt from $table group by lib order by $column " if $DEBUG;
2298 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 ");
2300 my $elements=$sth->fetchall_arrayref({});
2305 my @servers=qw<biblioserver authorityserver>;
2306 my (@zconns,@results);
2307 for ( my $i = 0 ; $i < @servers ; $i++ ) {
2308 $zconns[$i] = C4::Context->Zconn( $servers[$i], 1 );
2311 ZOOM::Query::CCL2RPN->new( qq"$fieldname $string", $zconns[$i])
2314 # The big moment: asynchronously retrieve results from all servers
2320 my ( $i, $size ) = @_;
2321 for ( my $j = 0 ; $j < $size ; $j++ ) {
2323 @hashscan{qw(value cnt)} =
2324 $results[ $i - 1 ]->display_term($j);
2325 push @elements, \%hashscan;
2333 =head2 _ZOOM_event_loop
2335 _ZOOM_event_loop(\@zconns, \@results, sub {
2336 my ( $i, $size ) = @_;
2340 Processes a ZOOM event loop and passes control to a closure for
2341 processing the results, and destroying the resultsets.
2345 sub _ZOOM_event_loop {
2346 my ($zconns, $results, $callback) = @_;
2347 while ( ( my $i = ZOOM::event( $zconns ) ) != 0 ) {
2348 my $ev = $zconns->[ $i - 1 ]->last_event();
2349 if ( $ev == ZOOM::Event::ZEND ) {
2350 next unless $results->[ $i - 1 ];
2351 my $size = $results->[ $i - 1 ]->size();
2353 $callback->($i, $size);
2358 foreach my $result (@$results) {
2364 END { } # module clean-up code here (global destructor)
2371 Koha Development Team <http://koha-community.org/>