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
25 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
70 &GetItemnumberFromBarcode
74 &GetAuthorisedValueDesc
89 &ModItemInMarconefield
100 # those functions are exported but should not be used
101 # they are usefull is few circumstances, so are exported.
102 # but don't use them unless you're a core developer ;-)
115 &PrepareItemrecordDisplay
122 C4::Biblio - cataloging management functions
126 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:
130 =item 1. in the biblio,biblioitems,items, etc tables, which are limited to a one-to-one mapping to underlying MARC data
132 =item 2. as raw MARC in the Zebra index and storage engine
134 =item 3. as raw MARC the biblioitems.marc and biblioitems.marcxml
138 In the 3.0 version of Koha, the authoritative record-level information is in biblioitems.marcxml
140 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.
144 =item 1. Compared with MySQL, Zebra is slow to update an index for small data changes -- especially for proc-intensive operations like circulation
146 =item 2. Zebra's index has been known to crash and a backup of the data is necessary to rebuild it in such cases
150 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:
154 =item 1. Add*/Mod*/Del*/ - high-level external functions suitable for being called from external scripts to manage the collection
156 =item 2. _koha_* - low-level internal functions for managing the koha tables
158 =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.
160 =item 4. Zebra functions used to update the Zebra index
162 =item 5. internal helper functions such as char_decode, checkitems, etc. Some of these probably belong in Koha.pm
166 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 :
170 =item 1. save datas in biblio and biblioitems table, that gives us a biblionumber and a biblioitemnumber
172 =item 2. add the biblionumber and biblioitemnumber into the MARC records
174 =item 3. save the marc record
178 When dealing with items, we must :
182 =item 1. save the item in items table, that gives us an itemnumber
184 =item 2. add the itemnumber to the item MARC field
186 =item 3. overwrite the MARC record (with the added item) into biblioitems.marc(xml)
188 When modifying a biblio or an item, the behaviour is quite similar.
192 =head1 EXPORTED FUNCTIONS
198 ($biblionumber,$biblioitemnumber) = AddBiblio($record,$frameworkcode);
199 Exported function (core API) for adding a new biblio to koha.
206 my ( $record, $frameworkcode ) = @_;
208 my $biblioitemnumber;
209 my $dbh = C4::Context->dbh;
210 # transform the data into koha-table style data
211 my $olddata = TransformMarcToKoha( $dbh, $record, $frameworkcode );
212 $biblionumber = _koha_add_biblio( $dbh, $olddata, $frameworkcode );
213 $olddata->{'biblionumber'} = $biblionumber;
214 $biblioitemnumber = _koha_add_biblioitem( $dbh, $olddata );
216 # we must add bibnum and bibitemnum in MARC::Record...
217 # we build the new field with biblionumber and biblioitemnumber
218 # we drop the original field
219 # we add the new builded field.
220 ( my $biblio_tag, my $biblio_subfield ) = GetMarcFromKohaField("biblio.biblionumber",$frameworkcode);
221 ( my $biblioitem_tag, my $biblioitem_subfield ) = GetMarcFromKohaField("biblioitems.biblioitemnumber",$frameworkcode);
225 # biblionumber & biblioitemnumber are in different fields
226 if ( $biblio_tag != $biblioitem_tag ) {
228 # deal with biblionumber
229 if ( $biblio_tag < 10 ) {
230 $newfield = MARC::Field->new( $biblio_tag, $biblionumber );
234 MARC::Field->new( $biblio_tag, '', '',
235 "$biblio_subfield" => $biblionumber );
238 # drop old field and create new one...
239 my $old_field = $record->field($biblio_tag);
240 $record->delete_field($old_field);
241 $record->append_fields($newfield);
243 # deal with biblioitemnumber
244 if ( $biblioitem_tag < 10 ) {
245 $newfield = MARC::Field->new( $biblioitem_tag, $biblioitemnumber, );
249 MARC::Field->new( $biblioitem_tag, '', '',
250 "$biblioitem_subfield" => $biblioitemnumber, );
252 # drop old field and create new one...
253 $old_field = $record->field($biblioitem_tag);
254 $record->delete_field($old_field);
255 $record->insert_fields_ordered($newfield);
257 # biblionumber & biblioitemnumber are in the same field (can't be <10 as fields <10 have only 1 value)
260 my $newfield = MARC::Field->new(
262 "$biblio_subfield" => $biblionumber,
263 "$biblioitem_subfield" => $biblioitemnumber
266 # drop old field and create new one...
267 my $old_field = $record->field($biblio_tag);
268 $record->delete_field($old_field);
269 $record->insert_fields_ordered($newfield);
273 $biblionumber = ModBiblioMarc( $record, $biblionumber, $frameworkcode );
275 &logaction(C4::Context->userenv->{'number'},"CATALOGUING","ADD",$biblionumber,"biblio")
276 if C4::Context->preference("CataloguingLog");
278 return ( $biblionumber, $biblioitemnumber );
285 $biblionumber = AddItem( $record, $biblionumber)
286 Exported function (core API) for adding a new item to Koha
293 my ( $record, $biblionumber ) = @_;
294 my $dbh = C4::Context->dbh;
297 my $frameworkcode = GetFrameworkCode( $biblionumber );
298 my $item = &TransformMarcToKoha( $dbh, $record, $frameworkcode );
300 # needs old biblionumber and biblioitemnumber
301 $item->{'biblionumber'} = $biblionumber;
304 "select biblioitemnumber,itemtype from biblioitems where biblionumber=?"
306 $sth->execute( $item->{'biblionumber'} );
308 ( $item->{'biblioitemnumber'}, $itemtype ) = $sth->fetchrow;
311 "select notforloan from itemtypes where itemtype='$itemtype'");
313 my $notforloan = $sth->fetchrow;
314 ##Change the notforloan field if $notforloan found
315 if ( $notforloan > 0 ) {
316 $item->{'notforloan'} = $notforloan;
317 &MARCitemchange( $record, "items.notforloan", $notforloan );
319 if ( !$item->{'dateaccessioned'} || $item->{'dateaccessioned'} eq '' ) {
322 my ( $sec, $min, $hour, $mday, $mon, $year, $wday, $yday, $isdst ) =
327 "$year-" . sprintf( "%0.2d", $mon ) . "-" . sprintf( "%0.2d", $mday );
328 $item->{'dateaccessioned'} = $date;
329 &MARCitemchange( $record, "items.dateaccessioned", $date );
331 my ( $itemnumber, $error ) =
332 &_koha_new_items( $dbh, $item, $item->{barcode} );
334 # add itemnumber to MARC::Record before adding the item.
337 "select tagfield,tagsubfield from marc_subfield_structure where frameworkcode=? and kohafield=?"
339 &TransformKohaToMarcOneField( $sth, $record, "items.itemnumber", $itemnumber,
343 &AddItemInMarc( $record, $item->{'biblionumber'},$frameworkcode );
345 &logaction(C4::Context->userenv->{'number'},"CATALOGUING","ADD",$itemnumber,"item")
346 if C4::Context->preference("CataloguingLog");
348 return ($item->{biblionumber}, $item->{biblioitemnumber},$itemnumber);
355 ModBiblio( $record,$biblionumber,$frameworkcode);
356 Exported function (core API) to modify a biblio
363 my ( $record, $biblionumber, $frameworkcode ) = @_;
365 if (C4::Context->preference("CataloguingLog")) {
366 my $newrecord = GetMarcBiblio($biblionumber);
367 &logaction(C4::Context->userenv->{'number'},"CATALOGUING","MODIFY",$biblionumber,$newrecord->as_formatted)
370 my $dbh = C4::Context->dbh;
372 $frameworkcode = "" unless $frameworkcode;
374 # get the items before and append them to the biblio before updating the record, atm we just have the biblio
375 my ( $itemtag, $itemsubfield ) = GetMarcFromKohaField("items.itemnumber",$frameworkcode);
376 my $oldRecord = GetMarcBiblio($biblionumber);
377 my @fields = $oldRecord->field($itemtag);
378 $record->append_fields(@fields);
380 # update the MARC record (that now contains biblio and items) with the new record data
381 &ModBiblioMarc($record, $biblionumber, $frameworkcode );
383 # load the koha-table data object
384 my $oldbiblio = TransformMarcToKoha( $dbh, $record, $frameworkcode );
386 # modify the other koha tables
387 $biblionumber = _koha_modify_biblio( $dbh, $oldbiblio );
388 _koha_modify_biblioitem( $dbh, $oldbiblio );
397 Exported function (core API) for modifying an item in Koha.
404 my ( $record, $biblionumber, $itemnumber, $delete, $new_item_hashref )
408 &logaction(C4::Context->userenv->{'number'},"CATALOGUING","MODIFY",$itemnumber,$record->as_formatted)
409 if C4::Context->preference("CataloguingLog");
411 my $dbh = C4::Context->dbh;
413 # if we have a MARC record, we're coming from cataloging and so
414 # we do the whole routine: update the MARC and zebra, then update the koha
417 my $frameworkcode = GetFrameworkCode( $biblionumber );
418 ModItemInMarc( $record, $biblionumber, $itemnumber, $frameworkcode );
419 my $olditem = TransformMarcToKoha( $dbh, $record, $frameworkcode );
420 _koha_modify_item( $dbh, $olditem );
421 return $biblionumber;
424 # otherwise, we're just looking to modify something quickly
425 # (like a status) so we just update the koha tables
426 elsif ($new_item_hashref) {
427 _koha_modify_item( $dbh, $new_item_hashref );
431 sub ModItemTransfer {
432 my ( $itemnumber, $frombranch, $tobranch ) = @_;
434 my $dbh = C4::Context->dbh;
436 #new entry in branchtransfers....
437 my $sth = $dbh->prepare(
438 "INSERT INTO branchtransfers (itemnumber, frombranch, datesent, tobranch)
439 VALUES (?, ?, now(), ?)");
440 $sth->execute($itemnumber, $frombranch, $tobranch);
441 #update holdingbranch in items .....
443 "UPDATE items set holdingbranch = ? WHERE items.itemnumber = ?");
444 $sth->execute($tobranch,$itemnumber);
445 &ModDateLastSeen($itemnumber);
446 $sth = $dbh->prepare(
447 "SELECT biblionumber FROM items WHERE itemnumber=?"
449 $sth->execute($itemnumber);
450 while ( my ( $biblionumber ) = $sth->fetchrow ) {
451 &ModItemInMarconefield( $biblionumber, $itemnumber,
452 'items.holdingbranch', $tobranch );
457 ##New sub to dotransfer in marc tables as well. Not exported -TG 10/04/2006
458 # sub domarctransfer {
459 # my ( $dbh, $itemnumber ) = @_;
460 # $itemnumber =~ s /\'//g; ##itemnumber seems to come with quotes-TG
463 # "select biblionumber,holdingbranch from items where itemnumber=$itemnumber"
466 # while ( my ( $biblionumber, $holdingbranch ) = $sth->fetchrow ) {
467 # &ModItemInMarconefield( $biblionumber, $itemnumber,
468 # 'items.holdingbranch', $holdingbranch );
472 =head2 ModBiblioframework
476 ModBiblioframework($biblionumber,$frameworkcode);
477 Exported function to modify a biblio framework
483 sub ModBiblioframework {
484 my ( $biblionumber, $frameworkcode ) = @_;
485 my $dbh = C4::Context->dbh;
488 "UPDATE biblio SET frameworkcode=? WHERE biblionumber=$biblionumber");
489 $sth->execute($frameworkcode);
493 =head2 ModItemInMarconefield
497 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)
498 &ModItemInMarconefield( $biblionumber, $itemnumber, $itemfield, $newvalue )
504 sub ModItemInMarconefield {
505 my ( $biblionumber, $itemnumber, $itemfield, $newvalue ) = @_;
506 my $dbh = C4::Context->dbh;
507 if ( !defined $newvalue ) {
511 my $record = GetMarcItem( $biblionumber, $itemnumber );
512 my ($tagfield, $tagsubfield) = GetMarcFromKohaField( $itemfield,'');
513 if ($tagfield && $tagsubfield) {
514 my $tag = $record->field($tagfield);
516 # my $tagsubs = $record->field($tagfield)->subfield($tagsubfield);
517 $tag->update( $tagsubfield => $newvalue );
518 $record->delete_field($tag);
519 $record->insert_fields_ordered($tag);
520 &ModItemInMarc( $record, $biblionumber, $itemnumber, 0 );
529 &ModItemInMarc( $record, $biblionumber, $itemnumber )
536 my ( $ItemRecord, $biblionumber, $itemnumber, $frameworkcode) = @_;
537 my $dbh = C4::Context->dbh;
539 # get complete MARC record & replace the item field by the new one
540 my $completeRecord = GetMarcBiblio($biblionumber);
541 my ($itemtag,$itemsubfield) = GetMarcFromKohaField("items.itemnumber",$frameworkcode);
542 my $itemField = $ItemRecord->field($itemtag);
543 my @items = $completeRecord->field($itemtag);
545 if ($_->subfield($itemsubfield) eq $itemnumber) {
546 # $completeRecord->delete_field($_);
547 $_->replace_with($itemField);
551 my $sth = $dbh->prepare("update biblioitems set marc=?,marcxml=? where biblionumber=?");
552 $sth->execute( $completeRecord->as_usmarc(), $completeRecord->as_xml_record(),$biblionumber );
554 ModZebra($biblionumber,"specialUpdate","biblioserver",$completeRecord);
557 =head2 ModDateLastSeen
559 &ModDateLastSeen($itemnum)
560 Mark item as seen. Is called when an item is issued, returned or manually marked during inventory/stocktaking
561 C<$itemnum> is the item number
565 sub ModDateLastSeen {
567 my $dbh = C4::Context->dbh;
570 "update items set itemlost=0, datelastseen = now() where items.itemnumber = ?"
572 $sth->execute($itemnum);
579 my $error = &DelBiblio($dbh,$biblionumber);
580 Exported function (core API) for deleting a biblio in koha.
581 Deletes biblio record from Zebra and Koha tables (biblio,biblioitems,items)
582 Also backs it up to deleted* tables
583 Checks to make sure there are not issues on any of the items
585 C<$error> : undef unless an error occurs
592 my ( $biblionumber ) = @_;
593 my $dbh = C4::Context->dbh;
594 my $error; # for error handling
596 # First make sure there are no items with issues are still attached
599 "SELECT itemnumber FROM items WHERE biblionumber=?");
600 $sth->execute($biblionumber);
601 while ( my $itemnumber = $sth->fetchrow ) {
602 my $issues = GetItemIssues($itemnumber);
603 foreach my $issue (@$issues) {
604 if ( ( $issue->{date_due} )
605 && ( $issue->{date_due} ne "Available" ) )
608 #FIXME: we need a status system in Biblio like in Circ to return standard codes and messages
609 # instead of hard-coded strings
611 "Item is checked out to a patron -- you must return it before deleting the Biblio";
615 return $error if $error;
617 # Delete in Zebra. Be careful NOT to move this line after _koha_delete_biblio
618 # for at least 2 reasons :
619 # - we need to read the biblio if NoZebra is set (to remove it from the indexes
620 # - if something goes wrong, the biblio may be deleted from Koha but not from zebra
621 # 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)
622 ModZebra($biblionumber, "delete_record", "biblioserver", undef);
624 # delete biblio from Koha tables and save in deletedbiblio
625 $error = &_koha_delete_biblio( $dbh, $biblionumber );
627 # delete biblioitems and items from Koha tables and save in deletedbiblioitems,deleteditems
630 "SELECT biblioitemnumber FROM biblioitems WHERE biblionumber=?");
631 $sth->execute($biblionumber);
632 while ( my $biblioitemnumber = $sth->fetchrow ) {
634 # delete this biblioitem
635 $error = &_koha_delete_biblioitems( $dbh, $biblioitemnumber );
636 return $error if $error;
641 "SELECT itemnumber FROM items WHERE biblioitemnumber=?");
642 $items_sth->execute($biblioitemnumber);
643 while ( my $itemnumber = $items_sth->fetchrow ) {
644 $error = &_koha_delete_item( $dbh, $itemnumber );
645 return $error if $error;
648 &logaction(C4::Context->userenv->{'number'},"CATALOGUING","DELETE",$biblionumber,"")
649 if C4::Context->preference("CataloguingLog");
657 DelItem( $biblionumber, $itemnumber );
658 Exported function (core API) for deleting an item record in Koha.
665 my ( $biblionumber, $itemnumber ) = @_;
666 my $dbh = C4::Context->dbh;
667 &_koha_delete_item( $dbh, $itemnumber );
668 # get the MARC record
669 my $record = GetMarcBiblio($biblionumber);
670 my $frameworkcode = GetFrameworkCode($biblionumber);
674 $dbh->prepare("UPDATE deleteditems SET marc=? WHERE itemnumber=?");
675 $copy2deleted->execute( $record->as_usmarc(), $itemnumber );
677 #search item field code
678 my ( $itemtag, $itemsubfield ) = GetMarcFromKohaField("items.itemnumber",$frameworkcode);
679 my @fields = $record->field($itemtag);
680 # delete the item specified
681 foreach my $field (@fields) {
682 if ( $field->subfield($itemsubfield) eq $itemnumber ) {
683 $record->delete_field($field);
686 &ModBiblioMarc( $record, $biblionumber, $frameworkcode );
687 &logaction(C4::Context->userenv->{'number'},"CATALOGUING","DELETE",$itemnumber,"item")
688 if C4::Context->preference("CataloguingLog");
695 $data = &GetBiblioData($biblionumber);
696 Returns information about the book with the given biblionumber.
697 C<&GetBiblioData> returns a reference-to-hash. The keys are the fields in
698 the C<biblio> and C<biblioitems> tables in the
700 In addition, C<$data-E<gt>{subject}> is the list of the book's
701 subjects, separated by C<" , "> (space, comma, space).
702 If there are multiple biblioitems with the given biblionumber, only
703 the first one is considered.
711 my $dbh = C4::Context->dbh;
714 SELECT * , biblioitems.notes AS bnotes, biblio.notes
716 LEFT JOIN biblioitems ON biblio.biblionumber = biblioitems.biblionumber
717 LEFT JOIN itemtypes ON biblioitems.itemtype = itemtypes.itemtype
718 WHERE biblio.biblionumber = ?
719 AND biblioitems.biblionumber = biblio.biblionumber
721 my $sth = $dbh->prepare($query);
722 $sth->execute($bibnum);
724 $data = $sth->fetchrow_hashref;
728 } # sub GetBiblioData
735 @results = &GetItemsInfo($biblionumber, $type);
737 Returns information about books with the given biblionumber.
739 C<$type> may be either C<intra> or anything else. If it is not set to
740 C<intra>, then the search will exclude lost, very overdue, and
743 C<&GetItemsInfo> returns a list of references-to-hash. Each element
744 contains a number of keys. Most of them are table items from the
745 C<biblio>, C<biblioitems>, C<items>, and C<itemtypes> tables in the
746 Koha database. Other keys include:
750 =item C<$data-E<gt>{branchname}>
752 The name (not the code) of the branch to which the book belongs.
754 =item C<$data-E<gt>{datelastseen}>
756 This is simply C<items.datelastseen>, except that while the date is
757 stored in YYYY-MM-DD format in the database, here it is converted to
758 DD/MM/YYYY format. A NULL date is returned as C<//>.
760 =item C<$data-E<gt>{datedue}>
762 =item C<$data-E<gt>{class}>
764 This is the concatenation of C<biblioitems.classification>, the book's
765 Dewey code, and C<biblioitems.subclass>.
767 =item C<$data-E<gt>{ocount}>
769 I think this is the number of copies of the book available.
771 =item C<$data-E<gt>{order}>
773 If this is set, it is set to C<One Order>.
782 my ( $biblionumber, $type ) = @_;
783 my $dbh = C4::Context->dbh;
784 my $query = "SELECT *,items.notforloan as itemnotforloan
785 FROM items, biblio, biblioitems
786 LEFT JOIN itemtypes on biblioitems.itemtype = itemtypes.itemtype
787 WHERE items.biblionumber = ?
788 AND biblioitems.biblioitemnumber = items.biblioitemnumber
789 AND biblio.biblionumber = items.biblionumber
790 ORDER BY items.dateaccessioned desc
792 my $sth = $dbh->prepare($query);
793 $sth->execute($biblionumber);
796 my ( $date_due, $count_reserves );
798 while ( my $data = $sth->fetchrow_hashref ) {
800 my $isth = $dbh->prepare(
801 "SELECT issues.*,borrowers.cardnumber
802 FROM issues, borrowers
804 AND returndate IS NULL
805 AND issues.borrowernumber=borrowers.borrowernumber"
807 $isth->execute( $data->{'itemnumber'} );
808 if ( my $idata = $isth->fetchrow_hashref ) {
809 $data->{borrowernumber} = $idata->{borrowernumber};
810 $data->{cardnumber} = $idata->{cardnumber};
811 $datedue = format_date( $idata->{'date_due'} );
813 if ( $datedue eq '' ) {
814 #$datedue="Available";
815 my ( $restype, $reserves ) =
816 C4::Reserves::CheckReserves( $data->{'itemnumber'} );
820 $count_reserves = $restype;
825 #get branch information.....
826 my $bsth = $dbh->prepare(
827 "SELECT * FROM branches WHERE branchcode = ?
830 $bsth->execute( $data->{'holdingbranch'} );
831 if ( my $bdata = $bsth->fetchrow_hashref ) {
832 $data->{'branchname'} = $bdata->{'branchname'};
834 my $date = format_date( $data->{'datelastseen'} );
835 $data->{'datelastseen'} = $date;
836 $data->{'datedue'} = $datedue;
837 $data->{'count_reserves'} = $count_reserves;
839 # get notforloan complete status if applicable
840 my $sthnflstatus = $dbh->prepare(
841 'SELECT authorised_value
842 FROM marc_subfield_structure
843 WHERE kohafield="items.notforloan"
847 $sthnflstatus->execute;
848 my ($authorised_valuecode) = $sthnflstatus->fetchrow;
849 if ($authorised_valuecode) {
850 $sthnflstatus = $dbh->prepare(
851 "SELECT lib FROM authorised_values
853 AND authorised_value=?"
855 $sthnflstatus->execute( $authorised_valuecode,
856 $data->{itemnotforloan} );
857 my ($lib) = $sthnflstatus->fetchrow;
858 $data->{notforloan} = $lib;
861 # my stack procedures
862 my $stackstatus = $dbh->prepare(
863 'SELECT authorised_value
864 FROM marc_subfield_structure
865 WHERE kohafield="items.stack"
868 $stackstatus->execute;
870 ($authorised_valuecode) = $stackstatus->fetchrow;
871 if ($authorised_valuecode) {
872 $stackstatus = $dbh->prepare(
874 FROM authorised_values
876 AND authorised_value=?
879 $stackstatus->execute( $authorised_valuecode, $data->{stack} );
880 my ($lib) = $stackstatus->fetchrow;
881 $data->{stack} = $lib;
883 $results[$i] = $data;
895 $itemstatushash = &getitemstatus($fwkcode);
896 returns information about status.
897 Can be MARC dependant.
899 But basically could be can be loan or not
900 Create a status selector with the following code
902 =head3 in PERL SCRIPT
904 my $itemstatushash = getitemstatus;
906 foreach my $thisstatus (keys %$itemstatushash) {
907 my %row =(value => $thisstatus,
908 statusname => $itemstatushash->{$thisstatus}->{'statusname'},
910 push @itemstatusloop, \%row;
912 $template->param(statusloop=>\@itemstatusloop);
917 <select name="statusloop">
918 <option value="">Default</option>
919 <!-- TMPL_LOOP name="statusloop" -->
920 <option value="<!-- TMPL_VAR name="value" -->" <!-- TMPL_IF name="selected" -->selected<!-- /TMPL_IF -->><!-- TMPL_VAR name="statusname" --></option>
928 # returns a reference to a hash of references to status...
931 my $dbh = C4::Context->dbh;
933 $fwk = '' unless ($fwk);
934 my ( $tag, $subfield ) =
935 GetMarcFromKohaField( "items.notforloan", $fwk );
936 if ( $tag and $subfield ) {
939 "select authorised_value from marc_subfield_structure where tagfield=? and tagsubfield=? and frameworkcode=?"
941 $sth->execute( $tag, $subfield, $fwk );
942 if ( my ($authorisedvaluecat) = $sth->fetchrow ) {
945 "select authorised_value, lib from authorised_values where category=? order by lib"
947 $authvalsth->execute($authorisedvaluecat);
948 while ( my ( $authorisedvalue, $lib ) = $authvalsth->fetchrow ) {
949 $itemstatus{$authorisedvalue} = $lib;
965 $itemstatus{"1"} = "Not For Loan";
969 =head2 getitemlocation
973 $itemlochash = &getitemlocation($fwk);
974 returns informations about location.
975 where fwk stands for an optional framework code.
976 Create a location selector with the following code
978 =head3 in PERL SCRIPT
980 my $itemlochash = getitemlocation;
982 foreach my $thisloc (keys %$itemlochash) {
983 my $selected = 1 if $thisbranch eq $branch;
984 my %row =(locval => $thisloc,
985 selected => $selected,
986 locname => $itemlochash->{$thisloc},
988 push @itemlocloop, \%row;
990 $template->param(itemlocationloop => \@itemlocloop);
994 <select name="location">
995 <option value="">Default</option>
996 <!-- TMPL_LOOP name="itemlocationloop" -->
997 <option value="<!-- TMPL_VAR name="locval" -->" <!-- TMPL_IF name="selected" -->selected<!-- /TMPL_IF -->><!-- TMPL_VAR name="locname" --></option>
1005 sub GetItemLocation {
1007 # returns a reference to a hash of references to location...
1010 my $dbh = C4::Context->dbh;
1012 $fwk = '' unless ($fwk);
1013 my ( $tag, $subfield ) =
1014 GetMarcFromKohaField( "items.location", $fwk );
1015 if ( $tag and $subfield ) {
1018 "select authorised_value from marc_subfield_structure where tagfield=? and tagsubfield=? and frameworkcode=?"
1020 $sth->execute( $tag, $subfield, $fwk );
1021 if ( my ($authorisedvaluecat) = $sth->fetchrow ) {
1024 "select authorised_value, lib from authorised_values where category=? order by lib"
1026 $authvalsth->execute($authorisedvaluecat);
1027 while ( my ( $authorisedvalue, $lib ) = $authvalsth->fetchrow ) {
1028 $itemlocation{$authorisedvalue} = $lib;
1030 $authvalsth->finish;
1031 return \%itemlocation;
1044 $itemlocation{"1"} = "Not For Loan";
1045 return \%itemlocation;
1050 $items = GetLostItems($where,$orderby);
1052 This function get the items lost into C<$items>.
1057 C<$where> is a hashref. it containts a field of the items table as key
1058 and the value to match as value.
1059 C<$orderby> is a field of the items table.
1062 C<$items> is a reference to an array full of hasref which keys are items' table column.
1064 =item usage in the perl script:
1067 $where{barcode} = 0001548;
1068 my $items = GetLostItems( \%where, "homebranch" );
1069 $template->param(itemsloop => $items);
1076 # Getting input args.
1078 my $orderby = shift;
1079 my $dbh = C4::Context->dbh;
1084 WHERE itemlost IS NOT NULL
1087 foreach my $key (keys %$where) {
1088 $query .= " AND " . $key . " LIKE '%" . $where->{$key} . "%'";
1090 $query .= " ORDER BY ".$orderby if defined $orderby;
1092 my $sth = $dbh->prepare($query);
1095 while ( my $row = $sth->fetchrow_hashref ){
1101 =head2 GetItemsForInventory
1103 $itemlist = GetItemsForInventory($minlocation,$maxlocation,$datelastseen,$offset,$size)
1105 Retrieve a list of title/authors/barcode/callnumber, for biblio inventory.
1107 The sub returns a list of hashes, containing itemnumber, author, title, barcode & item callnumber.
1108 It is ordered by callnumber,title.
1110 The minlocation & maxlocation parameters are used to specify a range of item callnumbers
1111 the datelastseen can be used to specify that you want to see items not seen since a past date only.
1112 offset & size can be used to retrieve only a part of the whole listing (defaut behaviour)
1116 sub GetItemsForInventory {
1117 my ( $minlocation, $maxlocation,$location, $datelastseen, $branch, $offset, $size ) = @_;
1118 my $dbh = C4::Context->dbh;
1120 if ($datelastseen) {
1121 $datelastseen=format_date_in_iso($datelastseen);
1123 "SELECT itemnumber,barcode,itemcallnumber,title,author,datelastseen
1125 LEFT JOIN biblio ON items.biblionumber=biblio.biblionumber
1126 WHERE itemcallnumber>= ?
1127 AND itemcallnumber <=?
1128 AND (datelastseen< ? OR datelastseen IS NULL)";
1129 $query.= " AND items.location=".$dbh->quote($location) if $location;
1130 $query.= " AND items.homebranch=".$dbh->quote($branch) if $branch;
1131 $query .= " ORDER BY itemcallnumber,title";
1132 $sth = $dbh->prepare($query);
1133 $sth->execute( $minlocation, $maxlocation, $datelastseen );
1137 SELECT itemnumber,barcode,itemcallnumber,title,author,datelastseen
1139 LEFT JOIN biblio ON items.biblionumber=biblio.biblionumber
1140 WHERE itemcallnumber>= ?
1141 AND itemcallnumber <=?";
1142 $query.= " AND items.location=".$dbh->quote($location) if $location;
1143 $query.= " AND items.homebranch=".$dbh->quote($branch) if $branch;
1144 $query .= " ORDER BY itemcallnumber,title";
1145 $sth = $dbh->prepare($query);
1146 $sth->execute( $minlocation, $maxlocation );
1149 while ( my $row = $sth->fetchrow_hashref ) {
1150 $offset-- if ($offset);
1151 $row->{datelastseen}=format_date($row->{datelastseen});
1152 if ( ( !$offset ) && $size ) {
1153 push @results, $row;
1160 =head2 &GetBiblioItemData
1164 $itemdata = &GetBiblioItemData($biblioitemnumber);
1166 Looks up the biblioitem with the given biblioitemnumber. Returns a
1167 reference-to-hash. The keys are the fields from the C<biblio>,
1168 C<biblioitems>, and C<itemtypes> tables in the Koha database, except
1169 that C<biblioitems.notes> is given as C<$itemdata-E<gt>{bnotes}>.
1176 sub GetBiblioItemData {
1178 my $dbh = C4::Context->dbh;
1181 "Select *,biblioitems.notes as bnotes from biblioitems, biblio,itemtypes where biblio.biblionumber = biblioitems.biblionumber and biblioitemnumber = ? and biblioitems.itemtype = itemtypes.itemtype"
1185 $sth->execute($bibitem);
1187 $data = $sth->fetchrow_hashref;
1191 } # sub &GetBiblioItemData
1193 =head2 GetItemnumberFromBarcode
1197 $result = GetItemnumberFromBarcode($barcode);
1203 sub GetItemnumberFromBarcode {
1205 my $dbh = C4::Context->dbh;
1208 $dbh->prepare("SELECT itemnumber from items where items.barcode=?");
1209 $rq->execute($barcode);
1210 my ($result) = $rq->fetchrow;
1214 =head2 GetBiblioItemByBiblioNumber
1218 NOTE : This function has been copy/paste from C4/Biblio.pm from head before zebra integration.
1224 sub GetBiblioItemByBiblioNumber {
1225 my ($biblionumber) = @_;
1226 my $dbh = C4::Context->dbh;
1227 my $sth = $dbh->prepare("Select * from biblioitems where biblionumber = ?");
1231 $sth->execute($biblionumber);
1233 while ( my $data = $sth->fetchrow_hashref ) {
1234 push @results, $data;
1241 =head2 GetBiblioFromItemNumber
1245 $item = &GetBiblioFromItemNumber($itemnumber);
1247 Looks up the item with the given itemnumber.
1249 C<&itemnodata> returns a reference-to-hash whose keys are the fields
1250 from the C<biblio>, C<biblioitems>, and C<items> tables in the Koha
1258 sub GetBiblioFromItemNumber {
1259 my ( $itemnumber ) = @_;
1260 my $dbh = C4::Context->dbh;
1261 my $sth = $dbh->prepare(
1262 "SELECT * FROM biblio,items,biblioitems
1263 WHERE items.itemnumber = ?
1264 AND biblio.biblionumber = items.biblionumber
1265 AND biblioitems.biblioitemnumber = items.biblioitemnumber"
1268 $sth->execute($itemnumber);
1269 my $data = $sth->fetchrow_hashref;
1278 ( $count, @results ) = &GetBiblio($biblionumber);
1285 my ($biblionumber) = @_;
1286 my $dbh = C4::Context->dbh;
1287 my $sth = $dbh->prepare("Select * from biblio where biblionumber = ?");
1290 $sth->execute($biblionumber);
1291 while ( my $data = $sth->fetchrow_hashref ) {
1292 $results[$count] = $data;
1296 return ( $count, @results );
1303 $data = &GetItem($itemnumber,$barcode);
1305 return Item information, for a given itemnumber or barcode
1312 my ($itemnumber,$barcode) = @_;
1313 my $dbh = C4::Context->dbh;
1315 my $sth = $dbh->prepare("
1317 WHERE itemnumber = ?");
1318 $sth->execute($itemnumber);
1319 my $data = $sth->fetchrow_hashref;
1322 my $sth = $dbh->prepare("
1326 $sth->execute($barcode);
1327 my $data = $sth->fetchrow_hashref;
1332 =head2 get_itemnumbers_of
1336 my @itemnumbers_of = get_itemnumbers_of(@biblionumbers);
1338 Given a list of biblionumbers, return the list of corresponding itemnumbers
1339 for each biblionumber.
1341 Return a reference on a hash where keys are biblionumbers and values are
1342 references on array of itemnumbers.
1348 sub get_itemnumbers_of {
1349 my @biblionumbers = @_;
1351 my $dbh = C4::Context->dbh;
1357 WHERE biblionumber IN (?' . ( ',?' x scalar @biblionumbers - 1 ) . ')
1359 my $sth = $dbh->prepare($query);
1360 $sth->execute(@biblionumbers);
1364 while ( my ( $itemnumber, $biblionumber ) = $sth->fetchrow_array ) {
1365 push @{ $itemnumbers_of{$biblionumber} }, $itemnumber;
1368 return \%itemnumbers_of;
1371 =head2 GetItemInfosOf
1375 GetItemInfosOf(@itemnumbers);
1381 sub GetItemInfosOf {
1382 my @itemnumbers = @_;
1387 WHERE itemnumber IN (' . join( ',', @itemnumbers ) . ')
1389 return get_infos_of( $query, 'itemnumber' );
1392 =head2 GetBiblioItemInfosOf
1396 GetBiblioItemInfosOf(@biblioitemnumbers);
1402 sub GetBiblioItemInfosOf {
1403 my @biblioitemnumbers = @_;
1406 SELECT biblioitemnumber,
1410 WHERE biblioitemnumber IN (' . join( ',', @biblioitemnumbers ) . ')
1412 return get_infos_of( $query, 'biblioitemnumber' );
1415 =head1 FUNCTIONS FOR HANDLING MARC MANAGEMENT
1417 =head2 GetMarcStructure
1421 $res = GetMarcStructure($forlibrarian,$frameworkcode);
1423 Returns a reference to a big hash of hash, with the Marc structure for the given frameworkcode
1424 $forlibrarian :if set to 1, the MARC descriptions are the librarians ones, otherwise it's the public (OPAC) ones
1425 $frameworkcode : the framework code to read
1431 sub GetMarcStructure {
1432 my ( $forlibrarian, $frameworkcode ) = @_;
1433 my $dbh=C4::Context->dbh;
1434 $frameworkcode = "" unless $frameworkcode;
1436 my $libfield = ( $forlibrarian eq 1 ) ? 'liblibrarian' : 'libopac';
1438 # check that framework exists
1441 "select count(*) from marc_tag_structure where frameworkcode=?");
1442 $sth->execute($frameworkcode);
1443 my ($total) = $sth->fetchrow;
1444 $frameworkcode = "" unless ( $total > 0 );
1447 "select tagfield,liblibrarian,libopac,mandatory,repeatable from marc_tag_structure where frameworkcode=? order by tagfield"
1449 $sth->execute($frameworkcode);
1450 my ( $liblibrarian, $libopac, $tag, $res, $tab, $mandatory, $repeatable );
1452 while ( ( $tag, $liblibrarian, $libopac, $mandatory, $repeatable ) =
1455 $res->{$tag}->{lib} =
1456 ( $forlibrarian or !$libopac ) ? $liblibrarian : $libopac;
1457 # why the hell do we need to explicitly decode utf8 ?
1458 # that's a good question, but we must do it...
1459 $res->{$tab}->{tab} = ""; # XXX
1460 $res->{$tag}->{mandatory} = $mandatory;
1461 $res->{$tag}->{repeatable} = $repeatable;
1466 "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"
1468 $sth->execute($frameworkcode);
1471 my $authorised_value;
1483 $tag, $subfield, $liblibrarian,
1485 $mandatory, $repeatable, $authorised_value,
1486 $authtypecode, $value_builder, $kohafield,
1487 $seealso, $hidden, $isurl,
1493 $res->{$tag}->{$subfield}->{lib} =
1494 ( $forlibrarian or !$libopac ) ? $liblibrarian : $libopac;
1495 $res->{$tag}->{$subfield}->{tab} = $tab;
1496 $res->{$tag}->{$subfield}->{mandatory} = $mandatory;
1497 $res->{$tag}->{$subfield}->{repeatable} = $repeatable;
1498 $res->{$tag}->{$subfield}->{authorised_value} = $authorised_value;
1499 $res->{$tag}->{$subfield}->{authtypecode} = $authtypecode;
1500 $res->{$tag}->{$subfield}->{value_builder} = $value_builder;
1501 $res->{$tag}->{$subfield}->{kohafield} = $kohafield;
1502 $res->{$tag}->{$subfield}->{seealso} = $seealso;
1503 $res->{$tag}->{$subfield}->{hidden} = $hidden;
1504 $res->{$tag}->{$subfield}->{isurl} = $isurl;
1505 $res->{$tag}->{$subfield}->{link} = $link;
1506 $res->{$tag}->{$subfield}->{defaultvalue} = $defaultvalue;
1511 =head2 GetMarcFromKohaField
1515 ($MARCfield,$MARCsubfield)=GetMarcFromKohaField($kohafield,$frameworkcode);
1516 Returns the MARC fields & subfields mapped to the koha field
1517 for the given frameworkcode
1523 sub GetMarcFromKohaField {
1524 my ( $kohafield, $frameworkcode ) = @_;
1525 return 0, 0 unless $kohafield;
1526 my $relations = C4::Context->marcfromkohafield;
1528 $relations->{$frameworkcode}->{$kohafield}->[0],
1529 $relations->{$frameworkcode}->{$kohafield}->[1]
1533 =head2 GetMarcBiblio
1537 Returns MARC::Record of the biblionumber passed in parameter.
1538 the marc record contains both biblio & item datas
1545 my $biblionumber = shift;
1546 my $dbh = C4::Context->dbh;
1548 $dbh->prepare("select marcxml from biblioitems where biblionumber=? ");
1549 $sth->execute($biblionumber);
1550 my ($marcxml) = $sth->fetchrow;
1551 MARC::File::XML->default_record_format(C4::Context->preference('marcflavour'));
1552 $marcxml =~ s/\x1e//g;
1553 $marcxml =~ s/\x1f//g;
1554 $marcxml =~ s/\x1d//g;
1555 $marcxml =~ s/\x0f//g;
1556 $marcxml =~ s/\x0c//g;
1558 my $record = MARC::Record->new();
1559 $record = MARC::Record::new_from_xml( $marcxml, "utf8",C4::Context->preference('marcflavour')) if $marcxml;
1560 # $record = MARC::Record::new_from_usmarc( $marc) if $marc;
1568 my $marcxml = GetXmlBiblio($biblionumber);
1570 Returns biblioitems.marcxml of the biblionumber passed in parameter.
1571 The XML contains both biblio & item datas
1578 my ( $biblionumber ) = @_;
1579 my $dbh = C4::Context->dbh;
1581 $dbh->prepare("select marcxml from biblioitems where biblionumber=? ");
1582 $sth->execute($biblionumber);
1583 my ($marcxml) = $sth->fetchrow;
1587 =head2 GetAuthorisedValueDesc
1591 my $subfieldvalue =get_authorised_value_desc(
1592 $tag, $subf[$i][0],$subf[$i][1], '', $taglib);
1593 Retrieve the complete description for a given authorised value.
1599 sub GetAuthorisedValueDesc {
1600 my ( $tag, $subfield, $value, $framework, $tagslib ) = @_;
1601 my $dbh = C4::Context->dbh;
1604 if ( $tagslib->{$tag}->{$subfield}->{'authorised_value'} eq "branches" ) {
1605 return C4::Branch::GetBranchName($value);
1609 if ( $tagslib->{$tag}->{$subfield}->{'authorised_value'} eq "itemtypes" ) {
1610 return getitemtypeinfo($value)->{description};
1613 #---- "true" authorized value
1614 my $category = $tagslib->{$tag}->{$subfield}->{'authorised_value'};
1615 if ( $category ne "" ) {
1618 "select lib from authorised_values where category = ? and authorised_value = ?"
1620 $sth->execute( $category, $value );
1621 my $data = $sth->fetchrow_hashref;
1622 return $data->{'lib'};
1625 return $value; # if nothing is found return the original value
1633 Returns MARC::Record of the item passed in parameter.
1640 my ( $biblionumber, $itemnumber ) = @_;
1641 my $dbh = C4::Context->dbh;
1642 my $newrecord = MARC::Record->new();
1643 my $marcflavour = C4::Context->preference('marcflavour');
1645 my $marcxml = GetXmlBiblio($biblionumber);
1646 my $record = MARC::Record->new();
1647 $record = MARC::Record::new_from_xml( $marcxml, "utf8", $marcflavour );
1648 # now, find where the itemnumber is stored & extract only the item
1649 my ( $itemnumberfield, $itemnumbersubfield ) =
1650 GetMarcFromKohaField( 'items.itemnumber', '' );
1651 my @fields = $record->field($itemnumberfield);
1652 foreach my $field (@fields) {
1653 if ( $field->subfield($itemnumbersubfield) eq $itemnumber ) {
1654 $newrecord->insert_fields_ordered($field);
1666 $marcnotesarray = GetMarcNotes( $record, $marcflavour );
1667 Get all notes from the MARC record and returns them in an array.
1668 The note are stored in differents places depending on MARC flavour
1675 my ( $record, $marcflavour ) = @_;
1677 if ( $marcflavour eq "MARC21" ) {
1680 else { # assume unimarc if not marc21
1687 foreach my $field ( $record->field($scope) ) {
1688 my $value = $field->as_string();
1689 if ( $note ne "" ) {
1690 $marcnote = { marcnote => $note, };
1691 push @marcnotes, $marcnote;
1694 if ( $note ne $value ) {
1695 $note = $note . " " . $value;
1700 $marcnote = { marcnote => $note };
1701 push @marcnotes, $marcnote; #load last tag into array
1704 } # end GetMarcNotes
1706 =head2 GetMarcSubjects
1710 $marcsubjcts = GetMarcSubjects($record,$marcflavour);
1711 Get all subjects from the MARC record and returns them in an array.
1712 The subjects are stored in differents places depending on MARC flavour
1718 sub GetMarcSubjects {
1719 my ( $record, $marcflavour ) = @_;
1720 my ( $mintag, $maxtag );
1721 if ( $marcflavour eq "MARC21" ) {
1725 else { # assume unimarc if not marc21
1732 foreach my $field ( $record->fields ) {
1733 next unless $field->tag() >= $mintag && $field->tag() <= $maxtag;
1734 my @subfields = $field->subfields();
1738 my $authoritysep=C4::Context->preference("authoritysep");
1739 for my $subject_subfield ( @subfields ) {
1741 $marcflavour ne 'MARC21'
1743 ($subject_subfield->[0] eq '3') or
1744 ($subject_subfield->[0] eq '4') or
1745 ($subject_subfield->[0] eq '5')
1751 my $code = $subject_subfield->[0];
1752 $label .= $subject_subfield->[1].$authoritysep unless ( $code == 9 );
1753 $link .= $subject_subfield->[1] . " and su-to:" unless ( $code == 9 );
1755 $link = "Koha-Auth-Number:".$subject_subfield->[1];
1759 $link =~ s/ and\ssu-to:$//;
1762 $label =~ s/$authoritysep$//;
1769 return \@marcsubjcts;
1770 } #end GetMarcSubjects
1772 =head2 GetMarcAuthors
1776 authors = GetMarcAuthors($record,$marcflavour);
1777 Get all authors from the MARC record and returns them in an array.
1778 The authors are stored in differents places depending on MARC flavour
1784 sub GetMarcAuthors {
1785 my ( $record, $marcflavour ) = @_;
1786 my ( $mintag, $maxtag );
1787 if ( $marcflavour eq "MARC21" ) {
1791 else { # assume unimarc if not marc21
1798 foreach my $field ( $record->fields ) {
1799 next unless $field->tag() >= $mintag && $field->tag() <= $maxtag;
1801 my @subfields = $field->subfields();
1804 for my $authors_subfield (@subfields) {
1806 $marcflavour ne 'MARC21'
1808 ($authors_subfield->[0] eq '3') or
1809 ($authors_subfield->[0] eq '4') or
1810 ($authors_subfield->[0] eq '5')
1816 if ($count_auth ne '0'){
1820 my $subfieldcode = $authors_subfield->[0];
1821 my $value = $authors_subfield->[1];
1822 $hash{tag} = $field->tag;
1823 $hash{value} .= $value . " " if ($subfieldcode != 9) ;
1824 $hash{link} .= $value if ($subfieldcode eq 9);
1826 push @marcauthors, \%hash;
1828 return \@marcauthors;
1831 =head2 GetMarcSeries
1835 $marcseriessarray = GetMarcSeries($record,$marcflavour);
1836 Get all series from the MARC record and returns them in an array.
1837 The series are stored in differents places depending on MARC flavour
1844 my ($record, $marcflavour) = @_;
1845 my ($mintag, $maxtag);
1846 if ($marcflavour eq "MARC21") {
1849 } else { # assume unimarc if not marc21
1859 foreach my $field ($record->field('440'), $record->field('490')) {
1861 #my $value = $field->subfield('a');
1862 #$marcsubjct = {MARCSUBJCT => $value,};
1863 my @subfields = $field->subfields();
1864 #warn "subfields:".join " ", @$subfields;
1867 for my $series_subfield (@subfields) {
1869 undef $volume_number;
1870 # see if this is an instance of a volume
1871 if ($series_subfield->[0] eq 'v') {
1875 my $code = $series_subfield->[0];
1876 my $value = $series_subfield->[1];
1877 my $linkvalue = $value;
1878 $linkvalue =~ s/(\(|\))//g;
1879 my $operator = " and " unless $counter==0;
1880 push @link_loop, {link => $linkvalue, operator => $operator };
1881 my $separator = C4::Context->preference("authoritysep") unless $counter==0;
1882 if ($volume_number) {
1883 push @subfields_loop, {volumenum => $value};
1886 push @subfields_loop, {code => $code, value => $value, link_loop => \@link_loop, separator => $separator, volumenum => $volume_number};
1890 push @marcseries, { MARCSERIES_SUBFIELDS_LOOP => \@subfields_loop };
1891 #$marcsubjct = {MARCSUBJCT => $field->as_string(),};
1892 #push @marcsubjcts, $marcsubjct;
1896 my $marcseriessarray=\@marcseries;
1897 return $marcseriessarray;
1898 } #end getMARCseriess
1900 =head2 GetFrameworkCode
1904 $frameworkcode = GetFrameworkCode( $biblionumber )
1910 sub GetFrameworkCode {
1911 my ( $biblionumber ) = @_;
1912 my $dbh = C4::Context->dbh;
1914 $dbh->prepare("select frameworkcode from biblio where biblionumber=?");
1915 $sth->execute($biblionumber);
1916 my ($frameworkcode) = $sth->fetchrow;
1917 return $frameworkcode;
1920 =head2 TransformKohaToMarc
1924 $record = TransformKohaToMarc( $hash )
1925 This function builds partial MARC::Record from a hash
1926 Hash entries can be from biblio or biblioitems.
1927 This function is called in acquisition module, to create a basic catalogue entry from user entry
1933 sub TransformKohaToMarc {
1936 my $dbh = C4::Context->dbh;
1939 "select tagfield,tagsubfield from marc_subfield_structure where frameworkcode=? and kohafield=?"
1941 my $record = MARC::Record->new();
1942 foreach (keys %{$hash}) {
1943 &TransformKohaToMarcOneField( $sth, $record, $_,
1949 =head2 TransformKohaToMarcOneField
1953 $record = TransformKohaToMarcOneField( $sth, $record, $kohafieldname, $value, $frameworkcode );
1959 sub TransformKohaToMarcOneField {
1960 my ( $sth, $record, $kohafieldname, $value, $frameworkcode ) = @_;
1961 $frameworkcode='' unless $frameworkcode;
1965 if ( !defined $sth ) {
1966 my $dbh = C4::Context->dbh;
1969 "select tagfield,tagsubfield from marc_subfield_structure where frameworkcode=? and kohafield=?"
1972 $sth->execute( $frameworkcode, $kohafieldname );
1973 if ( ( $tagfield, $tagsubfield ) = $sth->fetchrow ) {
1974 my $tag = $record->field($tagfield);
1976 $tag->update( $tagsubfield => $value );
1977 $record->delete_field($tag);
1978 $record->insert_fields_ordered($tag);
1981 $record->add_fields( $tagfield, " ", " ", $tagsubfield => $value );
1987 =head2 TransformHtmlToXml
1991 $xml = TransformHtmlToXml( $tags, $subfields, $values, $indicator, $ind_tag, $auth_type )
1993 $auth_type contains :
1994 - nothing : rebuild a biblio, un UNIMARC the encoding is in 100$a pos 26/27
1995 - UNIMARCAUTH : rebuild an authority. In UNIMARC, the encoding is in 100$a pos 13/14
1996 - ITEM : rebuild an item : in UNIMARC, 100$a, it's in the biblio ! (otherwise, we would get 2 100 fields !)
2001 sub TransformHtmlToXml {
2002 my ( $tags, $subfields, $values, $indicator, $ind_tag, $auth_type ) = @_;
2003 my $xml = MARC::File::XML::header('UTF-8');
2004 $auth_type = C4::Context->preference('marcflavour') unless $auth_type;
2005 MARC::File::XML->default_record_format($auth_type);
2006 # in UNIMARC, field 100 contains the encoding
2007 # check that there is one, otherwise the
2008 # MARC::Record->new_from_xml will fail (and Koha will die)
2009 my $unimarc_and_100_exist=0;
2010 $unimarc_and_100_exist=1 if $auth_type eq 'ITEM'; # if we rebuild an item, no need of a 100 field
2015 for ( my $i = 0 ; $i <= @$tags ; $i++ ) {
2016 if (C4::Context->preference('marcflavour') eq 'UNIMARC' and @$tags[$i] eq "100" and @$subfields[$i] eq "a") {
2017 # if we have a 100 field and it's values are not correct, skip them.
2018 # if we don't have any valid 100 field, we will create a default one at the end
2019 my $enc = substr( @$values[$i], 26, 2 );
2020 if ($enc eq '01' or $enc eq '50' or $enc eq '03') {
2021 $unimarc_and_100_exist=1;
2026 @$values[$i] =~ s/&/&/g;
2027 @$values[$i] =~ s/</</g;
2028 @$values[$i] =~ s/>/>/g;
2029 @$values[$i] =~ s/"/"/g;
2030 @$values[$i] =~ s/'/'/g;
2031 # if ( !utf8::is_utf8( @$values[$i] ) ) {
2032 # utf8::decode( @$values[$i] );
2034 if ( ( @$tags[$i] ne $prevtag ) ) {
2035 $j++ unless ( @$tags[$i] eq "" );
2037 $xml .= "</datafield>\n";
2038 if ( ( @$tags[$i] && @$tags[$i] > 10 )
2039 && ( @$values[$i] ne "" ) )
2041 my $ind1 = substr( @$indicator[$j], 0, 1 );
2043 if ( @$indicator[$j] ) {
2044 $ind2 = substr( @$indicator[$j], 1, 1 );
2047 warn "Indicator in @$tags[$i] is empty";
2051 "<datafield tag=\"@$tags[$i]\" ind1=\"$ind1\" ind2=\"$ind2\">\n";
2053 "<subfield code=\"@$subfields[$i]\">@$values[$i]</subfield>\n";
2061 if ( @$values[$i] ne "" ) {
2064 if ( @$tags[$i] eq "000" ) {
2065 $xml .= "<leader>@$values[$i]</leader>\n";
2068 # rest of the fixed fields
2070 elsif ( @$tags[$i] < 10 ) {
2072 "<controlfield tag=\"@$tags[$i]\">@$values[$i]</controlfield>\n";
2076 my $ind1 = substr( @$indicator[$j], 0, 1 );
2077 my $ind2 = substr( @$indicator[$j], 1, 1 );
2079 "<datafield tag=\"@$tags[$i]\" ind1=\"$ind1\" ind2=\"$ind2\">\n";
2081 "<subfield code=\"@$subfields[$i]\">@$values[$i]</subfield>\n";
2087 else { # @$tags[$i] eq $prevtag
2088 if ( @$values[$i] eq "" ) {
2092 my $ind1 = substr( @$indicator[$j], 0, 1 );
2093 my $ind2 = substr( @$indicator[$j], 1, 1 );
2095 "<datafield tag=\"@$tags[$i]\" ind1=\"$ind1\" ind2=\"$ind2\">\n";
2099 "<subfield code=\"@$subfields[$i]\">@$values[$i]</subfield>\n";
2102 $prevtag = @$tags[$i];
2104 if (C4::Context->preference('marcflavour') and !$unimarc_and_100_exist) {
2105 # warn "SETTING 100 for $auth_type";
2106 use POSIX qw(strftime);
2107 my $string = strftime( "%Y%m%d", localtime(time) );
2108 # set 50 to position 26 is biblios, 13 if authorities
2110 $pos=13 if $auth_type eq 'UNIMARCAUTH';
2111 $string = sprintf( "%-*s", 35, $string );
2112 substr( $string, $pos , 6, "50" );
2113 $xml .= "<datafield tag=\"100\" ind1=\"\" ind2=\"\">\n";
2114 $xml .= "<subfield code=\"a\">$string</subfield>\n";
2115 $xml .= "</datafield>\n";
2117 $xml .= MARC::File::XML::footer();
2121 =head2 TransformHtmlToMarc
2125 $record = TransformHtmlToMarc( $dbh, $rtags, $rsubfields, $rvalues, %indicators )
2131 sub TransformHtmlToMarc {
2132 my ( $dbh, $rtags, $rsubfields, $rvalues, %indicators ) = @_;
2134 my $record = MARC::Record->new();
2136 # my %subfieldlist=();
2137 my $prevvalue; # if tag <10
2138 my $field; # if tag >=10
2139 for ( my $i = 0 ; $i < @$rtags ; $i++ ) {
2140 next unless @$rvalues[$i];
2142 # rebuild MARC::Record
2143 # warn "0=>".@$rtags[$i].@$rsubfields[$i]." = ".@$rvalues[$i].": ";
2144 if ( @$rtags[$i] ne $prevtag ) {
2145 if ( $prevtag < 10 ) {
2148 if ( $prevtag ne '000' ) {
2149 $record->insert_fields_ordered(
2150 ( sprintf "%03s", $prevtag ), $prevvalue );
2154 $record->leader($prevvalue);
2161 $record->insert_fields_ordered($field);
2164 $indicators{ @$rtags[$i] } .= ' ';
2165 if ( @$rtags[$i] < 10 ) {
2166 $prevvalue = @$rvalues[$i];
2171 $field = MARC::Field->new(
2172 ( sprintf "%03s", @$rtags[$i] ),
2173 substr( $indicators{ @$rtags[$i] }, 0, 1 ),
2174 substr( $indicators{ @$rtags[$i] }, 1, 1 ),
2175 @$rsubfields[$i] => @$rvalues[$i]
2178 $prevtag = @$rtags[$i];
2181 if ( @$rtags[$i] < 10 ) {
2182 $prevvalue = @$rvalues[$i];
2185 if ( length( @$rvalues[$i] ) > 0 ) {
2186 $field->add_subfields( @$rsubfields[$i] => @$rvalues[$i] );
2189 $prevtag = @$rtags[$i];
2193 # the last has not been included inside the loop... do it now !
2194 $record->insert_fields_ordered($field) if $field;
2196 $record->encoding('UTF-8');
2198 # $record->MARC::File::USMARC::update_leader();
2202 =head2 TransformMarcToKoha
2206 $result = TransformMarcToKoha( $dbh, $record, $frameworkcode )
2212 sub TransformMarcToKoha {
2213 my ( $dbh, $record, $frameworkcode ) = @_;
2216 "select tagfield,tagsubfield from marc_subfield_structure where frameworkcode=? and kohafield=?"
2219 my $sth2 = $dbh->prepare("SHOW COLUMNS from biblio");
2222 while ( ($field) = $sth2->fetchrow ) {
2224 &TransformMarcToKohaOneField( "biblio", $field, $record, $result,
2227 $sth2 = $dbh->prepare("SHOW COLUMNS from biblioitems");
2229 while ( ($field) = $sth2->fetchrow ) {
2230 if ( $field eq 'notes' ) { $field = 'bnotes'; }
2232 &TransformMarcToKohaOneField( "biblioitems", $field, $record, $result,
2235 $sth2 = $dbh->prepare("SHOW COLUMNS from items");
2237 while ( ($field) = $sth2->fetchrow ) {
2239 &TransformMarcToKohaOneField( "items", $field, $record, $result,
2244 # modify copyrightdate to keep only the 1st year found
2245 my $temp = $result->{'copyrightdate'};
2246 $temp =~ m/c(\d\d\d\d)/; # search cYYYY first
2248 $result->{'copyrightdate'} = $1;
2250 else { # if no cYYYY, get the 1st date.
2251 $temp =~ m/(\d\d\d\d)/;
2252 $result->{'copyrightdate'} = $1;
2255 # modify publicationyear to keep only the 1st year found
2256 $temp = $result->{'publicationyear'};
2257 $temp =~ m/c(\d\d\d\d)/; # search cYYYY first
2259 $result->{'publicationyear'} = $1;
2261 else { # if no cYYYY, get the 1st date.
2262 $temp =~ m/(\d\d\d\d)/;
2263 $result->{'publicationyear'} = $1;
2268 =head2 TransformMarcToKohaOneField
2272 $result = TransformMarcToKohaOneField( $kohatable, $kohafield, $record, $result, $frameworkcode )
2278 sub TransformMarcToKohaOneField {
2280 # FIXME ? if a field has a repeatable subfield that is used in old-db, only the 1st will be retrieved...
2281 my ( $kohatable, $kohafield, $record, $result, $frameworkcode ) = @_;
2284 my ( $tagfield, $subfield ) =
2285 GetMarcFromKohaField( $kohatable . "." . $kohafield,
2287 foreach my $field ( $record->field($tagfield) ) {
2288 if ( $field->tag() < 10 ) {
2289 if ( $result->{$kohafield} ) {
2290 $result->{$kohafield} .= " | " . $field->data();
2293 $result->{$kohafield} = $field->data();
2297 if ( $field->subfields ) {
2298 my @subfields = $field->subfields();
2299 foreach my $subfieldcount ( 0 .. $#subfields ) {
2300 if ( $subfields[$subfieldcount][0] eq $subfield ) {
2301 if ( $result->{$kohafield} ) {
2302 $result->{$kohafield} .=
2303 " | " . $subfields[$subfieldcount][1];
2306 $result->{$kohafield} =
2307 $subfields[$subfieldcount][1];
2316 =head1 OTHER FUNCTIONS
2322 my $string = char_decode( $string, $encoding );
2324 converts ISO 5426 coded string to UTF-8
2325 sloppy code : should be improved in next issue
2332 my ( $string, $encoding ) = @_;
2335 $encoding = C4::Context->preference("marcflavour") unless $encoding;
2336 if ( $encoding eq "UNIMARC" ) {
2406 # this handles non-sorting blocks (if implementation requires this)
2407 $string = nsb_clean($_);
2409 elsif ( $encoding eq "USMARC" || $encoding eq "MARC21" ) {
2468 #Additional Turkish characters
2471 s/(\xf0)s/\xc5\x9f/gm;
2472 s/(\xf0)S/\xc5\x9e/gm;
2475 s/\xe7\x49/\\xc4\xb0/gm;
2476 s/(\xe6)G/\xc4\x9e/gm;
2477 s/(\xe6)g/ğ\xc4\x9f/gm;
2480 s/(\xe8|\xc8)o/ö/gm;
2481 s/(\xe8|\xc8)O/Ö/gm;
2482 s/(\xe8|\xc8)u/ü/gm;
2483 s/(\xe8|\xc8)U/Ü/gm;
2484 s/\xc2\xb8/\xc4\xb1/gm;
2487 # this handles non-sorting blocks (if implementation requires this)
2488 $string = nsb_clean($_);
2497 my $string = nsb_clean( $string, $encoding );
2504 my $NSB = '\x88'; # NSB : begin Non Sorting Block
2505 my $NSE = '\x89'; # NSE : Non Sorting Block end
2506 # handles non sorting blocks
2510 s/[ ]{0,1}$NSE/) /gm;
2515 =head2 PrepareItemrecordDisplay
2519 PrepareItemrecordDisplay($itemrecord,$bibnum,$itemumber);
2521 Returns a hash with all the fields for Display a given item data in a template
2527 sub PrepareItemrecordDisplay {
2529 my ( $bibnum, $itemnum ) = @_;
2531 my $dbh = C4::Context->dbh;
2532 my $frameworkcode = &GetFrameworkCode( $bibnum );
2533 my ( $itemtagfield, $itemtagsubfield ) =
2534 &GetMarcFromKohaField( "items.itemnumber", $frameworkcode );
2535 my $tagslib = &GetMarcStructure( 1, $frameworkcode );
2536 my $itemrecord = GetMarcItem( $bibnum, $itemnum) if ($itemnum);
2538 my $authorised_values_sth =
2540 "select authorised_value,lib from authorised_values where category=? order by lib"
2542 foreach my $tag ( sort keys %{$tagslib} ) {
2543 my $previous_tag = '';
2545 # loop through each subfield
2547 foreach my $subfield ( sort keys %{ $tagslib->{$tag} } ) {
2548 next if ( subfield_is_koha_internal_p($subfield) );
2549 next if ( $tagslib->{$tag}->{$subfield}->{'tab'} ne "10" );
2551 $subfield_data{tag} = $tag;
2552 $subfield_data{subfield} = $subfield;
2553 $subfield_data{countsubfield} = $cntsubf++;
2554 $subfield_data{kohafield} =
2555 $tagslib->{$tag}->{$subfield}->{'kohafield'};
2557 # $subfield_data{marc_lib}=$tagslib->{$tag}->{$subfield}->{lib};
2558 $subfield_data{marc_lib} =
2559 "<span id=\"error\" title=\""
2560 . $tagslib->{$tag}->{$subfield}->{lib} . "\">"
2561 . substr( $tagslib->{$tag}->{$subfield}->{lib}, 0, 12 )
2563 $subfield_data{mandatory} =
2564 $tagslib->{$tag}->{$subfield}->{mandatory};
2565 $subfield_data{repeatable} =
2566 $tagslib->{$tag}->{$subfield}->{repeatable};
2567 $subfield_data{hidden} = "display:none"
2568 if $tagslib->{$tag}->{$subfield}->{hidden};
2570 ( $x, $value ) = _find_value( $tag, $subfield, $itemrecord )
2572 $value =~ s/"/"/g;
2574 # search for itemcallnumber if applicable
2575 if ( $tagslib->{$tag}->{$subfield}->{kohafield} eq
2576 'items.itemcallnumber'
2577 && C4::Context->preference('itemcallnumber') )
2580 substr( C4::Context->preference('itemcallnumber'), 0, 3 );
2582 substr( C4::Context->preference('itemcallnumber'), 3, 1 );
2583 my $temp = $itemrecord->field($CNtag) if ($itemrecord);
2585 $value = $temp->subfield($CNsubfield);
2588 if ( $tagslib->{$tag}->{$subfield}->{authorised_value} ) {
2589 my @authorised_values;
2592 # builds list, depending on authorised value...
2594 if ( $tagslib->{$tag}->{$subfield}->{'authorised_value'} eq
2597 if ( ( C4::Context->preference("IndependantBranches") )
2598 && ( C4::Context->userenv->{flags} != 1 ) )
2602 "select branchcode,branchname from branches where branchcode = ? order by branchname"
2604 $sth->execute( C4::Context->userenv->{branch} );
2605 push @authorised_values, ""
2607 $tagslib->{$tag}->{$subfield}->{mandatory} );
2608 while ( my ( $branchcode, $branchname ) =
2609 $sth->fetchrow_array )
2611 push @authorised_values, $branchcode;
2612 $authorised_lib{$branchcode} = $branchname;
2618 "select branchcode,branchname from branches order by branchname"
2621 push @authorised_values, ""
2623 $tagslib->{$tag}->{$subfield}->{mandatory} );
2624 while ( my ( $branchcode, $branchname ) =
2625 $sth->fetchrow_array )
2627 push @authorised_values, $branchcode;
2628 $authorised_lib{$branchcode} = $branchname;
2634 elsif ( $tagslib->{$tag}->{$subfield}->{authorised_value} eq
2639 "select itemtype,description from itemtypes order by description"
2642 push @authorised_values, ""
2643 unless ( $tagslib->{$tag}->{$subfield}->{mandatory} );
2644 while ( my ( $itemtype, $description ) =
2645 $sth->fetchrow_array )
2647 push @authorised_values, $itemtype;
2648 $authorised_lib{$itemtype} = $description;
2651 #---- "true" authorised value
2654 $authorised_values_sth->execute(
2655 $tagslib->{$tag}->{$subfield}->{authorised_value} );
2656 push @authorised_values, ""
2657 unless ( $tagslib->{$tag}->{$subfield}->{mandatory} );
2658 while ( my ( $value, $lib ) =
2659 $authorised_values_sth->fetchrow_array )
2661 push @authorised_values, $value;
2662 $authorised_lib{$value} = $lib;
2665 $subfield_data{marc_value} = CGI::scrolling_list(
2666 -name => 'field_value',
2667 -values => \@authorised_values,
2668 -default => "$value",
2669 -labels => \%authorised_lib,
2675 elsif ( $tagslib->{$tag}->{$subfield}->{thesaurus_category} ) {
2676 $subfield_data{marc_value} =
2677 "<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>";
2680 # COMMENTED OUT because No $i is provided with this API.
2681 # And thus, no value_builder can be activated.
2682 # BUT could be thought over.
2683 # } elsif ($tagslib->{$tag}->{$subfield}->{'value_builder'}) {
2684 # my $plugin="value_builder/".$tagslib->{$tag}->{$subfield}->{'value_builder'};
2686 # my $extended_param = plugin_parameters($dbh,$itemrecord,$tagslib,$i,0);
2687 # my ($function_name,$javascript) = plugin_javascript($dbh,$record,$tagslib,$i,0);
2688 # $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";
2691 $subfield_data{marc_value} =
2692 "<input type=\"text\" name=\"field_value\" value=\"$value\" size=50 maxlength=255>";
2694 push( @loop_data, \%subfield_data );
2698 my $itemnumber = $itemrecord->subfield( $itemtagfield, $itemtagsubfield )
2699 if ( $itemrecord && $itemrecord->field($itemtagfield) );
2701 'itemtagfield' => $itemtagfield,
2702 'itemtagsubfield' => $itemtagsubfield,
2703 'itemnumber' => $itemnumber,
2704 'iteminformation' => \@loop_data
2710 # true ModZebra commented until indexdata fixes zebraDB crashes (it seems they occur on multiple updates
2712 # replaced by a zebraqueue table, that is filled with ModZebra to run.
2713 # the table is emptied by misc/cronjobs/zebraqueue_start.pl script
2714 # =head2 ModZebrafiles
2716 # &ModZebrafiles( $dbh, $biblionumber, $record, $folder, $server );
2720 # sub ModZebrafiles {
2722 # my ( $dbh, $biblionumber, $record, $folder, $server ) = @_;
2726 # C4::Context->zebraconfig($server)->{directory} . "/" . $folder . "/";
2727 # unless ( opendir( DIR, "$zebradir" ) ) {
2728 # warn "$zebradir not found";
2732 # my $filename = $zebradir . $biblionumber;
2735 # open( OUTPUT, ">", $filename . ".xml" );
2736 # print OUTPUT $record;
2745 ModZebra( $biblionumber, $op, $server, $newRecord );
2747 $biblionumber is the biblionumber we want to index
2748 $op is specialUpdate or delete, and is used to know what we want to do
2749 $server is the server that we want to update
2750 $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.
2756 ###Accepts a $server variable thus we can use it for biblios authorities or other zebra dbs
2757 my ( $biblionumber, $op, $server, $newRecord ) = @_;
2758 # warn "ModZebra with : ( $biblionumber, $op, $server, $newRecord )";
2759 my $dbh=C4::Context->dbh;
2760 #warn "SERVER:".$server;
2762 # true ModZebra commented until indexdata fixes zebraDB crashes (it seems they occur on multiple updates
2764 # replaced by a zebraqueue table, that is filled with ModZebra to run.
2765 # the table is emptied by misc/cronjobs/zebraqueue_start.pl script
2767 if (C4::Context->preference("NoZebra")) {
2768 # lock the nozebra table : we will read index lines, update them in Perl process
2769 # and write everything in 1 transaction.
2770 # lock the table to avoid someone else overwriting what we are doing
2771 $dbh->do('LOCK TABLES nozebra WRITE,biblio WRITE,biblioitems WRITE, systempreferences WRITE, auth_types WRITE, auth_header WRITE');
2772 my %result; # the result hash that will be builded by deletion / add, and written on mySQL at the end, to improve speed
2774 if ($server eq 'biblioserver') {
2775 $record= GetMarcBiblio($biblionumber);
2777 $record= C4::AuthoritiesMarc::GetAuthority($biblionumber);
2779 if ($op eq 'specialUpdate') {
2780 # OK, we have to add or update the record
2781 # 1st delete (virtually, in indexes) ...
2782 %result = _DelBiblioNoZebra($biblionumber,$record,$server);
2783 # ... add the record
2784 %result=_AddBiblioNoZebra($biblionumber,$newRecord, $server, %result);
2786 # it's a deletion, delete the record...
2787 # warn "DELETE the record $biblionumber on $server".$record->as_formatted;
2788 %result=_DelBiblioNoZebra($biblionumber,$record,$server);
2790 # ok, now update the database...
2791 my $sth = $dbh->prepare("UPDATE nozebra SET biblionumbers=? WHERE server=? AND indexname=? AND value=?");
2792 foreach my $key (keys %result) {
2793 foreach my $index (keys %{$result{$key}}) {
2794 # warn "UPDATING : $server $key , $index with :".$result{$key}->{$index};
2795 $sth->execute($result{$key}->{$index}, $server, $key, $index);
2798 $dbh->do('UNLOCK TABLES');
2802 # we use zebra, just fill zebraqueue table
2804 my $sth=$dbh->prepare("insert into zebraqueue (biblio_auth_number ,server,operation) values(?,?,?)");
2805 $sth->execute($biblionumber,$server,$op);
2810 =head2 GetNoZebraIndexes
2814 sub GetNoZebraIndexes {
2815 my $index = C4::Context->preference('NoZebraIndexes');
2817 foreach my $line (split /('|"),/,$index) {
2818 $line =~ /(.*)=>(.*)/;
2819 my $index = substr($1,1); # get the index, don't forget to remove initial ' or "
2821 $index =~ s/'|"| //g;
2822 $fields =~ s/'|"| //g;
2823 $indexes{$index}=$fields;
2828 =head1 INTERNAL FUNCTIONS
2830 =head2 _DelBiblioNoZebra($biblionumber,$record,$server);
2832 function to delete a biblio in NoZebra indexes
2833 This function does NOT delete anything in database : it reads all the indexes entries
2834 that have to be deleted & delete them in the hash
2835 The SQL part is done either :
2836 - after the Add if we are modifying a biblio (delete + add again)
2837 - immediatly after this sub if we are doing a true deletion.
2838 $server can be 'biblioserver' or 'authorityserver' : it indexes biblios or authorities (in the same table, $server being part of the table itself
2843 sub _DelBiblioNoZebra {
2844 my ($biblionumber, $record, $server)=@_;
2847 my $dbh = C4::Context->dbh;
2851 if ($server eq 'biblioserver') {
2852 %index=GetNoZebraIndexes;
2853 # get title of the record (to store the 10 first letters with the index)
2854 my ($titletag,$titlesubfield) = GetMarcFromKohaField('biblio.title');
2855 $title = lc($record->subfield($titletag,$titlesubfield));
2857 # for authorities, the "title" is the $a mainentry
2858 my $authref = C4::AuthoritiesMarc::GetAuthType($record->subfield(152,'b'));
2859 warn "ERROR : authtype undefined for ".$record->as_formatted unless $authref;
2860 $title = $record->subfield($authref->{auth_tag_to_report},'a');
2861 $index{'mainmainentry'}= $authref->{'auth_tag_to_report'}.'a';
2862 $index{'mainentry'} = $authref->{'auth_tag_to_report'}.'*';
2863 $index{'auth_type'} = '152b';
2867 # remove blancks comma (that could cause problem when decoding the string for CQL retrieval) and regexp specific values
2868 $title =~ s/ |,|;|\[|\]|\(|\)|\*|-|'|=//g;
2869 # limit to 10 char, should be enough, and limit the DB size
2870 $title = substr($title,0,10);
2872 my $sth2=$dbh->prepare('SELECT biblionumbers FROM nozebra WHERE server=? AND indexname=? AND value=?');
2873 foreach my $field ($record->fields()) {
2874 #parse each subfield
2875 next if $field->tag <10;
2876 foreach my $subfield ($field->subfields()) {
2877 my $tag = $field->tag();
2878 my $subfieldcode = $subfield->[0];
2880 # check each index to see if the subfield is stored somewhere
2881 # otherwise, store it in __RAW__ index
2882 foreach my $key (keys %index) {
2883 # warn "examining $key index : ".$index{$key}." for $tag $subfieldcode";
2884 if ($index{$key} =~ /$tag\*/ or $index{$key} =~ /$tag$subfieldcode/) {
2886 my $line= lc $subfield->[1];
2887 # remove meaningless value in the field...
2888 $line =~ s/-|\.|\?|,|;|!|'|\(|\)|\[|\]|{|}|"|<|>|&|\+|\*|\/|=|:/ /g;
2889 # ... and split in words
2890 foreach (split / /,$line) {
2891 next unless $_; # skip empty values (multiple spaces)
2892 # if the entry is already here, do nothing, the biblionumber has already be removed
2893 unless ($result{$key}->{$_} =~ /$biblionumber,$title\-(\d);/) {
2894 # get the index value if it exist in the nozebra table and remove the entry, otherwise, do nothing
2895 $sth2->execute($server,$key,$_);
2896 my $existing_biblionumbers = $sth2->fetchrow;
2898 if ($existing_biblionumbers) {
2899 # warn " existing for $key $_: $existing_biblionumbers";
2900 $result{$key}->{$_} =$existing_biblionumbers;
2901 $result{$key}->{$_} =~ s/$biblionumber,$title\-(\d);//;
2907 # the subfield is not indexed, store it in __RAW__ index anyway
2909 my $line= lc $subfield->[1];
2910 $line =~ s/-|\.|\?|,|;|!|'|\(|\)|\[|\]|{|}|"|<|>|&|\+|\*|\/|=|:/ /g;
2911 # ... and split in words
2912 foreach (split / /,$line) {
2913 next unless $_; # skip empty values (multiple spaces)
2914 # if the entry is already here, do nothing, the biblionumber has already be removed
2915 unless ($result{'__RAW__'}->{$_} =~ /$biblionumber,$title\-(\d);/) {
2916 # get the index value if it exist in the nozebra table and remove the entry, otherwise, do nothing
2917 $sth2->execute($server,'__RAW__',$_);
2918 my $existing_biblionumbers = $sth2->fetchrow;
2920 if ($existing_biblionumbers) {
2921 $result{'__RAW__'}->{$_} =$existing_biblionumbers;
2922 $result{'__RAW__'}->{$_} =~ s/$biblionumber,$title\-(\d);//;
2932 =head2 _DelBiblioNoZebra($biblionumber,$record);
2934 function to delete a biblio in NoZebra indexes
2939 sub _AddBiblioNoZebra {
2940 my ($biblionumber, $record, $server, %result)=@_;
2941 my $dbh = C4::Context->dbh;
2945 if ($server eq 'biblioserver') {
2946 %index=GetNoZebraIndexes;
2947 # get title of the record (to store the 10 first letters with the index)
2948 my ($titletag,$titlesubfield) = GetMarcFromKohaField('biblio.title');
2949 $title = lc($record->subfield($titletag,$titlesubfield));
2951 # warn "server : $server";
2952 # for authorities, the "title" is the $a mainentry
2953 my $authref = C4::AuthoritiesMarc::GetAuthType($record->subfield(152,'b'));
2954 warn "ERROR : authtype undefined for ".$record->as_formatted unless $authref;
2955 $title = $record->subfield($authref->{auth_tag_to_report},'a');
2956 $index{'mainmainentry'}=$authref->{auth_tag_to_report}.'a';
2957 $index{'mainentry'} = $authref->{auth_tag_to_report}.'*';
2958 $index{'auth_type'} = '152b';
2961 # remove blancks comma (that could cause problem when decoding the string for CQL retrieval) and regexp specific values
2962 $title =~ s/ |,|;|\[|\]|\(|\)|\*|-|'|=//g;
2963 # limit to 10 char, should be enough, and limit the DB size
2964 $title = substr($title,0,10);
2966 my $sth2=$dbh->prepare('SELECT biblionumbers FROM nozebra WHERE server=? AND indexname=? AND value=?');
2967 foreach my $field ($record->fields()) {
2968 #parse each subfield
2969 next if $field->tag <10;
2970 foreach my $subfield ($field->subfields()) {
2971 my $tag = $field->tag();
2972 my $subfieldcode = $subfield->[0];
2974 # check each index to see if the subfield is stored somewhere
2975 # otherwise, store it in __RAW__ index
2976 foreach my $key (keys %index) {
2977 # warn "examining $key index : ".$index{$key}." for $tag $subfieldcode";
2978 if ($index{$key} =~ /$tag\*/ or $index{$key} =~ /$tag$subfieldcode/) {
2980 my $line= lc $subfield->[1];
2981 # remove meaningless value in the field...
2982 $line =~ s/-|\.|\?|,|;|!|'|\(|\)|\[|\]|{|}|"|<|>|&|\+|\*|\/|=|:/ /g;
2983 # ... and split in words
2984 foreach (split / /,$line) {
2985 next unless $_; # skip empty values (multiple spaces)
2986 # if the entry is already here, improve weight
2987 # warn "managing $_";
2988 if ($result{$key}->{$_} =~ /$biblionumber,$title\-(\d);/) {
2990 $result{$key}->{$_} =~ s/$biblionumber,$title\-(\d);//;
2991 $result{$key}->{$_} .= "$biblionumber,$title-$weight;";
2993 # get the value if it exist in the nozebra table, otherwise, create it
2994 $sth2->execute($server,$key,$_);
2995 my $existing_biblionumbers = $sth2->fetchrow;
2997 if ($existing_biblionumbers) {
2998 $result{$key}->{$_} =$existing_biblionumbers;
3000 $result{$key}->{$_} =~ s/$biblionumber,$title\-(\d);//;
3001 $result{$key}->{$_} .= "$biblionumber,$title-$weight;";
3002 # create a new ligne for this entry
3004 # warn "INSERT : $server / $key / $_";
3005 $dbh->do('INSERT INTO nozebra SET server='.$dbh->quote($server).', indexname='.$dbh->quote($key).',value='.$dbh->quote($_));
3006 $result{$key}->{$_}.="$biblionumber,$title-1;";
3012 # the subfield is not indexed, store it in __RAW__ index anyway
3014 my $line= lc $subfield->[1];
3015 $line =~ s/-|\.|\?|,|;|!|'|\(|\)|\[|\]|{|}|"|<|>|&|\+|\*|\/|=|:/ /g;
3016 # ... and split in words
3017 foreach (split / /,$line) {
3018 next unless $_; # skip empty values (multiple spaces)
3019 # if the entry is already here, improve weight
3020 if ($result{'__RAW__'}->{$_} =~ /$biblionumber,$title\-(\d);/) {
3022 $result{'__RAW__'}->{$_} =~ s/$biblionumber,$title\-(\d);//;
3023 $result{'__RAW__'}->{$_} .= "$biblionumber,$title-$weight;";
3025 # get the value if it exist in the nozebra table, otherwise, create it
3026 $sth2->execute($server,'__RAW__',$_);
3027 my $existing_biblionumbers = $sth2->fetchrow;
3029 if ($existing_biblionumbers) {
3030 $result{'__RAW__'}->{$_} =$existing_biblionumbers;
3032 $result{'__RAW__'}->{$_} =~ s/$biblionumber,$title\-(\d);//;
3033 $result{'__RAW__'}->{$_} .= "$biblionumber,$title-$weight;";
3034 # create a new ligne for this entry
3036 $dbh->do('INSERT INTO nozebra SET server='.$dbh->quote($server).', indexname="__RAW__",value='.$dbh->quote($_));
3037 $result{'__RAW__'}->{$_}.="$biblionumber,$title-1;";
3048 =head2 MARCitemchange
3052 &MARCitemchange( $record, $itemfield, $newvalue )
3054 Function to update a single value in an item field.
3055 Used twice, could probably be replaced by something else, but works well...
3063 sub MARCitemchange {
3064 my ( $record, $itemfield, $newvalue ) = @_;
3065 my $dbh = C4::Context->dbh;
3067 my ( $tagfield, $tagsubfield ) =
3068 GetMarcFromKohaField( $itemfield, "" );
3069 if ( ($tagfield) && ($tagsubfield) ) {
3070 my $tag = $record->field($tagfield);
3072 $tag->update( $tagsubfield => $newvalue );
3073 $record->delete_field($tag);
3074 $record->insert_fields_ordered($tag);
3079 =head2 _koha_add_biblio
3083 _koha_add_biblio($dbh,$biblioitem);
3085 Internal function to add a biblio ($biblio is a hash with the values)
3091 sub _koha_add_biblio {
3092 my ( $dbh, $biblio, $frameworkcode ) = @_;
3093 my $sth = $dbh->prepare("Select max(biblionumber) from biblio");
3095 my $data = $sth->fetchrow_arrayref;
3096 my $biblionumber = $$data[0] + 1;
3099 if ( $biblio->{'seriestitle'} ) { $series = 1 }
3101 $sth = $dbh->prepare(
3103 SET biblionumber = ?, title = ?, author = ?, copyrightdate = ?, serial = ?, seriestitle = ?, notes = ?, abstract = ?, unititle = ?, frameworkcode = ? "
3106 $biblionumber, $biblio->{'title'},
3107 $biblio->{'author'}, $biblio->{'copyrightdate'},
3108 $biblio->{'serial'}, $biblio->{'seriestitle'},
3109 $biblio->{'notes'}, $biblio->{'abstract'},
3110 $biblio->{'unititle'}, $frameworkcode
3114 return ($biblionumber);
3121 ($indicators, $value) = _find_value($tag, $subfield, $record,$encoding);
3123 Find the given $subfield in the given $tag in the given
3124 MARC::Record $record. If the subfield is found, returns
3125 the (indicators, value) pair; otherwise, (undef, undef) is
3129 Such a function is used in addbiblio AND additem and serial-edit and maybe could be used in Authorities.
3130 I suggest we export it from this module.
3137 my ( $tagfield, $insubfield, $record, $encoding ) = @_;
3140 if ( $tagfield < 10 ) {
3141 if ( $record->field($tagfield) ) {
3142 push @result, $record->field($tagfield)->data();
3149 foreach my $field ( $record->field($tagfield) ) {
3150 my @subfields = $field->subfields();
3151 foreach my $subfield (@subfields) {
3152 if ( @$subfield[0] eq $insubfield ) {
3153 push @result, @$subfield[1];
3154 $indicator = $field->indicator(1) . $field->indicator(2);
3159 return ( $indicator, @result );
3162 =head2 _koha_modify_biblio
3166 Internal function for updating the biblio table
3172 sub _koha_modify_biblio {
3173 my ( $dbh, $biblio ) = @_;
3175 # FIXME: this code could be made more portable by not hard-coding the values that are supposed to be in biblio table
3178 "Update biblio set title = ?, author = ?, abstract = ?, copyrightdate = ?, seriestitle = ?, serial = ?, unititle = ?, notes = ? where biblionumber = ?"
3181 $biblio->{'title'}, $biblio->{'author'},
3182 $biblio->{'abstract'}, $biblio->{'copyrightdate'},
3183 $biblio->{'seriestitle'}, $biblio->{'serial'},
3184 $biblio->{'unititle'}, $biblio->{'notes'},
3185 $biblio->{'biblionumber'}
3188 return ( $biblio->{'biblionumber'} );
3191 =head2 _koha_modify_biblioitem
3195 _koha_modify_biblioitem( $dbh, $biblioitem );
3201 sub _koha_modify_biblioitem {
3202 my ( $dbh, $biblioitem ) = @_;
3204 ##Recalculate LC in case it changed --TG
3206 $biblioitem->{'itemtype'} = $dbh->quote( $biblioitem->{'itemtype'} );
3207 $biblioitem->{'url'} = $dbh->quote( $biblioitem->{'url'} );
3208 $biblioitem->{'isbn'} = $dbh->quote( $biblioitem->{'isbn'} );
3209 $biblioitem->{'issn'} = $dbh->quote( $biblioitem->{'issn'} );
3210 $biblioitem->{'publishercode'} =
3211 $dbh->quote( $biblioitem->{'publishercode'} );
3212 $biblioitem->{'publicationyear'} =
3213 $dbh->quote( $biblioitem->{'publicationyear'} );
3214 $biblioitem->{'classification'} =
3215 $dbh->quote( $biblioitem->{'classification'} );
3216 $biblioitem->{'dewey'} = $dbh->quote( $biblioitem->{'dewey'} );
3217 $biblioitem->{'subclass'} = $dbh->quote( $biblioitem->{'subclass'} );
3218 $biblioitem->{'illus'} = $dbh->quote( $biblioitem->{'illus'} );
3219 $biblioitem->{'pages'} = $dbh->quote( $biblioitem->{'pages'} );
3220 $biblioitem->{'volumeddesc'} = $dbh->quote( $biblioitem->{'volumeddesc'} );
3221 $biblioitem->{'bnotes'} = $dbh->quote( $biblioitem->{'bnotes'} );
3222 $biblioitem->{'size'} = $dbh->quote( $biblioitem->{'size'} );
3223 $biblioitem->{'place'} = $dbh->quote( $biblioitem->{'place'} );
3224 $biblioitem->{'ccode'} = $dbh->quote( $biblioitem->{'ccode'} );
3225 $biblioitem->{'biblionumber'} =
3226 $dbh->quote( $biblioitem->{'biblionumber'} );
3228 $query = "Update biblioitems set
3229 itemtype = $biblioitem->{'itemtype'},
3230 url = $biblioitem->{'url'},
3231 isbn = $biblioitem->{'isbn'},
3232 issn = $biblioitem->{'issn'},
3233 publishercode = $biblioitem->{'publishercode'},
3234 publicationyear = $biblioitem->{'publicationyear'},
3235 classification = $biblioitem->{'classification'},
3236 dewey = $biblioitem->{'dewey'},
3237 subclass = $biblioitem->{'subclass'},
3238 illus = $biblioitem->{'illus'},
3239 pages = $biblioitem->{'pages'},
3240 volumeddesc = $biblioitem->{'volumeddesc'},
3241 notes = $biblioitem->{'bnotes'},
3242 size = $biblioitem->{'size'},
3243 place = $biblioitem->{'place'},
3244 ccode = $biblioitem->{'ccode'}
3245 where biblionumber = $biblioitem->{'biblionumber'}";
3248 if ( $dbh->errstr ) {
3249 warn "ERROR in _koha_modify_biblioitem $query";
3253 =head2 _koha_add_biblioitem
3257 _koha_add_biblioitem( $dbh, $biblioitem );
3259 Internal function to add a biblioitem
3265 sub _koha_add_biblioitem {
3266 my ( $dbh, $biblioitem ) = @_;
3268 # my $dbh = C4Connect;
3269 my $sth = $dbh->prepare("SELECT max(biblioitemnumber) FROM biblioitems");
3274 $data = $sth->fetchrow_arrayref;
3275 $bibitemnum = $$data[0] + 1;
3279 $sth = $dbh->prepare(
3280 "INSERT INTO biblioitems SET
3281 biblioitemnumber = ?, biblionumber = ?,
3282 volume = ?, number = ?,
3283 classification = ?, itemtype = ?,
3285 issn = ?, dewey = ?,
3286 subclass = ?, publicationyear = ?,
3287 publishercode = ?, volumedate = ?,
3288 volumeddesc = ?, illus = ?,
3289 pages = ?, notes = ?,
3291 marc = ?, lcsort =?,
3292 place = ?, ccode = ?
3296 calculatelc( $biblioitem->{'classification'} )
3297 . $biblioitem->{'subclass'};
3299 $bibitemnum, $biblioitem->{'biblionumber'},
3300 $biblioitem->{'volume'}, $biblioitem->{'number'},
3301 $biblioitem->{'classification'}, $biblioitem->{'itemtype'},
3302 $biblioitem->{'url'}, $biblioitem->{'isbn'},
3303 $biblioitem->{'issn'}, $biblioitem->{'dewey'},
3304 $biblioitem->{'subclass'}, $biblioitem->{'publicationyear'},
3305 $biblioitem->{'publishercode'}, $biblioitem->{'volumedate'},
3306 $biblioitem->{'volumeddesc'}, $biblioitem->{'illus'},
3307 $biblioitem->{'pages'}, $biblioitem->{'bnotes'},
3308 $biblioitem->{'size'}, $biblioitem->{'lccn'},
3309 $biblioitem->{'marc'}, $biblioitem->{'place'},
3310 $lcsort, $biblioitem->{'ccode'}
3313 return ($bibitemnum);
3316 =head2 _koha_new_items
3320 _koha_new_items( $dbh, $item, $barcode );
3326 sub _koha_new_items {
3327 my ( $dbh, $item, $barcode ) = @_;
3329 # my $dbh = C4Connect;
3330 my $sth = $dbh->prepare("Select max(itemnumber) from items");
3336 $data = $sth->fetchrow_hashref;
3337 $itemnumber = $data->{'max(itemnumber)'} + 1;
3339 ## Now calculate lccalnumber
3340 my ($cutterextra) = itemcalculator(
3342 $item->{'biblioitemnumber'},
3343 $item->{'itemcallnumber'}
3346 # FIXME the "notforloan" field seems to be named "loan" in some places. workaround bugfix.
3347 if ( $item->{'loan'} ) {
3348 $item->{'notforloan'} = $item->{'loan'};
3351 # if dateaccessioned is provided, use it. Otherwise, set to NOW()
3352 if ( $item->{'dateaccessioned'} eq '' || !$item->{'dateaccessioned'} ) {
3354 $sth = $dbh->prepare(
3355 "Insert into items set
3356 itemnumber = ?, biblionumber = ?,
3357 multivolumepart = ?,
3358 biblioitemnumber = ?, barcode = ?,
3359 booksellerid = ?, dateaccessioned = NOW(),
3360 homebranch = ?, holdingbranch = ?,
3361 price = ?, replacementprice = ?,
3362 replacementpricedate = NOW(), datelastseen = NOW(),
3363 multivolume = ?, stack = ?,
3364 itemlost = ?, wthdrawn = ?,
3365 paidfor = ?, itemnotes = ?,
3366 itemcallnumber =?, notforloan = ?,
3367 location = ?, Cutterextra = ?
3371 $itemnumber, $item->{'biblionumber'},
3372 $item->{'multivolumepart'}, $item->{'biblioitemnumber'},
3373 $barcode, $item->{'booksellerid'},
3374 $item->{'homebranch'}, $item->{'holdingbranch'},
3375 $item->{'price'}, $item->{'replacementprice'},
3376 $item->{multivolume}, $item->{stack},
3377 $item->{itemlost}, $item->{wthdrawn},
3378 $item->{paidfor}, $item->{'itemnotes'},
3379 $item->{'itemcallnumber'}, $item->{'notforloan'},
3380 $item->{'location'}, $cutterextra
3384 $sth = $dbh->prepare(
3385 "INSERT INTO items SET
3386 itemnumber = ?, biblionumber = ?,
3387 multivolumepart = ?,
3388 biblioitemnumber = ?, barcode = ?,
3389 booksellerid = ?, dateaccessioned = ?,
3390 homebranch = ?, holdingbranch = ?,
3391 price = ?, replacementprice = ?,
3392 replacementpricedate = NOW(), datelastseen = NOW(),
3393 multivolume = ?, stack = ?,
3394 itemlost = ?, wthdrawn = ?,
3395 paidfor = ?, itemnotes = ?,
3396 itemcallnumber = ?, notforloan = ?,
3402 $itemnumber, $item->{'biblionumber'},
3403 $item->{'multivolumepart'}, $item->{'biblioitemnumber'},
3404 $barcode, $item->{'booksellerid'},
3405 $item->{'dateaccessioned'}, $item->{'homebranch'},
3406 $item->{'holdingbranch'}, $item->{'price'},
3407 $item->{'replacementprice'}, $item->{multivolume},
3408 $item->{stack}, $item->{itemlost},
3409 $item->{wthdrawn}, $item->{paidfor},
3410 $item->{'itemnotes'}, $item->{'itemcallnumber'},
3411 $item->{'notforloan'}, $item->{'location'},
3415 if ( defined $sth->errstr ) {
3416 $error .= $sth->errstr;
3418 return ( $itemnumber, $error );
3421 =head2 _koha_modify_item
3425 _koha_modify_item( $dbh, $item, $op );
3431 sub _koha_modify_item {
3432 my ( $dbh, $item, $op ) = @_;
3433 $item->{'itemnum'} = $item->{'itemnumber'} unless $item->{'itemnum'};
3435 # if all we're doing is setting statuses, just update those and get out
3436 if ( $op eq "setstatus" ) {
3438 "UPDATE items SET itemlost=?,wthdrawn=?,binding=? WHERE itemnumber=?";
3440 $item->{'itemlost'}, $item->{'wthdrawn'},
3441 $item->{'binding'}, $item->{'itemnumber'}
3443 my $sth = $dbh->prepare($query);
3444 $sth->execute(@bind);
3448 ## Now calculate lccalnumber
3450 itemcalculator( $dbh, $item->{'bibitemnum'}, $item->{'itemcallnumber'} );
3452 my $query = "UPDATE items SET
3453 barcode=?,itemnotes=?,itemcallnumber=?,notforloan=?,location=?,multivolumepart=?,multivolume=?,stack=?,wthdrawn=?,holdingbranch=?,homebranch=?,cutterextra=?, onloan=?, binding=?";
3456 $item->{'barcode'}, $item->{'notes'},
3457 $item->{'itemcallnumber'}, $item->{'notforloan'},
3458 $item->{'location'}, $item->{multivolumepart},
3459 $item->{multivolume}, $item->{stack},
3460 $item->{wthdrawn}, $item->{holdingbranch},
3461 $item->{homebranch}, $cutterextra,
3462 $item->{onloan}, $item->{binding}
3464 if ( $item->{'lost'} ne '' ) {
3466 "update items set biblioitemnumber=?,barcode=?,itemnotes=?,homebranch=?,
3467 itemlost=?,wthdrawn=?,itemcallnumber=?,notforloan=?,
3468 location=?,multivolumepart=?,multivolume=?,stack=?,wthdrawn=?,holdingbranch=?,cutterextra=?,onloan=?, binding=?";
3470 $item->{'bibitemnum'}, $item->{'barcode'},
3471 $item->{'notes'}, $item->{'homebranch'},
3472 $item->{'lost'}, $item->{'wthdrawn'},
3473 $item->{'itemcallnumber'}, $item->{'notforloan'},
3474 $item->{'location'}, $item->{multivolumepart},
3475 $item->{multivolume}, $item->{stack},
3476 $item->{wthdrawn}, $item->{holdingbranch},
3477 $cutterextra, $item->{onloan},
3480 if ( $item->{homebranch} ) {
3481 $query .= ",homebranch=?";
3482 push @bind, $item->{homebranch};
3484 if ( $item->{holdingbranch} ) {
3485 $query .= ",holdingbranch=?";
3486 push @bind, $item->{holdingbranch};
3489 $query .= " where itemnumber=?";
3490 push @bind, $item->{'itemnum'};
3491 if ( $item->{'replacement'} ne '' ) {
3492 $query =~ s/ where/,replacementprice='$item->{'replacement'}' where/;
3494 my $sth = $dbh->prepare($query);
3495 $sth->execute(@bind);
3499 =head2 _koha_delete_biblio
3503 $error = _koha_delete_biblio($dbh,$biblionumber);
3505 Internal sub for deleting from biblio table -- also saves to deletedbiblio
3507 C<$dbh> - the database handle
3508 C<$biblionumber> - the biblionumber of the biblio to be deleted
3514 # FIXME: add error handling
3516 sub _koha_delete_biblio {
3517 my ( $dbh, $biblionumber ) = @_;
3519 # get all the data for this biblio
3520 my $sth = $dbh->prepare("SELECT * FROM biblio WHERE biblionumber=?");
3521 $sth->execute($biblionumber);
3523 if ( my $data = $sth->fetchrow_hashref ) {
3525 # save the record in deletedbiblio
3526 # find the fields to save
3527 my $query = "INSERT INTO deletedbiblio SET ";
3529 foreach my $temp ( keys %$data ) {
3530 $query .= "$temp = ?,";
3531 push( @bind, $data->{$temp} );
3534 # replace the last , by ",?)"
3536 my $bkup_sth = $dbh->prepare($query);
3537 $bkup_sth->execute(@bind);
3541 my $del_sth = $dbh->prepare("DELETE FROM biblio WHERE biblionumber=?");
3542 $del_sth->execute($biblionumber);
3549 =head2 _koha_delete_biblioitems
3553 $error = _koha_delete_biblioitems($dbh,$biblioitemnumber);
3555 Internal sub for deleting from biblioitems table -- also saves to deletedbiblioitems
3557 C<$dbh> - the database handle
3558 C<$biblionumber> - the biblioitemnumber of the biblioitem to be deleted
3564 # FIXME: add error handling
3566 sub _koha_delete_biblioitems {
3567 my ( $dbh, $biblioitemnumber ) = @_;
3569 # get all the data for this biblioitem
3571 $dbh->prepare("SELECT * FROM biblioitems WHERE biblioitemnumber=?");
3572 $sth->execute($biblioitemnumber);
3574 if ( my $data = $sth->fetchrow_hashref ) {
3576 # save the record in deletedbiblioitems
3577 # find the fields to save
3578 my $query = "INSERT INTO deletedbiblioitems SET ";
3580 foreach my $temp ( keys %$data ) {
3581 $query .= "$temp = ?,";
3582 push( @bind, $data->{$temp} );
3585 # replace the last , by ",?)"
3587 my $bkup_sth = $dbh->prepare($query);
3588 $bkup_sth->execute(@bind);
3591 # delete the biblioitem
3593 $dbh->prepare("DELETE FROM biblioitems WHERE biblioitemnumber=?");
3594 $del_sth->execute($biblioitemnumber);
3601 =head2 _koha_delete_item
3605 _koha_delete_item( $dbh, $itemnum );
3607 Internal function to delete an item record from the koha tables
3613 sub _koha_delete_item {
3614 my ( $dbh, $itemnum ) = @_;
3616 my $sth = $dbh->prepare("select * from items where itemnumber=?");
3617 $sth->execute($itemnum);
3618 my $data = $sth->fetchrow_hashref;
3620 my $query = "Insert into deleteditems set ";
3622 foreach my $temp ( keys %$data ) {
3623 $query .= "$temp = ?,";
3624 push( @bind, $data->{$temp} );
3629 $sth = $dbh->prepare($query);
3630 $sth->execute(@bind);
3632 $sth = $dbh->prepare("Delete from items where itemnumber=?");
3633 $sth->execute($itemnum);
3637 =head1 UNEXPORTED FUNCTIONS
3643 $lc = calculatelc($classification);
3650 my ($classification) = @_;
3651 $classification =~ s/^\s+|\s+$//g;
3656 for ( $i = 0 ; $i < length($classification) ; $i++ ) {
3657 my $c = ( substr( $classification, $i, 1 ) );
3658 if ( $c ge '0' && $c le '9' ) {
3660 $lc2 = substr( $classification, $i );
3664 $lc1 .= substr( $classification, $i, 1 );
3669 my $other = length($lc1);
3676 for ( 1 .. ( 4 - $other ) ) {
3685 ##Find the decimal part of $lc2
3686 my $pos = index( $lc2, "." );
3687 if ( $pos < 0 ) { $pos = length($lc2); }
3688 if ( $pos >= 0 && $pos < 5 ) {
3689 ##Pad lc2 with zeros to create a 5digit decimal needed in marc record to sort as numeric
3691 for ( 1 .. ( 5 - $pos ) ) {
3695 $lc2 = $extras . $lc2;
3696 return ( $lc1 . $lc2 );
3699 =head2 itemcalculator
3703 $cutterextra = itemcalculator( $dbh, $biblioitem, $callnumber );
3709 sub itemcalculator {
3710 my ( $dbh, $biblioitem, $callnumber ) = @_;
3713 "select classification, subclass from biblioitems where biblioitemnumber=?"
3716 $sth->execute($biblioitem);
3717 my ( $classification, $subclass ) = $sth->fetchrow;
3718 my $all = $classification . " " . $subclass;
3719 my $total = length($all);
3720 my $cutterextra = substr( $callnumber, $total - 1 );
3722 return $cutterextra;
3725 =head2 ModBiblioMarc
3729 &ModBiblioMarc($newrec,$biblionumber,$frameworkcode);
3731 Add MARC data for a biblio to koha
3733 Function exported, but should NOT be used, unless you really know what you're doing
3741 # pass the MARC::Record to this function, and it will create the records in the marc field
3742 my ( $record, $biblionumber, $frameworkcode ) = @_;
3743 my $dbh = C4::Context->dbh;
3744 my @fields = $record->fields();
3745 if ( !$frameworkcode ) {
3746 $frameworkcode = "";
3749 $dbh->prepare("UPDATE biblio SET frameworkcode=? WHERE biblionumber=?");
3750 $sth->execute( $frameworkcode, $biblionumber );
3752 my $encoding = C4::Context->preference("marcflavour");
3754 # deal with UNIMARC field 100 (encoding) : create it if needed & set encoding to unicode
3755 if ( $encoding eq "UNIMARC" ) {
3757 if ( length($record->subfield( 100, "a" )) == 35 ) {
3758 $string = $record->subfield( 100, "a" );
3759 my $f100 = $record->field(100);
3760 $record->delete_field($f100);
3763 $string = POSIX::strftime( "%Y%m%d", localtime );
3765 $string = sprintf( "%-*s", 35, $string );
3767 substr( $string, 22, 6, "frey50" );
3768 unless ( $record->subfield( 100, "a" ) ) {
3769 $record->insert_grouped_field(
3770 MARC::Field->new( 100, "", "", "a" => $string ) );
3773 # warn "biblionumber : ".$biblionumber;
3774 ModZebra($biblionumber,"specialUpdate","biblioserver",$record);
3777 "update biblioitems set marc=?,marcxml=? where biblionumber=?");
3778 $sth->execute( $record->as_usmarc(), $record->as_xml_record(),
3780 # warn $record->as_xml_record();
3782 return $biblionumber;
3785 =head2 AddItemInMarc
3789 $newbiblionumber = AddItemInMarc( $record, $biblionumber, $frameworkcode );
3791 Add an item in a MARC record and save the MARC record
3793 Function exported, but should NOT be used, unless you really know what you're doing
3801 # pass the MARC::Record to this function, and it will create the records in the marc tables
3802 my ( $record, $biblionumber, $frameworkcode ) = @_;
3803 my $newrec = &GetMarcBiblio($biblionumber);
3806 my @fields = $record->fields();
3807 foreach my $field (@fields) {
3808 $newrec->append_fields($field);
3811 # FIXME: should we be making sure the biblionumbers are the same?
3812 my $newbiblionumber =
3813 &ModBiblioMarc( $newrec, $biblionumber, $frameworkcode );
3814 return $newbiblionumber;
3817 =head2 z3950_extended_services
3819 z3950_extended_services($serviceType,$serviceOptions,$record);
3821 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.
3823 C<$serviceType> one of: itemorder,create,drop,commit,update,xmlupdate
3825 C<$serviceOptions> a has of key/value pairs. For instance, if service_type is 'update', $service_options should contain:
3827 action => update action, one of specialUpdate, recordInsert, recordReplace, recordDelete, elementUpdate.
3831 recordidOpaque => Opaque Record ID (user supplied) or recordidNumber => Record ID number (system number).
3832 syntax => the record syntax (transfer syntax)
3833 databaseName = Database from connection object
3835 To set serviceOptions, call set_service_options($serviceType)
3837 C<$record> the record, if one is needed for the service type
3839 A record should be in XML. You can convert it to XML from MARC by running it through marc2xml().
3843 sub z3950_extended_services {
3844 my ( $server, $serviceType, $action, $serviceOptions ) = @_;
3846 # get our connection object
3847 my $Zconn = C4::Context->Zconn( $server, 0, 1 );
3849 # create a new package object
3850 my $Zpackage = $Zconn->package();
3853 $Zpackage->option( action => $action );
3855 if ( $serviceOptions->{'databaseName'} ) {
3856 $Zpackage->option( databaseName => $serviceOptions->{'databaseName'} );
3858 if ( $serviceOptions->{'recordIdNumber'} ) {
3860 recordIdNumber => $serviceOptions->{'recordIdNumber'} );
3862 if ( $serviceOptions->{'recordIdOpaque'} ) {
3864 recordIdOpaque => $serviceOptions->{'recordIdOpaque'} );
3867 # this is an ILL request (Zebra doesn't support it, but Koha could eventually)
3868 #if ($serviceType eq 'itemorder') {
3869 # $Zpackage->option('contact-name' => $serviceOptions->{'contact-name'});
3870 # $Zpackage->option('contact-phone' => $serviceOptions->{'contact-phone'});
3871 # $Zpackage->option('contact-email' => $serviceOptions->{'contact-email'});
3872 # $Zpackage->option('itemorder-item' => $serviceOptions->{'itemorder-item'});
3875 if ( $serviceOptions->{record} ) {
3876 $Zpackage->option( record => $serviceOptions->{record} );
3878 # can be xml or marc
3879 if ( $serviceOptions->{'syntax'} ) {
3880 $Zpackage->option( syntax => $serviceOptions->{'syntax'} );
3884 # send the request, handle any exception encountered
3885 eval { $Zpackage->send($serviceType) };
3886 if ( $@ && $@->isa("ZOOM::Exception") ) {
3887 return "error: " . $@->code() . " " . $@->message() . "\n";
3890 # free up package resources
3891 $Zpackage->destroy();
3894 =head2 set_service_options
3896 my $serviceOptions = set_service_options($serviceType);
3898 C<$serviceType> itemorder,create,drop,commit,update,xmlupdate
3900 Currently, we only support 'create', 'commit', and 'update'. 'drop' support will be added as soon as Zebra supports it.
3904 sub set_service_options {
3905 my ($serviceType) = @_;
3908 # FIXME: This needs to be an OID ... if we ever need 'syntax' this sub will need to change
3909 # $serviceOptions->{ 'syntax' } = ''; #zebra doesn't support syntaxes other than xml
3911 if ( $serviceType eq 'commit' ) {
3915 if ( $serviceType eq 'create' ) {
3919 if ( $serviceType eq 'drop' ) {
3920 die "ERROR: 'drop' not currently supported (by Zebra)";
3922 return $serviceOptions;
3925 =head2 GetItemsCount
3927 $count = &GetItemsCount( $biblionumber);
3928 this function return count of item with $biblionumber
3932 my ( $biblionumber ) = @_;
3933 my $dbh = C4::Context->dbh;
3934 my $query = qq|SELECT count(*)
3936 WHERE biblionumber=?|;
3937 my $sth = $dbh->prepare($query);
3938 $sth->execute($biblionumber);
3939 my $count = $sth->fetchrow;
3947 END { } # module clean-up code here (global destructor)
3955 Koha Developement team <info@koha.org>
3957 Paul POULAIN paul.poulain@free.fr
3959 Joshua Ferraro jmf@liblime.com
3965 # Revision 1.218 2007/07/19 07:40:08 hdl
3966 # Adding selection by location for inventory
3968 # Revision 1.217 2007/07/03 13:47:44 tipaul
3969 # fixing some display bugs (itemtype not properly returned and a html table bug that makes items appear strangely
3971 # Revision 1.216 2007/07/03 09:40:58 tipaul
3972 # return itemtype description properly
3974 # Revision 1.215 2007/07/03 09:33:05 tipaul
3975 # 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
3977 # Revision 1.214 2007/07/02 09:13:22 tipaul
3978 # 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
3980 # Revision 1.213 2007/06/25 15:01:45 tipaul
3981 # bugfixes on unimarc 100 handling (the field used for encoding)
3983 # Revision 1.212 2007/06/15 13:44:44 tipaul
3984 # some fixes (and only fixes)
3986 # Revision 1.211 2007/06/15 09:40:06 toins
3987 # do not get $3 $4 and $5 on GetMarcSubjects GetMarcAuthors on unimarc flavour.
3989 # Revision 1.210 2007/06/13 13:03:34 toins
3990 # removing warn compilation.
3992 # Revision 1.209 2007/05/23 16:19:40 tipaul
3993 # various bugfixes (minor) and french translation updated
3995 # Revision 1.208 2007/05/22 09:13:54 tipaul
3996 # Bugfixes & improvements (various and minor) :
3997 # - updating templates to have tmpl_process3.pl running without any errors
3998 # - adding a drupal-like css for prog templates (with 3 small images)
3999 # - fixing some bugs in circulation & other scripts
4000 # - updating french translation
4001 # - fixing some typos in templates
4003 # Revision 1.207 2007/05/22 08:51:19 hdl
4004 # Changing GetMarcStructure signature.
4005 # Deleting first parameter $dbh
4007 # Revision 1.206 2007/05/21 08:44:17 btoumi
4008 # add security when u delete biblio :
4009 # u must delete linked items before delete biblio
4011 # Revision 1.205 2007/05/11 16:04:03 btoumi
4013 # problem in displayed label link with subject in detail.tmpl
4014 # ex: label random => rdom
4016 # Revision 1.204 2007/05/10 14:45:15 tipaul
4018 # - support for authorities
4019 # - some bugfixes in ordering and "CCL" parsing
4020 # - support for authorities <=> biblios walking
4022 # Seems I can do what I want now, so I consider its done, except for bugfixes that will be needed i m sure !
4024 # Revision 1.203 2007/05/03 15:16:02 tipaul
4025 # BUGFIX for : NoZebra
4026 # - NoZebra features : seems they work fine now (adding, modifying, deleting)
4027 # - Biblio edition major bugfix : before this commit editing a biblio resulted in an item removal in marcxml field
4029 # Revision 1.202 2007/05/02 16:44:31 tipaul
4030 # NoZebra SQL index management :
4031 # * adding 3 subs in Biblio.pm
4032 # - GetNoZebraIndexes, that get the index structure in a new systempreference (added with this commit)
4033 # - _DelBiblioNoZebra, that retrieve all index entries for a biblio and remove in a variable the biblio reference
4034 # - _AddBiblioNoZebra, that add index entries for a biblio.
4035 # 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).
4036 # I think the code has to be more deeply tested, but it works at least partially.
4038 # Revision 1.201 2007/04/27 14:00:49 hdl
4039 # Removing $dbh from GetMarcFromKohaField (dbh is not used in this function.)
4041 # Revision 1.200 2007/04/25 16:26:42 tipaul
4042 # 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 :
4043 # - add nozebra table management on biblio editing
4044 # - the index table content is hardcoded. I still have to add some specific systempref to let the library update it
4045 # - manage pagination (next/previous)
4048 # - NZgetRecords : has exactly the same API & returns as zebra getQuery, except that some parameters are unused
4049 # - search & sort works quite good
4050 # - CQL parser is better that what I thought I could do : title="harry and sally" and publicationyear>2000 not itemtype=LIVR should work fine
4052 # Revision 1.199 2007/04/24 09:07:53 tipaul
4053 # moving dotransfer to Biblio.pm::ModItemTransfer + some CheckReserves fixes
4055 # Revision 1.198 2007/04/23 15:21:17 tipaul
4056 # renaming currenttransfers to transferstoreceive
4058 # Revision 1.197 2007/04/18 17:00:14 tipaul
4059 # removing all useless %env / $env
4061 # Revision 1.196 2007/04/17 08:48:00 tipaul
4062 # circulation cleaning continued: bufixing
4064 # Revision 1.195 2007/04/04 16:46:22 tipaul
4065 # HUGE COMMIT : code cleaning circulation.
4067 # some stuff to do, i'll write a mail on koha-devel NOW !
4069 # Revision 1.194 2007/03/30 12:00:42 tipaul
4070 # 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...
4072 # Revision 1.193 2007/03/29 16:45:53 tipaul
4073 # Code cleaning of Biblio.pm (continued)
4075 # All subs have be cleaned :
4078 # - reordering Biblio.pm completly
4079 # - using only naming conventions
4081 # Seems to have broken nothing, but it still has to be heavily tested.
4082 # Note that Biblio.pm is now much more efficient than previously & probably more reliable as well.
4084 # Revision 1.192 2007/03/29 13:30:31 tipaul
4086 # == Biblio.pm cleaning (useless) ==
4087 # * some sub declaration dropped
4088 # * removed modbiblio sub
4089 # * removed moditem sub
4090 # * removed newitems. It was used only in finishrecieve. Replaced by a TransformKohaToMarc+AddItem, that is better.
4091 # * removed MARCkoha2marcItem
4092 # * removed MARCdelsubfield declaration
4093 # * removed MARCkoha2marcBiblio
4095 # == Biblio.pm cleaning (naming conventions) ==
4096 # * MARCgettagslib renamed to GetMarcStructure
4097 # * MARCgetitems renamed to GetMarcItem
4098 # * MARCfind_frameworkcode renamed to GetFrameworkCode
4099 # * MARCmarc2koha renamed to TransformMarcToKoha
4100 # * MARChtml2marc renamed to TransformHtmlToMarc
4101 # * MARChtml2xml renamed to TranformeHtmlToXml
4102 # * zebraop renamed to ModZebra
4105 # * removing MARC=OFF related scripts (in cataloguing directory)
4106 # * removed checkitems (function related to MARC=off feature, that is completly broken in head. If someone want to reintroduce it, hard work coming...)
4107 # * removed getitemsbybiblioitem (used only by MARC=OFF scripts, that is removed as well)
4109 # Revision 1.191 2007/03/29 09:42:13 tipaul
4110 # adding default value new feature into cataloguing. The system (definition) part has already been added by toins
4112 # Revision 1.190 2007/03/29 08:45:19 hdl
4113 # Deleting ignore_errors(1) pour MARC::Charset
4115 # Revision 1.189 2007/03/28 10:39:16 hdl
4116 # removing $dbh as a parameter in AuthoritiesMarc functions
4117 # And reporting all differences into the scripts taht relies on those functions.