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',
960 'date-entered-on-file',
961 'Date-of-acquisition',
962 'Date-of-publication',
963 'Dewey-classification',
970 'Geographic-subdivision',
973 'Heading-use-main-or-added-entry',
974 'Heading-use-series-added-entry ',
975 'Heading-use-subject-added-entry',
993 'Local-classification',
996 'Match-heading-see-from',
1004 'Name-geographic-heading',
1005 'Name-geographic-see',
1006 'Name-geographic-seealso',
1014 'Personal-name-heading',
1015 'Personal-name-see',
1016 'Personal-name-seealso',
1018 'Place-publication',
1023 'Record-control-number',
1034 'Subject-heading-thesaurus',
1035 'Subject-name-personal',
1036 'Subject-subdivision',
1046 'Term-genre-form-heading',
1047 'Term-genre-form-see',
1048 'Term-genre-form-seealso',
1055 'Title-uniform-heading',
1056 'Title-uniform-see',
1057 'Title-uniform-seealso',
1067 'classification-source',
1069 'coded-location-qualifier',
1080 'Local-classification',
1083 'materials-specified',
1092 'replacementpricedate',
1107 =head2 _handle_exploding_index
1109 my $query = _handle_exploding_index($index, $term)
1111 Callback routine to generate the search for "exploding" indexes (i.e.
1112 those indexes which are turned into multiple or-connected searches based
1117 sub _handle_exploding_index {
1118 my ($QParser, $filter, $params, $negate, $server) = @_;
1119 my $index = $filter;
1120 my $term = join(' ', @$params);
1122 return unless ($index =~ m/(su-br|su-na|su-rl)/ && $term);
1124 my $marcflavour = C4::Context->preference('marcflavour');
1126 my $codesubfield = $marcflavour eq 'UNIMARC' ? '5' : 'w';
1127 my $wantedcodes = '';
1128 my @subqueries = ( "\@attr 1=Subject \@attr 4=1 \"$term\"");
1129 my ($error, $results, $total_hits) = SimpleSearch( "he:$term", undef, undef, [ "authorityserver" ] );
1130 foreach my $auth (@$results) {
1131 my $record = MARC::Record->new_from_usmarc($auth);
1132 my @references = $record->field('5..');
1134 if ($index eq 'su-br') {
1136 } elsif ($index eq 'su-na') {
1138 } elsif ($index eq 'su-rl') {
1141 foreach my $reference (@references) {
1142 my $codes = $reference->subfield($codesubfield);
1143 push @subqueries, '@attr 1=Subject @attr 4=1 "' . $reference->as_string('abcdefghijlmnopqrstuvxyz') . '"' if (($codes && $codes eq $wantedcodes) || !$wantedcodes);
1147 my $query = ' @or ' x (scalar(@subqueries) - 1) . join(' ', @subqueries);
1153 ( $operators, $operands, $indexes, $limits,
1154 $sort_by, $scan, $lang ) =
1155 buildQuery ( $operators, $operands, $indexes, $limits, $sort_by, $scan, $lang);
1157 Shim function to ease the transition from buildQuery to a new QueryParser.
1158 This function is called at the beginning of buildQuery, and modifies
1159 buildQuery's input. If it can handle the input, it returns a query that
1160 buildQuery will not try to parse.
1164 my ( $operators, $operands, $indexes, $limits, $sort_by, $scan, $lang) = @_;
1166 my @operators = $operators ? @$operators : ();
1167 my @indexes = $indexes ? @$indexes : ();
1168 my @operands = $operands ? @$operands : ();
1169 my @limits = $limits ? @$limits : ();
1170 my @sort_by = $sort_by ? @$sort_by : ();
1172 my $query = $operands[0];
1178 $QParser = C4::Context->queryparser if (C4::Context->preference('UseQueryParser') || $query =~ s/^qp=//);
1179 undef $QParser if ($query =~ m/^(ccl=|pqf=|cql=)/ || grep (/\w,\w|\w=\w/, @operands, @indexes) );
1180 undef $QParser if (scalar @limits > 0);
1184 $QParser->custom_data->{'QueryAutoTruncate'} = C4::Context->preference('QueryAutoTruncate');
1186 for ( my $ii = 0 ; $ii <= @operands ; $ii++ ) {
1187 next unless $operands[$ii];
1188 $query .= $operators[ $ii - 1 ] eq 'or' ? ' || ' : ' && '
1190 if ( $operands[$ii] =~ /^[^"]\W*[-|_\w]*:\w.*[^"]$/ ) {
1191 $query .= $operands[$ii];
1193 elsif ( $indexes[$ii] =~ m/su-/ ) {
1194 $query .= $indexes[$ii] . '(' . $operands[$ii] . ')';
1198 ( $indexes[$ii] ? "$indexes[$ii]:" : '' ) . $operands[$ii];
1201 foreach my $limit (@limits) {
1203 if ( scalar(@sort_by) > 0 ) {
1205 '#(' . join( '|', @{ $QParser->modifiers } ) . ')';
1206 $query =~ s/$modifier_re//g;
1207 foreach my $modifier (@sort_by) {
1208 $query .= " #$modifier";
1212 $query_desc = $query;
1213 $query_desc =~ s/\s+/ /g;
1214 if ( C4::Context->preference("QueryWeightFields") ) {
1216 $QParser->add_bib1_filter_map( 'su-br' => 'biblioserver' =>
1217 { 'target_syntax_callback' => \&_handle_exploding_index } );
1218 $QParser->add_bib1_filter_map( 'su-na' => 'biblioserver' =>
1219 { 'target_syntax_callback' => \&_handle_exploding_index } );
1220 $QParser->add_bib1_filter_map( 'su-rl' => 'biblioserver' =>
1221 { 'target_syntax_callback' => \&_handle_exploding_index } );
1222 $QParser->parse($query);
1223 $operands[0] = "pqf=" . $QParser->target_syntax('biblioserver');
1226 require Koha::QueryParser::Driver::PQF;
1227 my $modifier_re = '#(' . join( '|', @{Koha::QueryParser::Driver::PQF->modifiers}) . ')';
1228 s/$modifier_re//g for @operands;
1231 return ( $operators, \@operands, $indexes, $limits, $sort_by, $scan, $lang, $query_desc);
1237 $simple_query, $query_cgi,
1238 $query_desc, $limit,
1239 $limit_cgi, $limit_desc,
1240 $stopwords_removed, $query_type ) = buildQuery ( $operators, $operands, $indexes, $limits, $sort_by, $scan, $lang);
1242 Build queries and limits in CCL, CGI, Human,
1243 handle truncation, stemming, field weighting, stopwords, fuzziness, etc.
1245 See verbose embedded documentation.
1251 my ( $operators, $operands, $indexes, $limits, $sort_by, $scan, $lang) = @_;
1253 warn "---------\nEnter buildQuery\n---------" if $DEBUG;
1256 ( $operators, $operands, $indexes, $limits, $sort_by, $scan, $lang, $query_desc) = parseQuery($operators, $operands, $indexes, $limits, $sort_by, $scan, $lang);
1259 my @operators = $operators ? @$operators : ();
1260 my @indexes = $indexes ? @$indexes : ();
1261 my @operands = $operands ? @$operands : ();
1262 my @limits = $limits ? @$limits : ();
1263 my @sort_by = $sort_by ? @$sort_by : ();
1265 my $stemming = C4::Context->preference("QueryStemming") || 0;
1266 my $auto_truncation = C4::Context->preference("QueryAutoTruncate") || 0;
1267 my $weight_fields = C4::Context->preference("QueryWeightFields") || 0;
1268 my $fuzzy_enabled = C4::Context->preference("QueryFuzzy") || 0;
1269 my $remove_stopwords = C4::Context->preference("QueryRemoveStopwords") || 0;
1271 my $query = $operands[0];
1272 my $simple_query = $operands[0];
1274 # initialize the variables we're passing back
1282 my $stopwords_removed; # flag to determine if stopwords have been removed
1285 my $cclindexes = getIndexes();
1286 if ( $query !~ /\s*(ccl=|pqf=|cql=)/ ) {
1287 while ( !$cclq && $query =~ /(?:^|\W)([\w-]+)(,[\w-]+)*[:=]/g ) {
1289 $cclq = grep { lc($_) eq $dx } @$cclindexes;
1291 $query = "ccl=$query" if $cclq;
1294 # for handling ccl, cql, pqf queries in diagnostic mode, skip the rest of the steps
1296 if ( $query =~ /^ccl=/ ) {
1298 # This is needed otherwise ccl= and &limit won't work together, and
1299 # this happens when selecting a subject on the opac-detail page
1300 @limits = grep {!/^$/} @limits;
1302 $q .= ' and '.join(' and ', @limits);
1304 return ( undef, $q, $q, "q=ccl=".uri_escape($q), $q, '', '', '', '', 'ccl' );
1306 if ( $query =~ /^cql=/ ) {
1307 return ( undef, $', $', "q=cql=".uri_escape($'), $', '', '', '', '', 'cql' );
1309 if ( $query =~ /^pqf=/ ) {
1311 $query_cgi = "q=".uri_escape($query_desc);
1314 $query_cgi = "q=pqf=".uri_escape($');
1316 return ( undef, $', $', $query_cgi, $query_desc, '', '', '', '', 'pqf' );
1319 # pass nested queries directly
1320 # FIXME: need better handling of some of these variables in this case
1321 # Nested queries aren't handled well and this implementation is flawed and causes users to be
1322 # unable to search for anything containing () commenting out, will be rewritten for 3.4.0
1323 # if ( $query =~ /(\(|\))/ ) {
1325 # undef, $query, $simple_query, $query_cgi,
1326 # $query, $limit, $limit_cgi, $limit_desc,
1327 # $stopwords_removed, 'ccl'
1331 # Form-based queries are non-nested and fixed depth, so we can easily modify the incoming
1332 # query operands and indexes and add stemming, truncation, field weighting, etc.
1333 # Once we do so, we'll end up with a value in $query, just like if we had an
1334 # incoming $query from the user
1337 ; # clear it out so we can populate properly with field-weighted, stemmed, etc. query
1338 my $previous_operand
1339 ; # a flag used to keep track if there was a previous query
1340 # if there was, we can apply the current operator
1342 for ( my $i = 0 ; $i <= @operands ; $i++ ) {
1344 # COMBINE OPERANDS, INDEXES AND OPERATORS
1345 if ( $operands[$i] ) {
1346 $operands[$i]=~s/^\s+//;
1348 # A flag to determine whether or not to add the index to the query
1351 # If the user is sophisticated enough to specify an index, turn off field weighting, stemming, and stopword handling
1352 if ( $operands[$i] =~ /\w(:|=)/ || $scan ) {
1355 $remove_stopwords = 0;
1357 $operands[$i] =~ s/\?/{?}/g; # need to escape question marks
1359 my $operand = $operands[$i];
1360 my $index = $indexes[$i];
1362 # Add index-specific attributes
1363 # Date of Publication
1364 if ( $index eq 'yr' ) {
1365 $index .= ",st-numeric";
1367 $stemming = $auto_truncation = $weight_fields = $fuzzy_enabled = $remove_stopwords = 0;
1370 # Date of Acquisition
1371 elsif ( $index eq 'acqdate' ) {
1372 $index .= ",st-date-normalized";
1374 $stemming = $auto_truncation = $weight_fields = $fuzzy_enabled = $remove_stopwords = 0;
1376 # ISBN,ISSN,Standard Number, don't need special treatment
1377 elsif ( $index eq 'nb' || $index eq 'ns' ) {
1379 $stemming, $auto_truncation,
1380 $weight_fields, $fuzzy_enabled,
1382 ) = ( 0, 0, 0, 0, 0 );
1390 # Set default structure attribute (word list)
1391 my $struct_attr = q{};
1392 unless ( $indexes_set || !$index || $index =~ /,(st-|phr|ext|wrdl)/ || $index =~ /^(nb|ns)$/ ) {
1393 $struct_attr = ",wrdl";
1396 # Some helpful index variants
1397 my $index_plus = $index . $struct_attr . ':';
1398 my $index_plus_comma = $index . $struct_attr . ',';
1401 if ($remove_stopwords) {
1402 ( $operand, $stopwords_removed ) =
1403 _remove_stopwords( $operand, $index );
1404 warn "OPERAND w/out STOPWORDS: >$operand<" if $DEBUG;
1405 warn "REMOVED STOPWORDS: @$stopwords_removed"
1406 if ( $stopwords_removed && $DEBUG );
1409 if ($auto_truncation){
1410 unless ( $index =~ /,(st-|phr|ext)/ ) {
1411 #FIXME only valid with LTR scripts
1412 $operand=join(" ",map{
1413 (index($_,"*")>0?"$_":"$_*")
1414 }split (/\s+/,$operand));
1415 warn $operand if $DEBUG;
1420 my $truncated_operand;
1421 my( $nontruncated, $righttruncated, $lefttruncated,
1422 $rightlefttruncated, $regexpr
1423 ) = _detect_truncation( $operand, $index );
1425 "TRUNCATION: NON:>@$nontruncated< RIGHT:>@$righttruncated< LEFT:>@$lefttruncated< RIGHTLEFT:>@$rightlefttruncated< REGEX:>@$regexpr<"
1430 scalar(@$righttruncated) + scalar(@$lefttruncated) +
1431 scalar(@$rightlefttruncated) > 0 )
1434 # Don't field weight or add the index to the query, we do it here
1436 undef $weight_fields;
1437 my $previous_truncation_operand;
1438 if (scalar @$nontruncated) {
1439 $truncated_operand .= "$index_plus @$nontruncated ";
1440 $previous_truncation_operand = 1;
1442 if (scalar @$righttruncated) {
1443 $truncated_operand .= "and " if $previous_truncation_operand;
1444 $truncated_operand .= $index_plus_comma . "rtrn:@$righttruncated ";
1445 $previous_truncation_operand = 1;
1447 if (scalar @$lefttruncated) {
1448 $truncated_operand .= "and " if $previous_truncation_operand;
1449 $truncated_operand .= $index_plus_comma . "ltrn:@$lefttruncated ";
1450 $previous_truncation_operand = 1;
1452 if (scalar @$rightlefttruncated) {
1453 $truncated_operand .= "and " if $previous_truncation_operand;
1454 $truncated_operand .= $index_plus_comma . "rltrn:@$rightlefttruncated ";
1455 $previous_truncation_operand = 1;
1458 $operand = $truncated_operand if $truncated_operand;
1459 warn "TRUNCATED OPERAND: >$truncated_operand<" if $DEBUG;
1462 my $stemmed_operand;
1463 $stemmed_operand = _build_stemmed_operand($operand, $lang)
1466 warn "STEMMED OPERAND: >$stemmed_operand<" if $DEBUG;
1468 # Handle Field Weighting
1469 my $weighted_operand;
1470 if ($weight_fields) {
1471 $weighted_operand = _build_weighted_query( $operand, $stemmed_operand, $index );
1472 $operand = $weighted_operand;
1476 warn "FIELD WEIGHTED OPERAND: >$weighted_operand<" if $DEBUG;
1478 # If there's a previous operand, we need to add an operator
1479 if ($previous_operand) {
1481 # User-specified operator
1482 if ( $operators[ $i - 1 ] ) {
1483 $query .= " $operators[$i-1] ";
1484 $query .= " $index_plus " unless $indexes_set;
1485 $query .= " $operand";
1486 $query_cgi .= "&op=".uri_escape($operators[$i-1]);
1487 $query_cgi .= "&idx=".uri_escape($index) if $index;
1488 $query_cgi .= "&q=".uri_escape($operands[$i]) if $operands[$i];
1490 " $operators[$i-1] $index_plus $operands[$i]";
1493 # Default operator is and
1496 $query .= "$index_plus " unless $indexes_set;
1497 $query .= "$operand";
1498 $query_cgi .= "&op=and&idx=".uri_escape($index) if $index;
1499 $query_cgi .= "&q=".uri_escape($operands[$i]) if $operands[$i];
1500 $query_desc .= " and $index_plus $operands[$i]";
1504 # There isn't a pervious operand, don't need an operator
1507 # Field-weighted queries already have indexes set
1508 $query .= " $index_plus " unless $indexes_set;
1510 $query_desc .= " $index_plus $operands[$i]";
1511 $query_cgi .= "&idx=".uri_escape($index) if $index;
1512 $query_cgi .= "&q=".uri_escape($operands[$i]) if $operands[$i];
1513 $previous_operand = 1;
1518 warn "QUERY BEFORE LIMITS: >$query<" if $DEBUG;
1521 my %group_OR_limits;
1522 my $availability_limit;
1523 foreach my $this_limit (@limits) {
1524 next unless $this_limit;
1525 if ( $this_limit =~ /available/ ) {
1527 ## 'available' is defined as (items.onloan is NULL) and (items.itemlost = 0)
1529 ## all records not indexed in the onloan register (zebra) and all records with a value of lost equal to 0
1530 $availability_limit .=
1531 "( ( allrecords,AlwaysMatches='' not onloan,AlwaysMatches='') and (lost,st-numeric=0) )"; #or ( allrecords,AlwaysMatches='' not lost,AlwaysMatches='')) )";
1532 $limit_cgi .= "&limit=available";
1536 # group_OR_limits, prefixed by mc-
1537 # OR every member of the group
1538 elsif ( $this_limit =~ /mc/ ) {
1539 my ($k,$v) = split(/:/, $this_limit,2);
1540 if ( $k !~ /mc-i(tem)?type/ ) {
1541 # in case the mc-ccode value has complicating chars like ()'s inside it we wrap in quotes
1542 $this_limit =~ tr/"//d;
1543 $this_limit = $k.":\"".$v."\"";
1546 $group_OR_limits{$k} .= " or " if $group_OR_limits{$k};
1547 $limit_desc .= " or " if $group_OR_limits{$k};
1548 $group_OR_limits{$k} .= "$this_limit";
1549 $limit_cgi .= "&limit=$this_limit";
1550 $limit_desc .= " $this_limit";
1553 # Regular old limits
1555 $limit .= " and " if $limit || $query;
1556 $limit .= "$this_limit";
1557 $limit_cgi .= "&limit=$this_limit";
1558 if ($this_limit =~ /^branch:(.+)/) {
1559 my $branchcode = $1;
1560 my $branchname = GetBranchName($branchcode);
1561 if (defined $branchname) {
1562 $limit_desc .= " branch:$branchname";
1564 $limit_desc .= " $this_limit";
1567 $limit_desc .= " $this_limit";
1571 foreach my $k (keys (%group_OR_limits)) {
1572 $limit .= " and " if ( $query || $limit );
1573 $limit .= "($group_OR_limits{$k})";
1575 if ($availability_limit) {
1576 $limit .= " and " if ( $query || $limit );
1577 $limit .= "($availability_limit)";
1580 # Normalize the query and limit strings
1581 # This is flawed , means we can't search anything with : in it
1582 # if user wants to do ccl or cql, start the query with that
1583 # $query =~ s/:/=/g;
1584 $query =~ s/(?<=(ti|au|pb|su|an|kw|mc|nb|ns)):/=/g;
1585 $query =~ s/(?<=(wrdl)):/=/g;
1586 $query =~ s/(?<=(trn|phr)):/=/g;
1588 for ( $query, $query_desc, $limit, $limit_desc ) {
1589 s/ +/ /g; # remove extra spaces
1590 s/^ //g; # remove any beginning spaces
1591 s/ $//g; # remove any ending spaces
1592 s/==/=/g; # remove double == from query
1594 $query_cgi =~ s/^&//; # remove unnecessary & from beginning of the query cgi
1596 for ($query_cgi,$simple_query) {
1599 # append the limit to the query
1600 $query .= " " . $limit;
1604 warn "QUERY:" . $query;
1605 warn "QUERY CGI:" . $query_cgi;
1606 warn "QUERY DESC:" . $query_desc;
1607 warn "LIMIT:" . $limit;
1608 warn "LIMIT CGI:" . $limit_cgi;
1609 warn "LIMIT DESC:" . $limit_desc;
1610 warn "---------\nLeave buildQuery\n---------";
1613 undef, $query, $simple_query, $query_cgi,
1614 $query_desc, $limit, $limit_cgi, $limit_desc,
1615 $stopwords_removed, $query_type
1619 =head2 searchResults
1621 my @search_results = searchResults($search_context, $searchdesc, $hits,
1622 $results_per_page, $offset, $scan,
1625 Format results in a form suitable for passing to the template
1629 # IMO this subroutine is pretty messy still -- it's responsible for
1630 # building the HTML output for the template
1632 my ( $search_context, $searchdesc, $hits, $results_per_page, $offset, $scan, $marcresults ) = @_;
1633 my $dbh = C4::Context->dbh;
1638 $search_context = 'opac' if !$search_context || $search_context ne 'intranet';
1639 my ($is_opac, $hidelostitems);
1640 if ($search_context eq 'opac') {
1641 $hidelostitems = C4::Context->preference('hidelostitems');
1645 #Build branchnames hash
1647 #get branch information.....
1649 my $bsth =$dbh->prepare("SELECT branchcode,branchname FROM branches"); # FIXME : use C4::Branch::GetBranches
1651 while ( my $bdata = $bsth->fetchrow_hashref ) {
1652 $branches{ $bdata->{'branchcode'} } = $bdata->{'branchname'};
1654 # FIXME - We build an authorised values hash here, using the default framework
1655 # though it is possible to have different authvals for different fws.
1657 my $shelflocations =GetKohaAuthorisedValues('items.location','');
1659 # get notforloan authorised value list (see $shelflocations FIXME)
1660 my $notforloan_authorised_value = GetAuthValCode('items.notforloan','');
1662 #Build itemtype hash
1663 #find itemtype & itemtype image
1667 "SELECT itemtype,description,imageurl,summary,notforloan FROM itemtypes"
1670 while ( my $bdata = $bsth->fetchrow_hashref ) {
1671 foreach (qw(description imageurl summary notforloan)) {
1672 $itemtypes{ $bdata->{'itemtype'} }->{$_} = $bdata->{$_};
1676 #search item field code
1677 my ($itemtag, undef) = &GetMarcFromKohaField( "items.itemnumber", "" );
1679 ## find column names of items related to MARC
1680 my $sth2 = $dbh->prepare("SHOW COLUMNS FROM items");
1682 my %subfieldstosearch;
1683 while ( ( my $column ) = $sth2->fetchrow ) {
1684 my ( $tagfield, $tagsubfield ) =
1685 &GetMarcFromKohaField( "items." . $column, "" );
1686 if ( defined $tagsubfield ) {
1687 $subfieldstosearch{$column} = $tagsubfield;
1691 # handle which records to actually retrieve
1693 if ( $hits && $offset + $results_per_page <= $hits ) {
1694 $times = $offset + $results_per_page;
1697 $times = $hits; # FIXME: if $hits is undefined, why do we want to equal it?
1700 my $marcflavour = C4::Context->preference("marcflavour");
1701 # We get the biblionumber position in MARC
1702 my ($bibliotag,$bibliosubf)=GetMarcFromKohaField('biblio.biblionumber','');
1704 # loop through all of the records we've retrieved
1705 for ( my $i = $offset ; $i <= $times - 1 ; $i++ ) {
1706 my $marcrecord = eval { MARC::File::USMARC::decode( $marcresults->[$i] ); };
1708 warn "ERROR DECODING RECORD - $@: " . $marcresults->[$i];
1715 ? GetFrameworkCode($marcrecord->field($bibliotag)->data)
1716 : GetFrameworkCode($marcrecord->subfield($bibliotag,$bibliosubf));
1717 my $oldbiblio = TransformMarcToKoha( $dbh, $marcrecord, $fw );
1718 $oldbiblio->{subtitle} = GetRecordValue('subtitle', $marcrecord, $fw);
1719 $oldbiblio->{result_number} = $i + 1;
1721 # add imageurl to itemtype if there is one
1722 $oldbiblio->{imageurl} = getitemtypeimagelocation( $search_context, $itemtypes{ $oldbiblio->{itemtype} }->{imageurl} );
1724 $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 ) ) : [];
1725 $oldbiblio->{normalized_upc} = GetNormalizedUPC( $marcrecord,$marcflavour);
1726 $oldbiblio->{normalized_ean} = GetNormalizedEAN( $marcrecord,$marcflavour);
1727 $oldbiblio->{normalized_oclc} = GetNormalizedOCLCNumber($marcrecord,$marcflavour);
1728 $oldbiblio->{normalized_isbn} = GetNormalizedISBN(undef,$marcrecord,$marcflavour);
1729 $oldbiblio->{content_identifier_exists} = 1 if ($oldbiblio->{normalized_isbn} or $oldbiblio->{normalized_oclc} or $oldbiblio->{normalized_ean} or $oldbiblio->{normalized_upc});
1731 # edition information, if any
1732 $oldbiblio->{edition} = $oldbiblio->{editionstatement};
1733 $oldbiblio->{description} = $itemtypes{ $oldbiblio->{itemtype} }->{description};
1734 # Build summary if there is one (the summary is defined in the itemtypes table)
1735 # FIXME: is this used anywhere, I think it can be commented out? -- JF
1736 if ( $itemtypes{ $oldbiblio->{itemtype} }->{summary} ) {
1737 my $summary = $itemtypes{ $oldbiblio->{itemtype} }->{summary};
1738 my @fields = $marcrecord->fields();
1741 foreach my $line ( "$summary\n" =~ /(.*)\n/g ){
1743 foreach my $tag ( $line =~ /\[(\d{3}[\w|\d])\]/ ) {
1744 $tag =~ /(.{3})(.)/;
1745 if($marcrecord->field($1)){
1746 my @abc = $marcrecord->field($1)->subfield($2);
1747 $tags->{$tag} = $#abc + 1 ;
1751 # We catch how many times to repeat this line
1753 foreach my $tag (keys(%$tags)){
1754 $max = $tags->{$tag} if($tags->{$tag} > $max);
1757 # we replace, and repeat each line
1758 for (my $i = 0 ; $i < $max ; $i++){
1759 my $newline = $line;
1761 foreach my $tag ( $newline =~ /\[(\d{3}[\w|\d])\]/g ) {
1762 $tag =~ /(.{3})(.)/;
1764 if($marcrecord->field($1)){
1765 my @repl = $marcrecord->field($1)->subfield($2);
1766 my $subfieldvalue = $repl[$i];
1768 if (! utf8::is_utf8($subfieldvalue)) {
1769 utf8::decode($subfieldvalue);
1772 $newline =~ s/\[$tag\]/$subfieldvalue/g;
1775 $newsummary .= "$newline\n";
1779 $newsummary =~ s/\[(.*?)]//g;
1780 $newsummary =~ s/\n/<br\/>/g;
1781 $oldbiblio->{summary} = $newsummary;
1784 # Pull out the items fields
1785 my @fields = $marcrecord->field($itemtag);
1786 my $marcflavor = C4::Context->preference("marcflavour");
1787 # adding linked items that belong to host records
1788 my $analyticsfield = '773';
1789 if ($marcflavor eq 'MARC21' || $marcflavor eq 'NORMARC') {
1790 $analyticsfield = '773';
1791 } elsif ($marcflavor eq 'UNIMARC') {
1792 $analyticsfield = '461';
1794 foreach my $hostfield ( $marcrecord->field($analyticsfield)) {
1795 my $hostbiblionumber = $hostfield->subfield("0");
1796 my $linkeditemnumber = $hostfield->subfield("9");
1797 if(!$hostbiblionumber eq undef){
1798 my $hostbiblio = GetMarcBiblio($hostbiblionumber, 1);
1799 my ($itemfield, undef) = GetMarcFromKohaField( 'items.itemnumber', GetFrameworkCode($hostbiblionumber) );
1800 if(!$hostbiblio eq undef){
1801 my @hostitems = $hostbiblio->field($itemfield);
1802 foreach my $hostitem (@hostitems){
1803 if ($hostitem->subfield("9") eq $linkeditemnumber){
1804 my $linkeditem =$hostitem;
1805 # append linked items if they exist
1806 if (!$linkeditem eq undef){
1807 push (@fields, $linkeditem);}
1814 # Setting item statuses for display
1815 my @available_items_loop;
1816 my @onloan_items_loop;
1817 my @other_items_loop;
1819 my $available_items;
1823 my $ordered_count = 0;
1824 my $available_count = 0;
1825 my $onloan_count = 0;
1826 my $longoverdue_count = 0;
1827 my $other_count = 0;
1828 my $wthdrawn_count = 0;
1829 my $itemlost_count = 0;
1830 my $hideatopac_count = 0;
1831 my $itembinding_count = 0;
1832 my $itemdamaged_count = 0;
1833 my $item_in_transit_count = 0;
1834 my $can_place_holds = 0;
1835 my $item_onhold_count = 0;
1836 my $items_count = scalar(@fields);
1837 my $maxitems_pref = C4::Context->preference('maxItemsinSearchResults');
1838 my $maxitems = $maxitems_pref ? $maxitems_pref - 1 : 1;
1839 my @hiddenitems; # hidden itemnumbers based on OpacHiddenItems syspref
1841 # loop through every item
1842 foreach my $field (@fields) {
1845 # populate the items hash
1846 foreach my $code ( keys %subfieldstosearch ) {
1847 $item->{$code} = $field->subfield( $subfieldstosearch{$code} );
1849 $item->{description} = $itemtypes{ $item->{itype} }{description};
1853 # hidden because lost
1854 if ($hidelostitems && $item->{itemlost}) {
1855 $hideatopac_count++;
1858 # hidden based on OpacHiddenItems syspref
1859 my @hi = C4::Items::GetHiddenItemnumbers($item);
1861 push @hiddenitems, @hi;
1862 $hideatopac_count++;
1867 my $hbranch = C4::Context->preference('HomeOrHoldingBranch') eq 'homebranch' ? 'homebranch' : 'holdingbranch';
1868 my $otherbranch = C4::Context->preference('HomeOrHoldingBranch') eq 'homebranch' ? 'holdingbranch' : 'homebranch';
1870 # set item's branch name, use HomeOrHoldingBranch syspref first, fall back to the other one
1871 if ($item->{$hbranch}) {
1872 $item->{'branchname'} = $branches{$item->{$hbranch}};
1874 elsif ($item->{$otherbranch}) { # Last resort
1875 $item->{'branchname'} = $branches{$item->{$otherbranch}};
1878 my $prefix = $item->{$hbranch} . '--' . $item->{location} . $item->{itype} . $item->{itemcallnumber};
1879 # For each grouping of items (onloan, available, unavailable), we build a key to store relevant info about that item
1880 my $userenv = C4::Context->userenv;
1881 if ( $item->{onloan} && !(C4::Members::GetHideLostItemsPreference($userenv->{'number'}) && $item->{itemlost}) ) {
1883 my $key = $prefix . $item->{onloan} . $item->{barcode};
1884 $onloan_items->{$key}->{due_date} = format_date($item->{onloan});
1885 $onloan_items->{$key}->{count}++ if $item->{$hbranch};
1886 $onloan_items->{$key}->{branchname} = $item->{branchname};
1887 $onloan_items->{$key}->{location} = $shelflocations->{ $item->{location} };
1888 $onloan_items->{$key}->{itemcallnumber} = $item->{itemcallnumber};
1889 $onloan_items->{$key}->{description} = $item->{description};
1890 $onloan_items->{$key}->{imageurl} = getitemtypeimagelocation( $search_context, $itemtypes{ $item->{itype} }->{imageurl} );
1891 # if something's checked out and lost, mark it as 'long overdue'
1892 if ( $item->{itemlost} ) {
1893 $onloan_items->{$prefix}->{longoverdue}++;
1894 $longoverdue_count++;
1895 } else { # can place holds as long as item isn't lost
1896 $can_place_holds = 1;
1900 # items not on loan, but still unavailable ( lost, withdrawn, damaged )
1904 if ( $item->{notforloan} < 0 ) {
1908 # is item in transit?
1909 my $transfertwhen = '';
1910 my ($transfertfrom, $transfertto);
1912 # is item on the reserve shelf?
1913 my $reservestatus = '';
1915 unless ($item->{wthdrawn}
1916 || $item->{itemlost}
1918 || $item->{notforloan}
1919 || $items_count > 20) {
1921 # A couple heuristics to limit how many times
1922 # we query the database for item transfer information, sacrificing
1923 # accuracy in some cases for speed;
1925 # 1. don't query if item has one of the other statuses
1926 # 2. don't check transit status if the bib has
1927 # more than 20 items
1929 # FIXME: to avoid having the query the database like this, and to make
1930 # the in transit status count as unavailable for search limiting,
1931 # should map transit status to record indexed in Zebra.
1933 ($transfertwhen, $transfertfrom, $transfertto) = C4::Circulation::GetTransfers($item->{itemnumber});
1934 $reservestatus = C4::Reserves::GetReserveStatus( $item->{itemnumber}, $oldbiblio->{biblionumber} );
1937 # item is withdrawn, lost, damaged, not for loan, reserved or in transit
1938 if ( $item->{wthdrawn}
1939 || $item->{itemlost}
1941 || $item->{notforloan}
1942 || $reservestatus eq 'Waiting'
1943 || ($transfertwhen ne ''))
1945 $wthdrawn_count++ if $item->{wthdrawn};
1946 $itemlost_count++ if $item->{itemlost};
1947 $itemdamaged_count++ if $item->{damaged};
1948 $item_in_transit_count++ if $transfertwhen ne '';
1949 $item_onhold_count++ if $reservestatus eq 'Waiting';
1950 $item->{status} = $item->{wthdrawn} . "-" . $item->{itemlost} . "-" . $item->{damaged} . "-" . $item->{notforloan};
1952 # can place a hold on a item if
1953 # not lost nor withdrawn
1954 # not damaged unless AllowHoldsOnDamagedItems is true
1955 # item is either for loan or on order (notforloan < 0)
1956 $can_place_holds = 1
1959 && !$item->{wthdrawn}
1960 && ( !$item->{damaged} || C4::Context->preference('AllowHoldsOnDamagedItems') )
1961 && ( !$item->{notforloan} || $item->{notforloan} < 0 )
1966 my $key = $prefix . $item->{status};
1967 foreach (qw(wthdrawn itemlost damaged branchname itemcallnumber)) {
1968 $other_items->{$key}->{$_} = $item->{$_};
1970 $other_items->{$key}->{intransit} = ( $transfertwhen ne '' ) ? 1 : 0;
1971 $other_items->{$key}->{onhold} = ($reservestatus) ? 1 : 0;
1972 $other_items->{$key}->{notforloan} = GetAuthorisedValueDesc('','',$item->{notforloan},'','',$notforloan_authorised_value) if $notforloan_authorised_value and $item->{notforloan};
1973 $other_items->{$key}->{count}++ if $item->{$hbranch};
1974 $other_items->{$key}->{location} = $shelflocations->{ $item->{location} };
1975 $other_items->{$key}->{description} = $item->{description};
1976 $other_items->{$key}->{imageurl} = getitemtypeimagelocation( $search_context, $itemtypes{ $item->{itype} }->{imageurl} );
1980 $can_place_holds = 1;
1982 $available_items->{$prefix}->{count}++ if $item->{$hbranch};
1983 foreach (qw(branchname itemcallnumber description)) {
1984 $available_items->{$prefix}->{$_} = $item->{$_};
1986 $available_items->{$prefix}->{location} = $shelflocations->{ $item->{location} };
1987 $available_items->{$prefix}->{imageurl} = getitemtypeimagelocation( $search_context, $itemtypes{ $item->{itype} }->{imageurl} );
1990 } # notforloan, item level and biblioitem level
1992 # if all items are hidden, do not show the record
1993 if ($items_count > 0 && $hideatopac_count == $items_count) {
1997 my ( $availableitemscount, $onloanitemscount, $otheritemscount );
1998 for my $key ( sort keys %$onloan_items ) {
1999 (++$onloanitemscount > $maxitems) and last;
2000 push @onloan_items_loop, $onloan_items->{$key};
2002 for my $key ( sort keys %$other_items ) {
2003 (++$otheritemscount > $maxitems) and last;
2004 push @other_items_loop, $other_items->{$key};
2006 for my $key ( sort keys %$available_items ) {
2007 (++$availableitemscount > $maxitems) and last;
2008 push @available_items_loop, $available_items->{$key}
2011 # XSLT processing of some stuff
2013 SetUTF8Flag($marcrecord);
2014 warn $marcrecord->as_formatted if $DEBUG;
2015 my $interface = $search_context eq 'opac' ? 'OPAC' : '';
2016 if (!$scan && C4::Context->preference($interface . "XSLTResultsDisplay")) {
2017 $oldbiblio->{XSLTResultsRecord} = XSLTParse4Display($oldbiblio->{biblionumber}, $marcrecord, $interface."XSLTResultsDisplay", 1, \@hiddenitems);
2018 # the last parameter tells Koha to clean up the problematic ampersand entities that Zebra outputs
2021 # if biblio level itypes are used and itemtype is notforloan, it can't be reserved either
2022 if (!C4::Context->preference("item-level_itypes")) {
2023 if ($itemtypes{ $oldbiblio->{itemtype} }->{notforloan}) {
2024 $can_place_holds = 0;
2027 $oldbiblio->{norequests} = 1 unless $can_place_holds;
2028 $oldbiblio->{itemsplural} = 1 if $items_count > 1;
2029 $oldbiblio->{items_count} = $items_count;
2030 $oldbiblio->{available_items_loop} = \@available_items_loop;
2031 $oldbiblio->{onloan_items_loop} = \@onloan_items_loop;
2032 $oldbiblio->{other_items_loop} = \@other_items_loop;
2033 $oldbiblio->{availablecount} = $available_count;
2034 $oldbiblio->{availableplural} = 1 if $available_count > 1;
2035 $oldbiblio->{onloancount} = $onloan_count;
2036 $oldbiblio->{onloanplural} = 1 if $onloan_count > 1;
2037 $oldbiblio->{othercount} = $other_count;
2038 $oldbiblio->{otherplural} = 1 if $other_count > 1;
2039 $oldbiblio->{wthdrawncount} = $wthdrawn_count;
2040 $oldbiblio->{itemlostcount} = $itemlost_count;
2041 $oldbiblio->{damagedcount} = $itemdamaged_count;
2042 $oldbiblio->{intransitcount} = $item_in_transit_count;
2043 $oldbiblio->{onholdcount} = $item_onhold_count;
2044 $oldbiblio->{orderedcount} = $ordered_count;
2046 if (C4::Context->preference("AlternateHoldingsField") && $items_count == 0) {
2047 my $fieldspec = C4::Context->preference("AlternateHoldingsField");
2048 my $subfields = substr $fieldspec, 3;
2049 my $holdingsep = C4::Context->preference("AlternateHoldingsSeparator") || ' ';
2050 my @alternateholdingsinfo = ();
2051 my @holdingsfields = $marcrecord->field(substr $fieldspec, 0, 3);
2052 my $alternateholdingscount = 0;
2054 for my $field (@holdingsfields) {
2055 my %holding = ( holding => '' );
2056 my $havesubfield = 0;
2057 for my $subfield ($field->subfields()) {
2058 if ((index $subfields, $$subfield[0]) >= 0) {
2059 $holding{'holding'} .= $holdingsep if (length $holding{'holding'} > 0);
2060 $holding{'holding'} .= $$subfield[1];
2064 if ($havesubfield) {
2065 push(@alternateholdingsinfo, \%holding);
2066 $alternateholdingscount++;
2070 $oldbiblio->{'ALTERNATEHOLDINGS'} = \@alternateholdingsinfo;
2071 $oldbiblio->{'alternateholdings_count'} = $alternateholdingscount;
2074 push( @newresults, $oldbiblio );
2080 =head2 SearchAcquisitions
2081 Search for acquisitions
2084 sub SearchAcquisitions{
2085 my ($datebegin, $dateend, $itemtypes,$criteria, $orderby) = @_;
2087 my $dbh=C4::Context->dbh;
2088 # Variable initialization
2092 LEFT JOIN biblioitems ON biblioitems.biblionumber=biblio.biblionumber
2093 LEFT JOIN items ON items.biblionumber=biblio.biblionumber
2094 WHERE dateaccessioned BETWEEN ? AND ?
2097 my (@params,@loopcriteria);
2099 push @params, $datebegin->output("iso");
2100 push @params, $dateend->output("iso");
2102 if (scalar(@$itemtypes)>0 and $criteria ne "itemtype" ){
2103 if(C4::Context->preference("item-level_itypes")){
2104 $str .= "AND items.itype IN (?".( ',?' x scalar @$itemtypes - 1 ).") ";
2106 $str .= "AND biblioitems.itemtype IN (?".( ',?' x scalar @$itemtypes - 1 ).") ";
2108 push @params, @$itemtypes;
2111 if ($criteria =~/itemtype/){
2112 if(C4::Context->preference("item-level_itypes")){
2113 $str .= "AND items.itype=? ";
2115 $str .= "AND biblioitems.itemtype=? ";
2118 if(scalar(@$itemtypes) == 0){
2119 my $itypes = GetItemTypes();
2120 for my $key (keys %$itypes){
2121 push @$itemtypes, $key;
2125 @loopcriteria= @$itemtypes;
2126 }elsif ($criteria=~/itemcallnumber/){
2127 $str .= "AND (items.itemcallnumber LIKE CONCAT(?,'%')
2128 OR items.itemcallnumber is NULL
2129 OR items.itemcallnumber = '')";
2131 @loopcriteria = ("AA".."ZZ", "") unless (scalar(@loopcriteria)>0);
2133 $str .= "AND biblio.title LIKE CONCAT(?,'%') ";
2134 @loopcriteria = ("A".."z") unless (scalar(@loopcriteria)>0);
2137 if ($orderby =~ /date_desc/){
2138 $str.=" ORDER BY dateaccessioned DESC";
2140 $str.=" ORDER BY title";
2143 my $qdataacquisitions=$dbh->prepare($str);
2145 my @loopacquisitions;
2146 foreach my $value(@loopcriteria){
2147 push @params,$value;
2149 $cell{"title"}=$value;
2150 $cell{"titlecode"}=$value;
2152 eval{$qdataacquisitions->execute(@params);};
2154 if ($@){ warn "recentacquisitions Error :$@";}
2157 while (my $data=$qdataacquisitions->fetchrow_hashref){
2158 push @loopdata, {"summary"=>GetBiblioSummary( $data->{'marcxml'} ) };
2160 $cell{"loopdata"}=\@loopdata;
2162 push @loopacquisitions,\%cell if (scalar(@{$cell{loopdata}})>0);
2165 $qdataacquisitions->finish;
2166 return \@loopacquisitions;
2169 =head2 enabled_staff_search_views
2171 %hash = enabled_staff_search_views()
2173 This function returns a hash that contains three flags obtained from the system
2174 preferences, used to determine whether a particular staff search results view
2179 =item C<Output arg:>
2181 * $hash{can_view_MARC} is true only if the MARC view is enabled
2182 * $hash{can_view_ISBD} is true only if the ISBD view is enabled
2183 * $hash{can_view_labeledMARC} is true only if the Labeled MARC view is enabled
2185 =item C<usage in the script:>
2189 $template->param ( C4::Search::enabled_staff_search_views );
2193 sub enabled_staff_search_views
2196 can_view_MARC => C4::Context->preference('viewMARC'), # 1 if the staff search allows the MARC view
2197 can_view_ISBD => C4::Context->preference('viewISBD'), # 1 if the staff search allows the ISBD view
2198 can_view_labeledMARC => C4::Context->preference('viewLabeledMARC'), # 1 if the staff search allows the Labeled MARC view
2202 sub AddSearchHistory{
2203 my ($borrowernumber,$session,$query_desc,$query_cgi, $total)=@_;
2204 my $dbh = C4::Context->dbh;
2206 # Add the request the user just made
2207 my $sql = "INSERT INTO search_history(userid, sessionid, query_desc, query_cgi, total, time) VALUES(?, ?, ?, ?, ?, NOW())";
2208 my $sth = $dbh->prepare($sql);
2209 $sth->execute($borrowernumber, $session, $query_desc, $query_cgi, $total);
2210 return $dbh->last_insert_id(undef, 'search_history', undef,undef,undef);
2213 sub GetSearchHistory{
2214 my ($borrowernumber,$session)=@_;
2215 my $dbh = C4::Context->dbh;
2217 # Add the request the user just made
2218 my $query = "SELECT FROM search_history WHERE (userid=? OR sessionid=?)";
2219 my $sth = $dbh->prepare($query);
2220 $sth->execute($borrowernumber, $session);
2221 return $sth->fetchall_hashref({});
2224 =head2 z3950_search_args
2226 $arrayref = z3950_search_args($matchpoints)
2228 This function returns an array reference that contains the search parameters to be
2229 passed to the Z39.50 search script (z3950_search.pl). The array elements
2230 are hash refs whose keys are name, value and encvalue, and whose values are the
2231 name of a search parameter, the value of that search parameter and the URL encoded
2232 value of that parameter.
2234 The search parameter names are lccn, isbn, issn, title, author, dewey and subject.
2236 The search parameter values are obtained from the bibliographic record whose
2237 data is in a hash reference in $matchpoints, as returned by Biblio::GetBiblioData().
2239 If $matchpoints is a scalar, it is assumed to be an unnamed query descriptor, e.g.
2240 a general purpose search argument. In this case, the returned array contains only
2241 entry: the key is 'title' and the value and encvalue are derived from $matchpoints.
2243 If a search parameter value is undefined or empty, it is not included in the returned
2246 The returned array reference may be passed directly to the template parameters.
2250 =item C<Output arg:>
2252 * $array containing hash refs as described above
2254 =item C<usage in the script:>
2258 $data = Biblio::GetBiblioData($bibno);
2259 $template->param ( MYLOOP => C4::Search::z3950_search_args($data) )
2263 $template->param ( MYLOOP => C4::Search::z3950_search_args($searchscalar) )
2267 sub z3950_search_args {
2269 my $isbn = Business::ISBN->new($bibrec);
2271 if (defined $isbn && $isbn->is_valid)
2273 $bibrec = { isbn => $bibrec } if !ref $bibrec;
2276 $bibrec = { title => $bibrec } if !ref $bibrec;
2279 for my $field (qw/ lccn isbn issn title author dewey subject /)
2281 my $encvalue = URI::Escape::uri_escape_utf8($bibrec->{$field});
2282 push @$array, { name=>$field, value=>$bibrec->{$field}, encvalue=>$encvalue } if defined $bibrec->{$field};
2287 =head2 GetDistinctValues($field);
2289 C<$field> is a reference to the fields array
2293 sub GetDistinctValues {
2294 my ($fieldname,$string)=@_;
2295 # returns a reference to a hash of references to branches...
2296 if ($fieldname=~/\./){
2297 my ($table,$column)=split /\./, $fieldname;
2298 my $dbh = C4::Context->dbh;
2299 warn "select DISTINCT($column) as value, count(*) as cnt from $table group by lib order by $column " if $DEBUG;
2300 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 ");
2302 my $elements=$sth->fetchall_arrayref({});
2307 my @servers=qw<biblioserver authorityserver>;
2308 my (@zconns,@results);
2309 for ( my $i = 0 ; $i < @servers ; $i++ ) {
2310 $zconns[$i] = C4::Context->Zconn( $servers[$i], 1 );
2313 ZOOM::Query::CCL2RPN->new( qq"$fieldname $string", $zconns[$i])
2316 # The big moment: asynchronously retrieve results from all servers
2322 my ( $i, $size ) = @_;
2323 for ( my $j = 0 ; $j < $size ; $j++ ) {
2325 @hashscan{qw(value cnt)} =
2326 $results[ $i - 1 ]->display_term($j);
2327 push @elements, \%hashscan;
2335 =head2 _ZOOM_event_loop
2337 _ZOOM_event_loop(\@zconns, \@results, sub {
2338 my ( $i, $size ) = @_;
2342 Processes a ZOOM event loop and passes control to a closure for
2343 processing the results, and destroying the resultsets.
2347 sub _ZOOM_event_loop {
2348 my ($zconns, $results, $callback) = @_;
2349 while ( ( my $i = ZOOM::event( $zconns ) ) != 0 ) {
2350 my $ev = $zconns->[ $i - 1 ]->last_event();
2351 if ( $ev == ZOOM::Event::ZEND ) {
2352 next unless $results->[ $i - 1 ];
2353 my $size = $results->[ $i - 1 ]->size();
2355 $callback->($i, $size);
2360 foreach my $result (@$results) {
2366 END { } # module clean-up code here (global destructor)
2373 Koha Development Team <http://koha-community.org/>