3 # Copyright 2000-2002 Katipo Communications
5 # This file is part of Koha.
7 # Koha is free software; you can redistribute it and/or modify it under the
8 # terms of the GNU General Public License as published by the Free Software
9 # Foundation; either version 2 of the License, or (at your option) any later
12 # Koha is distributed in the hope that it will be useful, but WITHOUT ANY
13 # WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
14 # A PARTICULAR PURPOSE. See the GNU General Public License for more details.
16 # You should have received a copy of the GNU General Public License along with
17 # Koha; if not, write to the Free Software Foundation, Inc., 59 Temple Place,
18 # Suite 330, Boston, MA 02111-1307 USA
26 use MARC::File::USMARC;
31 use C4::Log; # logaction
33 use vars qw($VERSION @ISA @EXPORT);
35 # set the version for version checking
36 $VERSION = do { my @v = '$Revision$' =~ /\d+/g; shift(@v).".".join( "_", map { sprintf "%03d", $_ } @v ); };
38 @ISA = qw( Exporter );
42 # to add biblios or items
43 push @EXPORT, qw( &AddBiblio &AddItem );
51 &GetBiblioItemByBiblioNumber
52 &GetBiblioFromItemNumber
71 &GetItemsByBiblioitemnumber
72 &GetItemnumberFromBarcode
76 &GetAuthorisedValueDesc
80 &GetPublisherNameFromIsbn
92 &ModItemInMarconefield
103 # those functions are exported but should not be used
104 # they are usefull is few circumstances, so are exported.
105 # but don't use them unless you're a core developer ;-)
116 &TransformHtmlToMarc2
119 &PrepareItemrecordDisplay
126 C4::Biblio - cataloging management functions
130 Biblio.pm contains functions for managing storage and editing of bibliographic data within Koha. Most of the functions in this module are used for cataloging records: adding, editing, or removing biblios, biblioitems, or items. Koha's stores bibliographic information in three places:
134 =item 1. in the biblio,biblioitems,items, etc tables, which are limited to a one-to-one mapping to underlying MARC data
136 =item 2. as raw MARC in the Zebra index and storage engine
138 =item 3. as raw MARC the biblioitems.marc and biblioitems.marcxml
142 In the 3.0 version of Koha, the authoritative record-level information is in biblioitems.marcxml
144 Because the data isn't completely normalized there's a chance for information to get out of sync. The design choice to go with a un-normalized schema was driven by performance and stability concerns. However, if this occur, it can be considered as a bug : The API is (or should be) complete & the only entry point for all biblio/items managements.
148 =item 1. Compared with MySQL, Zebra is slow to update an index for small data changes -- especially for proc-intensive operations like circulation
150 =item 2. Zebra's index has been known to crash and a backup of the data is necessary to rebuild it in such cases
154 Because of this design choice, the process of managing storage and editing is a bit convoluted. Historically, Biblio.pm's grown to an unmanagable size and as a result we have several types of functions currently:
158 =item 1. Add*/Mod*/Del*/ - high-level external functions suitable for being called from external scripts to manage the collection
160 =item 2. _koha_* - low-level internal functions for managing the koha tables
162 =item 3. Marc management function : as the MARC record is stored in biblioitems.marc(xml), some subs dedicated to it's management are in this package. They should be used only internally by Biblio.pm, the only official entry points being AddBiblio, AddItem, ModBiblio, ModItem.
164 =item 4. Zebra functions used to update the Zebra index
166 =item 5. internal helper functions such as char_decode, checkitems, etc. Some of these probably belong in Koha.pm
170 The MARC record (in biblioitems.marcxml) contains the complete marc record, including items. It also contains the biblionumber. That is the reason why it is not stored directly by AddBiblio, with all other fields . To save a biblio, we need to :
174 =item 1. save datas in biblio and biblioitems table, that gives us a biblionumber and a biblioitemnumber
176 =item 2. add the biblionumber and biblioitemnumber into the MARC records
178 =item 3. save the marc record
182 When dealing with items, we must :
186 =item 1. save the item in items table, that gives us an itemnumber
188 =item 2. add the itemnumber to the item MARC field
190 =item 3. overwrite the MARC record (with the added item) into biblioitems.marc(xml)
192 When modifying a biblio or an item, the behaviour is quite similar.
196 =head1 EXPORTED FUNCTIONS
202 ($biblionumber,$biblioitemnumber) = AddBiblio($record,$frameworkcode);
203 Exported function (core API) for adding a new biblio to koha.
210 my ( $record, $frameworkcode ) = @_;
212 my $biblioitemnumber;
213 my $dbh = C4::Context->dbh;
214 # transform the data into koha-table style data
215 my $olddata = TransformMarcToKoha( $dbh, $record, $frameworkcode );
216 $biblionumber = _koha_add_biblio( $dbh, $olddata, $frameworkcode );
217 $olddata->{'biblionumber'} = $biblionumber;
218 $biblioitemnumber = _koha_add_biblioitem( $dbh, $olddata );
220 # we must add bibnum and bibitemnum in MARC::Record...
221 # we build the new field with biblionumber and biblioitemnumber
222 # we drop the original field
223 # we add the new builded field.
224 ( my $biblio_tag, my $biblio_subfield ) = GetMarcFromKohaField("biblio.biblionumber",$frameworkcode);
225 ( my $biblioitem_tag, my $biblioitem_subfield ) = GetMarcFromKohaField("biblioitems.biblioitemnumber",$frameworkcode);
229 # biblionumber & biblioitemnumber are in different fields
230 if ( $biblio_tag != $biblioitem_tag ) {
232 # deal with biblionumber
233 if ( $biblio_tag < 10 ) {
234 $newfield = MARC::Field->new( $biblio_tag, $biblionumber );
238 MARC::Field->new( $biblio_tag, '', '',
239 "$biblio_subfield" => $biblionumber );
242 # drop old field and create new one...
243 my $old_field = $record->field($biblio_tag);
244 $record->delete_field($old_field);
245 $record->append_fields($newfield);
247 # deal with biblioitemnumber
248 if ( $biblioitem_tag < 10 ) {
249 $newfield = MARC::Field->new( $biblioitem_tag, $biblioitemnumber, );
253 MARC::Field->new( $biblioitem_tag, '', '',
254 "$biblioitem_subfield" => $biblioitemnumber, );
256 # drop old field and create new one...
257 $old_field = $record->field($biblioitem_tag);
258 $record->delete_field($old_field);
259 $record->insert_fields_ordered($newfield);
261 # biblionumber & biblioitemnumber are in the same field (can't be <10 as fields <10 have only 1 value)
264 my $newfield = MARC::Field->new(
266 "$biblio_subfield" => $biblionumber,
267 "$biblioitem_subfield" => $biblioitemnumber
270 # drop old field and create new one...
271 my $old_field = $record->field($biblio_tag);
272 $record->delete_field($old_field);
273 $record->insert_fields_ordered($newfield);
277 $biblionumber = ModBiblioMarc( $record, $biblionumber, $frameworkcode );
279 &logaction(C4::Context->userenv->{'number'},"CATALOGUING","ADD",$biblionumber,"biblio")
280 if C4::Context->preference("CataloguingLog");
282 return ( $biblionumber, $biblioitemnumber );
289 $biblionumber = AddItem( $record, $biblionumber)
290 Exported function (core API) for adding a new item to Koha
297 my ( $record, $biblionumber ) = @_;
298 my $dbh = C4::Context->dbh;
301 my $frameworkcode = GetFrameworkCode( $biblionumber );
302 my $item = &TransformMarcToKoha( $dbh, $record, $frameworkcode );
304 # needs old biblionumber and biblioitemnumber
305 $item->{'biblionumber'} = $biblionumber;
308 "select biblioitemnumber,itemtype from biblioitems where biblionumber=?"
310 $sth->execute( $item->{'biblionumber'} );
312 ( $item->{'biblioitemnumber'}, $itemtype ) = $sth->fetchrow;
315 "select notforloan from itemtypes where itemtype='$itemtype'");
317 my $notforloan = $sth->fetchrow;
318 ##Change the notforloan field if $notforloan found
319 if ( $notforloan > 0 ) {
320 $item->{'notforloan'} = $notforloan;
321 &MARCitemchange( $record, "items.notforloan", $notforloan );
323 if ( !$item->{'dateaccessioned'} || $item->{'dateaccessioned'} eq '' ) {
326 my ( $sec, $min, $hour, $mday, $mon, $year, $wday, $yday, $isdst ) =
331 "$year-" . sprintf( "%0.2d", $mon ) . "-" . sprintf( "%0.2d", $mday );
332 $item->{'dateaccessioned'} = $date;
333 &MARCitemchange( $record, "items.dateaccessioned", $date );
335 my ( $itemnumber, $error ) =
336 &_koha_new_items( $dbh, $item, $item->{barcode} );
338 # add itemnumber to MARC::Record before adding the item.
339 $sth = $dbh->prepare(
340 "select tagfield,tagsubfield from marc_subfield_structure where frameworkcode=? and kohafield=?"
342 &TransformKohaToMarcOneField( $sth, $record, "items.itemnumber", $itemnumber,
346 &AddItemInMarc( $record, $item->{'biblionumber'},$frameworkcode );
348 &logaction(C4::Context->userenv->{'number'},"CATALOGUING","ADD",$itemnumber,"item")
349 if C4::Context->preference("CataloguingLog");
351 return ($item->{biblionumber}, $item->{biblioitemnumber},$itemnumber);
356 ModBiblio( $record,$biblionumber,$frameworkcode);
357 Exported function (core API) to modify a biblio
362 my ( $record, $biblionumber, $frameworkcode ) = @_;
363 if (C4::Context->preference("CataloguingLog")) {
364 my $newrecord = GetMarcBiblio($biblionumber);
365 &logaction(C4::Context->userenv->{'number'},"CATALOGUING","MODIFY",$biblionumber,"BEFORE=>".$newrecord->as_formatted);
368 my $dbh = C4::Context->dbh;
370 $frameworkcode = "" unless $frameworkcode;
372 # get the items before and append them to the biblio before updating the record, atm we just have the biblio
373 my ( $itemtag, $itemsubfield ) = GetMarcFromKohaField("items.itemnumber",$frameworkcode);
374 my $oldRecord = GetMarcBiblio( $biblionumber );
376 # parse each item, and, for an unknown reason, re-encode each subfield
377 # if you don't do that, the record will have encoding mixed
378 # and the biblio will be re-encoded.
379 # strange, I (Paul P.) searched more than 1 day to understand what happends
380 # but could only solve the problem this way...
381 my @fields = $oldRecord->field( $itemtag );
382 foreach my $fielditem ( @fields ){
384 foreach ($fielditem->subfields()) {
386 $field->add_subfields(Encode::encode('utf-8',$_->[0]) => Encode::encode('utf-8',$_->[1]));
388 $field = MARC::Field->new("$itemtag",'','',Encode::encode('utf-8',$_->[0]) => Encode::encode('utf-8',$_->[1]));
391 $record->append_fields($field);
394 # adding biblionumber
395 my ($tag_biblionumber, $subfield_biblionumber) = GetMarcFromKohaField('biblio.biblionumber',$frameworkcode);
396 $record->append_fields(
398 $tag_biblionumber,'','',$subfield_biblionumber => $biblionumber
400 ) unless ($record->subfield($tag_biblionumber,$subfield_biblionumber));
402 # update the MARC record (that now contains biblio and items) with the new record data
403 &ModBiblioMarc( $record, $biblionumber, $frameworkcode );
405 # load the koha-table data object
406 my $oldbiblio = TransformMarcToKoha( $dbh, $record, $frameworkcode );
408 # modify the other koha tables
409 _koha_modify_biblio( $dbh, $oldbiblio );
410 _koha_modify_biblioitem( $dbh, $oldbiblio );
418 Exported function (core API) for modifying an item in Koha.
425 my ( $record, $biblionumber, $itemnumber, $delete, $new_item_hashref )
429 &logaction(C4::Context->userenv->{'number'},"CATALOGUING","MODIFY",$itemnumber,$record->as_formatted)
430 if C4::Context->preference("CataloguingLog");
432 my $dbh = C4::Context->dbh;
434 # if we have a MARC record, we're coming from cataloging and so
435 # we do the whole routine: update the MARC and zebra, then update the koha
438 my $frameworkcode = GetFrameworkCode( $biblionumber );
439 ModItemInMarc( $record, $biblionumber, $itemnumber, $frameworkcode );
440 my $olditem = TransformMarcToKoha( $dbh, $record, $frameworkcode );
441 _koha_modify_item( $dbh, $olditem );
442 return $biblionumber;
445 # otherwise, we're just looking to modify something quickly
446 # (like a status) so we just update the koha tables
447 elsif ($new_item_hashref) {
448 _koha_modify_item( $dbh, $new_item_hashref );
452 sub ModItemTransfer {
453 my ( $itemnumber, $frombranch, $tobranch ) = @_;
455 my $dbh = C4::Context->dbh;
457 #new entry in branchtransfers....
458 my $sth = $dbh->prepare(
459 "INSERT INTO branchtransfers (itemnumber, frombranch, datesent, tobranch)
460 VALUES (?, ?, now(), ?)");
461 $sth->execute($itemnumber, $frombranch, $tobranch);
462 #update holdingbranch in items .....
464 "UPDATE items set holdingbranch = ? WHERE items.itemnumber = ?");
465 $sth->execute($tobranch,$itemnumber);
466 &ModDateLastSeen($itemnumber);
467 $sth = $dbh->prepare(
468 "SELECT biblionumber FROM items WHERE itemnumber=?"
470 $sth->execute($itemnumber);
471 while ( my ( $biblionumber ) = $sth->fetchrow ) {
472 &ModItemInMarconefield( $biblionumber, $itemnumber,
473 'items.holdingbranch', $tobranch );
478 =head2 ModBiblioframework
480 ModBiblioframework($biblionumber,$frameworkcode);
481 Exported function to modify a biblio framework
485 sub ModBiblioframework {
486 my ( $biblionumber, $frameworkcode ) = @_;
487 my $dbh = C4::Context->dbh;
488 my $sth = $dbh->prepare(
489 "UPDATE biblio SET frameworkcode=? WHERE biblionumber=$biblionumber"
491 $sth->execute($frameworkcode);
495 =head2 ModItemInMarconefield
499 modify only 1 field in a MARC item (mainly used for holdingbranch, but could also be used for status modif - moving a book to "lost" on a long overdu for example)
500 &ModItemInMarconefield( $biblionumber, $itemnumber, $itemfield, $newvalue )
506 sub ModItemInMarconefield {
507 my ( $biblionumber, $itemnumber, $itemfield, $newvalue ) = @_;
508 my $dbh = C4::Context->dbh;
509 if ( !defined $newvalue ) {
513 my $record = GetMarcItem( $biblionumber, $itemnumber );
514 my ($tagfield, $tagsubfield) = GetMarcFromKohaField( $itemfield,'');
515 if ($tagfield && $tagsubfield) {
516 my $tag = $record->field($tagfield);
518 # my $tagsubs = $record->field($tagfield)->subfield($tagsubfield);
519 $tag->update( $tagsubfield => $newvalue );
520 $record->delete_field($tag);
521 $record->insert_fields_ordered($tag);
522 &ModItemInMarc( $record, $biblionumber, $itemnumber, 0 );
531 &ModItemInMarc( $record, $biblionumber, $itemnumber )
538 my ( $ItemRecord, $biblionumber, $itemnumber, $frameworkcode) = @_;
539 my $dbh = C4::Context->dbh;
541 # get complete MARC record & replace the item field by the new one
542 my $completeRecord = GetMarcBiblio($biblionumber);
543 my ($itemtag,$itemsubfield) = GetMarcFromKohaField("items.itemnumber",$frameworkcode);
544 my $itemField = $ItemRecord->field($itemtag);
545 my @items = $completeRecord->field($itemtag);
547 if ($_->subfield($itemsubfield) eq $itemnumber) {
548 # $completeRecord->delete_field($_);
549 $_->replace_with($itemField);
553 my $sth = $dbh->prepare("update biblioitems set marc=?,marcxml=? where biblionumber=?");
554 $sth->execute( $completeRecord->as_usmarc(), $completeRecord->as_xml_record(),$biblionumber );
556 ModZebra($biblionumber,"specialUpdate","biblioserver",$completeRecord);
559 =head2 ModDateLastSeen
561 &ModDateLastSeen($itemnum)
562 Mark item as seen. Is called when an item is issued, returned or manually marked during inventory/stocktaking
563 C<$itemnum> is the item number
567 sub ModDateLastSeen {
569 my $dbh = C4::Context->dbh;
572 "update items set itemlost=0, datelastseen = now() where items.itemnumber = ?"
574 $sth->execute($itemnum);
581 my $error = &DelBiblio($dbh,$biblionumber);
582 Exported function (core API) for deleting a biblio in koha.
583 Deletes biblio record from Zebra and Koha tables (biblio,biblioitems,items)
584 Also backs it up to deleted* tables
585 Checks to make sure there are not issues on any of the items
587 C<$error> : undef unless an error occurs
594 my ( $biblionumber ) = @_;
595 my $dbh = C4::Context->dbh;
596 my $error; # for error handling
598 # First make sure there are no items with issues are still attached
601 "SELECT itemnumber FROM items WHERE biblionumber=?");
602 $sth->execute($biblionumber);
603 while ( my $itemnumber = $sth->fetchrow ) {
604 my $issues = GetItemIssues($itemnumber);
605 foreach my $issue (@$issues) {
606 if ( ( $issue->{date_due} )
607 && ( $issue->{date_due} ne "Available" ) )
610 #FIXME: we need a status system in Biblio like in Circ to return standard codes and messages
611 # instead of hard-coded strings
613 "Item is checked out to a patron -- you must return it before deleting the Biblio";
617 return $error if $error;
619 # Delete in Zebra. Be careful NOT to move this line after _koha_delete_biblio
620 # for at least 2 reasons :
621 # - we need to read the biblio if NoZebra is set (to remove it from the indexes
622 # - if something goes wrong, the biblio may be deleted from Koha but not from zebra
623 # and we would have no way to remove it (except manually in zebra, but I bet it would be very hard to handle the problem)
624 ModZebra($biblionumber, "delete_record", "biblioserver", undef);
626 # delete biblio from Koha tables and save in deletedbiblio
627 $error = &_koha_delete_biblio( $dbh, $biblionumber );
629 # delete biblioitems and items from Koha tables and save in deletedbiblioitems,deleteditems
632 "SELECT biblioitemnumber FROM biblioitems WHERE biblionumber=?");
633 $sth->execute($biblionumber);
634 while ( my $biblioitemnumber = $sth->fetchrow ) {
636 # delete this biblioitem
637 $error = &_koha_delete_biblioitems( $dbh, $biblioitemnumber );
638 return $error if $error;
643 "SELECT itemnumber FROM items WHERE biblioitemnumber=?");
644 $items_sth->execute($biblioitemnumber);
645 while ( my $itemnumber = $items_sth->fetchrow ) {
646 $error = &_koha_delete_item( $dbh, $itemnumber );
647 return $error if $error;
650 &logaction(C4::Context->userenv->{'number'},"CATALOGUING","DELETE",$biblionumber,"")
651 if C4::Context->preference("CataloguingLog");
659 DelItem( $biblionumber, $itemnumber );
660 Exported function (core API) for deleting an item record in Koha.
667 my ( $biblionumber, $itemnumber ) = @_;
668 my $dbh = C4::Context->dbh;
669 &_koha_delete_item( $dbh, $itemnumber );
670 # get the MARC record
671 my $record = GetMarcBiblio($biblionumber);
672 my $frameworkcode = GetFrameworkCode($biblionumber);
676 $dbh->prepare("UPDATE deleteditems SET marc=? WHERE itemnumber=?");
677 $copy2deleted->execute( $record->as_usmarc(), $itemnumber );
679 #search item field code
680 my ( $itemtag, $itemsubfield ) = GetMarcFromKohaField("items.itemnumber",$frameworkcode);
681 my @fields = $record->field($itemtag);
682 # delete the item specified
683 foreach my $field (@fields) {
684 if ( $field->subfield($itemsubfield) eq $itemnumber ) {
685 $record->delete_field($field);
688 &ModBiblioMarc( $record, $biblionumber, $frameworkcode );
689 &logaction(C4::Context->userenv->{'number'},"CATALOGUING","DELETE",$itemnumber,"item")
690 if C4::Context->preference("CataloguingLog");
697 $data = &GetBiblioData($biblionumber);
698 Returns information about the book with the given biblionumber.
699 C<&GetBiblioData> returns a reference-to-hash. The keys are the fields in
700 the C<biblio> and C<biblioitems> tables in the
702 In addition, C<$data-E<gt>{subject}> is the list of the book's
703 subjects, separated by C<" , "> (space, comma, space).
704 If there are multiple biblioitems with the given biblionumber, only
705 the first one is considered.
713 my $dbh = C4::Context->dbh;
716 SELECT * , biblioitems.notes AS bnotes, biblio.notes
718 LEFT JOIN biblioitems ON biblio.biblionumber = biblioitems.biblionumber
719 LEFT JOIN itemtypes ON biblioitems.itemtype = itemtypes.itemtype
720 WHERE biblio.biblionumber = ?
721 AND biblioitems.biblionumber = biblio.biblionumber
723 my $sth = $dbh->prepare($query);
724 $sth->execute($bibnum);
726 $data = $sth->fetchrow_hashref;
730 } # sub GetBiblioData
737 @results = &GetItemsInfo($biblionumber, $type);
739 Returns information about books with the given biblionumber.
741 C<$type> may be either C<intra> or anything else. If it is not set to
742 C<intra>, then the search will exclude lost, very overdue, and
745 C<&GetItemsInfo> returns a list of references-to-hash. Each element
746 contains a number of keys. Most of them are table items from the
747 C<biblio>, C<biblioitems>, C<items>, and C<itemtypes> tables in the
748 Koha database. Other keys include:
752 =item C<$data-E<gt>{branchname}>
754 The name (not the code) of the branch to which the book belongs.
756 =item C<$data-E<gt>{datelastseen}>
758 This is simply C<items.datelastseen>, except that while the date is
759 stored in YYYY-MM-DD format in the database, here it is converted to
760 DD/MM/YYYY format. A NULL date is returned as C<//>.
762 =item C<$data-E<gt>{datedue}>
764 =item C<$data-E<gt>{class}>
766 This is the concatenation of C<biblioitems.classification>, the book's
767 Dewey code, and C<biblioitems.subclass>.
769 =item C<$data-E<gt>{ocount}>
771 I think this is the number of copies of the book available.
773 =item C<$data-E<gt>{order}>
775 If this is set, it is set to C<One Order>.
784 my ( $biblionumber, $type ) = @_;
785 my $dbh = C4::Context->dbh;
786 my $query = "SELECT *,items.notforloan as itemnotforloan
788 LEFT JOIN biblio ON biblio.biblionumber = items.biblionumber
789 LEFT JOIN biblioitems ON biblioitems.biblioitemnumber = items.biblioitemnumber
790 LEFT JOIN itemtypes on biblioitems.itemtype = itemtypes.itemtype
791 WHERE items.biblionumber = ?
792 ORDER BY items.dateaccessioned desc
794 my $sth = $dbh->prepare($query);
795 $sth->execute($biblionumber);
798 my ( $date_due, $count_reserves );
800 while ( my $data = $sth->fetchrow_hashref ) {
802 my $isth = $dbh->prepare(
803 "SELECT issues.*,borrowers.cardnumber,borrowers.surname,borrowers.firstname
804 FROM issues LEFT JOIN borrowers ON issues.borrowernumber=borrowers.borrowernumber
806 AND returndate IS NULL"
808 $isth->execute( $data->{'itemnumber'} );
809 if ( my $idata = $isth->fetchrow_hashref ) {
810 $data->{borrowernumber} = $idata->{borrowernumber};
811 $data->{cardnumber} = $idata->{cardnumber};
812 $data->{surname} = $idata->{surname};
813 $data->{firstname} = $idata->{firstname};
814 $datedue = format_date( $idata->{'date_due'} );
816 if ( $datedue eq '' ) {
817 #$datedue="Available";
818 my ( $restype, $reserves ) =
819 C4::Reserves::CheckReserves( $data->{'itemnumber'} );
823 $count_reserves = $restype;
828 #get branch information.....
829 my $bsth = $dbh->prepare(
830 "SELECT * FROM branches WHERE branchcode = ?
833 $bsth->execute( $data->{'holdingbranch'} );
834 if ( my $bdata = $bsth->fetchrow_hashref ) {
835 $data->{'branchname'} = $bdata->{'branchname'};
837 my $date = format_date( $data->{'datelastseen'} );
838 $data->{'datelastseen'} = $date;
839 $data->{'datedue'} = $datedue;
840 $data->{'count_reserves'} = $count_reserves;
842 # get notforloan complete status if applicable
843 my $sthnflstatus = $dbh->prepare(
844 'SELECT authorised_value
845 FROM marc_subfield_structure
846 WHERE kohafield="items.notforloan"
850 $sthnflstatus->execute;
851 my ($authorised_valuecode) = $sthnflstatus->fetchrow;
852 if ($authorised_valuecode) {
853 $sthnflstatus = $dbh->prepare(
854 "SELECT lib FROM authorised_values
856 AND authorised_value=?"
858 $sthnflstatus->execute( $authorised_valuecode,
859 $data->{itemnotforloan} );
860 my ($lib) = $sthnflstatus->fetchrow;
861 $data->{notforloan} = $lib;
864 # my stack procedures
865 my $stackstatus = $dbh->prepare(
866 'SELECT authorised_value
867 FROM marc_subfield_structure
868 WHERE kohafield="items.stack"
871 $stackstatus->execute;
873 ($authorised_valuecode) = $stackstatus->fetchrow;
874 if ($authorised_valuecode) {
875 $stackstatus = $dbh->prepare(
877 FROM authorised_values
879 AND authorised_value=?
882 $stackstatus->execute( $authorised_valuecode, $data->{stack} );
883 my ($lib) = $stackstatus->fetchrow;
884 $data->{stack} = $lib;
886 $results[$i] = $data;
898 $itemstatushash = &getitemstatus($fwkcode);
899 returns information about status.
900 Can be MARC dependant.
902 But basically could be can be loan or not
903 Create a status selector with the following code
905 =head3 in PERL SCRIPT
907 my $itemstatushash = getitemstatus;
909 foreach my $thisstatus (keys %$itemstatushash) {
910 my %row =(value => $thisstatus,
911 statusname => $itemstatushash->{$thisstatus}->{'statusname'},
913 push @itemstatusloop, \%row;
915 $template->param(statusloop=>\@itemstatusloop);
920 <select name="statusloop">
921 <option value="">Default</option>
922 <!-- TMPL_LOOP name="statusloop" -->
923 <option value="<!-- TMPL_VAR name="value" -->" <!-- TMPL_IF name="selected" -->selected<!-- /TMPL_IF -->><!-- TMPL_VAR name="statusname" --></option>
931 # returns a reference to a hash of references to status...
934 my $dbh = C4::Context->dbh;
936 $fwk = '' unless ($fwk);
937 my ( $tag, $subfield ) =
938 GetMarcFromKohaField( "items.notforloan", $fwk );
939 if ( $tag and $subfield ) {
942 "select authorised_value from marc_subfield_structure where tagfield=? and tagsubfield=? and frameworkcode=?"
944 $sth->execute( $tag, $subfield, $fwk );
945 if ( my ($authorisedvaluecat) = $sth->fetchrow ) {
948 "select authorised_value, lib from authorised_values where category=? order by lib"
950 $authvalsth->execute($authorisedvaluecat);
951 while ( my ( $authorisedvalue, $lib ) = $authvalsth->fetchrow ) {
952 $itemstatus{$authorisedvalue} = $lib;
968 $itemstatus{"1"} = "Not For Loan";
972 =head2 getitemlocation
976 $itemlochash = &getitemlocation($fwk);
977 returns informations about location.
978 where fwk stands for an optional framework code.
979 Create a location selector with the following code
981 =head3 in PERL SCRIPT
983 my $itemlochash = getitemlocation;
985 foreach my $thisloc (keys %$itemlochash) {
986 my $selected = 1 if $thisbranch eq $branch;
987 my %row =(locval => $thisloc,
988 selected => $selected,
989 locname => $itemlochash->{$thisloc},
991 push @itemlocloop, \%row;
993 $template->param(itemlocationloop => \@itemlocloop);
997 <select name="location">
998 <option value="">Default</option>
999 <!-- TMPL_LOOP name="itemlocationloop" -->
1000 <option value="<!-- TMPL_VAR name="locval" -->" <!-- TMPL_IF name="selected" -->selected<!-- /TMPL_IF -->><!-- TMPL_VAR name="locname" --></option>
1008 sub GetItemLocation {
1010 # returns a reference to a hash of references to location...
1013 my $dbh = C4::Context->dbh;
1015 $fwk = '' unless ($fwk);
1016 my ( $tag, $subfield ) =
1017 GetMarcFromKohaField( "items.location", $fwk );
1018 if ( $tag and $subfield ) {
1021 "select authorised_value from marc_subfield_structure where tagfield=? and tagsubfield=? and frameworkcode=?"
1023 $sth->execute( $tag, $subfield, $fwk );
1024 if ( my ($authorisedvaluecat) = $sth->fetchrow ) {
1027 "select authorised_value, lib from authorised_values where category=? order by lib"
1029 $authvalsth->execute($authorisedvaluecat);
1030 while ( my ( $authorisedvalue, $lib ) = $authvalsth->fetchrow ) {
1031 $itemlocation{$authorisedvalue} = $lib;
1033 $authvalsth->finish;
1034 return \%itemlocation;
1047 $itemlocation{"1"} = "Not For Loan";
1048 return \%itemlocation;
1053 $items = GetLostItems($where,$orderby);
1055 This function get the items lost into C<$items>.
1060 C<$where> is a hashref. it containts a field of the items table as key
1061 and the value to match as value.
1062 C<$orderby> is a field of the items table.
1065 C<$items> is a reference to an array full of hasref which keys are items' table column.
1067 =item usage in the perl script:
1070 $where{barcode} = 0001548;
1071 my $items = GetLostItems( \%where, "homebranch" );
1072 $template->param(itemsloop => $items);
1079 # Getting input args.
1081 my $orderby = shift;
1082 my $dbh = C4::Context->dbh;
1087 WHERE itemlost IS NOT NULL
1090 foreach my $key (keys %$where) {
1091 $query .= " AND " . $key . " LIKE '%" . $where->{$key} . "%'";
1093 $query .= " ORDER BY ".$orderby if defined $orderby;
1095 my $sth = $dbh->prepare($query);
1098 while ( my $row = $sth->fetchrow_hashref ){
1104 =head2 GetItemsForInventory
1106 $itemlist = GetItemsForInventory($minlocation,$maxlocation,$datelastseen,$offset,$size)
1108 Retrieve a list of title/authors/barcode/callnumber, for biblio inventory.
1110 The sub returns a list of hashes, containing itemnumber, author, title, barcode & item callnumber.
1111 It is ordered by callnumber,title.
1113 The minlocation & maxlocation parameters are used to specify a range of item callnumbers
1114 the datelastseen can be used to specify that you want to see items not seen since a past date only.
1115 offset & size can be used to retrieve only a part of the whole listing (defaut behaviour)
1119 sub GetItemsForInventory {
1120 my ( $minlocation, $maxlocation,$location, $datelastseen, $branch, $offset, $size ) = @_;
1121 my $dbh = C4::Context->dbh;
1123 if ($datelastseen) {
1124 $datelastseen=format_date_in_iso($datelastseen);
1126 "SELECT itemnumber,barcode,itemcallnumber,title,author,biblio.biblionumber,datelastseen
1128 LEFT JOIN biblio ON items.biblionumber=biblio.biblionumber
1129 WHERE itemcallnumber>= ?
1130 AND itemcallnumber <=?
1131 AND (datelastseen< ? OR datelastseen IS NULL)";
1132 $query.= " AND items.location=".$dbh->quote($location) if $location;
1133 $query.= " AND items.homebranch=".$dbh->quote($branch) if $branch;
1134 $query .= " ORDER BY itemcallnumber,title";
1135 $sth = $dbh->prepare($query);
1136 $sth->execute( $minlocation, $maxlocation, $datelastseen );
1140 SELECT itemnumber,barcode,itemcallnumber,biblio.biblionumber,title,author,datelastseen
1142 LEFT JOIN biblio ON items.biblionumber=biblio.biblionumber
1143 WHERE itemcallnumber>= ?
1144 AND itemcallnumber <=?";
1145 $query.= " AND items.location=".$dbh->quote($location) if $location;
1146 $query.= " AND items.homebranch=".$dbh->quote($branch) if $branch;
1147 $query .= " ORDER BY itemcallnumber,title";
1148 $sth = $dbh->prepare($query);
1149 $sth->execute( $minlocation, $maxlocation );
1152 while ( my $row = $sth->fetchrow_hashref ) {
1153 $offset-- if ($offset);
1154 $row->{datelastseen}=format_date($row->{datelastseen});
1155 if ( ( !$offset ) && $size ) {
1156 push @results, $row;
1163 =head2 &GetBiblioItemData
1167 $itemdata = &GetBiblioItemData($biblioitemnumber);
1169 Looks up the biblioitem with the given biblioitemnumber. Returns a
1170 reference-to-hash. The keys are the fields from the C<biblio>,
1171 C<biblioitems>, and C<itemtypes> tables in the Koha database, except
1172 that C<biblioitems.notes> is given as C<$itemdata-E<gt>{bnotes}>.
1179 sub GetBiblioItemData {
1180 my ($biblioitemnumber) = @_;
1181 my $dbh = C4::Context->dbh;
1184 "SELECT *,biblioitems.notes AS bnotes
1185 FROM biblioitems,biblio,itemtypes
1186 WHERE biblio.biblionumber = biblioitems.biblionumber
1187 AND biblioitemnumber = ? "
1190 $sth->execute($biblioitemnumber);
1191 $data = $sth->fetchrow_hashref;
1194 } # sub &GetBiblioItemData
1196 =head2 GetItemnumberFromBarcode
1200 $result = GetItemnumberFromBarcode($barcode);
1206 sub GetItemnumberFromBarcode {
1208 my $dbh = C4::Context->dbh;
1211 $dbh->prepare("SELECT itemnumber from items where items.barcode=?");
1212 $rq->execute($barcode);
1213 my ($result) = $rq->fetchrow;
1217 =head2 GetBiblioItemByBiblioNumber
1221 NOTE : This function has been copy/paste from C4/Biblio.pm from head before zebra integration.
1227 sub GetBiblioItemByBiblioNumber {
1228 my ($biblionumber) = @_;
1229 my $dbh = C4::Context->dbh;
1230 my $sth = $dbh->prepare("Select * from biblioitems where biblionumber = ?");
1234 $sth->execute($biblionumber);
1236 while ( my $data = $sth->fetchrow_hashref ) {
1237 push @results, $data;
1244 =head2 GetBiblioFromItemNumber
1248 $item = &GetBiblioFromItemNumber($itemnumber);
1250 Looks up the item with the given itemnumber.
1252 C<&itemnodata> returns a reference-to-hash whose keys are the fields
1253 from the C<biblio>, C<biblioitems>, and C<items> tables in the Koha
1261 sub GetBiblioFromItemNumber {
1262 my ( $itemnumber ) = @_;
1263 my $dbh = C4::Context->dbh;
1264 my $sth = $dbh->prepare(
1265 "SELECT * FROM items
1266 LEFT JOIN biblio ON biblio.biblionumber = items.biblionumber
1267 LEFT JOIN biblioitems ON biblioitems.biblioitemnumber = items.biblioitemnumber
1268 WHERE items.itemnumber = ?"
1271 $sth->execute($itemnumber);
1272 my $data = $sth->fetchrow_hashref;
1281 ( $count, @results ) = &GetBiblio($biblionumber);
1288 my ($biblionumber) = @_;
1289 my $dbh = C4::Context->dbh;
1290 my $sth = $dbh->prepare("Select * from biblio where biblionumber = ?");
1293 $sth->execute($biblionumber);
1294 while ( my $data = $sth->fetchrow_hashref ) {
1295 $results[$count] = $data;
1299 return ( $count, @results );
1306 $data = &GetItem($itemnumber,$barcode);
1308 return Item information, for a given itemnumber or barcode
1315 my ($itemnumber,$barcode) = @_;
1316 my $dbh = C4::Context->dbh;
1318 my $sth = $dbh->prepare("
1320 WHERE itemnumber = ?");
1321 $sth->execute($itemnumber);
1322 my $data = $sth->fetchrow_hashref;
1325 my $sth = $dbh->prepare("
1329 $sth->execute($barcode);
1330 my $data = $sth->fetchrow_hashref;
1335 =head2 get_itemnumbers_of
1339 my @itemnumbers_of = get_itemnumbers_of(@biblionumbers);
1341 Given a list of biblionumbers, return the list of corresponding itemnumbers
1342 for each biblionumber.
1344 Return a reference on a hash where keys are biblionumbers and values are
1345 references on array of itemnumbers.
1351 sub get_itemnumbers_of {
1352 my @biblionumbers = @_;
1354 my $dbh = C4::Context->dbh;
1360 WHERE biblionumber IN (?' . ( ',?' x scalar @biblionumbers - 1 ) . ')
1362 my $sth = $dbh->prepare($query);
1363 $sth->execute(@biblionumbers);
1367 while ( my ( $itemnumber, $biblionumber ) = $sth->fetchrow_array ) {
1368 push @{ $itemnumbers_of{$biblionumber} }, $itemnumber;
1371 return \%itemnumbers_of;
1374 =head2 GetItemInfosOf
1378 GetItemInfosOf(@itemnumbers);
1384 sub GetItemInfosOf {
1385 my @itemnumbers = @_;
1390 WHERE itemnumber IN (' . join( ',', @itemnumbers ) . ')
1392 return get_infos_of( $query, 'itemnumber' );
1395 =head2 GetItemsByBiblioitemnumber
1399 GetItemsByBiblioitemnumber($biblioitemnumber);
1401 Returns an arrayref of hashrefs suitable for use in a TMPL_LOOP
1402 Called by moredetail.pl
1408 sub GetItemsByBiblioitemnumber {
1409 my ( $bibitem ) = @_;
1410 my $dbh = C4::Context->dbh;
1411 my $sth = $dbh->prepare("SELECT * FROM items WHERE items.biblioitemnumber = ?") || die $dbh->errstr;
1412 # Get all items attached to a biblioitem
1415 $sth->execute($bibitem) || die $sth->errstr;
1416 while ( my $data = $sth->fetchrow_hashref ) {
1417 # Foreach item, get circulation information
1418 my $sth2 = $dbh->prepare( "SELECT * FROM issues,borrowers
1419 WHERE itemnumber = ?
1420 AND returndate is NULL
1421 AND issues.borrowernumber = borrowers.borrowernumber"
1423 $sth2->execute( $data->{'itemnumber'} );
1424 if ( my $data2 = $sth2->fetchrow_hashref ) {
1425 # if item is out, set the due date and who it is out too
1426 $data->{'date_due'} = $data2->{'date_due'};
1427 $data->{'cardnumber'} = $data2->{'cardnumber'};
1428 $data->{'borrowernumber'} = $data2->{'borrowernumber'};
1431 # set date_due to blank, so in the template we check itemlost, and wthdrawn
1432 $data->{'date_due'} = '';
1435 # Find the last 3 people who borrowed this item.
1436 my $query2 = "SELECT * FROM issues, borrowers WHERE itemnumber = ?
1437 AND issues.borrowernumber = borrowers.borrowernumber
1438 AND returndate is not NULL
1439 ORDER BY returndate desc,timestamp desc LIMIT 3";
1440 $sth2 = $dbh->prepare($query2) || die $dbh->errstr;
1441 $sth2->execute( $data->{'itemnumber'} ) || die $sth2->errstr;
1443 while ( my $data2 = $sth2->fetchrow_hashref ) {
1444 $data->{"timestamp$i2"} = $data2->{'timestamp'};
1445 $data->{"card$i2"} = $data2->{'cardnumber'};
1446 $data->{"borrower$i2"} = $data2->{'borrowernumber'};
1450 push(@results,$data);
1457 =head2 GetBiblioItemInfosOf
1461 GetBiblioItemInfosOf(@biblioitemnumbers);
1467 sub GetBiblioItemInfosOf {
1468 my @biblioitemnumbers = @_;
1471 SELECT biblioitemnumber,
1475 WHERE biblioitemnumber IN (' . join( ',', @biblioitemnumbers ) . ')
1477 return get_infos_of( $query, 'biblioitemnumber' );
1480 =head1 FUNCTIONS FOR HANDLING MARC MANAGEMENT
1482 =head2 GetMarcStructure
1486 $res = GetMarcStructure($forlibrarian,$frameworkcode);
1488 Returns a reference to a big hash of hash, with the Marc structure for the given frameworkcode
1489 $forlibrarian :if set to 1, the MARC descriptions are the librarians ones, otherwise it's the public (OPAC) ones
1490 $frameworkcode : the framework code to read
1496 sub GetMarcStructure {
1497 my ( $forlibrarian, $frameworkcode ) = @_;
1498 my $dbh=C4::Context->dbh;
1499 $frameworkcode = "" unless $frameworkcode;
1501 my $libfield = ( $forlibrarian eq 1 ) ? 'liblibrarian' : 'libopac';
1503 # check that framework exists
1506 "select count(*) from marc_tag_structure where frameworkcode=?");
1507 $sth->execute($frameworkcode);
1508 my ($total) = $sth->fetchrow;
1509 $frameworkcode = "" unless ( $total > 0 );
1512 "select tagfield,liblibrarian,libopac,mandatory,repeatable from marc_tag_structure where frameworkcode=? order by tagfield"
1514 $sth->execute($frameworkcode);
1515 my ( $liblibrarian, $libopac, $tag, $res, $tab, $mandatory, $repeatable );
1517 while ( ( $tag, $liblibrarian, $libopac, $mandatory, $repeatable ) =
1520 $res->{$tag}->{lib} =
1521 ( $forlibrarian or !$libopac ) ? $liblibrarian : $libopac;
1522 # why the hell do we need to explicitly decode utf8 ?
1523 # that's a good question, but we must do it...
1524 $res->{$tab}->{tab} = ""; # XXX
1525 $res->{$tag}->{mandatory} = $mandatory;
1526 $res->{$tag}->{repeatable} = $repeatable;
1531 "select tagfield,tagsubfield,liblibrarian,libopac,tab, mandatory, repeatable,authorised_value,authtypecode,value_builder,kohafield,seealso,hidden,isurl,link,defaultvalue from marc_subfield_structure where frameworkcode=? order by tagfield,tagsubfield"
1534 $sth->execute($frameworkcode);
1537 my $authorised_value;
1549 $tag, $subfield, $liblibrarian,
1551 $mandatory, $repeatable, $authorised_value,
1552 $authtypecode, $value_builder, $kohafield,
1553 $seealso, $hidden, $isurl,
1559 $res->{$tag}->{$subfield}->{lib} =
1560 ( $forlibrarian or !$libopac ) ? $liblibrarian : $libopac;
1561 $res->{$tag}->{$subfield}->{tab} = $tab;
1562 $res->{$tag}->{$subfield}->{mandatory} = $mandatory;
1563 $res->{$tag}->{$subfield}->{repeatable} = $repeatable;
1564 $res->{$tag}->{$subfield}->{authorised_value} = $authorised_value;
1565 $res->{$tag}->{$subfield}->{authtypecode} = $authtypecode;
1566 $res->{$tag}->{$subfield}->{value_builder} = $value_builder;
1567 $res->{$tag}->{$subfield}->{kohafield} = $kohafield;
1568 $res->{$tag}->{$subfield}->{seealso} = $seealso;
1569 $res->{$tag}->{$subfield}->{hidden} = $hidden;
1570 $res->{$tag}->{$subfield}->{isurl} = $isurl;
1571 $res->{$tag}->{$subfield}->{'link'} = $link;
1572 $res->{$tag}->{$subfield}->{defaultvalue} = $defaultvalue;
1577 =head2 GetUsedMarcStructure
1579 the same function as GetMarcStructure expcet it just take field
1580 in tab 0-9. (used field)
1582 my $results = GetUsedMarcStructure($frameworkcode);
1584 L<$results> is a ref to an array which each case containts a ref
1585 to a hash which each keys is the columns from marc_subfield_structure
1587 L<$frameworkcode> is the framework code.
1591 sub GetUsedMarcStructure($){
1592 my $frameworkcode = shift || '';
1593 my $dbh = C4::Context->dbh;
1596 FROM marc_subfield_structure
1598 AND frameworkcode = ?
1601 my $sth = $dbh->prepare($query);
1602 $sth->execute($frameworkcode);
1603 while (my $row = $sth->fetchrow_hashref){
1609 =head2 GetMarcFromKohaField
1613 ($MARCfield,$MARCsubfield)=GetMarcFromKohaField($kohafield,$frameworkcode);
1614 Returns the MARC fields & subfields mapped to the koha field
1615 for the given frameworkcode
1621 sub GetMarcFromKohaField {
1622 my ( $kohafield, $frameworkcode ) = @_;
1623 return 0, 0 unless $kohafield;
1624 my $relations = C4::Context->marcfromkohafield;
1626 $relations->{$frameworkcode}->{$kohafield}->[0],
1627 $relations->{$frameworkcode}->{$kohafield}->[1]
1631 =head2 GetMarcBiblio
1635 Returns MARC::Record of the biblionumber passed in parameter.
1636 the marc record contains both biblio & item datas
1643 my $biblionumber = shift;
1644 my $dbh = C4::Context->dbh;
1646 $dbh->prepare("select marcxml from biblioitems where biblionumber=? ");
1647 $sth->execute($biblionumber);
1648 my ($marcxml) = $sth->fetchrow;
1649 MARC::File::XML->default_record_format(C4::Context->preference('marcflavour'));
1650 $marcxml =~ s/\x1e//g;
1651 $marcxml =~ s/\x1f//g;
1652 $marcxml =~ s/\x1d//g;
1653 $marcxml =~ s/\x0f//g;
1654 $marcxml =~ s/\x0c//g;
1656 my $record = MARC::Record->new();
1658 $record = eval {MARC::Record::new_from_xml( $marcxml, "utf8",C4::Context->preference('marcflavour'))} if ($marcxml);
1660 # $record = MARC::Record::new_from_usmarc( $marc) if $marc;
1668 my $marcxml = GetXmlBiblio($biblionumber);
1670 Returns biblioitems.marcxml of the biblionumber passed in parameter.
1671 The XML contains both biblio & item datas
1678 my ( $biblionumber ) = @_;
1679 my $dbh = C4::Context->dbh;
1681 $dbh->prepare("select marcxml from biblioitems where biblionumber=? ");
1682 $sth->execute($biblionumber);
1683 my ($marcxml) = $sth->fetchrow;
1687 =head2 GetAuthorisedValueDesc
1691 my $subfieldvalue =get_authorised_value_desc(
1692 $tag, $subf[$i][0],$subf[$i][1], '', $taglib);
1693 Retrieve the complete description for a given authorised value.
1699 sub GetAuthorisedValueDesc {
1700 my ( $tag, $subfield, $value, $framework, $tagslib ) = @_;
1701 my $dbh = C4::Context->dbh;
1704 if ( $tagslib->{$tag}->{$subfield}->{'authorised_value'} eq "branches" ) {
1705 return C4::Branch::GetBranchName($value);
1709 if ( $tagslib->{$tag}->{$subfield}->{'authorised_value'} eq "itemtypes" ) {
1710 return getitemtypeinfo($value)->{description};
1713 #---- "true" authorized value
1714 my $category = $tagslib->{$tag}->{$subfield}->{'authorised_value'};
1715 if ( $category ne "" ) {
1718 "select lib from authorised_values where category = ? and authorised_value = ?"
1720 $sth->execute( $category, $value );
1721 my $data = $sth->fetchrow_hashref;
1722 return $data->{'lib'};
1725 return $value; # if nothing is found return the original value
1733 Returns MARC::Record of the item passed in parameter.
1740 my ( $biblionumber, $itemnumber ) = @_;
1741 my $dbh = C4::Context->dbh;
1742 my $newrecord = MARC::Record->new();
1743 my $marcflavour = C4::Context->preference('marcflavour');
1745 my $marcxml = GetXmlBiblio($biblionumber);
1746 my $record = MARC::Record->new();
1747 $record = MARC::Record::new_from_xml( $marcxml, "utf8", $marcflavour );
1748 # now, find where the itemnumber is stored & extract only the item
1749 my ( $itemnumberfield, $itemnumbersubfield ) =
1750 GetMarcFromKohaField( 'items.itemnumber', '' );
1751 my @fields = $record->field($itemnumberfield);
1752 foreach my $field (@fields) {
1753 if ( $field->subfield($itemnumbersubfield) eq $itemnumber ) {
1754 $newrecord->insert_fields_ordered($field);
1766 $marcnotesarray = GetMarcNotes( $record, $marcflavour );
1767 Get all notes from the MARC record and returns them in an array.
1768 The note are stored in differents places depending on MARC flavour
1775 my ( $record, $marcflavour ) = @_;
1777 if ( $marcflavour eq "MARC21" ) {
1780 else { # assume unimarc if not marc21
1787 foreach my $field ( $record->field($scope) ) {
1788 my $value = $field->as_string();
1789 if ( $note ne "" ) {
1790 $marcnote = { marcnote => $note, };
1791 push @marcnotes, $marcnote;
1794 if ( $note ne $value ) {
1795 $note = $note . " " . $value;
1800 $marcnote = { marcnote => $note };
1801 push @marcnotes, $marcnote; #load last tag into array
1804 } # end GetMarcNotes
1806 =head2 GetMarcSubjects
1810 $marcsubjcts = GetMarcSubjects($record,$marcflavour);
1811 Get all subjects from the MARC record and returns them in an array.
1812 The subjects are stored in differents places depending on MARC flavour
1818 sub GetMarcSubjects {
1819 my ( $record, $marcflavour ) = @_;
1820 my ( $mintag, $maxtag );
1821 if ( $marcflavour eq "MARC21" ) {
1825 else { # assume unimarc if not marc21
1832 foreach my $field ( $record->fields ) {
1833 next unless $field->tag() >= $mintag && $field->tag() <= $maxtag;
1834 my @subfields = $field->subfields();
1838 my $authoritysep=C4::Context->preference("authoritysep");
1839 for my $subject_subfield ( @subfields ) {
1841 $marcflavour ne 'MARC21'
1843 ($subject_subfield->[0] eq '3') or
1844 ($subject_subfield->[0] eq '4') or
1845 ($subject_subfield->[0] eq '5')
1851 my $code = $subject_subfield->[0];
1852 $label .= $subject_subfield->[1].$authoritysep unless ( $code == 9 );
1853 $link .= " and su-to:".$subject_subfield->[1] unless ( $code == 9 );
1855 $link = "an:".$subject_subfield->[1];
1859 $link =~ s/ and\ssu-to:$//;
1862 $label =~ s/$authoritysep$//;
1869 return \@marcsubjcts;
1870 } #end GetMarcSubjects
1872 =head2 GetMarcAuthors
1876 authors = GetMarcAuthors($record,$marcflavour);
1877 Get all authors from the MARC record and returns them in an array.
1878 The authors are stored in differents places depending on MARC flavour
1884 sub GetMarcAuthors {
1885 my ( $record, $marcflavour ) = @_;
1886 my ( $mintag, $maxtag );
1887 # tagslib useful for UNIMARC author reponsabilities
1888 my $tagslib = &GetMarcStructure( 1, '' ); # FIXME : we don't have the framework available, we take the default framework. May be bugguy on some setups, will be usually correct.
1889 if ( $marcflavour eq "MARC21" ) {
1893 else { # assume unimarc if not marc21
1900 foreach my $field ( $record->fields ) {
1901 next unless $field->tag() >= $mintag && $field->tag() <= $maxtag;
1903 my @subfields = $field->subfields();
1906 for my $authors_subfield (@subfields) {
1908 $marcflavour ne 'MARC21'
1910 ($authors_subfield->[0] eq '3') or
1911 ($authors_subfield->[0] eq '5')
1917 if ($count_auth ne '0'){
1921 my $subfieldcode = $authors_subfield->[0];
1923 # deal with UNIMARC author responsibility
1925 $marcflavour ne 'MARC21'
1926 and ($authors_subfield->[0] eq '4')
1929 $value = "(".GetAuthorisedValueDesc( $field->tag(), $authors_subfield->[0], $authors_subfield->[1], '', $tagslib ).")";
1931 $value = $authors_subfield->[1];
1933 $hash{tag} = $field->tag;
1934 $hash{value} .= $value . " " if ($subfieldcode != 9) ;
1935 $hash{link} .= $value if ($subfieldcode eq 9);
1937 push @marcauthors, \%hash;
1939 return \@marcauthors;
1942 =head2 GetMarcSeries
1946 $marcseriessarray = GetMarcSeries($record,$marcflavour);
1947 Get all series from the MARC record and returns them in an array.
1948 The series are stored in differents places depending on MARC flavour
1955 my ($record, $marcflavour) = @_;
1956 my ($mintag, $maxtag);
1957 if ($marcflavour eq "MARC21") {
1960 } else { # assume unimarc if not marc21
1970 foreach my $field ($record->field('440'), $record->field('490')) {
1972 #my $value = $field->subfield('a');
1973 #$marcsubjct = {MARCSUBJCT => $value,};
1974 my @subfields = $field->subfields();
1975 #warn "subfields:".join " ", @$subfields;
1978 for my $series_subfield (@subfields) {
1980 undef $volume_number;
1981 # see if this is an instance of a volume
1982 if ($series_subfield->[0] eq 'v') {
1986 my $code = $series_subfield->[0];
1987 my $value = $series_subfield->[1];
1988 my $linkvalue = $value;
1989 $linkvalue =~ s/(\(|\))//g;
1990 my $operator = " and " unless $counter==0;
1991 push @link_loop, {link => $linkvalue, operator => $operator };
1992 my $separator = C4::Context->preference("authoritysep") unless $counter==0;
1993 if ($volume_number) {
1994 push @subfields_loop, {volumenum => $value};
1997 push @subfields_loop, {code => $code, value => $value, link_loop => \@link_loop, separator => $separator, volumenum => $volume_number};
2001 push @marcseries, { MARCSERIES_SUBFIELDS_LOOP => \@subfields_loop };
2002 #$marcsubjct = {MARCSUBJCT => $field->as_string(),};
2003 #push @marcsubjcts, $marcsubjct;
2007 my $marcseriessarray=\@marcseries;
2008 return $marcseriessarray;
2009 } #end getMARCseriess
2011 =head2 GetFrameworkCode
2015 $frameworkcode = GetFrameworkCode( $biblionumber )
2021 sub GetFrameworkCode {
2022 my ( $biblionumber ) = @_;
2023 my $dbh = C4::Context->dbh;
2024 my $sth = $dbh->prepare("select frameworkcode from biblio where biblionumber=?");
2025 $sth->execute($biblionumber);
2026 my ($frameworkcode) = $sth->fetchrow;
2027 return $frameworkcode;
2030 =head2 GetPublisherNameFromIsbn
2032 $name = GetPublishercodeFromIsbn($isbn);
2039 sub GetPublisherNameFromIsbn($){
2041 $isbn =~ s/[- _]//g;
2043 my @codes = (split '-', DisplayISBN($isbn));
2044 my $code = $codes[0].$codes[1].$codes[2];
2045 my $dbh = C4::Context->dbh;
2047 SELECT distinct publishercode
2050 AND publishercode IS NOT NULL
2053 my $sth = $dbh->prepare($query);
2054 $sth->execute("$code%");
2055 my $name = $sth->fetchrow;
2056 return $name if length $name;
2060 =head2 TransformKohaToMarc
2064 $record = TransformKohaToMarc( $hash )
2065 This function builds partial MARC::Record from a hash
2066 Hash entries can be from biblio or biblioitems.
2067 This function is called in acquisition module, to create a basic catalogue entry from user entry
2073 sub TransformKohaToMarc {
2076 my $dbh = C4::Context->dbh;
2079 "select tagfield,tagsubfield from marc_subfield_structure where frameworkcode=? and kohafield=?"
2081 my $record = MARC::Record->new();
2082 foreach (keys %{$hash}) {
2083 &TransformKohaToMarcOneField( $sth, $record, $_,
2089 =head2 TransformKohaToMarcOneField
2093 $record = TransformKohaToMarcOneField( $sth, $record, $kohafieldname, $value, $frameworkcode );
2099 sub TransformKohaToMarcOneField {
2100 my ( $sth, $record, $kohafieldname, $value, $frameworkcode ) = @_;
2101 $frameworkcode='' unless $frameworkcode;
2105 if ( !defined $sth ) {
2106 my $dbh = C4::Context->dbh;
2107 $sth = $dbh->prepare(
2108 "select tagfield,tagsubfield from marc_subfield_structure where frameworkcode=? and kohafield=?"
2111 $sth->execute( $frameworkcode, $kohafieldname );
2112 if ( ( $tagfield, $tagsubfield ) = $sth->fetchrow ) {
2113 my $tag = $record->field($tagfield);
2115 $tag->update( $tagsubfield => $value );
2116 $record->delete_field($tag);
2117 $record->insert_fields_ordered($tag);
2120 $record->add_fields( $tagfield, " ", " ", $tagsubfield => $value );
2126 =head2 TransformHtmlToXml
2130 $xml = TransformHtmlToXml( $tags, $subfields, $values, $indicator, $ind_tag, $auth_type )
2132 $auth_type contains :
2133 - nothing : rebuild a biblio, un UNIMARC the encoding is in 100$a pos 26/27
2134 - UNIMARCAUTH : rebuild an authority. In UNIMARC, the encoding is in 100$a pos 13/14
2135 - ITEM : rebuild an item : in UNIMARC, 100$a, it's in the biblio ! (otherwise, we would get 2 100 fields !)
2141 sub TransformHtmlToXml {
2142 my ( $tags, $subfields, $values, $indicator, $ind_tag, $auth_type ) = @_;
2143 my $xml = MARC::File::XML::header('UTF-8');
2144 $auth_type = C4::Context->preference('marcflavour') unless $auth_type;
2145 MARC::File::XML->default_record_format($auth_type);
2146 # in UNIMARC, field 100 contains the encoding
2147 # check that there is one, otherwise the
2148 # MARC::Record->new_from_xml will fail (and Koha will die)
2149 my $unimarc_and_100_exist=0;
2150 $unimarc_and_100_exist=1 if $auth_type eq 'ITEM'; # if we rebuild an item, no need of a 100 field
2155 for ( my $i = 0 ; $i <= @$tags ; $i++ ) {
2156 if (C4::Context->preference('marcflavour') eq 'UNIMARC' and @$tags[$i] eq "100" and @$subfields[$i] eq "a") {
2157 # if we have a 100 field and it's values are not correct, skip them.
2158 # if we don't have any valid 100 field, we will create a default one at the end
2159 my $enc = substr( @$values[$i], 26, 2 );
2160 if ($enc eq '01' or $enc eq '50' or $enc eq '03') {
2161 $unimarc_and_100_exist=1;
2166 @$values[$i] =~ s/&/&/g;
2167 @$values[$i] =~ s/</</g;
2168 @$values[$i] =~ s/>/>/g;
2169 @$values[$i] =~ s/"/"/g;
2170 @$values[$i] =~ s/'/'/g;
2171 # if ( !utf8::is_utf8( @$values[$i] ) ) {
2172 # utf8::decode( @$values[$i] );
2174 if ( ( @$tags[$i] ne $prevtag ) ) {
2175 $j++ unless ( @$tags[$i] eq "" );
2177 $xml .= "</datafield>\n";
2178 if ( ( @$tags[$i] && @$tags[$i] > 10 )
2179 && ( @$values[$i] ne "" ) )
2181 my $ind1 = substr( @$indicator[$j], 0, 1 );
2183 if ( @$indicator[$j] ) {
2184 $ind2 = substr( @$indicator[$j], 1, 1 );
2187 warn "Indicator in @$tags[$i] is empty";
2191 "<datafield tag=\"@$tags[$i]\" ind1=\"$ind1\" ind2=\"$ind2\">\n";
2193 "<subfield code=\"@$subfields[$i]\">@$values[$i]</subfield>\n";
2201 if ( @$values[$i] ne "" ) {
2204 if ( @$tags[$i] eq "000" ) {
2205 $xml .= "<leader>@$values[$i]</leader>\n";
2208 # rest of the fixed fields
2210 elsif ( @$tags[$i] < 10 ) {
2212 "<controlfield tag=\"@$tags[$i]\">@$values[$i]</controlfield>\n";
2216 my $ind1 = substr( @$indicator[$j], 0, 1 );
2217 my $ind2 = substr( @$indicator[$j], 1, 1 );
2219 "<datafield tag=\"@$tags[$i]\" ind1=\"$ind1\" ind2=\"$ind2\">\n";
2221 "<subfield code=\"@$subfields[$i]\">@$values[$i]</subfield>\n";
2227 else { # @$tags[$i] eq $prevtag
2228 if ( @$values[$i] eq "" ) {
2232 my $ind1 = substr( @$indicator[$j], 0, 1 );
2233 my $ind2 = substr( @$indicator[$j], 1, 1 );
2235 "<datafield tag=\"@$tags[$i]\" ind1=\"$ind1\" ind2=\"$ind2\">\n";
2239 "<subfield code=\"@$subfields[$i]\">@$values[$i]</subfield>\n";
2242 $prevtag = @$tags[$i];
2244 if (C4::Context->preference('marcflavour') and !$unimarc_and_100_exist) {
2245 # warn "SETTING 100 for $auth_type";
2246 use POSIX qw(strftime);
2247 my $string = strftime( "%Y%m%d", localtime(time) );
2248 # set 50 to position 26 is biblios, 13 if authorities
2250 $pos=13 if $auth_type eq 'UNIMARCAUTH';
2251 $string = sprintf( "%-*s", 35, $string );
2252 substr( $string, $pos , 6, "50" );
2253 $xml .= "<datafield tag=\"100\" ind1=\"\" ind2=\"\">\n";
2254 $xml .= "<subfield code=\"a\">$string</subfield>\n";
2255 $xml .= "</datafield>\n";
2257 $xml .= MARC::File::XML::footer();
2261 =head2 TransformHtmlToMarc
2263 L<$record> = TransformHtmlToMarc(L<$params>,L<$cgi>)
2264 L<$params> is a ref to an array as below:
2266 'tag_010_indicator_531951' ,
2267 'tag_010_code_a_531951_145735' ,
2268 'tag_010_subfield_a_531951_145735' ,
2269 'tag_200_indicator_873510' ,
2270 'tag_200_code_a_873510_673465' ,
2271 'tag_200_subfield_a_873510_673465' ,
2272 'tag_200_code_b_873510_704318' ,
2273 'tag_200_subfield_b_873510_704318' ,
2274 'tag_200_code_e_873510_280822' ,
2275 'tag_200_subfield_e_873510_280822' ,
2276 'tag_200_code_f_873510_110730' ,
2277 'tag_200_subfield_f_873510_110730' ,
2279 L<$cgi> is the CGI object which containts the value.
2280 L<$record> is the MARC::Record object.
2284 sub TransformHtmlToMarc {
2288 # creating a new record
2289 my $record = MARC::Record->new();
2292 while ($params->[$i]){ # browse all CGI params
2293 my $param = $params->[$i];
2295 # if we are on biblionumber, store it in the MARC::Record (it may not be in the edited fields)
2296 if ($param eq 'biblionumber') {
2297 my ( $biblionumbertagfield, $biblionumbertagsubfield ) =
2298 &GetMarcFromKohaField( "biblio.biblionumber", '' );
2299 if ($biblionumbertagfield < 10) {
2300 $newfield = MARC::Field->new(
2301 $biblionumbertagfield,
2302 $cgi->param($param),
2305 $newfield = MARC::Field->new(
2306 $biblionumbertagfield,
2309 "$biblionumbertagsubfield" => $cgi->param($param),
2312 push @fields,$newfield if($newfield);
2314 elsif ($param =~ /^tag_(\d*)_indicator_/){ # new field start when having 'input name="..._indicator_..."
2317 my $ind1 = substr($cgi->param($param),0,1);
2318 my $ind2 = substr($cgi->param($param),1,1);
2322 if($tag < 10){ # no code for theses fields
2323 # in MARC editor, 000 contains the leader.
2324 if ($tag eq '000' ) {
2325 $record->leader($cgi->param($params->[$j+1])) if length($cgi->param($params->[$j+1]))==24;
2326 # between 001 and 009 (included)
2328 $newfield = MARC::Field->new(
2330 $cgi->param($params->[$j+1]),
2333 # > 009, deal with subfields
2335 while($params->[$j] =~ /_code_/){ # browse all it's subfield
2336 my $inner_param = $params->[$j];
2338 if($cgi->param($params->[$j+1])){ # only if there is a value (code => value)
2339 $newfield->add_subfields(
2340 $cgi->param($inner_param) => $cgi->param($params->[$j+1])
2344 if ( $cgi->param($params->[$j+1]) ) { # creating only if there is a value (code => value)
2345 $newfield = MARC::Field->new(
2349 $cgi->param($inner_param) => $cgi->param($params->[$j+1]),
2356 push @fields,$newfield if($newfield);
2361 $record->append_fields(@fields);
2365 =head2 TransformMarcToKoha
2369 $result = TransformMarcToKoha( $dbh, $record, $frameworkcode )
2375 sub TransformMarcToKoha {
2376 my ( $dbh, $record, $frameworkcode ) = @_;
2378 # FIXME :: This query is unused..
2381 #"select tagfield,tagsubfield from marc_subfield_structure where frameworkcode=? and kohafield=?"
2385 my $sth2 = $dbh->prepare("SHOW COLUMNS from biblio");
2388 while ( ($field) = $sth2->fetchrow ) {
2390 &TransformMarcToKohaOneField( "biblio", $field, $record, $result,
2393 my $sth2 = $dbh->prepare("SHOW COLUMNS from biblioitems");
2395 while ( ($field) = $sth2->fetchrow ) {
2396 if ( $field eq 'notes' ) { $field = 'bnotes'; }
2398 &TransformMarcToKohaOneField( "biblioitems", $field, $record, $result,
2401 $sth2 = $dbh->prepare("SHOW COLUMNS from items");
2403 while ( ($field) = $sth2->fetchrow ) {
2405 &TransformMarcToKohaOneField( "items", $field, $record, $result,
2410 # modify copyrightdate to keep only the 1st year found
2411 my $temp = $result->{'copyrightdate'};
2412 $temp =~ m/c(\d\d\d\d)/; # search cYYYY first
2414 $result->{'copyrightdate'} = $1;
2416 else { # if no cYYYY, get the 1st date.
2417 $temp =~ m/(\d\d\d\d)/;
2418 $result->{'copyrightdate'} = $1;
2421 # modify publicationyear to keep only the 1st year found
2422 $temp = $result->{'publicationyear'};
2423 $temp =~ m/c(\d\d\d\d)/; # search cYYYY first
2425 $result->{'publicationyear'} = $1;
2427 else { # if no cYYYY, get the 1st date.
2428 $temp =~ m/(\d\d\d\d)/;
2429 $result->{'publicationyear'} = $1;
2434 =head2 TransformMarcToKohaOneField
2438 $result = TransformMarcToKohaOneField( $kohatable, $kohafield, $record, $result, $frameworkcode )
2444 sub TransformMarcToKohaOneField {
2446 # FIXME ? if a field has a repeatable subfield that is used in old-db,
2447 # only the 1st will be retrieved...
2448 my ( $kohatable, $kohafield, $record, $result, $frameworkcode ) = @_;
2450 my ( $tagfield, $subfield ) =
2451 GetMarcFromKohaField( $kohatable . "." . $kohafield,
2453 foreach my $field ( $record->field($tagfield) ) {
2454 if ( $field->tag() < 10 ) {
2455 if ( $result->{$kohafield} ) {
2456 $result->{$kohafield} .= " | " . $field->data();
2459 $result->{$kohafield} = $field->data();
2463 if ( $field->subfields ) {
2464 my @subfields = $field->subfields();
2465 foreach my $subfieldcount ( 0 .. $#subfields ) {
2466 if ( $subfields[$subfieldcount][0] eq $subfield ) {
2467 if ( $result->{$kohafield} ) {
2468 $result->{$kohafield} .=
2469 " | " . $subfields[$subfieldcount][1];
2472 $result->{$kohafield} =
2473 $subfields[$subfieldcount][1];
2483 =head1 OTHER FUNCTIONS
2489 my $string = char_decode( $string, $encoding );
2491 converts ISO 5426 coded string to UTF-8
2492 sloppy code : should be improved in next issue
2499 my ( $string, $encoding ) = @_;
2502 $encoding = C4::Context->preference("marcflavour") unless $encoding;
2503 if ( $encoding eq "UNIMARC" ) {
2573 # this handles non-sorting blocks (if implementation requires this)
2574 $string = nsb_clean($_);
2576 elsif ( $encoding eq "USMARC" || $encoding eq "MARC21" ) {
2635 #Additional Turkish characters
2638 s/(\xf0)s/\xc5\x9f/gm;
2639 s/(\xf0)S/\xc5\x9e/gm;
2642 s/\xe7\x49/\\xc4\xb0/gm;
2643 s/(\xe6)G/\xc4\x9e/gm;
2644 s/(\xe6)g/ğ\xc4\x9f/gm;
2647 s/(\xe8|\xc8)o/ö/gm;
2648 s/(\xe8|\xc8)O/Ö/gm;
2649 s/(\xe8|\xc8)u/ü/gm;
2650 s/(\xe8|\xc8)U/Ü/gm;
2651 s/\xc2\xb8/\xc4\xb1/gm;
2654 # this handles non-sorting blocks (if implementation requires this)
2655 $string = nsb_clean($_);
2664 my $string = nsb_clean( $string, $encoding );
2671 my $NSB = '\x88'; # NSB : begin Non Sorting Block
2672 my $NSE = '\x89'; # NSE : Non Sorting Block end
2673 # handles non sorting blocks
2677 s/[ ]{0,1}$NSE/) /gm;
2682 =head2 PrepareItemrecordDisplay
2686 PrepareItemrecordDisplay($itemrecord,$bibnum,$itemumber);
2688 Returns a hash with all the fields for Display a given item data in a template
2694 sub PrepareItemrecordDisplay {
2696 my ( $bibnum, $itemnum ) = @_;
2698 my $dbh = C4::Context->dbh;
2699 my $frameworkcode = &GetFrameworkCode( $bibnum );
2700 my ( $itemtagfield, $itemtagsubfield ) =
2701 &GetMarcFromKohaField( "items.itemnumber", $frameworkcode );
2702 my $tagslib = &GetMarcStructure( 1, $frameworkcode );
2703 my $itemrecord = GetMarcItem( $bibnum, $itemnum) if ($itemnum);
2705 my $authorised_values_sth =
2707 "select authorised_value,lib from authorised_values where category=? order by lib"
2709 foreach my $tag ( sort keys %{$tagslib} ) {
2710 my $previous_tag = '';
2712 # loop through each subfield
2714 foreach my $subfield ( sort keys %{ $tagslib->{$tag} } ) {
2715 next if ( subfield_is_koha_internal_p($subfield) );
2716 next if ( $tagslib->{$tag}->{$subfield}->{'tab'} ne "10" );
2718 $subfield_data{tag} = $tag;
2719 $subfield_data{subfield} = $subfield;
2720 $subfield_data{countsubfield} = $cntsubf++;
2721 $subfield_data{kohafield} =
2722 $tagslib->{$tag}->{$subfield}->{'kohafield'};
2724 # $subfield_data{marc_lib}=$tagslib->{$tag}->{$subfield}->{lib};
2725 $subfield_data{marc_lib} =
2726 "<span id=\"error\" title=\""
2727 . $tagslib->{$tag}->{$subfield}->{lib} . "\">"
2728 . substr( $tagslib->{$tag}->{$subfield}->{lib}, 0, 12 )
2730 $subfield_data{mandatory} =
2731 $tagslib->{$tag}->{$subfield}->{mandatory};
2732 $subfield_data{repeatable} =
2733 $tagslib->{$tag}->{$subfield}->{repeatable};
2734 $subfield_data{hidden} = "display:none"
2735 if $tagslib->{$tag}->{$subfield}->{hidden};
2737 ( $x, $value ) = _find_value( $tag, $subfield, $itemrecord )
2739 $value =~ s/"/"/g;
2741 # search for itemcallnumber if applicable
2742 if ( $tagslib->{$tag}->{$subfield}->{kohafield} eq
2743 'items.itemcallnumber'
2744 && C4::Context->preference('itemcallnumber') )
2747 substr( C4::Context->preference('itemcallnumber'), 0, 3 );
2749 substr( C4::Context->preference('itemcallnumber'), 3, 1 );
2750 my $temp = $itemrecord->field($CNtag) if ($itemrecord);
2752 $value = $temp->subfield($CNsubfield);
2755 if ( $tagslib->{$tag}->{$subfield}->{authorised_value} ) {
2756 my @authorised_values;
2759 # builds list, depending on authorised value...
2761 if ( $tagslib->{$tag}->{$subfield}->{'authorised_value'} eq
2764 if ( ( C4::Context->preference("IndependantBranches") )
2765 && ( C4::Context->userenv->{flags} != 1 ) )
2769 "select branchcode,branchname from branches where branchcode = ? order by branchname"
2771 $sth->execute( C4::Context->userenv->{branch} );
2772 push @authorised_values, ""
2774 $tagslib->{$tag}->{$subfield}->{mandatory} );
2775 while ( my ( $branchcode, $branchname ) =
2776 $sth->fetchrow_array )
2778 push @authorised_values, $branchcode;
2779 $authorised_lib{$branchcode} = $branchname;
2785 "select branchcode,branchname from branches order by branchname"
2788 push @authorised_values, ""
2790 $tagslib->{$tag}->{$subfield}->{mandatory} );
2791 while ( my ( $branchcode, $branchname ) =
2792 $sth->fetchrow_array )
2794 push @authorised_values, $branchcode;
2795 $authorised_lib{$branchcode} = $branchname;
2801 elsif ( $tagslib->{$tag}->{$subfield}->{authorised_value} eq
2806 "select itemtype,description from itemtypes order by description"
2809 push @authorised_values, ""
2810 unless ( $tagslib->{$tag}->{$subfield}->{mandatory} );
2811 while ( my ( $itemtype, $description ) =
2812 $sth->fetchrow_array )
2814 push @authorised_values, $itemtype;
2815 $authorised_lib{$itemtype} = $description;
2818 #---- "true" authorised value
2821 $authorised_values_sth->execute(
2822 $tagslib->{$tag}->{$subfield}->{authorised_value} );
2823 push @authorised_values, ""
2824 unless ( $tagslib->{$tag}->{$subfield}->{mandatory} );
2825 while ( my ( $value, $lib ) =
2826 $authorised_values_sth->fetchrow_array )
2828 push @authorised_values, $value;
2829 $authorised_lib{$value} = $lib;
2832 $subfield_data{marc_value} = CGI::scrolling_list(
2833 -name => 'field_value',
2834 -values => \@authorised_values,
2835 -default => "$value",
2836 -labels => \%authorised_lib,
2842 elsif ( $tagslib->{$tag}->{$subfield}->{thesaurus_category} ) {
2843 $subfield_data{marc_value} =
2844 "<input type=\"text\" name=\"field_value\" size=47 maxlength=255> <a href=\"javascript:Dopop('cataloguing/thesaurus_popup.pl?category=$tagslib->{$tag}->{$subfield}->{thesaurus_category}&index=',)\">...</a>";
2847 # COMMENTED OUT because No $i is provided with this API.
2848 # And thus, no value_builder can be activated.
2849 # BUT could be thought over.
2850 # } elsif ($tagslib->{$tag}->{$subfield}->{'value_builder'}) {
2851 # my $plugin="value_builder/".$tagslib->{$tag}->{$subfield}->{'value_builder'};
2853 # my $extended_param = plugin_parameters($dbh,$itemrecord,$tagslib,$i,0);
2854 # my ($function_name,$javascript) = plugin_javascript($dbh,$record,$tagslib,$i,0);
2855 # $subfield_data{marc_value}="<input type=\"text\" value=\"$value\" name=\"field_value\" size=47 maxlength=255 DISABLE READONLY OnFocus=\"javascript:Focus$function_name()\" OnBlur=\"javascript:Blur$function_name()\"> <a href=\"javascript:Clic$function_name()\">...</a> $javascript";
2858 $subfield_data{marc_value} =
2859 "<input type=\"text\" name=\"field_value\" value=\"$value\" size=50 maxlength=255>";
2861 push( @loop_data, \%subfield_data );
2865 my $itemnumber = $itemrecord->subfield( $itemtagfield, $itemtagsubfield )
2866 if ( $itemrecord && $itemrecord->field($itemtagfield) );
2868 'itemtagfield' => $itemtagfield,
2869 'itemtagsubfield' => $itemtagsubfield,
2870 'itemnumber' => $itemnumber,
2871 'iteminformation' => \@loop_data
2877 # true ModZebra commented until indexdata fixes zebraDB crashes (it seems they occur on multiple updates
2879 # replaced by a zebraqueue table, that is filled with ModZebra to run.
2880 # the table is emptied by misc/cronjobs/zebraqueue_start.pl script
2881 # =head2 ModZebrafiles
2883 # &ModZebrafiles( $dbh, $biblionumber, $record, $folder, $server );
2887 # sub ModZebrafiles {
2889 # my ( $dbh, $biblionumber, $record, $folder, $server ) = @_;
2893 # C4::Context->zebraconfig($server)->{directory} . "/" . $folder . "/";
2894 # unless ( opendir( DIR, "$zebradir" ) ) {
2895 # warn "$zebradir not found";
2899 # my $filename = $zebradir . $biblionumber;
2902 # open( OUTPUT, ">", $filename . ".xml" );
2903 # print OUTPUT $record;
2912 ModZebra( $biblionumber, $op, $server, $newRecord );
2914 $biblionumber is the biblionumber we want to index
2915 $op is specialUpdate or delete, and is used to know what we want to do
2916 $server is the server that we want to update
2917 $newRecord is the MARC::Record containing the new record. It is usefull only when NoZebra=1, and is used to know what to add to the nozebra database. (the record in mySQL being, if it exist, the previous record, the one just before the modif. We need both : the previous and the new one.
2924 ###Accepts a $server variable thus we can use it for biblios authorities or other zebra dbs
2925 my ( $biblionumber, $op, $server, $newRecord ) = @_;
2926 my $dbh=C4::Context->dbh;
2928 # true ModZebra commented until indexdata fixes zebraDB crashes (it seems they occur on multiple updates
2930 # replaced by a zebraqueue table, that is filled with ModZebra to run.
2931 # the table is emptied by misc/cronjobs/zebraqueue_start.pl script
2933 if (C4::Context->preference("NoZebra")) {
2934 # lock the nozebra table : we will read index lines, update them in Perl process
2935 # and write everything in 1 transaction.
2936 # lock the table to avoid someone else overwriting what we are doing
2937 $dbh->do('LOCK TABLES nozebra WRITE,biblio WRITE,biblioitems WRITE, systempreferences WRITE, auth_types WRITE, auth_header WRITE');
2938 my %result; # the result hash that will be builded by deletion / add, and written on mySQL at the end, to improve speed
2940 if ($server eq 'biblioserver') {
2941 $record= GetMarcBiblio($biblionumber);
2943 $record= C4::AuthoritiesMarc::GetAuthority($biblionumber);
2945 if ($op eq 'specialUpdate') {
2946 # OK, we have to add or update the record
2947 # 1st delete (virtually, in indexes) ...
2948 %result = _DelBiblioNoZebra($biblionumber,$record,$server);
2949 # ... add the record
2950 %result=_AddBiblioNoZebra($biblionumber,$newRecord, $server, %result);
2952 # it's a deletion, delete the record...
2953 # warn "DELETE the record $biblionumber on $server".$record->as_formatted;
2954 %result=_DelBiblioNoZebra($biblionumber,$record,$server);
2956 # ok, now update the database...
2957 my $sth = $dbh->prepare("UPDATE nozebra SET biblionumbers=? WHERE server=? AND indexname=? AND value=?");
2958 foreach my $key (keys %result) {
2959 foreach my $index (keys %{$result{$key}}) {
2960 $sth->execute($result{$key}->{$index}, $server, $key, $index);
2963 $dbh->do('UNLOCK TABLES');
2967 # we use zebra, just fill zebraqueue table
2969 my $sth=$dbh->prepare("insert into zebraqueue (biblio_auth_number ,server,operation) values(?,?,?)");
2970 $sth->execute($biblionumber,$server,$op);
2975 =head2 GetNoZebraIndexes
2977 %indexes = GetNoZebraIndexes;
2979 return the data from NoZebraIndexes syspref.
2983 sub GetNoZebraIndexes {
2984 my $index = C4::Context->preference('NoZebraIndexes');
2986 foreach my $line (split /('|"),/,$index) {
2987 $line =~ /(.*)=>(.*)/;
2988 my $index = substr($1,1); # get the index, don't forget to remove initial ' or "
2990 $index =~ s/'|"| //g;
2991 $fields =~ s/'|"| //g;
2992 $indexes{$index}=$fields;
2997 =head1 INTERNAL FUNCTIONS
2999 =head2 _DelBiblioNoZebra($biblionumber,$record,$server);
3001 function to delete a biblio in NoZebra indexes
3002 This function does NOT delete anything in database : it reads all the indexes entries
3003 that have to be deleted & delete them in the hash
3004 The SQL part is done either :
3005 - after the Add if we are modifying a biblio (delete + add again)
3006 - immediatly after this sub if we are doing a true deletion.
3007 $server can be 'biblioserver' or 'authorityserver' : it indexes biblios or authorities (in the same table, $server being part of the table itself
3012 sub _DelBiblioNoZebra {
3013 my ($biblionumber, $record, $server)=@_;
3016 my $dbh = C4::Context->dbh;
3020 if ($server eq 'biblioserver') {
3021 %index=GetNoZebraIndexes;
3022 # get title of the record (to store the 10 first letters with the index)
3023 my ($titletag,$titlesubfield) = GetMarcFromKohaField('biblio.title');
3024 $title = lc($record->subfield($titletag,$titlesubfield));
3026 # for authorities, the "title" is the $a mainentry
3027 my $authref = C4::AuthoritiesMarc::GetAuthType($record->subfield(152,'b'));
3028 warn "ERROR : authtype undefined for ".$record->as_formatted unless $authref;
3029 $title = $record->subfield($authref->{auth_tag_to_report},'a');
3030 $index{'mainmainentry'}= $authref->{'auth_tag_to_report'}.'a';
3031 $index{'mainentry'} = $authref->{'auth_tag_to_report'}.'*';
3032 $index{'auth_type'} = '152b';
3036 # remove blancks comma (that could cause problem when decoding the string for CQL retrieval) and regexp specific values
3037 $title =~ s/ |,|;|\[|\]|\(|\)|\*|-|'|=//g;
3038 # limit to 10 char, should be enough, and limit the DB size
3039 $title = substr($title,0,10);
3041 my $sth2=$dbh->prepare('SELECT biblionumbers FROM nozebra WHERE server=? AND indexname=? AND value=?');
3042 foreach my $field ($record->fields()) {
3043 #parse each subfield
3044 next if $field->tag <10;
3045 foreach my $subfield ($field->subfields()) {
3046 my $tag = $field->tag();
3047 my $subfieldcode = $subfield->[0];
3049 # check each index to see if the subfield is stored somewhere
3050 # otherwise, store it in __RAW__ index
3051 foreach my $key (keys %index) {
3052 # warn "examining $key index : ".$index{$key}." for $tag $subfieldcode";
3053 if ($index{$key} =~ /$tag\*/ or $index{$key} =~ /$tag$subfieldcode/) {
3055 my $line= lc $subfield->[1];
3056 # remove meaningless value in the field...
3057 $line =~ s/-|\.|\?|,|;|!|'|\(|\)|\[|\]|{|}|"|<|>|&|\+|\*|\/|=|:/ /g;
3058 # ... and split in words
3059 foreach (split / /,$line) {
3060 next unless $_; # skip empty values (multiple spaces)
3061 # if the entry is already here, do nothing, the biblionumber has already be removed
3062 unless ($result{$key}->{$_} =~ /$biblionumber,$title\-(\d);/) {
3063 # get the index value if it exist in the nozebra table and remove the entry, otherwise, do nothing
3064 $sth2->execute($server,$key,$_);
3065 my $existing_biblionumbers = $sth2->fetchrow;
3067 if ($existing_biblionumbers) {
3068 # warn " existing for $key $_: $existing_biblionumbers";
3069 $result{$key}->{$_} =$existing_biblionumbers;
3070 $result{$key}->{$_} =~ s/$biblionumber,$title\-(\d);//;
3076 # the subfield is not indexed, store it in __RAW__ index anyway
3078 my $line= lc $subfield->[1];
3079 $line =~ s/-|\.|\?|,|;|!|'|\(|\)|\[|\]|{|}|"|<|>|&|\+|\*|\/|=|:/ /g;
3080 # ... and split in words
3081 foreach (split / /,$line) {
3082 next unless $_; # skip empty values (multiple spaces)
3083 # if the entry is already here, do nothing, the biblionumber has already be removed
3084 unless ($result{'__RAW__'}->{$_} =~ /$biblionumber,$title\-(\d);/) {
3085 # get the index value if it exist in the nozebra table and remove the entry, otherwise, do nothing
3086 $sth2->execute($server,'__RAW__',$_);
3087 my $existing_biblionumbers = $sth2->fetchrow;
3089 if ($existing_biblionumbers) {
3090 $result{'__RAW__'}->{$_} =$existing_biblionumbers;
3091 $result{'__RAW__'}->{$_} =~ s/$biblionumber,$title\-(\d);//;
3101 =head2 _AddBiblioNoZebra($biblionumber, $record, $server, %result);
3103 function to add a biblio in NoZebra indexes
3107 sub _AddBiblioNoZebra {
3108 my ($biblionumber, $record, $server, %result)=@_;
3109 my $dbh = C4::Context->dbh;
3113 if ($server eq 'biblioserver') {
3114 %index=GetNoZebraIndexes;
3115 # get title of the record (to store the 10 first letters with the index)
3116 my ($titletag,$titlesubfield) = GetMarcFromKohaField('biblio.title');
3117 $title = lc($record->subfield($titletag,$titlesubfield));
3119 # warn "server : $server";
3120 # for authorities, the "title" is the $a mainentry
3121 my $authref = C4::AuthoritiesMarc::GetAuthType($record->subfield(152,'b'));
3122 warn "ERROR : authtype undefined for ".$record->as_formatted unless $authref;
3123 $title = $record->subfield($authref->{auth_tag_to_report},'a');
3124 $index{'mainmainentry'} = $authref->{auth_tag_to_report}.'a';
3125 $index{'mainentry'} = $authref->{auth_tag_to_report}.'*';
3126 $index{'auth_type'} = '152b';
3129 # remove blancks comma (that could cause problem when decoding the string for CQL retrieval) and regexp specific values
3130 $title =~ s/ |,|;|\[|\]|\(|\)|\*|-|'|=//g;
3131 # limit to 10 char, should be enough, and limit the DB size
3132 $title = substr($title,0,10);
3134 my $sth2=$dbh->prepare('SELECT biblionumbers FROM nozebra WHERE server=? AND indexname=? AND value=?');
3135 foreach my $field ($record->fields()) {
3136 #parse each subfield
3137 next if $field->tag <10;
3138 foreach my $subfield ($field->subfields()) {
3139 my $tag = $field->tag();
3140 my $subfieldcode = $subfield->[0];
3142 # check each index to see if the subfield is stored somewhere
3143 # otherwise, store it in __RAW__ index
3144 foreach my $key (keys %index) {
3145 # warn "examining $key index : ".$index{$key}." for $tag $subfieldcode";
3146 if ($index{$key} =~ /$tag\*/ or $index{$key} =~ /$tag$subfieldcode/) {
3148 my $line= lc $subfield->[1];
3149 # remove meaningless value in the field...
3150 $line =~ s/-|\.|\?|,|;|!|'|\(|\)|\[|\]|{|}|"|<|>|&|\+|\*|\/|=|:/ /g;
3151 # ... and split in words
3152 foreach (split / /,$line) {
3153 next unless $_; # skip empty values (multiple spaces)
3154 # if the entry is already here, improve weight
3155 # warn "managing $_";
3156 if ($result{$key}->{"$_"} =~ /$biblionumber,$title\-(\d);/) {
3158 $result{$key}->{"$_"} =~ s/$biblionumber,$title\-(\d);//;
3159 $result{$key}->{"$_"} .= "$biblionumber,$title-$weight;";
3161 # get the value if it exist in the nozebra table, otherwise, create it
3162 $sth2->execute($server,$key,$_);
3163 my $existing_biblionumbers = $sth2->fetchrow;
3165 if ($existing_biblionumbers) {
3166 $result{$key}->{"$_"} =$existing_biblionumbers;
3168 $result{$key}->{"$_"} =~ s/$biblionumber,$title\-(\d);//;
3169 $result{$key}->{"$_"} .= "$biblionumber,$title-$weight;";
3170 # create a new ligne for this entry
3172 # warn "INSERT : $server / $key / $_";
3173 $dbh->do('INSERT INTO nozebra SET server='.$dbh->quote($server).', indexname='.$dbh->quote($key).',value='.$dbh->quote($_));
3174 $result{$key}->{"$_"}.="$biblionumber,$title-1;";
3180 # the subfield is not indexed, store it in __RAW__ index anyway
3182 my $line= lc $subfield->[1];
3183 $line =~ s/-|\.|\?|,|;|!|'|\(|\)|\[|\]|{|}|"|<|>|&|\+|\*|\/|=|:/ /g;
3184 # ... and split in words
3185 foreach (split / /,$line) {
3186 next unless $_; # skip empty values (multiple spaces)
3187 # if the entry is already here, improve weight
3188 if ($result{'__RAW__'}->{"$_"} =~ /$biblionumber,$title\-(\d);/) {
3190 $result{'__RAW__'}->{"$_"} =~ s/$biblionumber,$title\-(\d);//;
3191 $result{'__RAW__'}->{"$_"} .= "$biblionumber,$title-$weight;";
3193 # get the value if it exist in the nozebra table, otherwise, create it
3194 $sth2->execute($server,'__RAW__',$_);
3195 my $existing_biblionumbers = $sth2->fetchrow;
3197 if ($existing_biblionumbers) {
3198 $result{'__RAW__'}->{"$_"} =$existing_biblionumbers;
3200 $result{'__RAW__'}->{"$_"} =~ s/$biblionumber,$title\-(\d);//;
3201 $result{'__RAW__'}->{"$_"} .= "$biblionumber,$title-$weight;";
3202 # create a new ligne for this entry
3204 $dbh->do('INSERT INTO nozebra SET server='.$dbh->quote($server).', indexname="__RAW__",value='.$dbh->quote($_));
3205 $result{'__RAW__'}->{"$_"}.="$biblionumber,$title-1;";
3216 =head2 MARCitemchange
3220 &MARCitemchange( $record, $itemfield, $newvalue )
3222 Function to update a single value in an item field.
3223 Used twice, could probably be replaced by something else, but works well...
3231 sub MARCitemchange {
3232 my ( $record, $itemfield, $newvalue ) = @_;
3233 my $dbh = C4::Context->dbh;
3235 my ( $tagfield, $tagsubfield ) =
3236 GetMarcFromKohaField( $itemfield, "" );
3237 if ( ($tagfield) && ($tagsubfield) ) {
3238 my $tag = $record->field($tagfield);
3240 $tag->update( $tagsubfield => $newvalue );
3241 $record->delete_field($tag);
3242 $record->insert_fields_ordered($tag);
3247 =head2 _koha_add_biblio
3251 _koha_add_biblio($dbh,$biblioitem);
3253 Internal function to add a biblio ($biblio is a hash with the values)
3259 sub _koha_add_biblio {
3260 my ( $dbh, $biblio, $frameworkcode ) = @_;
3261 my $sth = $dbh->prepare("Select max(biblionumber) from biblio");
3263 my $data = $sth->fetchrow_arrayref;
3264 my $biblionumber = $$data[0] + 1;
3267 if ( $biblio->{'seriestitle'} ) { $series = 1 }
3269 $sth = $dbh->prepare(
3271 SET biblionumber = ?, title = ?, author = ?, copyrightdate = ?, serial = ?, seriestitle = ?, notes = ?, abstract = ?, unititle = ?, frameworkcode = ? "
3274 $biblionumber, $biblio->{'title'},
3275 $biblio->{'author'}, $biblio->{'copyrightdate'},
3276 $biblio->{'serial'}, $biblio->{'seriestitle'},
3277 $biblio->{'notes'}, $biblio->{'abstract'},
3278 $biblio->{'unititle'}, $frameworkcode
3282 return ($biblionumber);
3289 ($indicators, $value) = _find_value($tag, $subfield, $record,$encoding);
3291 Find the given $subfield in the given $tag in the given
3292 MARC::Record $record. If the subfield is found, returns
3293 the (indicators, value) pair; otherwise, (undef, undef) is
3297 Such a function is used in addbiblio AND additem and serial-edit and maybe could be used in Authorities.
3298 I suggest we export it from this module.
3305 my ( $tagfield, $insubfield, $record, $encoding ) = @_;
3308 if ( $tagfield < 10 ) {
3309 if ( $record->field($tagfield) ) {
3310 push @result, $record->field($tagfield)->data();
3317 foreach my $field ( $record->field($tagfield) ) {
3318 my @subfields = $field->subfields();
3319 foreach my $subfield (@subfields) {
3320 if ( @$subfield[0] eq $insubfield ) {
3321 push @result, @$subfield[1];
3322 $indicator = $field->indicator(1) . $field->indicator(2);
3327 return ( $indicator, @result );
3330 =head2 _koha_modify_biblio
3334 $biblionumber = _koha_modify_biblio($dbh,$biblio);
3335 Internal function for updating the biblio table
3341 sub _koha_modify_biblio {
3342 my ( $dbh, $biblio ) = @_;
3343 # FIXME: this code could be made more portable by not hard-coding
3344 # the values that are supposed to be in biblio table
3355 WHERE biblionumber = ?
3357 my $sth = $dbh->prepare($query);
3361 $biblio->{'author'},
3362 $biblio->{'abstract'},
3363 $biblio->{'copyrightdate'},
3364 $biblio->{'seriestitle'},
3365 $biblio->{'serial'},
3366 $biblio->{'unititle'},
3368 $biblio->{'biblionumber'}
3369 ) if $biblio->{'biblionumber'};
3371 warn $sth->err if $sth->err;
3372 warn "BIG ERROR :: No biblionumber for $biblio->{title}" if $biblio->{biblionumber} !~ /\d+/; # if it is not a number
3373 return ( $biblio->{'biblionumber'} );
3376 =head2 _koha_modify_biblioitem
3380 _koha_modify_biblioitem( $dbh, $biblioitem );
3386 sub _koha_modify_biblioitem {
3387 my ( $dbh, $biblioitem ) = @_;
3389 ##Recalculate LC in case it changed --TG
3391 $biblioitem->{'itemtype'} = $dbh->quote( $biblioitem->{'itemtype'} );
3392 $biblioitem->{'url'} = $dbh->quote( $biblioitem->{'url'} );
3393 $biblioitem->{'isbn'} = $dbh->quote( $biblioitem->{'isbn'} );
3394 $biblioitem->{'issn'} = $dbh->quote( $biblioitem->{'issn'} );
3395 $biblioitem->{'publishercode'} =
3396 $dbh->quote( $biblioitem->{'publishercode'} );
3397 $biblioitem->{'publicationyear'} =
3398 $dbh->quote( $biblioitem->{'publicationyear'} );
3399 $biblioitem->{'classification'} =
3400 $dbh->quote( $biblioitem->{'classification'} );
3401 $biblioitem->{'dewey'} = $dbh->quote( $biblioitem->{'dewey'} );
3402 $biblioitem->{'subclass'} = $dbh->quote( $biblioitem->{'subclass'} );
3403 $biblioitem->{'illus'} = $dbh->quote( $biblioitem->{'illus'} );
3404 $biblioitem->{'pages'} = $dbh->quote( $biblioitem->{'pages'} );
3405 $biblioitem->{'volumeddesc'} = $dbh->quote( $biblioitem->{'volumeddesc'} );
3406 $biblioitem->{'bnotes'} = $dbh->quote( $biblioitem->{'bnotes'} );
3407 $biblioitem->{'size'} = $dbh->quote( $biblioitem->{'size'} );
3408 $biblioitem->{'place'} = $dbh->quote( $biblioitem->{'place'} );
3409 $biblioitem->{'collectiontitle'} = $dbh->quote( $biblioitem->{'collectiontitle'} );
3410 $biblioitem->{'collectionissn'} = $dbh->quote( $biblioitem->{'collectionissn'} );
3411 $biblioitem->{'collectionvolume'} = $dbh->quote( $biblioitem->{'collectionvolume'} );
3412 $biblioitem->{'editionstatement'} = $dbh->quote( $biblioitem->{'editionstatement'} );
3413 $biblioitem->{'editionresponsibility'} = $dbh->quote( $biblioitem->{'editionresponsibility'} );
3414 $biblioitem->{'ccode'} = $dbh->quote( $biblioitem->{'ccode'} );
3415 $biblioitem->{'biblionumber'} =
3416 $dbh->quote( $biblioitem->{'biblionumber'} );
3418 $query = "UPDATE biblioitems SET
3419 itemtype = $biblioitem->{'itemtype'},
3420 url = $biblioitem->{'url'},
3421 isbn = $biblioitem->{'isbn'},
3422 issn = $biblioitem->{'issn'},
3423 publishercode = $biblioitem->{'publishercode'},
3424 publicationyear = $biblioitem->{'publicationyear'},
3425 classification = $biblioitem->{'classification'},
3426 dewey = $biblioitem->{'dewey'},
3427 subclass = $biblioitem->{'subclass'},
3428 illus = $biblioitem->{'illus'},
3429 pages = $biblioitem->{'pages'},
3430 volumeddesc = $biblioitem->{'volumeddesc'},
3431 notes = $biblioitem->{'bnotes'},
3432 size = $biblioitem->{'size'},
3433 place = $biblioitem->{'place'},
3434 collectiontitle = $biblioitem->{'collectiontitle'},
3435 collectionissn = $biblioitem->{'collectionissn'},
3436 collectionvolume= $biblioitem->{'collectionvolume'},
3437 editionstatement= $biblioitem->{'editionstatement'},
3438 editionresponsibility= $biblioitem->{'editionresponsibility'},
3439 ccode = $biblioitem->{'ccode'}
3440 where biblionumber = $biblioitem->{'biblionumber'}";
3443 if ( $dbh->errstr ) {
3444 warn "ERROR in _koha_modify_biblioitem $query";
3448 =head2 _koha_add_biblioitem
3452 _koha_add_biblioitem( $dbh, $biblioitem );
3454 Internal function to add a biblioitem
3460 sub _koha_add_biblioitem {
3461 my ( $dbh, $biblioitem ) = @_;
3463 # my $dbh = C4Connect;
3464 my $sth = $dbh->prepare("SELECT max(biblioitemnumber) FROM biblioitems");
3469 $data = $sth->fetchrow_arrayref;
3470 $bibitemnum = $$data[0] + 1;
3474 $sth = $dbh->prepare(
3475 "INSERT INTO biblioitems SET
3476 biblioitemnumber = ?, biblionumber = ?,
3477 volume = ?, number = ?,
3478 classification = ?, itemtype = ?,
3480 issn = ?, dewey = ?,
3481 subclass = ?, publicationyear = ?,
3482 publishercode = ?, volumedate = ?,
3483 volumeddesc = ?, illus = ?,
3484 pages = ?, notes = ?,
3486 marc = ?, lcsort = ?,
3487 place = ?, ccode = ?,
3488 collectiontitle = ?, collectionissn = ?,
3489 collectionvolume = ?, editionstatement= ?,
3490 editionresponsibility= ?
3494 calculatelc( $biblioitem->{'classification'} )
3495 . $biblioitem->{'subclass'};
3497 $bibitemnum, $biblioitem->{'biblionumber'},
3498 $biblioitem->{'volume'}, $biblioitem->{'number'},
3499 $biblioitem->{'classification'}, $biblioitem->{'itemtype'},
3500 $biblioitem->{'url'}, $biblioitem->{'isbn'},
3501 $biblioitem->{'issn'}, $biblioitem->{'dewey'},
3502 $biblioitem->{'subclass'}, $biblioitem->{'publicationyear'},
3503 $biblioitem->{'publishercode'}, $biblioitem->{'volumedate'},
3504 $biblioitem->{'volumeddesc'}, $biblioitem->{'illus'},
3505 $biblioitem->{'pages'}, $biblioitem->{'bnotes'},
3506 $biblioitem->{'size'}, $biblioitem->{'lccn'},
3507 $biblioitem->{'marc'}, $biblioitem->{'place'},
3508 $lcsort, $biblioitem->{'ccode'},
3509 $biblioitem->{'collectiontitle'},$biblioitem->{'collectionissn'},
3510 $biblioitem->{'collectionvolume'},$biblioitem->{'editionstatement'},
3511 $biblioitem->{'editionresponsibility'}
3514 return ($bibitemnum);
3517 =head2 _koha_new_items
3521 _koha_new_items( $dbh, $item, $barcode );
3527 sub _koha_new_items {
3528 my ( $dbh, $item, $barcode ) = @_;
3530 # my $dbh = C4Connect;
3531 my $sth = $dbh->prepare("Select max(itemnumber) from items");
3537 $data = $sth->fetchrow_hashref;
3538 $itemnumber = $data->{'max(itemnumber)'} + 1;
3540 ## Now calculate lccalnumber
3541 my ($cutterextra) = itemcalculator(
3543 $item->{'biblioitemnumber'},
3544 $item->{'itemcallnumber'}
3547 # FIXME the "notforloan" field seems to be named "loan" in some places. workaround bugfix.
3548 if ( $item->{'loan'} ) {
3549 $item->{'notforloan'} = $item->{'loan'};
3552 # if dateaccessioned is provided, use it. Otherwise, set to NOW()
3553 if ( $item->{'dateaccessioned'} eq '' || !$item->{'dateaccessioned'} ) {
3555 $sth = $dbh->prepare(
3556 "Insert into items set
3557 itemnumber = ?, biblionumber = ?,
3558 biblioitemnumber = ?, barcode = ?,
3559 booksellerid = ?, dateaccessioned = NOW(),
3560 homebranch = ?, holdingbranch = ?,
3561 price = ?, replacementprice = ?,
3562 replacementpricedate = NOW(), datelastseen = NOW(),
3564 itemlost = ?, wthdrawn = ?,
3565 paidfor = ?, itemnotes = ?,
3566 itemcallnumber =?, notforloan = ?,
3567 location = ?, Cutterextra = ?
3571 $itemnumber, $item->{'biblionumber'},
3572 $item->{'biblioitemnumber'},
3573 $barcode, $item->{'booksellerid'},
3574 $item->{'homebranch'}, $item->{'holdingbranch'},
3575 $item->{'price'}, $item->{'replacementprice'},
3577 $item->{itemlost}, $item->{wthdrawn},
3578 $item->{paidfor}, $item->{'itemnotes'},
3579 $item->{'itemcallnumber'}, $item->{'notforloan'},
3580 $item->{'location'}, $cutterextra
3584 $sth = $dbh->prepare(
3585 "INSERT INTO items SET
3586 itemnumber = ?, biblionumber = ?,
3587 biblioitemnumber = ?, barcode = ?,
3588 booksellerid = ?, dateaccessioned = ?,
3589 homebranch = ?, holdingbranch = ?,
3590 price = ?, replacementprice = ?,
3591 replacementpricedate = NOW(), datelastseen = NOW(),
3593 itemlost = ?, wthdrawn = ?,
3594 paidfor = ?, itemnotes = ?,
3595 itemcallnumber = ?, notforloan = ?,
3601 $itemnumber, $item->{'biblionumber'},
3602 $item->{'biblioitemnumber'},
3603 $barcode, $item->{'booksellerid'},
3604 $item->{'dateaccessioned'}, $item->{'homebranch'},
3605 $item->{'holdingbranch'}, $item->{'price'},
3606 $item->{'replacementprice'},
3607 $item->{stack}, $item->{itemlost},
3608 $item->{wthdrawn}, $item->{paidfor},
3609 $item->{'itemnotes'}, $item->{'itemcallnumber'},
3610 $item->{'notforloan'}, $item->{'location'},
3614 if ( defined $sth->errstr ) {
3615 $error .= $sth->errstr;
3617 return ( $itemnumber, $error );
3620 =head2 _koha_modify_item
3624 _koha_modify_item( $dbh, $item, $op );
3630 sub _koha_modify_item {
3631 my ( $dbh, $item, $op ) = @_;
3632 $item->{'itemnum'} = $item->{'itemnumber'} unless $item->{'itemnum'};
3634 # if all we're doing is setting statuses, just update those and get out
3635 if ( $op eq "setstatus" ) {
3637 "UPDATE items SET itemlost=?,wthdrawn=? WHERE itemnumber=?";
3639 $item->{'itemlost'}, $item->{'wthdrawn'},
3640 $item->{'itemnumber'}
3642 my $sth = $dbh->prepare($query);
3643 $sth->execute(@bind);
3647 ## Now calculate lccalnumber
3649 itemcalculator( $dbh, $item->{'bibitemnum'}, $item->{'itemcallnumber'} );
3651 my $query = "UPDATE items SET
3652 barcode=?,itemnotes=?,itemcallnumber=?,notforloan=?,location=?,stack=?,wthdrawn=?,holdingbranch=?,homebranch=?,cutterextra=?, onloan=?";
3655 $item->{'barcode'}, $item->{'notes'},
3656 $item->{'itemcallnumber'}, $item->{'notforloan'},
3657 $item->{'location'}, $item->{stack},
3658 $item->{wthdrawn}, $item->{holdingbranch},
3659 $item->{homebranch}, $cutterextra,
3662 if ( $item->{'lost'} ne '' ) {
3664 "update items set biblioitemnumber=?,barcode=?,itemnotes=?,homebranch=?,
3665 itemlost=?,wthdrawn=?,itemcallnumber=?,notforloan=?,
3666 location=?,stack=?,wthdrawn=?,holdingbranch=?,cutterextra=?,onloan=?";
3668 $item->{'bibitemnum'}, $item->{'barcode'},
3669 $item->{'notes'}, $item->{'homebranch'},
3670 $item->{'lost'}, $item->{'wthdrawn'},
3671 $item->{'itemcallnumber'}, $item->{'notforloan'},
3672 $item->{'location'}, $item->{stack},
3673 $item->{wthdrawn}, $item->{holdingbranch},
3674 $cutterextra, $item->{onloan}
3676 if ( $item->{homebranch} ) {
3677 $query .= ",homebranch=?";
3678 push @bind, $item->{homebranch};
3680 if ( $item->{holdingbranch} ) {
3681 $query .= ",holdingbranch=?";
3682 push @bind, $item->{holdingbranch};
3685 $query .= " where itemnumber=?";
3686 push @bind, $item->{'itemnum'};
3687 if ( $item->{'replacement'} ne '' ) {
3688 $query =~ s/ where/,replacementprice='$item->{'replacement'}' where/;
3690 my $sth = $dbh->prepare($query);
3691 $sth->execute(@bind);
3695 =head2 _koha_delete_biblio
3699 $error = _koha_delete_biblio($dbh,$biblionumber);
3701 Internal sub for deleting from biblio table -- also saves to deletedbiblio
3703 C<$dbh> - the database handle
3704 C<$biblionumber> - the biblionumber of the biblio to be deleted
3710 # FIXME: add error handling
3712 sub _koha_delete_biblio {
3713 my ( $dbh, $biblionumber ) = @_;
3715 # get all the data for this biblio
3716 my $sth = $dbh->prepare("SELECT * FROM biblio WHERE biblionumber=?");
3717 $sth->execute($biblionumber);
3719 if ( my $data = $sth->fetchrow_hashref ) {
3721 # save the record in deletedbiblio
3722 # find the fields to save
3723 my $query = "INSERT INTO deletedbiblio SET ";
3725 foreach my $temp ( keys %$data ) {
3726 $query .= "$temp = ?,";
3727 push( @bind, $data->{$temp} );
3730 # replace the last , by ",?)"
3732 my $bkup_sth = $dbh->prepare($query);
3733 $bkup_sth->execute(@bind);
3737 my $del_sth = $dbh->prepare("DELETE FROM biblio WHERE biblionumber=?");
3738 $del_sth->execute($biblionumber);
3745 =head2 _koha_delete_biblioitems
3749 $error = _koha_delete_biblioitems($dbh,$biblioitemnumber);
3751 Internal sub for deleting from biblioitems table -- also saves to deletedbiblioitems
3753 C<$dbh> - the database handle
3754 C<$biblionumber> - the biblioitemnumber of the biblioitem to be deleted
3760 # FIXME: add error handling
3762 sub _koha_delete_biblioitems {
3763 my ( $dbh, $biblioitemnumber ) = @_;
3765 # get all the data for this biblioitem
3767 $dbh->prepare("SELECT * FROM biblioitems WHERE biblioitemnumber=?");
3768 $sth->execute($biblioitemnumber);
3770 if ( my $data = $sth->fetchrow_hashref ) {
3772 # save the record in deletedbiblioitems
3773 # find the fields to save
3774 my $query = "INSERT INTO deletedbiblioitems SET ";
3776 foreach my $temp ( keys %$data ) {
3777 $query .= "$temp = ?,";
3778 push( @bind, $data->{$temp} );
3781 # replace the last , by ",?)"
3783 my $bkup_sth = $dbh->prepare($query);
3784 $bkup_sth->execute(@bind);
3787 # delete the biblioitem
3789 $dbh->prepare("DELETE FROM biblioitems WHERE biblioitemnumber=?");
3790 $del_sth->execute($biblioitemnumber);
3797 =head2 _koha_delete_item
3801 _koha_delete_item( $dbh, $itemnum );
3803 Internal function to delete an item record from the koha tables
3809 sub _koha_delete_item {
3810 my ( $dbh, $itemnum ) = @_;
3812 my $sth = $dbh->prepare("select * from items where itemnumber=?");
3813 $sth->execute($itemnum);
3814 my $data = $sth->fetchrow_hashref;
3816 my $query = "Insert into deleteditems set ";
3818 foreach my $temp ( keys %$data ) {
3819 $query .= "$temp = ?,";
3820 push( @bind, $data->{$temp} );
3825 $sth = $dbh->prepare($query);
3826 $sth->execute(@bind);
3828 $sth = $dbh->prepare("Delete from items where itemnumber=?");
3829 $sth->execute($itemnum);
3833 =head1 UNEXPORTED FUNCTIONS
3839 $lc = calculatelc($classification);
3846 my ($classification) = @_;
3847 $classification =~ s/^\s+|\s+$//g;
3852 for ( $i = 0 ; $i < length($classification) ; $i++ ) {
3853 my $c = ( substr( $classification, $i, 1 ) );
3854 if ( $c ge '0' && $c le '9' ) {
3856 $lc2 = substr( $classification, $i );
3860 $lc1 .= substr( $classification, $i, 1 );
3865 my $other = length($lc1);
3872 for ( 1 .. ( 4 - $other ) ) {
3881 ##Find the decimal part of $lc2
3882 my $pos = index( $lc2, "." );
3883 if ( $pos < 0 ) { $pos = length($lc2); }
3884 if ( $pos >= 0 && $pos < 5 ) {
3885 ##Pad lc2 with zeros to create a 5digit decimal needed in marc record to sort as numeric
3887 for ( 1 .. ( 5 - $pos ) ) {
3891 $lc2 = $extras . $lc2;
3892 return ( $lc1 . $lc2 );
3895 =head2 itemcalculator
3899 $cutterextra = itemcalculator( $dbh, $biblioitem, $callnumber );
3905 sub itemcalculator {
3906 my ( $dbh, $biblioitem, $callnumber ) = @_;
3909 "select classification, subclass from biblioitems where biblioitemnumber=?"
3912 $sth->execute($biblioitem);
3913 my ( $classification, $subclass ) = $sth->fetchrow;
3914 my $all = $classification . " " . $subclass;
3915 my $total = length($all);
3916 my $cutterextra = substr( $callnumber, $total - 1 );
3918 return $cutterextra;
3921 =head2 ModBiblioMarc
3923 &ModBiblioMarc($newrec,$biblionumber,$frameworkcode);
3925 Add MARC data for a biblio to koha
3927 Function exported, but should NOT be used, unless you really know what you're doing
3933 # pass the MARC::Record to this function, and it will create the records in the marc field
3934 my ( $record, $biblionumber, $frameworkcode ) = @_;
3935 my $dbh = C4::Context->dbh;
3936 my @fields = $record->fields();
3937 if ( !$frameworkcode ) {
3938 $frameworkcode = "";
3941 $dbh->prepare("UPDATE biblio SET frameworkcode=? WHERE biblionumber=?");
3942 $sth->execute( $frameworkcode, $biblionumber );
3944 my $encoding = C4::Context->preference("marcflavour");
3946 # deal with UNIMARC field 100 (encoding) : create it if needed & set encoding to unicode
3947 if ( $encoding eq "UNIMARC" ) {
3949 if ( length($record->subfield( 100, "a" )) == 35 ) {
3950 $string = $record->subfield( 100, "a" );
3951 my $f100 = $record->field(100);
3952 $record->delete_field($f100);
3955 $string = POSIX::strftime( "%Y%m%d", localtime );
3957 $string = sprintf( "%-*s", 35, $string );
3959 substr( $string, 22, 6, "frey50" );
3960 unless ( $record->subfield( 100, "a" ) ) {
3961 $record->insert_grouped_field(
3962 MARC::Field->new( 100, "", "", "a" => $string ) );
3965 ModZebra($biblionumber,"specialUpdate","biblioserver",$record);
3968 "update biblioitems set marc=?,marcxml=? where biblionumber=?");
3969 $sth->execute( $record->as_usmarc(), $record->as_xml_record($encoding),
3972 return $biblionumber;
3975 =head2 AddItemInMarc
3979 $newbiblionumber = AddItemInMarc( $record, $biblionumber, $frameworkcode );
3981 Add an item in a MARC record and save the MARC record
3983 Function exported, but should NOT be used, unless you really know what you're doing
3991 # pass the MARC::Record to this function, and it will create the records in the marc tables
3992 my ( $record, $biblionumber, $frameworkcode ) = @_;
3993 my $newrec = &GetMarcBiblio($biblionumber);
3996 my @fields = $record->fields();
3997 foreach my $field (@fields) {
3998 $newrec->append_fields($field);
4001 # FIXME: should we be making sure the biblionumbers are the same?
4002 my $newbiblionumber =
4003 &ModBiblioMarc( $newrec, $biblionumber, $frameworkcode );
4004 return $newbiblionumber;
4007 =head2 z3950_extended_services
4009 z3950_extended_services($serviceType,$serviceOptions,$record);
4011 z3950_extended_services is used to handle all interactions with Zebra's extended serices package, which is employed to perform all management of the MARC data stored in Zebra.
4013 C<$serviceType> one of: itemorder,create,drop,commit,update,xmlupdate
4015 C<$serviceOptions> a has of key/value pairs. For instance, if service_type is 'update', $service_options should contain:
4017 action => update action, one of specialUpdate, recordInsert, recordReplace, recordDelete, elementUpdate.
4021 recordidOpaque => Opaque Record ID (user supplied) or recordidNumber => Record ID number (system number).
4022 syntax => the record syntax (transfer syntax)
4023 databaseName = Database from connection object
4025 To set serviceOptions, call set_service_options($serviceType)
4027 C<$record> the record, if one is needed for the service type
4029 A record should be in XML. You can convert it to XML from MARC by running it through marc2xml().
4033 sub z3950_extended_services {
4034 my ( $server, $serviceType, $action, $serviceOptions ) = @_;
4036 # get our connection object
4037 my $Zconn = C4::Context->Zconn( $server, 0, 1 );
4039 # create a new package object
4040 my $Zpackage = $Zconn->package();
4043 $Zpackage->option( action => $action );
4045 if ( $serviceOptions->{'databaseName'} ) {
4046 $Zpackage->option( databaseName => $serviceOptions->{'databaseName'} );
4048 if ( $serviceOptions->{'recordIdNumber'} ) {
4050 recordIdNumber => $serviceOptions->{'recordIdNumber'} );
4052 if ( $serviceOptions->{'recordIdOpaque'} ) {
4054 recordIdOpaque => $serviceOptions->{'recordIdOpaque'} );
4057 # this is an ILL request (Zebra doesn't support it, but Koha could eventually)
4058 #if ($serviceType eq 'itemorder') {
4059 # $Zpackage->option('contact-name' => $serviceOptions->{'contact-name'});
4060 # $Zpackage->option('contact-phone' => $serviceOptions->{'contact-phone'});
4061 # $Zpackage->option('contact-email' => $serviceOptions->{'contact-email'});
4062 # $Zpackage->option('itemorder-item' => $serviceOptions->{'itemorder-item'});
4065 if ( $serviceOptions->{record} ) {
4066 $Zpackage->option( record => $serviceOptions->{record} );
4068 # can be xml or marc
4069 if ( $serviceOptions->{'syntax'} ) {
4070 $Zpackage->option( syntax => $serviceOptions->{'syntax'} );
4074 # send the request, handle any exception encountered
4075 eval { $Zpackage->send($serviceType) };
4076 if ( $@ && $@->isa("ZOOM::Exception") ) {
4077 return "error: " . $@->code() . " " . $@->message() . "\n";
4080 # free up package resources
4081 $Zpackage->destroy();
4084 =head2 set_service_options
4086 my $serviceOptions = set_service_options($serviceType);
4088 C<$serviceType> itemorder,create,drop,commit,update,xmlupdate
4090 Currently, we only support 'create', 'commit', and 'update'. 'drop' support will be added as soon as Zebra supports it.
4094 sub set_service_options {
4095 my ($serviceType) = @_;
4098 # FIXME: This needs to be an OID ... if we ever need 'syntax' this sub will need to change
4099 # $serviceOptions->{ 'syntax' } = ''; #zebra doesn't support syntaxes other than xml
4101 if ( $serviceType eq 'commit' ) {
4105 if ( $serviceType eq 'create' ) {
4109 if ( $serviceType eq 'drop' ) {
4110 die "ERROR: 'drop' not currently supported (by Zebra)";
4112 return $serviceOptions;
4115 =head2 GetItemsCount
4117 $count = &GetItemsCount( $biblionumber);
4118 this function return count of item with $biblionumber
4122 my ( $biblionumber ) = @_;
4123 my $dbh = C4::Context->dbh;
4124 my $query = qq|SELECT count(*)
4126 WHERE biblionumber=?|;
4127 my $sth = $dbh->prepare($query);
4128 $sth->execute($biblionumber);
4129 my $count = $sth->fetchrow;
4134 END { } # module clean-up code here (global destructor)
4142 Koha Developement team <info@koha.org>
4144 Paul POULAIN paul.poulain@free.fr
4146 Joshua Ferraro jmf@liblime.com
4152 # Revision 1.221 2007/07/31 16:01:11 toins
4153 # Some new functions.
4154 # TransformHTMLtoMarc rewrited.
4156 # Revision 1.220 2007/07/20 15:43:16 hdl
4157 # Bug Fixing GetMarcSubjects.
4158 # Links parameters were mixed.
4160 # Revision 1.218 2007/07/19 07:40:08 hdl
4161 # Adding selection by location for inventory
4163 # Revision 1.217 2007/07/03 13:47:44 tipaul
4164 # fixing some display bugs (itemtype not properly returned and a html table bug that makes items appear strangely
4166 # Revision 1.216 2007/07/03 09:40:58 tipaul
4167 # return itemtype description properly
4169 # Revision 1.215 2007/07/03 09:33:05 tipaul
4170 # if you just replace su by a space in subjects, you'll replace jesus by je s, which is strange for users. this fix solves the problem and introduces authoritysep systempref as separator of subfields, for a better identification of where the authority starts and end
4172 # Revision 1.214 2007/07/02 09:13:22 tipaul
4173 # unimarc bugfix : the encoding is in field 100 in UNIMARC. when TransformHTMLtoXML on an item, you must not automatically add a 100 field in items, otherwise there will be 2 100 fields in the biblio, which is wrong
4175 # Revision 1.213 2007/06/25 15:01:45 tipaul
4176 # bugfixes on unimarc 100 handling (the field used for encoding)
4178 # Revision 1.212 2007/06/15 13:44:44 tipaul
4179 # some fixes (and only fixes)
4181 # Revision 1.211 2007/06/15 09:40:06 toins
4182 # do not get $3 $4 and $5 on GetMarcSubjects GetMarcAuthors on unimarc flavour.
4184 # Revision 1.210 2007/06/13 13:03:34 toins
4185 # removing warn compilation.
4187 # Revision 1.209 2007/05/23 16:19:40 tipaul
4188 # various bugfixes (minor) and french translation updated
4190 # Revision 1.208 2007/05/22 09:13:54 tipaul
4191 # Bugfixes & improvements (various and minor) :
4192 # - updating templates to have tmpl_process3.pl running without any errors
4193 # - adding a drupal-like css for prog templates (with 3 small images)
4194 # - fixing some bugs in circulation & other scripts
4195 # - updating french translation
4196 # - fixing some typos in templates
4198 # Revision 1.207 2007/05/22 08:51:19 hdl
4199 # Changing GetMarcStructure signature.
4200 # Deleting first parameter $dbh
4202 # Revision 1.206 2007/05/21 08:44:17 btoumi
4203 # add security when u delete biblio :
4204 # u must delete linked items before delete biblio
4206 # Revision 1.205 2007/05/11 16:04:03 btoumi
4208 # problem in displayed label link with subject in detail.tmpl
4209 # ex: label random => rdom
4211 # Revision 1.204 2007/05/10 14:45:15 tipaul
4213 # - support for authorities
4214 # - some bugfixes in ordering and "CCL" parsing
4215 # - support for authorities <=> biblios walking
4217 # Seems I can do what I want now, so I consider its done, except for bugfixes that will be needed i m sure !
4219 # Revision 1.203 2007/05/03 15:16:02 tipaul
4220 # BUGFIX for : NoZebra
4221 # - NoZebra features : seems they work fine now (adding, modifying, deleting)
4222 # - Biblio edition major bugfix : before this commit editing a biblio resulted in an item removal in marcxml field
4224 # Revision 1.202 2007/05/02 16:44:31 tipaul
4225 # NoZebra SQL index management :
4226 # * adding 3 subs in Biblio.pm
4227 # - GetNoZebraIndexes, that get the index structure in a new systempreference (added with this commit)
4228 # - _DelBiblioNoZebra, that retrieve all index entries for a biblio and remove in a variable the biblio reference
4229 # - _AddBiblioNoZebra, that add index entries for a biblio.
4230 # Note that the 2 _Add and _Del subs work only in a hash variable, to speed up things in case of a modif (ie : delete+add). The effective SQL update is done in the ModZebra sub (that existed before, and dealed with zebra index).
4231 # I think the code has to be more deeply tested, but it works at least partially.
4233 # Revision 1.201 2007/04/27 14:00:49 hdl
4234 # Removing $dbh from GetMarcFromKohaField (dbh is not used in this function.)
4236 # Revision 1.200 2007/04/25 16:26:42 tipaul
4237 # Koha 3.0 nozebra 1st commit : the script misc/migration_tools/rebuild_nozebra.pl build the nozebra table, and, if you set NoZebra to Yes, queries will be done through zebra. TODO :
4238 # - add nozebra table management on biblio editing
4239 # - the index table content is hardcoded. I still have to add some specific systempref to let the library update it
4240 # - manage pagination (next/previous)
4243 # - NZgetRecords : has exactly the same API & returns as zebra getQuery, except that some parameters are unused
4244 # - search & sort works quite good
4245 # - CQL parser is better that what I thought I could do : title="harry and sally" and publicationyear>2000 not itemtype=LIVR should work fine
4247 # Revision 1.199 2007/04/24 09:07:53 tipaul
4248 # moving dotransfer to Biblio.pm::ModItemTransfer + some CheckReserves fixes
4250 # Revision 1.198 2007/04/23 15:21:17 tipaul
4251 # renaming currenttransfers to transferstoreceive
4253 # Revision 1.197 2007/04/18 17:00:14 tipaul
4254 # removing all useless %env / $env
4256 # Revision 1.196 2007/04/17 08:48:00 tipaul
4257 # circulation cleaning continued: bufixing
4259 # Revision 1.195 2007/04/04 16:46:22 tipaul
4260 # HUGE COMMIT : code cleaning circulation.
4262 # some stuff to do, i'll write a mail on koha-devel NOW !
4264 # Revision 1.194 2007/03/30 12:00:42 tipaul
4265 # why the hell do we need to explicitly utf8 decode this string ? I really don't know, but it seems it's mandatory, otherwise, tag descriptions are not properly encoded...
4267 # Revision 1.193 2007/03/29 16:45:53 tipaul
4268 # Code cleaning of Biblio.pm (continued)
4270 # All subs have be cleaned :
4273 # - reordering Biblio.pm completly
4274 # - using only naming conventions
4276 # Seems to have broken nothing, but it still has to be heavily tested.
4277 # Note that Biblio.pm is now much more efficient than previously & probably more reliable as well.
4279 # Revision 1.192 2007/03/29 13:30:31 tipaul
4281 # == Biblio.pm cleaning (useless) ==
4282 # * some sub declaration dropped
4283 # * removed modbiblio sub
4284 # * removed moditem sub
4285 # * removed newitems. It was used only in finishrecieve. Replaced by a TransformKohaToMarc+AddItem, that is better.
4286 # * removed MARCkoha2marcItem
4287 # * removed MARCdelsubfield declaration
4288 # * removed MARCkoha2marcBiblio
4290 # == Biblio.pm cleaning (naming conventions) ==
4291 # * MARCgettagslib renamed to GetMarcStructure
4292 # * MARCgetitems renamed to GetMarcItem
4293 # * MARCfind_frameworkcode renamed to GetFrameworkCode
4294 # * MARCmarc2koha renamed to TransformMarcToKoha
4295 # * MARChtml2marc renamed to TransformHtmlToMarc
4296 # * MARChtml2xml renamed to TranformeHtmlToXml
4297 # * zebraop renamed to ModZebra
4300 # * removing MARC=OFF related scripts (in cataloguing directory)
4301 # * removed checkitems (function related to MARC=off feature, that is completly broken in head. If someone want to reintroduce it, hard work coming...)
4302 # * removed getitemsbybiblioitem (used only by MARC=OFF scripts, that is removed as well)
4304 # Revision 1.191 2007/03/29 09:42:13 tipaul
4305 # adding default value new feature into cataloguing. The system (definition) part has already been added by toins
4307 # Revision 1.190 2007/03/29 08:45:19 hdl
4308 # Deleting ignore_errors(1) pour MARC::Charset
4310 # Revision 1.189 2007/03/28 10:39:16 hdl
4311 # removing $dbh as a parameter in AuthoritiesMarc functions
4312 # And reporting all differences into the scripts taht relies on those functions.