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
21 use C4::Biblio; # GetMarcFromKohaField
22 use C4::Koha; # getFacets
24 use C4::Search::PazPar2;
26 use C4::Dates qw(format_date);
29 use vars qw($VERSION @ISA @EXPORT @EXPORT_OK %EXPORT_TAGS $DEBUG);
31 # set the version for version checking
34 $DEBUG = ($ENV{DEBUG}) ? 1 : 0;
39 C4::Search - Functions for searching the Koha catalog.
43 See opac/opac-search.pl or catalogue/search.pl for example of usage
47 This module provides searching functions for Koha's bibliographic databases
65 # make all your functions, whether exported or not;
67 =head2 findseealso($dbh,$fields);
69 C<$dbh> is a link to the DB handler.
72 my $dbh =C4::Context->dbh;
74 C<$fields> is a reference to the fields array
76 This function modifies the @$fields array and adds related fields to search on.
78 FIXME: this function is probably deprecated in Koha 3
83 my ( $dbh, $fields ) = @_;
84 my $tagslib = GetMarcStructure(1);
85 for ( my $i = 0 ; $i <= $#{$fields} ; $i++ ) {
86 my ($tag) = substr( @$fields[$i], 1, 3 );
87 my ($subfield) = substr( @$fields[$i], 4, 1 );
88 @$fields[$i] .= ',' . $tagslib->{$tag}->{$subfield}->{seealso}
89 if ( $tagslib->{$tag}->{$subfield}->{seealso} );
95 ($biblionumber,$biblionumber,$title) = FindDuplicate($record);
97 This function attempts to find duplicate records using a hard-coded, fairly simplistic algorithm
103 my $dbh = C4::Context->dbh;
104 my $result = TransformMarcToKoha( $dbh, $record, '' );
109 my ( $biblionumber, $title );
111 # search duplicate on ISBN, easy and fast..
112 # ... normalize first
113 if ( $result->{isbn} ) {
114 $result->{isbn} =~ s/\(.*$//;
115 $result->{isbn} =~ s/\s+$//;
116 $query = "isbn=$result->{isbn}";
119 $result->{title} =~ s /\\//g;
120 $result->{title} =~ s /\"//g;
121 $result->{title} =~ s /\(//g;
122 $result->{title} =~ s /\)//g;
124 # FIXME: instead of removing operators, could just do
125 # quotes around the value
126 $result->{title} =~ s/(and|or|not)//g;
127 $query = "ti,ext=$result->{title}";
128 $query .= " and itemtype=$result->{itemtype}"
129 if ( $result->{itemtype} );
130 if ( $result->{author} ) {
131 $result->{author} =~ s /\\//g;
132 $result->{author} =~ s /\"//g;
133 $result->{author} =~ s /\(//g;
134 $result->{author} =~ s /\)//g;
136 # remove valid operators
137 $result->{author} =~ s/(and|or|not)//g;
138 $query .= " and au,ext=$result->{author}";
142 # FIXME: add error handling
143 my ( $error, $searchresults ) = SimpleSearch($query); # FIXME :: hardcoded !
145 foreach my $possible_duplicate_record (@$searchresults) {
147 MARC::Record->new_from_usmarc($possible_duplicate_record);
148 my $result = TransformMarcToKoha( $dbh, $marcrecord, '' );
150 # FIXME :: why 2 $biblionumber ?
152 push @results, $result->{'biblionumber'};
153 push @results, $result->{'title'};
161 ( $error, $results, $total_hits ) = SimpleSearch( $query, $offset, $max_results, [@servers] );
163 This function provides a simple search API on the bibliographic catalog
169 * $query can be a simple keyword or a complete CCL query
170 * @servers is optional. Defaults to biblioserver as found in koha-conf.xml
171 * $offset - If present, represents the number of records at the beggining to omit. Defaults to 0
172 * $max_results - if present, determines the maximum number of records to fetch. undef is All. defaults to undef.
177 * $error is a empty unless an error is detected
178 * \@results is an array of records.
179 * $total_hits is the number of hits that would have been returned with no limit
181 =item C<usage in the script:>
185 my ( $error, $marcresults, $total_hits ) = SimpleSearch($query);
187 if (defined $error) {
188 $template->param(query_error => $error);
189 warn "error: ".$error;
190 output_html_with_http_headers $input, $cookie, $template->output;
194 my $hits = scalar @$marcresults;
197 for my $i (0..$hits) {
199 my $marcrecord = MARC::File::USMARC::decode($marcresults->[$i]);
200 my $biblio = TransformMarcToKoha(C4::Context->dbh,$marcrecord,'');
202 #build the hash for the template.
203 $resultsloop{highlight} = ($i % 2)?(1):(0);
204 $resultsloop{title} = $biblio->{'title'};
205 $resultsloop{subtitle} = $biblio->{'subtitle'};
206 $resultsloop{biblionumber} = $biblio->{'biblionumber'};
207 $resultsloop{author} = $biblio->{'author'};
208 $resultsloop{publishercode} = $biblio->{'publishercode'};
209 $resultsloop{publicationyear} = $biblio->{'publicationyear'};
211 push @results, \%resultsloop;
214 $template->param(result=>\@results);
219 my ( $query, $offset, $max_results, $servers ) = @_;
221 if ( C4::Context->preference('NoZebra') ) {
222 my $result = NZorder( NZanalyse($query) )->{'biblioserver'};
225 && $result->{hits} > 0 ? $result->{'RECORDS'} : [] );
226 return ( undef, $search_result, scalar($search_result) );
229 # FIXME hardcoded value. See catalog/search.pl & opac-search.pl too.
230 my @servers = defined ( $servers ) ? @$servers : ( "biblioserver" );
236 return ( "No query entered", undef, undef ) unless $query;
238 # Initialize & Search Zebra
239 for ( my $i = 0 ; $i < @servers ; $i++ ) {
241 $zconns[$i] = C4::Context->Zconn( $servers[$i], 1 );
242 $zoom_queries[$i] = new ZOOM::Query::CCL2RPN( $query, $zconns[$i]);
243 $tmpresults[$i] = $zconns[$i]->search( $zoom_queries[$i] );
247 $zconns[$i]->errmsg() . " ("
248 . $zconns[$i]->errcode() . ") "
249 . $zconns[$i]->addinfo() . " "
250 . $zconns[$i]->diagset();
252 return ( $error, undef, undef ) if $zconns[$i]->errcode();
256 # caught a ZOOM::Exception
260 . $@->addinfo() . " "
263 return ( $error, undef, undef );
266 while ( ( my $i = ZOOM::event( \@zconns ) ) != 0 ) {
267 my $event = $zconns[ $i - 1 ]->last_event();
268 if ( $event == ZOOM::Event::ZEND ) {
270 my $first_record = defined( $offset ) ? $offset+1 : 1;
271 my $hits = $tmpresults[ $i - 1 ]->size();
272 $total_hits += $hits;
273 my $last_record = $hits;
274 if ( defined $max_results && $offset + $max_results < $hits ) {
275 $last_record = $offset + $max_results;
278 for my $j ( $first_record..$last_record ) {
279 my $record = $tmpresults[ $i - 1 ]->record( $j-1 )->raw(); # 0 indexed
280 push @results, $record;
285 foreach my $result (@tmpresults) {
288 foreach my $zoom_query (@zoom_queries) {
289 $zoom_query->destroy();
292 return ( undef, \@results, $total_hits );
298 ( undef, $results_hashref, \@facets_loop ) = getRecords (
300 $koha_query, $simple_query, $sort_by_ref, $servers_ref,
301 $results_per_page, $offset, $expanded_facet, $branches,
305 The all singing, all dancing, multi-server, asynchronous, scanning,
306 searching, record nabbing, facet-building
308 See verbse embedded documentation.
314 $koha_query, $simple_query, $sort_by_ref, $servers_ref,
315 $results_per_page, $offset, $expanded_facet, $branches,
319 my @servers = @$servers_ref;
320 my @sort_by = @$sort_by_ref;
322 # Initialize variables for the ZOOM connection and results object
326 my $results_hashref = ();
328 # Initialize variables for the faceted results objects
329 my $facets_counter = ();
330 my $facets_info = ();
331 my $facets = getFacets();
334 ; # stores the ref to array of hashes for template facets loop
336 ### LOOP THROUGH THE SERVERS
337 for ( my $i = 0 ; $i < @servers ; $i++ ) {
338 $zconns[$i] = C4::Context->Zconn( $servers[$i], 1 );
340 # perform the search, create the results objects
341 # if this is a local search, use the $koha-query, if it's a federated one, use the federated-query
342 my $query_to_use = ($servers[$i] =~ /biblioserver/) ? $koha_query : $simple_query;
344 #$query_to_use = $simple_query if $scan;
345 warn $simple_query if ( $scan and $DEBUG );
347 # Check if we've got a query_type defined, if so, use it
351 if ( $query_type =~ /^ccl/ ) {
353 s/\:/\=/g; # change : to = last minute (FIXME)
356 new ZOOM::Query::CCL2RPN( $query_to_use, $zconns[$i] )
359 elsif ( $query_type =~ /^cql/ ) {
362 new ZOOM::Query::CQL( $query_to_use, $zconns[$i] ) );
364 elsif ( $query_type =~ /^pqf/ ) {
367 new ZOOM::Query::PQF( $query_to_use, $zconns[$i] ) );
374 new ZOOM::Query::CCL2RPN( $query_to_use, $zconns[$i] )
380 new ZOOM::Query::CCL2RPN( $query_to_use, $zconns[$i] )
386 warn "WARNING: query problem with $query_to_use " . $@;
389 # Concatenate the sort_by limits and pass them to the results object
390 # Note: sort will override rank
392 foreach my $sort (@sort_by) {
393 if ( $sort eq "author_az" ) {
394 $sort_by .= "1=1003 <i ";
396 elsif ( $sort eq "author_za" ) {
397 $sort_by .= "1=1003 >i ";
399 elsif ( $sort eq "popularity_asc" ) {
400 $sort_by .= "1=9003 <i ";
402 elsif ( $sort eq "popularity_dsc" ) {
403 $sort_by .= "1=9003 >i ";
405 elsif ( $sort eq "call_number_asc" ) {
406 $sort_by .= "1=20 <i ";
408 elsif ( $sort eq "call_number_dsc" ) {
409 $sort_by .= "1=20 >i ";
411 elsif ( $sort eq "pubdate_asc" ) {
412 $sort_by .= "1=31 <i ";
414 elsif ( $sort eq "pubdate_dsc" ) {
415 $sort_by .= "1=31 >i ";
417 elsif ( $sort eq "acqdate_asc" ) {
418 $sort_by .= "1=32 <i ";
420 elsif ( $sort eq "acqdate_dsc" ) {
421 $sort_by .= "1=32 >i ";
423 elsif ( $sort eq "title_az" ) {
424 $sort_by .= "1=4 <i ";
426 elsif ( $sort eq "title_za" ) {
427 $sort_by .= "1=4 >i ";
431 if ( $results[$i]->sort( "yaz", $sort_by ) < 0 ) {
432 warn "WARNING sort $sort_by failed";
435 } # finished looping through servers
437 # The big moment: asynchronously retrieve results from all servers
438 while ( ( my $i = ZOOM::event( \@zconns ) ) != 0 ) {
439 my $ev = $zconns[ $i - 1 ]->last_event();
440 if ( $ev == ZOOM::Event::ZEND ) {
441 next unless $results[ $i - 1 ];
442 my $size = $results[ $i - 1 ]->size();
446 # loop through the results
447 $results_hash->{'hits'} = $size;
449 if ( $offset + $results_per_page <= $size ) {
450 $times = $offset + $results_per_page;
455 for ( my $j = $offset ; $j < $times ; $j++ ) {
460 ## Check if it's an index scan
462 my ( $term, $occ ) = $results[ $i - 1 ]->term($j);
464 # here we create a minimal MARC record and hand it off to the
465 # template just like a normal result ... perhaps not ideal, but
467 my $tmprecord = MARC::Record->new();
468 $tmprecord->encoding('UTF-8');
472 # the minimal record in author/title (depending on MARC flavour)
473 if (C4::Context->preference("marcflavour") eq "UNIMARC") {
474 $tmptitle = MARC::Field->new('200',' ',' ', a => $term, f => $occ);
475 $tmprecord->append_fields($tmptitle);
477 $tmptitle = MARC::Field->new('245',' ',' ', a => $term,);
478 $tmpauthor = MARC::Field->new('100',' ',' ', a => $occ,);
479 $tmprecord->append_fields($tmptitle);
480 $tmprecord->append_fields($tmpauthor);
482 $results_hash->{'RECORDS'}[$j] = $tmprecord->as_usmarc();
487 $record = $results[ $i - 1 ]->record($j)->raw();
489 # warn "RECORD $j:".$record;
490 $results_hash->{'RECORDS'}[$j] = $record;
492 # Fill the facets while we're looping, but only for the biblioserver
493 $facet_record = MARC::Record->new_from_usmarc($record)
494 if $servers[ $i - 1 ] =~ /biblioserver/;
496 #warn $servers[$i-1]."\n".$record; #.$facet_record->title();
498 for ( my $k = 0 ; $k <= @$facets ; $k++ ) {
500 if ( $facets->[$k] ) {
502 for my $tag ( @{ $facets->[$k]->{'tags'} } )
505 $facet_record->field($tag);
507 for my $field (@fields) {
508 my @subfields = $field->subfields();
509 for my $subfield (@subfields) {
510 my ( $code, $data ) = @$subfield;
512 $facets->[$k]->{'subfield'} )
514 $facets_counter->{ $facets->[$k]
520 $facets_info->{ $facets->[$k]
521 ->{'link_value'} }->{'label_value'} =
522 $facets->[$k]->{'label_value'};
523 $facets_info->{ $facets->[$k]
524 ->{'link_value'} }->{'expanded'} =
525 $facets->[$k]->{'expanded'};
531 $results_hashref->{ $servers[ $i - 1 ] } = $results_hash;
534 # warn "connection ", $i-1, ": $size hits";
535 # warn $results[$i-1]->record(0)->render() if $size > 0;
538 if ( $servers[ $i - 1 ] =~ /biblioserver/ ) {
540 sort { $facets_counter->{$b} <=> $facets_counter->{$a} }
541 keys %$facets_counter )
544 my $number_of_facets;
545 my @this_facets_array;
548 $facets_counter->{$link_value}
549 ->{$b} <=> $facets_counter->{$link_value}->{$a}
550 } keys %{ $facets_counter->{$link_value} }
554 if ( ( $number_of_facets < 6 )
555 || ( $expanded_facet eq $link_value )
556 || ( $facets_info->{$link_value}->{'expanded'} ) )
559 # Sanitize the link value ), ( will cause errors with CCL,
560 my $facet_link_value = $one_facet;
561 $facet_link_value =~ s/(\(|\))/ /g;
563 # fix the length that will display in the label,
564 my $facet_label_value = $one_facet;
566 substr( $one_facet, 0, 20 ) . "..."
567 unless length($facet_label_value) <= 20;
569 # if it's a branch, label by the name, not the code,
570 if ( $link_value =~ /branch/ ) {
572 $branches->{$one_facet}->{'branchname'};
575 # but we're down with the whole label being in the link's title.
576 my $facet_title_value = $one_facet;
578 push @this_facets_array,
582 $facets_counter->{$link_value}
584 facet_label_value => $facet_label_value,
585 facet_title_value => $facet_title_value,
586 facet_link_value => $facet_link_value,
587 type_link_value => $link_value,
593 # handle expanded option
594 unless ( $facets_info->{$link_value}->{'expanded'} ) {
596 if ( ( $number_of_facets > 6 )
597 && ( $expanded_facet ne $link_value ) );
602 type_link_value => $link_value,
603 type_id => $link_value . "_id",
604 "type_label_" . $facets_info->{$link_value}->{'label_value'} => 1,
605 facets => \@this_facets_array,
606 expandable => $expandable,
607 expand => $link_value,
609 ) unless ( ($facets_info->{$link_value}->{'label_value'} =~ /Libraries/) and (C4::Context->preference('singleBranchMode')) );
614 return ( undef, $results_hashref, \@facets_loop );
619 $koha_query, $simple_query, $sort_by_ref, $servers_ref,
620 $results_per_page, $offset, $expanded_facet, $branches,
624 my $paz = C4::Search::PazPar2->new(C4::Context->config('pazpar2url'));
626 $paz->search($simple_query);
630 my $results_hashref = {};
631 my $stats = XMLin($paz->stat);
632 my $results = XMLin($paz->show($offset, $results_per_page, 'work-title:1'), forcearray => 1);
634 # for a grouped search result, the number of hits
635 # is the number of groups returned; 'bib_hits' will have
636 # the total number of bibs.
637 $results_hashref->{'biblioserver'}->{'hits'} = $results->{'merged'}->[0];
638 $results_hashref->{'biblioserver'}->{'bib_hits'} = $stats->{'hits'};
640 HIT: foreach my $hit (@{ $results->{'hit'} }) {
641 my $recid = $hit->{recid}->[0];
643 my $work_title = $hit->{'md-work-title'}->[0];
645 if (exists $hit->{'md-work-author'}) {
646 $work_author = $hit->{'md-work-author'}->[0];
648 my $group_label = (defined $work_author) ? "$work_title / $work_author" : $work_title;
650 my $result_group = {};
651 $result_group->{'group_label'} = $group_label;
652 $result_group->{'group_merge_key'} = $recid;
655 if (exists $hit->{count}) {
656 $count = $hit->{count}->[0];
658 $result_group->{'group_count'} = $count;
660 for (my $i = 0; $i < $count; $i++) {
661 # FIXME -- may need to worry about diacritics here
662 my $rec = $paz->record($recid, $i);
663 push @{ $result_group->{'RECORDS'} }, $rec;
666 push @{ $results_hashref->{'biblioserver'}->{'GROUPS'} }, $result_group;
669 # pass through facets
670 my $termlist_xml = $paz->termlist('author,subject');
671 my $terms = XMLin($termlist_xml, forcearray => 1);
672 my @facets_loop = ();
673 #die Dumper($results);
674 # foreach my $list (sort keys %{ $terms->{'list'} }) {
676 # foreach my $facet (sort @{ $terms->{'list'}->{$list}->{'term'} } ) {
678 # facet_label_value => $facet->{'name'}->[0],
681 # push @facets_loop, ( {
682 # type_label => $list,
683 # facets => \@facets,
687 return ( undef, $results_hashref, \@facets_loop );
691 sub _remove_stopwords {
692 my ( $operand, $index ) = @_;
693 my @stopwords_removed;
695 # phrase and exact-qualified indexes shouldn't have stopwords removed
696 if ( $index !~ m/phr|ext/ ) {
698 # remove stopwords from operand : parse all stopwords & remove them (case insensitive)
699 # we use IsAlpha unicode definition, to deal correctly with diacritics.
700 # otherwise, a French word like "leçon" woudl be split into "le" "çon", "le"
701 # is a stopword, we'd get "çon" and wouldn't find anything...
702 foreach ( keys %{ C4::Context->stopwords } ) {
703 next if ( $_ =~ /(and|or|not)/ ); # don't remove operators
705 /(\P{IsAlpha}$_\P{IsAlpha}|^$_\P{IsAlpha}|\P{IsAlpha}$_$|^$_$)/ )
707 $operand =~ s/\P{IsAlpha}$_\P{IsAlpha}/ /gi;
708 $operand =~ s/^$_\P{IsAlpha}/ /gi;
709 $operand =~ s/\P{IsAlpha}$_$/ /gi;
710 $operand =~ s/$1//gi;
711 push @stopwords_removed, $_;
715 return ( $operand, \@stopwords_removed );
719 sub _detect_truncation {
720 my ( $operand, $index ) = @_;
721 my ( @nontruncated, @righttruncated, @lefttruncated, @rightlefttruncated,
724 my @wordlist = split( /\s/, $operand );
725 foreach my $word (@wordlist) {
726 if ( $word =~ s/^\*([^\*]+)\*$/$1/ ) {
727 push @rightlefttruncated, $word;
729 elsif ( $word =~ s/^\*([^\*]+)$/$1/ ) {
730 push @lefttruncated, $word;
732 elsif ( $word =~ s/^([^\*]+)\*$/$1/ ) {
733 push @righttruncated, $word;
735 elsif ( index( $word, "*" ) < 0 ) {
736 push @nontruncated, $word;
739 push @regexpr, $word;
743 \@nontruncated, \@righttruncated, \@lefttruncated,
744 \@rightlefttruncated, \@regexpr
749 sub _build_stemmed_operand {
753 # If operand contains a digit, it is almost certainly an identifier, and should
754 # not be stemmed. This is particularly relevant for ISBNs and ISSNs, which
755 # can contain the letter "X" - for example, _build_stemmend_operand would reduce
756 # "014100018X" to "x ", which for a MARC21 database would bring up irrelevant
757 # results (e.g., "23 x 29 cm." from the 300$c). Bug 2098.
758 return $operand if $operand =~ /\d/;
760 # FIXME: the locale should be set based on the user's language and/or search choice
761 my $stemmer = Lingua::Stem->new( -locale => 'EN-US' );
763 # FIXME: these should be stored in the db so the librarian can modify the behavior
764 $stemmer->add_exceptions(
771 my @words = split( / /, $operand );
772 my $stems = $stemmer->stem(@words);
773 for my $stem (@$stems) {
774 $stemmed_operand .= "$stem";
775 $stemmed_operand .= "?"
776 unless ( $stem =~ /(and$|or$|not$)/ ) || ( length($stem) < 3 );
777 $stemmed_operand .= " ";
779 warn "STEMMED OPERAND: $stemmed_operand" if $DEBUG;
780 return $stemmed_operand;
784 sub _build_weighted_query {
786 # FIELD WEIGHTING - This is largely experimental stuff. What I'm committing works
787 # pretty well but could work much better if we had a smarter query parser
788 my ( $operand, $stemmed_operand, $index ) = @_;
789 my $stemming = C4::Context->preference("QueryStemming") || 0;
790 my $weight_fields = C4::Context->preference("QueryWeightFields") || 0;
791 my $fuzzy_enabled = C4::Context->preference("QueryFuzzy") || 0;
793 my $weighted_query .= "(rk=("; # Specifies that we're applying rank
795 # Keyword, or, no index specified
796 if ( ( $index eq 'kw' ) || ( !$index ) ) {
798 "Title-cover,ext,r1=\"$operand\""; # exact title-cover
799 $weighted_query .= " or ti,ext,r2=\"$operand\""; # exact title
800 $weighted_query .= " or ti,phr,r3=\"$operand\""; # phrase title
801 #$weighted_query .= " or any,ext,r4=$operand"; # exact any
802 #$weighted_query .=" or kw,wrdl,r5=\"$operand\""; # word list any
803 $weighted_query .= " or wrdl,fuzzy,r8=\"$operand\""
804 if $fuzzy_enabled; # add fuzzy, word list
805 $weighted_query .= " or wrdl,right-Truncation,r9=\"$stemmed_operand\""
806 if ( $stemming and $stemmed_operand )
807 ; # add stemming, right truncation
808 $weighted_query .= " or wrdl,r9=\"$operand\"";
810 # embedded sorting: 0 a-z; 1 z-a
811 # $weighted_query .= ") or (sort1,aut=1";
814 # Barcode searches should skip this process
815 elsif ( $index eq 'bc' ) {
816 $weighted_query .= "bc=\"$operand\"";
819 # Authority-number searches should skip this process
820 elsif ( $index eq 'an' ) {
821 $weighted_query .= "an=\"$operand\"";
824 # If the index already has more than one qualifier, wrap the operand
825 # in quotes and pass it back (assumption is that the user knows what they
826 # are doing and won't appreciate us mucking up their query
827 elsif ( $index =~ ',' ) {
828 $weighted_query .= " $index=\"$operand\"";
831 #TODO: build better cases based on specific search indexes
833 $weighted_query .= " $index,ext,r1=\"$operand\""; # exact index
834 #$weighted_query .= " or (title-sort-az=0 or $index,startswithnt,st-word,r3=$operand #)";
835 $weighted_query .= " or $index,phr,r3=\"$operand\""; # phrase index
837 " or $index,rt,wrdl,r3=\"$operand\""; # word list index
840 $weighted_query .= "))"; # close rank specification
841 return $weighted_query;
847 $simple_query, $query_cgi,
849 $limit_cgi, $limit_desc,
850 $stopwords_removed, $query_type ) = getRecords ( $operators, $operands, $indexes, $limits, $sort_by, $scan);
852 Build queries and limits in CCL, CGI, Human,
853 handle truncation, stemming, field weighting, stopwords, fuzziness, etc.
855 See verbose embedded documentation.
861 my ( $operators, $operands, $indexes, $limits, $sort_by, $scan ) = @_;
863 warn "---------\nEnter buildQuery\n---------" if $DEBUG;
866 my @operators = @$operators if $operators;
867 my @indexes = @$indexes if $indexes;
868 my @operands = @$operands if $operands;
869 my @limits = @$limits if $limits;
870 my @sort_by = @$sort_by if $sort_by;
872 my $stemming = C4::Context->preference("QueryStemming") || 0;
873 my $auto_truncation = C4::Context->preference("QueryAutoTruncate") || 0;
874 my $weight_fields = C4::Context->preference("QueryWeightFields") || 0;
875 my $fuzzy_enabled = C4::Context->preference("QueryFuzzy") || 0;
876 my $remove_stopwords = C4::Context->preference("QueryRemoveStopwords") || 0;
878 # no stemming/weight/fuzzy in NoZebra
879 if ( C4::Context->preference("NoZebra") ) {
885 my $query = $operands[0];
886 my $simple_query = $operands[0];
888 # initialize the variables we're passing back
897 my $stopwords_removed; # flag to determine if stopwords have been removed
899 # for handling ccl, cql, pqf queries in diagnostic mode, skip the rest of the steps
901 if ( $query =~ /^ccl=/ ) {
902 return ( undef, $', $', $', $', '', '', '', '', 'ccl' );
904 if ( $query =~ /^cql=/ ) {
905 return ( undef, $', $', $', $', '', '', '', '', 'cql' );
907 if ( $query =~ /^pqf=/ ) {
908 return ( undef, $', $', $', $', '', '', '', '', 'pqf' );
911 # pass nested queries directly
912 # FIXME: need better handling of some of these variables in this case
913 if ( $query =~ /(\(|\))/ ) {
915 undef, $query, $simple_query, $query_cgi,
916 $query, $limit, $limit_cgi, $limit_desc,
917 $stopwords_removed, 'ccl'
921 # Form-based queries are non-nested and fixed depth, so we can easily modify the incoming
922 # query operands and indexes and add stemming, truncation, field weighting, etc.
923 # Once we do so, we'll end up with a value in $query, just like if we had an
924 # incoming $query from the user
927 ; # clear it out so we can populate properly with field-weighted, stemmed, etc. query
929 ; # a flag used to keep track if there was a previous query
930 # if there was, we can apply the current operator
932 for ( my $i = 0 ; $i <= @operands ; $i++ ) {
934 # COMBINE OPERANDS, INDEXES AND OPERATORS
935 if ( $operands[$i] ) {
937 # A flag to determine whether or not to add the index to the query
940 # If the user is sophisticated enough to specify an index, turn off field weighting, stemming, and stopword handling
941 if ( $operands[$i] =~ /(:|=)/ || $scan ) {
944 $remove_stopwords = 0;
946 my $operand = $operands[$i];
947 my $index = $indexes[$i];
949 # Add index-specific attributes
950 # Date of Publication
951 if ( $index eq 'yr' ) {
952 $index .= ",st-numeric";
954 $stemming = $auto_truncation = $weight_fields = $fuzzy_enabled = $remove_stopwords = 0;
957 # Date of Acquisition
958 elsif ( $index eq 'acqdate' ) {
959 $index .= ",st-date-normalized";
961 $stemming = $auto_truncation = $weight_fields = $fuzzy_enabled = $remove_stopwords = 0;
963 # ISBN,ISSN,Standard Number, don't need special treatment
964 elsif ( $index eq 'nb' || $index eq 'ns' ) {
967 $stemming, $auto_truncation,
968 $weight_fields, $fuzzy_enabled,
970 ) = ( 0, 0, 0, 0, 0 );
973 # Set default structure attribute (word list)
975 unless ( $indexes_set || !$index || $index =~ /(st-|phr|ext|wrdl)/ ) {
976 $struct_attr = ",wrdl";
979 # Some helpful index variants
980 my $index_plus = $index . $struct_attr . ":" if $index;
981 my $index_plus_comma = $index . $struct_attr . "," if $index;
984 if ($remove_stopwords) {
985 ( $operand, $stopwords_removed ) =
986 _remove_stopwords( $operand, $index );
987 warn "OPERAND w/out STOPWORDS: >$operand<" if $DEBUG;
988 warn "REMOVED STOPWORDS: @$stopwords_removed"
989 if ( $stopwords_removed && $DEBUG );
993 my ( $nontruncated, $righttruncated, $lefttruncated,
994 $rightlefttruncated, $regexpr );
995 my $truncated_operand;
997 $nontruncated, $righttruncated, $lefttruncated,
998 $rightlefttruncated, $regexpr
999 ) = _detect_truncation( $operand, $index );
1001 "TRUNCATION: NON:>@$nontruncated< RIGHT:>@$righttruncated< LEFT:>@$lefttruncated< RIGHTLEFT:>@$rightlefttruncated< REGEX:>@$regexpr<"
1006 scalar(@$righttruncated) + scalar(@$lefttruncated) +
1007 scalar(@$rightlefttruncated) > 0 )
1010 # Don't field weight or add the index to the query, we do it here
1012 undef $weight_fields;
1013 my $previous_truncation_operand;
1014 if ( scalar(@$nontruncated) > 0 ) {
1015 $truncated_operand .= "$index_plus @$nontruncated ";
1016 $previous_truncation_operand = 1;
1018 if ( scalar(@$righttruncated) > 0 ) {
1019 $truncated_operand .= "and "
1020 if $previous_truncation_operand;
1021 $truncated_operand .=
1022 "$index_plus_comma" . "rtrn:@$righttruncated ";
1023 $previous_truncation_operand = 1;
1025 if ( scalar(@$lefttruncated) > 0 ) {
1026 $truncated_operand .= "and "
1027 if $previous_truncation_operand;
1028 $truncated_operand .=
1029 "$index_plus_comma" . "ltrn:@$lefttruncated ";
1030 $previous_truncation_operand = 1;
1032 if ( scalar(@$rightlefttruncated) > 0 ) {
1033 $truncated_operand .= "and "
1034 if $previous_truncation_operand;
1035 $truncated_operand .=
1036 "$index_plus_comma" . "rltrn:@$rightlefttruncated ";
1037 $previous_truncation_operand = 1;
1040 $operand = $truncated_operand if $truncated_operand;
1041 warn "TRUNCATED OPERAND: >$truncated_operand<" if $DEBUG;
1044 my $stemmed_operand;
1045 $stemmed_operand = _build_stemmed_operand($operand)
1047 warn "STEMMED OPERAND: >$stemmed_operand<" if $DEBUG;
1049 # Handle Field Weighting
1050 my $weighted_operand;
1052 _build_weighted_query( $operand, $stemmed_operand, $index )
1054 warn "FIELD WEIGHTED OPERAND: >$weighted_operand<" if $DEBUG;
1055 $operand = $weighted_operand if $weight_fields;
1056 $indexes_set = 1 if $weight_fields;
1058 # If there's a previous operand, we need to add an operator
1059 if ($previous_operand) {
1061 # User-specified operator
1062 if ( $operators[ $i - 1 ] ) {
1063 $query .= " $operators[$i-1] ";
1064 $query .= " $index_plus " unless $indexes_set;
1065 $query .= " $operand";
1066 $query_cgi .= "&op=$operators[$i-1]";
1067 $query_cgi .= "&idx=$index" if $index;
1068 $query_cgi .= "&q=$operands[$i]" if $operands[$i];
1070 " $operators[$i-1] $index_plus $operands[$i]";
1073 # Default operator is and
1076 $query .= "$index_plus " unless $indexes_set;
1077 $query .= "$operand";
1078 $query_cgi .= "&op=and&idx=$index" if $index;
1079 $query_cgi .= "&q=$operands[$i]" if $operands[$i];
1080 $query_desc .= " and $index_plus $operands[$i]";
1084 # There isn't a pervious operand, don't need an operator
1087 # Field-weighted queries already have indexes set
1088 $query .= " $index_plus " unless $indexes_set;
1090 $query_desc .= " $index_plus $operands[$i]";
1091 $query_cgi .= "&idx=$index" if $index;
1092 $query_cgi .= "&q=$operands[$i]" if $operands[$i];
1093 $previous_operand = 1;
1098 warn "QUERY BEFORE LIMITS: >$query<" if $DEBUG;
1101 my $group_OR_limits;
1102 my $availability_limit;
1103 foreach my $this_limit (@limits) {
1104 if ( $this_limit =~ /available/ ) {
1106 # 'available' is defined as (items.onloan is NULL) and (items.itemlost = 0)
1108 # all records not indexed in the onloan register (zebra) and all records with a value of lost equal to 0
1109 $availability_limit .=
1110 "( ( allrecords,AlwaysMatches='' not onloan,AlwaysMatches='') and (lost,st-numeric=0) )"; #or ( allrecords,AlwaysMatches='' not lost,AlwaysMatches='')) )";
1111 $limit_cgi .= "&limit=available";
1115 # group_OR_limits, prefixed by mc-
1116 # OR every member of the group
1117 elsif ( $this_limit =~ /mc/ ) {
1118 $group_OR_limits .= " or " if $group_OR_limits;
1119 $limit_desc .= " or " if $group_OR_limits;
1120 $group_OR_limits .= "$this_limit";
1121 $limit_cgi .= "&limit=$this_limit";
1122 $limit_desc .= " $this_limit";
1125 # Regular old limits
1127 $limit .= " and " if $limit || $query;
1128 $limit .= "$this_limit";
1129 $limit_cgi .= "&limit=$this_limit";
1130 $limit_desc .= " $this_limit";
1133 if ($group_OR_limits) {
1134 $limit .= " and " if ( $query || $limit );
1135 $limit .= "($group_OR_limits)";
1137 if ($availability_limit) {
1138 $limit .= " and " if ( $query || $limit );
1139 $limit .= "($availability_limit)";
1142 # Normalize the query and limit strings
1145 for ( $query, $query_desc, $limit, $limit_desc ) {
1146 $_ =~ s/ / /g; # remove extra spaces
1147 $_ =~ s/^ //g; # remove any beginning spaces
1148 $_ =~ s/ $//g; # remove any ending spaces
1149 $_ =~ s/==/=/g; # remove double == from query
1151 $query_cgi =~ s/^&//; # remove unnecessary & from beginning of the query cgi
1153 for ($query_cgi,$simple_query) {
1156 # append the limit to the query
1157 $query .= " " . $limit;
1161 warn "QUERY:" . $query;
1162 warn "QUERY CGI:" . $query_cgi;
1163 warn "QUERY DESC:" . $query_desc;
1164 warn "LIMIT:" . $limit;
1165 warn "LIMIT CGI:" . $limit_cgi;
1166 warn "LIMIT DESC:" . $limit_desc;
1167 warn "---------\nLeave buildQuery\n---------";
1170 undef, $query, $simple_query, $query_cgi,
1171 $query_desc, $limit, $limit_cgi, $limit_desc,
1172 $stopwords_removed, $query_type
1176 =head2 searchResults
1178 Format results in a form suitable for passing to the template
1182 # IMO this subroutine is pretty messy still -- it's responsible for
1183 # building the HTML output for the template
1185 my ( $searchdesc, $hits, $results_per_page, $offset, $scan, @marcresults ) = @_;
1186 my $dbh = C4::Context->dbh;
1190 # add search-term highlighting via <span>s on the search terms
1191 my $span_terms_hashref;
1192 for my $span_term ( split( / /, $searchdesc ) ) {
1193 $span_term =~ s/(.*=|\)|\(|\+|\.|\*)//g;
1194 $span_terms_hashref->{$span_term}++;
1197 #Build branchnames hash
1199 #get branch information.....
1202 $dbh->prepare("SELECT branchcode,branchname FROM branches")
1203 ; # FIXME : use C4::Koha::GetBranches
1205 while ( my $bdata = $bsth->fetchrow_hashref ) {
1206 $branches{ $bdata->{'branchcode'} } = $bdata->{'branchname'};
1208 # FIXME - We build an authorised values hash here, using the default framework
1209 # though it is possible to have different authvals for different fws.
1211 my $shelflocations =GetKohaAuthorisedValues('items.location','');
1213 # get notforloan authorised value list (see $shelflocations FIXME)
1214 my $notforloan_authorised_value = GetAuthValCode('items.notforloan','');
1216 #Build itemtype hash
1217 #find itemtype & itemtype image
1221 "SELECT itemtype,description,imageurl,summary,notforloan FROM itemtypes"
1224 while ( my $bdata = $bsth->fetchrow_hashref ) {
1225 foreach (qw(description imageurl summary notforloan)) {
1226 $itemtypes{ $bdata->{'itemtype'} }->{$_} = $bdata->{$_};
1230 #search item field code
1233 "SELECT tagfield FROM marc_subfield_structure WHERE kohafield LIKE 'items.itemnumber'"
1236 my ($itemtag) = $sth->fetchrow;
1238 ## find column names of items related to MARC
1239 my $sth2 = $dbh->prepare("SHOW COLUMNS FROM items");
1241 my %subfieldstosearch;
1242 while ( ( my $column ) = $sth2->fetchrow ) {
1243 my ( $tagfield, $tagsubfield ) =
1244 &GetMarcFromKohaField( "items." . $column, "" );
1245 $subfieldstosearch{$column} = $tagsubfield;
1248 # handle which records to actually retrieve
1250 if ( $hits && $offset + $results_per_page <= $hits ) {
1251 $times = $offset + $results_per_page;
1254 $times = $hits; # FIXME: if $hits is undefined, why do we want to equal it?
1257 # loop through all of the records we've retrieved
1258 for ( my $i = $offset ; $i <= $times - 1 ; $i++ ) {
1259 my $marcrecord = MARC::File::USMARC::decode( $marcresults[$i] );
1260 my $oldbiblio = TransformMarcToKoha( $dbh, $marcrecord, '' );
1261 $oldbiblio->{subtitle} = C4::Biblio::get_koha_field_from_marc('bibliosubtitle', 'subtitle', $marcrecord, '');
1262 $oldbiblio->{result_number} = $i + 1;
1264 # add imageurl to itemtype if there is one
1265 $oldbiblio->{imageurl} = getitemtypeimagelocation( 'opac', $itemtypes{ $oldbiblio->{itemtype} }->{imageurl} );
1267 $oldbiblio->{'authorised_value_images'} = C4::Items::get_authorised_value_images( C4::Biblio::get_biblio_authorised_values( $oldbiblio->{'biblionumber'} ) );
1268 (my $aisbn) = $oldbiblio->{isbn} =~ /([\d-]*[X]*)/;
1270 $oldbiblio->{amazonisbn} = $aisbn;
1271 $oldbiblio->{description} = $itemtypes{ $oldbiblio->{itemtype} }->{description};
1272 # Build summary if there is one (the summary is defined in the itemtypes table)
1273 # FIXME: is this used anywhere, I think it can be commented out? -- JF
1274 if ( $itemtypes{ $oldbiblio->{itemtype} }->{summary} ) {
1275 my $summary = $itemtypes{ $oldbiblio->{itemtype} }->{summary};
1276 my @fields = $marcrecord->fields();
1277 foreach my $field (@fields) {
1278 my $tag = $field->tag();
1279 my $tagvalue = $field->as_string();
1281 s/\[(.?.?.?.?)$tag\*(.*?)]/$1$tagvalue$2\[$1$tag$2]/g;
1282 unless ( $tag < 10 ) {
1283 my @subf = $field->subfields;
1284 for my $i ( 0 .. $#subf ) {
1285 my $subfieldcode = $subf[$i][0];
1286 my $subfieldvalue = $subf[$i][1];
1287 my $tagsubf = $tag . $subfieldcode;
1289 s/\[(.?.?.?.?)$tagsubf(.*?)]/$1$subfieldvalue$2\[$1$tagsubf$2]/g;
1294 $summary =~ s/\[(.*?)]//g;
1295 $summary =~ s/\n/<br\/>/g;
1296 $oldbiblio->{summary} = $summary;
1299 # save an author with no <span> tag, for the <a href=search.pl?q=<!--tmpl_var name="author"-->> link
1300 $oldbiblio->{'author_nospan'} = $oldbiblio->{'author'};
1301 $oldbiblio->{'title_nospan'} = $oldbiblio->{'title'};
1302 # Add search-term highlighting to the whole record where they match using <span>s
1303 if (C4::Context->preference("OpacHighlightedWords")){
1304 my $searchhighlightblob;
1305 for my $highlight_field ( $marcrecord->fields ) {
1307 # FIXME: need to skip title, subtitle, author, etc., as they are handled below
1308 next if $highlight_field->tag() =~ /(^00)/; # skip fixed fields
1309 for my $subfield ($highlight_field->subfields()) {
1311 next if $subfield->[0] eq '9';
1312 my $field = $subfield->[1];
1313 for my $term ( keys %$span_terms_hashref ) {
1314 if ( ( $field =~ /$term/i ) && (( length($term) > 3 ) || ($field =~ / $term /i)) ) {
1315 $field =~ s/$term/<span class=\"term\">$&<\/span>/gi;
1319 $searchhighlightblob .= $field . " ... " if $match;
1323 $searchhighlightblob = ' ... '.$searchhighlightblob if $searchhighlightblob;
1324 $oldbiblio->{'searchhighlightblob'} = $searchhighlightblob;
1327 # Add search-term highlighting to the title, subtitle, etc. fields
1328 for my $term ( keys %$span_terms_hashref ) {
1329 my $old_term = $term;
1330 if ( length($term) > 3 ) {
1331 $term =~ s/(.*=|\)|\(|\+|\.|\?|\[|\]|\\|\*)//g;
1332 foreach(qw(title subtitle author publishercode place pages notes size)) {
1333 $oldbiblio->{$_} =~ s/$term/<span class=\"term\">$&<\/span>/gi;
1338 ($i % 2) and $oldbiblio->{'toggle'} = 1;
1340 # Pull out the items fields
1341 my @fields = $marcrecord->field($itemtag);
1343 # Setting item statuses for display
1344 my @available_items_loop;
1345 my @onloan_items_loop;
1346 my @other_items_loop;
1348 my $available_items;
1352 my $ordered_count = 0;
1353 my $available_count = 0;
1354 my $onloan_count = 0;
1355 my $longoverdue_count = 0;
1356 my $other_count = 0;
1357 my $wthdrawn_count = 0;
1358 my $itemlost_count = 0;
1359 my $itembinding_count = 0;
1360 my $itemdamaged_count = 0;
1361 my $item_in_transit_count = 0;
1362 my $can_place_holds = 0;
1363 my $items_count = scalar(@fields);
1366 ( C4::Context->preference('maxItemsinSearchResults') )
1367 ? C4::Context->preference('maxItemsinSearchResults') - 1
1370 # loop through every item
1371 foreach my $field (@fields) {
1375 # populate the items hash
1376 foreach my $code ( keys %subfieldstosearch ) {
1377 $item->{$code} = $field->subfield( $subfieldstosearch{$code} );
1379 my $hbranch = C4::Context->preference('HomeOrHoldingBranch') eq 'homebranch' ? 'homebranch' : 'holdingbranch';
1380 my $otherbranch = C4::Context->preference('HomeOrHoldingBranch') eq 'homebranch' ? 'holdingbranch' : 'homebranch';
1381 # set item's branch name, use HomeOrHoldingBranch syspref first, fall back to the other one
1382 if ($item->{$hbranch}) {
1383 $item->{'branchname'} = $branches{$item->{$hbranch}};
1385 elsif ($item->{$otherbranch}) { # Last resort
1386 $item->{'branchname'} = $branches{$item->{$otherbranch}};
1389 my $prefix = $item->{$hbranch} . '--' . $item->{location} . $item->{itype} . $item->{itemcallnumber};
1390 # For each grouping of items (onloan, available, unavailable), we build a key to store relevant info about that item
1391 if ( $item->{onloan} ) {
1393 my $key = $prefix . $item->{due_date};
1394 $onloan_items->{$key}->{due_date} = format_date($item->{onloan});
1395 $onloan_items->{$key}->{count}++ if $item->{$hbranch};
1396 $onloan_items->{$key}->{branchname} = $item->{branchname};
1397 $onloan_items->{$key}->{location} = $shelflocations->{ $item->{location} };
1398 $onloan_items->{$key}->{itemcallnumber} = $item->{itemcallnumber};
1399 $onloan_items->{$key}->{imageurl} = getitemtypeimagelocation( 'opac', $itemtypes{ $item->{itype} }->{imageurl} );
1400 # if something's checked out and lost, mark it as 'long overdue'
1401 if ( $item->{itemlost} ) {
1402 $onloan_items->{$prefix}->{longoverdue}++;
1403 $longoverdue_count++;
1404 } else { # can place holds as long as item isn't lost
1405 $can_place_holds = 1;
1409 # items not on loan, but still unavailable ( lost, withdrawn, damaged )
1413 if ( $item->{notforloan} == -1 ) {
1417 # is item in transit?
1418 my $transfertwhen = '';
1419 my ($transfertfrom, $transfertto);
1421 unless ($item->{wthdrawn}
1422 || $item->{itemlost}
1424 || $item->{notforloan}
1425 || $items_count > 20) {
1427 # A couple heuristics to limit how many times
1428 # we query the database for item transfer information, sacrificing
1429 # accuracy in some cases for speed;
1431 # 1. don't query if item has one of the other statuses
1432 # 2. don't check transit status if the bib has
1433 # more than 20 items
1435 # FIXME: to avoid having the query the database like this, and to make
1436 # the in transit status count as unavailable for search limiting,
1437 # should map transit status to record indexed in Zebra.
1439 ($transfertwhen, $transfertfrom, $transfertto) = C4::Circulation::GetTransfers($item->{itemnumber});
1442 # item is withdrawn, lost or damaged
1443 if ( $item->{wthdrawn}
1444 || $item->{itemlost}
1446 || $item->{notforloan}
1447 || ($transfertwhen ne ''))
1449 $wthdrawn_count++ if $item->{wthdrawn};
1450 $itemlost_count++ if $item->{itemlost};
1451 $itemdamaged_count++ if $item->{damaged};
1452 $item_in_transit_count++ if $transfertwhen ne '';
1453 $item->{status} = $item->{wthdrawn} . "-" . $item->{itemlost} . "-" . $item->{damaged} . "-" . $item->{notforloan};
1456 my $key = $prefix . $item->{status};
1457 foreach (qw(wthdrawn itemlost damaged branchname itemcallnumber)) {
1458 $other_items->{$key}->{$_} = $item->{$_};
1460 $other_items->{$key}->{intransit} = ($transfertwhen ne '') ? 1 : 0;
1461 $other_items->{$key}->{notforloan} = GetAuthorisedValueDesc('','',$item->{notforloan},'','',$notforloan_authorised_value) if $notforloan_authorised_value;
1462 $other_items->{$key}->{count}++ if $item->{$hbranch};
1463 $other_items->{$key}->{location} = $shelflocations->{ $item->{location} };
1464 $other_items->{$key}->{imageurl} = getitemtypeimagelocation( 'opac', $itemtypes{ $item->{itype} }->{imageurl} );
1468 $can_place_holds = 1;
1470 $available_items->{$prefix}->{count}++ if $item->{$hbranch};
1471 foreach (qw(branchname itemcallnumber)) {
1472 $available_items->{$prefix}->{$_} = $item->{$_};
1474 $available_items->{$prefix}->{location} = $shelflocations->{ $item->{location} };
1475 $available_items->{$prefix}->{imageurl} = getitemtypeimagelocation( 'opac', $itemtypes{ $item->{itype} }->{imageurl} );
1478 } # notforloan, item level and biblioitem level
1479 my ( $availableitemscount, $onloanitemscount, $otheritemscount );
1481 ( C4::Context->preference('maxItemsinSearchResults') )
1482 ? C4::Context->preference('maxItemsinSearchResults') - 1
1484 for my $key ( sort keys %$onloan_items ) {
1485 (++$onloanitemscount > $maxitems) and last;
1486 push @onloan_items_loop, $onloan_items->{$key};
1488 for my $key ( sort keys %$other_items ) {
1489 (++$otheritemscount > $maxitems) and last;
1490 push @other_items_loop, $other_items->{$key};
1492 for my $key ( sort keys %$available_items ) {
1493 (++$availableitemscount > $maxitems) and last;
1494 push @available_items_loop, $available_items->{$key}
1497 # XSLT processing of some stuff
1498 if (C4::Context->preference("XSLTResultsDisplay") && !$scan) {
1499 my $newxmlrecord = XSLTParse4Display($oldbiblio->{biblionumber},C4::Context->config('opachtdocs')."/prog/en/xslt/MARC21slim2OPACResults.xsl");
1500 $oldbiblio->{XSLTResultsRecord} = $newxmlrecord;
1503 # last check for norequest : if itemtype is notforloan, it can't be reserved either, whatever the items
1504 $can_place_holds = 0
1505 if $itemtypes{ $oldbiblio->{itemtype} }->{notforloan};
1506 $oldbiblio->{norequests} = 1 unless $can_place_holds;
1507 $oldbiblio->{itemsplural} = 1 if $items_count > 1;
1508 $oldbiblio->{items_count} = $items_count;
1509 $oldbiblio->{available_items_loop} = \@available_items_loop;
1510 $oldbiblio->{onloan_items_loop} = \@onloan_items_loop;
1511 $oldbiblio->{other_items_loop} = \@other_items_loop;
1512 $oldbiblio->{availablecount} = $available_count;
1513 $oldbiblio->{availableplural} = 1 if $available_count > 1;
1514 $oldbiblio->{onloancount} = $onloan_count;
1515 $oldbiblio->{onloanplural} = 1 if $onloan_count > 1;
1516 $oldbiblio->{othercount} = $other_count;
1517 $oldbiblio->{otherplural} = 1 if $other_count > 1;
1518 $oldbiblio->{wthdrawncount} = $wthdrawn_count;
1519 $oldbiblio->{itemlostcount} = $itemlost_count;
1520 $oldbiblio->{damagedcount} = $itemdamaged_count;
1521 $oldbiblio->{intransitcount} = $item_in_transit_count;
1522 $oldbiblio->{orderedcount} = $ordered_count;
1523 $oldbiblio->{isbn} =~
1524 s/-//g; # deleting - in isbn to enable amazon content
1525 push( @newresults, $oldbiblio );
1530 #----------------------------------------------------------------------
1532 # Non-Zebra GetRecords#
1533 #----------------------------------------------------------------------
1537 NZgetRecords has the same API as zera getRecords, even if some parameters are not managed
1543 $query, $simple_query, $sort_by_ref, $servers_ref,
1544 $results_per_page, $offset, $expanded_facet, $branches,
1547 warn "query =$query" if $DEBUG;
1548 my $result = NZanalyse($query);
1549 warn "results =$result" if $DEBUG;
1551 NZorder( $result, @$sort_by_ref[0], $results_per_page, $offset ),
1557 NZanalyse : get a CQL string as parameter, and returns a list of biblionumber;title,biblionumber;title,...
1558 the list is built from an inverted index in the nozebra SQL table
1559 note that title is here only for convenience : the sorting will be very fast when requested on title
1560 if the sorting is requested on something else, we will have to reread all results, and that may be longer.
1565 my ( $string, $server ) = @_;
1566 # warn "---------" if $DEBUG;
1567 warn " NZanalyse" if $DEBUG;
1568 # warn "---------" if $DEBUG;
1570 # $server contains biblioserver or authorities, depending on what we search on.
1571 #warn "querying : $string on $server";
1572 $server = 'biblioserver' unless $server;
1574 # if we have a ", replace the content to discard temporarily any and/or/not inside
1576 if ( $string =~ /"/ ) {
1577 $string =~ s/"(.*?)"/__X__/;
1579 warn "commacontent : $commacontent" if $DEBUG;
1582 # split the query string in 3 parts : X AND Y means : $left="X", $operand="AND" and $right="Y"
1583 # then, call again NZanalyse with $left and $right
1584 # (recursive until we find a leaf (=> something without and/or/not)
1585 # delete repeated operator... Would then go in infinite loop
1586 while ( $string =~ s/( and| or| not| AND| OR| NOT)\1/$1/g ) {
1589 #process parenthesis before.
1590 if ( $string =~ /^\s*\((.*)\)(( and | or | not | AND | OR | NOT )(.*))?/ ) {
1593 my $operator = lc($3); # FIXME: and/or/not are operators, not operands
1595 "dealing w/parenthesis before recursive sub call. left :$left operator:$operator right:$right"
1597 my $leftresult = NZanalyse( $left, $server );
1599 my $rightresult = NZanalyse( $right, $server );
1601 # OK, we have the results for right and left part of the query
1602 # depending of operand, intersect, union or exclude both lists
1603 # to get a result list
1604 if ( $operator eq ' and ' ) {
1605 return NZoperatorAND($leftresult,$rightresult);
1607 elsif ( $operator eq ' or ' ) {
1609 # just merge the 2 strings
1610 return $leftresult . $rightresult;
1612 elsif ( $operator eq ' not ' ) {
1613 return NZoperatorNOT($leftresult,$rightresult);
1617 # this error is impossible, because of the regexp that isolate the operand, but just in case...
1621 warn "string :" . $string if $DEBUG;
1625 if ($string =~ /(.*?)( and | or | not | AND | OR | NOT )(.*)/) {
1628 $operator = lc($2); # FIXME: and/or/not are operators, not operands
1630 warn "no parenthesis. left : $left operator: $operator right: $right"
1633 # it's not a leaf, we have a and/or/not
1636 # reintroduce comma content if needed
1637 $right =~ s/__X__/"$commacontent"/ if $commacontent;
1638 $left =~ s/__X__/"$commacontent"/ if $commacontent;
1639 warn "node : $left / $operator / $right\n" if $DEBUG;
1640 my $leftresult = NZanalyse( $left, $server );
1641 my $rightresult = NZanalyse( $right, $server );
1642 warn " leftresult : $leftresult" if $DEBUG;
1643 warn " rightresult : $rightresult" if $DEBUG;
1644 # OK, we have the results for right and left part of the query
1645 # depending of operand, intersect, union or exclude both lists
1646 # to get a result list
1647 if ( $operator eq ' and ' ) {
1649 return NZoperatorAND($leftresult,$rightresult);
1651 elsif ( $operator eq ' or ' ) {
1653 # just merge the 2 strings
1654 return $leftresult . $rightresult;
1656 elsif ( $operator eq ' not ' ) {
1657 return NZoperatorNOT($leftresult,$rightresult);
1661 # this error is impossible, because of the regexp that isolate the operand, but just in case...
1662 die "error : operand unknown : $operator for $string";
1665 # it's a leaf, do the real SQL query and return the result
1668 $string =~ s/__X__/"$commacontent"/ if $commacontent;
1669 $string =~ s/-|\.|\?|,|;|!|'|\(|\)|\[|\]|{|}|"|&|\+|\*|\// /g;
1670 #remove trailing blank at the beginning
1672 warn "leaf:$string" if $DEBUG;
1674 # parse the string in in operator/operand/value again
1678 if ($string =~ /(.*)(>=|<=)(.*)/) {
1685 # warn "handling leaf... left:$left operator:$operator right:$right"
1687 unless ($operator) {
1688 if ($string =~ /(.*)(>|<|=)(.*)/) {
1693 "handling unless (operator)... left:$left operator:$operator right:$right"
1701 # strip adv, zebra keywords, currently not handled in nozebra: wrdl, ext, phr...
1704 # automatic replace for short operators
1705 $left = 'title' if $left =~ '^ti$';
1706 $left = 'author' if $left =~ '^au$';
1707 $left = 'publisher' if $left =~ '^pb$';
1708 $left = 'subject' if $left =~ '^su$';
1709 $left = 'koha-Auth-Number' if $left =~ '^an$';
1710 $left = 'keyword' if $left =~ '^kw$';
1711 warn "handling leaf... left:$left operator:$operator right:$right" if $DEBUG;
1712 if ( $operator && $left ne 'keyword' ) {
1714 #do a specific search
1715 my $dbh = C4::Context->dbh;
1716 $operator = 'LIKE' if $operator eq '=' and $right =~ /%/;
1719 "SELECT biblionumbers,value FROM nozebra WHERE server=? AND indexname=? AND value $operator ?"
1721 warn "$left / $operator / $right\n" if $DEBUG;
1723 # split each word, query the DB and build the biblionumbers result
1724 #sanitizing leftpart
1725 $left =~ s/^\s+|\s+$//;
1726 foreach ( split / /, $right ) {
1728 $_ =~ s/^\s+|\s+$//;
1730 warn "EXECUTE : $server, $left, $_" if $DEBUG;
1731 $sth->execute( $server, $left, $_ )
1732 or warn "execute failed: $!";
1733 while ( my ( $line, $value ) = $sth->fetchrow ) {
1735 # if we are dealing with a numeric value, use only numeric results (in case of >=, <=, > or <)
1736 # otherwise, fill the result
1737 $biblionumbers .= $line
1738 unless ( $right =~ /^\d+$/ && $value =~ /\D/ );
1739 warn "result : $value "
1740 . ( $right =~ /\d/ ) . "=="
1741 . ( $value =~ /\D/?$line:"" ) if $DEBUG; #= $line";
1744 # do a AND with existing list if there is one, otherwise, use the biblionumbers list as 1st result list
1746 warn "NZAND" if $DEBUG;
1747 $results = NZoperatorAND($biblionumbers,$results);
1750 $results = $biblionumbers;
1756 #do a complete search (all indexes), if index='kw' do complete search too.
1757 my $dbh = C4::Context->dbh;
1760 "SELECT biblionumbers FROM nozebra WHERE server=? AND value LIKE ?"
1763 # split each word, query the DB and build the biblionumbers result
1764 foreach ( split / /, $string ) {
1765 next if C4::Context->stopwords->{ uc($_) }; # skip if stopword
1766 warn "search on all indexes on $_" if $DEBUG;
1769 $sth->execute( $server, $_ );
1770 while ( my $line = $sth->fetchrow ) {
1771 $biblionumbers .= $line;
1774 # do a AND with existing list if there is one, otherwise, use the biblionumbers list as 1st result list
1776 $results = NZoperatorAND($biblionumbers,$results);
1779 warn "NEW RES for $_ = $biblionumbers" if $DEBUG;
1780 $results = $biblionumbers;
1784 warn "return : $results for LEAF : $string" if $DEBUG;
1787 warn "---------\nLeave NZanalyse\n---------" if $DEBUG;
1791 my ($rightresult, $leftresult)=@_;
1793 my @leftresult = split /;/, $leftresult;
1794 warn " @leftresult / $rightresult \n" if $DEBUG;
1796 # my @rightresult = split /;/,$leftresult;
1799 # parse the left results, and if the biblionumber exist in the right result, save it in finalresult
1800 # the result is stored twice, to have the same weight for AND than OR.
1801 # example : TWO : 61,61,64,121 (two is twice in the biblio #61) / TOWER : 61,64,130
1802 # result : 61,61,61,61,64,64 for two AND tower : 61 has more weight than 64
1803 foreach (@leftresult) {
1806 ( $value, $countvalue ) = ( $1, $2 ) if ($value=~/(.*)-(\d+)$/);
1807 if ( $rightresult =~ /\Q$value\E-(\d+);/ ) {
1808 $countvalue = ( $1 > $countvalue ? $countvalue : $1 );
1810 "$value-$countvalue;$value-$countvalue;";
1813 warn "NZAND DONE : $finalresult \n" if $DEBUG;
1814 return $finalresult;
1818 my ($rightresult, $leftresult)=@_;
1819 return $rightresult.$leftresult;
1823 my ($leftresult, $rightresult)=@_;
1825 my @leftresult = split /;/, $leftresult;
1827 # my @rightresult = split /;/,$leftresult;
1829 foreach (@leftresult) {
1831 $value=$1 if $value=~m/(.*)-\d+$/;
1832 unless ($rightresult =~ "$value-") {
1833 $finalresult .= "$_;";
1836 return $finalresult;
1841 $finalresult = NZorder($biblionumbers, $ordering,$results_per_page,$offset);
1848 my ( $biblionumbers, $ordering, $results_per_page, $offset ) = @_;
1849 warn "biblionumbers = $biblionumbers and ordering = $ordering\n" if $DEBUG;
1851 # order title asc by default
1852 # $ordering = '1=36 <i' unless $ordering;
1853 $results_per_page = 20 unless $results_per_page;
1854 $offset = 0 unless $offset;
1855 my $dbh = C4::Context->dbh;
1858 # order by POPULARITY
1860 if ( $ordering =~ /popularity/ ) {
1864 # popularity is not in MARC record, it's builded from a specific query
1866 $dbh->prepare("select sum(issues) from items where biblionumber=?");
1867 foreach ( split /;/, $biblionumbers ) {
1868 my ( $biblionumber, $title ) = split /,/, $_;
1869 $result{$biblionumber} = GetMarcBiblio($biblionumber);
1870 $sth->execute($biblionumber);
1871 my $popularity = $sth->fetchrow || 0;
1873 # hint : the key is popularity.title because we can have
1874 # many results with the same popularity. In this cas, sub-ordering is done by title
1875 # we also have biblionumber to avoid bug for 2 biblios with the same title & popularity
1876 # (un-frequent, I agree, but we won't forget anything that way ;-)
1877 $popularity{ sprintf( "%10d", $popularity ) . $title
1878 . $biblionumber } = $biblionumber;
1881 # sort the hash and return the same structure as GetRecords (Zebra querying)
1884 if ( $ordering eq 'popularity_dsc' ) { # sort popularity DESC
1885 foreach my $key ( sort { $b cmp $a } ( keys %popularity ) ) {
1886 $result_hash->{'RECORDS'}[ $numbers++ ] =
1887 $result{ $popularity{$key} }->as_usmarc();
1890 else { # sort popularity ASC
1891 foreach my $key ( sort ( keys %popularity ) ) {
1892 $result_hash->{'RECORDS'}[ $numbers++ ] =
1893 $result{ $popularity{$key} }->as_usmarc();
1896 my $finalresult = ();
1897 $result_hash->{'hits'} = $numbers;
1898 $finalresult->{'biblioserver'} = $result_hash;
1899 return $finalresult;
1905 elsif ( $ordering =~ /author/ ) {
1907 foreach ( split /;/, $biblionumbers ) {
1908 my ( $biblionumber, $title ) = split /,/, $_;
1909 my $record = GetMarcBiblio($biblionumber);
1911 if ( C4::Context->preference('marcflavour') eq 'UNIMARC' ) {
1912 $author = $record->subfield( '200', 'f' );
1913 $author = $record->subfield( '700', 'a' ) unless $author;
1916 $author = $record->subfield( '100', 'a' );
1919 # hint : the result is sorted by title.biblionumber because we can have X biblios with the same title
1920 # and we don't want to get only 1 result for each of them !!!
1921 $result{ $author . $biblionumber } = $record;
1924 # sort the hash and return the same structure as GetRecords (Zebra querying)
1927 if ( $ordering eq 'author_za' ) { # sort by author desc
1928 foreach my $key ( sort { $b cmp $a } ( keys %result ) ) {
1929 $result_hash->{'RECORDS'}[ $numbers++ ] =
1930 $result{$key}->as_usmarc();
1933 else { # sort by author ASC
1934 foreach my $key ( sort ( keys %result ) ) {
1935 $result_hash->{'RECORDS'}[ $numbers++ ] =
1936 $result{$key}->as_usmarc();
1939 my $finalresult = ();
1940 $result_hash->{'hits'} = $numbers;
1941 $finalresult->{'biblioserver'} = $result_hash;
1942 return $finalresult;
1945 # ORDER BY callnumber
1948 elsif ( $ordering =~ /callnumber/ ) {
1950 foreach ( split /;/, $biblionumbers ) {
1951 my ( $biblionumber, $title ) = split /,/, $_;
1952 my $record = GetMarcBiblio($biblionumber);
1954 my ( $callnumber_tag, $callnumber_subfield ) =
1955 GetMarcFromKohaField( $dbh, 'items.itemcallnumber' );
1956 ( $callnumber_tag, $callnumber_subfield ) =
1957 GetMarcFromKohaField('biblioitems.callnumber')
1958 unless $callnumber_tag;
1959 if ( C4::Context->preference('marcflavour') eq 'UNIMARC' ) {
1960 $callnumber = $record->subfield( '200', 'f' );
1963 $callnumber = $record->subfield( '100', 'a' );
1966 # hint : the result is sorted by title.biblionumber because we can have X biblios with the same title
1967 # and we don't want to get only 1 result for each of them !!!
1968 $result{ $callnumber . $biblionumber } = $record;
1971 # sort the hash and return the same structure as GetRecords (Zebra querying)
1974 if ( $ordering eq 'call_number_dsc' ) { # sort by title desc
1975 foreach my $key ( sort { $b cmp $a } ( keys %result ) ) {
1976 $result_hash->{'RECORDS'}[ $numbers++ ] =
1977 $result{$key}->as_usmarc();
1980 else { # sort by title ASC
1981 foreach my $key ( sort { $a cmp $b } ( keys %result ) ) {
1982 $result_hash->{'RECORDS'}[ $numbers++ ] =
1983 $result{$key}->as_usmarc();
1986 my $finalresult = ();
1987 $result_hash->{'hits'} = $numbers;
1988 $finalresult->{'biblioserver'} = $result_hash;
1989 return $finalresult;
1991 elsif ( $ordering =~ /pubdate/ ) { #pub year
1993 foreach ( split /;/, $biblionumbers ) {
1994 my ( $biblionumber, $title ) = split /,/, $_;
1995 my $record = GetMarcBiblio($biblionumber);
1996 my ( $publicationyear_tag, $publicationyear_subfield ) =
1997 GetMarcFromKohaField( 'biblioitems.publicationyear', '' );
1998 my $publicationyear =
1999 $record->subfield( $publicationyear_tag,
2000 $publicationyear_subfield );
2002 # hint : the result is sorted by title.biblionumber because we can have X biblios with the same title
2003 # and we don't want to get only 1 result for each of them !!!
2004 $result{ $publicationyear . $biblionumber } = $record;
2007 # sort the hash and return the same structure as GetRecords (Zebra querying)
2010 if ( $ordering eq 'pubdate_dsc' ) { # sort by pubyear desc
2011 foreach my $key ( sort { $b cmp $a } ( keys %result ) ) {
2012 $result_hash->{'RECORDS'}[ $numbers++ ] =
2013 $result{$key}->as_usmarc();
2016 else { # sort by pub year ASC
2017 foreach my $key ( sort ( keys %result ) ) {
2018 $result_hash->{'RECORDS'}[ $numbers++ ] =
2019 $result{$key}->as_usmarc();
2022 my $finalresult = ();
2023 $result_hash->{'hits'} = $numbers;
2024 $finalresult->{'biblioserver'} = $result_hash;
2025 return $finalresult;
2031 elsif ( $ordering =~ /title/ ) {
2033 # the title is in the biblionumbers string, so we just need to build a hash, sort it and return
2035 foreach ( split /;/, $biblionumbers ) {
2036 my ( $biblionumber, $title ) = split /,/, $_;
2038 # hint : the result is sorted by title.biblionumber because we can have X biblios with the same title
2039 # and we don't want to get only 1 result for each of them !!!
2040 # hint & speed improvement : we can order without reading the record
2041 # so order, and read records only for the requested page !
2042 $result{ $title . $biblionumber } = $biblionumber;
2045 # sort the hash and return the same structure as GetRecords (Zebra querying)
2048 if ( $ordering eq 'title_az' ) { # sort by title desc
2049 foreach my $key ( sort ( keys %result ) ) {
2050 $result_hash->{'RECORDS'}[ $numbers++ ] = $result{$key};
2053 else { # sort by title ASC
2054 foreach my $key ( sort { $b cmp $a } ( keys %result ) ) {
2055 $result_hash->{'RECORDS'}[ $numbers++ ] = $result{$key};
2059 # limit the $results_per_page to result size if it's more
2060 $results_per_page = $numbers - 1 if $numbers < $results_per_page;
2062 # for the requested page, replace biblionumber by the complete record
2063 # speed improvement : avoid reading too much things
2065 my $counter = $offset ;
2066 $counter <= $offset + $results_per_page ;
2070 $result_hash->{'RECORDS'}[$counter] =
2071 GetMarcBiblio( $result_hash->{'RECORDS'}[$counter] )->as_usmarc;
2073 my $finalresult = ();
2074 $result_hash->{'hits'} = $numbers;
2075 $finalresult->{'biblioserver'} = $result_hash;
2076 return $finalresult;
2083 # we need 2 hashes to order by ranking : the 1st one to count the ranking, the 2nd to order by ranking
2086 foreach ( split /;/, $biblionumbers ) {
2087 my ( $biblionumber, $title ) = split /,/, $_;
2088 $title =~ /(.*)-(\d)/;
2093 # note that we + the ranking because ranking is calculated on weight of EACH term requested.
2094 # if we ask for "two towers", and "two" has weight 2 in biblio N, and "towers" has weight 4 in biblio N
2095 # biblio N has ranking = 6
2096 $count_ranking{$biblionumber} += $ranking;
2099 # build the result by "inverting" the count_ranking hash
2100 # hing : as usual, we don't order by ranking only, to avoid having only 1 result for each rank. We build an hash on concat(ranking,biblionumber) instead
2102 foreach ( keys %count_ranking ) {
2103 $result{ sprintf( "%10d", $count_ranking{$_} ) . '-' . $_ } = $_;
2106 # sort the hash and return the same structure as GetRecords (Zebra querying)
2109 foreach my $key ( sort { $b cmp $a } ( keys %result ) ) {
2110 $result_hash->{'RECORDS'}[ $numbers++ ] = $result{$key};
2113 # limit the $results_per_page to result size if it's more
2114 $results_per_page = $numbers - 1 if $numbers < $results_per_page;
2116 # for the requested page, replace biblionumber by the complete record
2117 # speed improvement : avoid reading too much things
2119 my $counter = $offset ;
2120 $counter <= $offset + $results_per_page ;
2124 $result_hash->{'RECORDS'}[$counter] =
2125 GetMarcBiblio( $result_hash->{'RECORDS'}[$counter] )->as_usmarc
2126 if $result_hash->{'RECORDS'}[$counter];
2128 my $finalresult = ();
2129 $result_hash->{'hits'} = $numbers;
2130 $finalresult->{'biblioserver'} = $result_hash;
2131 return $finalresult;
2137 ($countchanged,$listunchanged) = ModBiblios($listbiblios, $tagsubfield,$initvalue,$targetvalue,$test);
2139 this function changes all the values $initvalue in subfield $tag$subfield in any record in $listbiblios
2140 test parameter if set donot perform change to records in database.
2146 * $listbiblios is an array ref to marcrecords to be changed
2147 * $tagsubfield is the reference of the subfield to change.
2148 * $initvalue is the value to search the record for
2149 * $targetvalue is the value to set the subfield to
2150 * $test is to be set only not to perform changes in database.
2152 =item C<Output arg:>
2153 * $countchanged counts all the changes performed.
2154 * $listunchanged contains the list of all the biblionumbers of records unchanged.
2156 =item C<usage in the script:>
2160 my ($countchanged, $listunchanged) = EditBiblios($results->{RECORD}, $tagsubfield,$initvalue,$targetvalue);;
2161 #If one wants to display unchanged records, you should get biblios foreach @$listunchanged
2162 $template->param(countchanged => $countchanged, loopunchanged=>$listunchanged);
2167 my ( $listbiblios, $tagsubfield, $initvalue, $targetvalue, $test ) = @_;
2170 my ( $tag, $subfield ) = ( $1, $2 )
2171 if ( $tagsubfield =~ /^(\d{1,3})([a-z0-9A-Z@])?$/ );
2172 if ( ( length($tag) < 3 ) && $subfield =~ /0-9/ ) {
2173 $tag = $tag . $subfield;
2176 my ( $bntag, $bnsubf ) = GetMarcFromKohaField('biblio.biblionumber');
2177 my ( $itemtag, $itemsubf ) = GetMarcFromKohaField('items.itemnumber');
2178 if ($tag eq $itemtag) {
2179 # do not allow the embedded item tag to be
2181 warn "Attempting to edit item tag via C4::Search::ModBiblios -- not allowed";
2184 foreach my $usmarc (@$listbiblios) {
2186 $record = eval { MARC::Record->new_from_usmarc($usmarc) };
2190 # usmarc is not a valid usmarc May be a biblionumber
2191 # FIXME - sorry, please let's figure out whether
2192 # this function is to be passed a list of
2193 # record numbers or a list of MARC::Record
2194 # objects. The former is probably better
2195 # because the MARC records supplied by Zebra
2196 # may be not current.
2197 $record = GetMarcBiblio($usmarc);
2198 $biblionumber = $usmarc;
2201 if ( $bntag >= 010 ) {
2202 $biblionumber = $record->subfield( $bntag, $bnsubf );
2205 $biblionumber = $record->field($bntag)->data;
2209 #GetBiblionumber is to be written.
2210 #Could be replaced by TransformMarcToKoha (But Would be longer)
2211 if ( $record->field($tag) ) {
2213 foreach my $field ( $record->field($tag) ) {
2216 $field->delete_subfield(
2217 'code' => $subfield,
2218 'match' => qr($initvalue)
2224 $field->update( $subfield, $targetvalue )
2229 if ( $tag >= 010 ) {
2230 if ( $field->delete_field($field) ) {
2236 $field->data = $targetvalue
2237 if ( $field->data =~ qr($initvalue) );
2242 # warn $record->as_formatted;
2244 ModBiblio( $record, $biblionumber,
2245 GetFrameworkCode($biblionumber) )
2249 push @unmatched, $biblionumber;
2253 push @unmatched, $biblionumber;
2256 return ( $countmatched, \@unmatched );
2259 END { } # module clean-up code here (global destructor)
2266 Koha Developement team <info@koha.org>