3 # Copyright 2000-2002 Katipo Communications
5 # This file is part of Koha.
7 # Koha is free software; you can redistribute it and/or modify it under the
8 # terms of the GNU General Public License as published by the Free Software
9 # Foundation; either version 2 of the License, or (at your option) any later
12 # Koha is distributed in the hope that it will be useful, but WITHOUT ANY
13 # WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
14 # A PARTICULAR PURPOSE. See the GNU General Public License for more details.
16 # You should have received a copy of the GNU General Public License along with
17 # Koha; if not, write to the Free Software Foundation, Inc., 59 Temple Place,
18 # Suite 330, Boston, MA 02111-1307 USA
26 use MARC::File::USMARC;
31 use C4::Log; # logaction
33 use vars qw($VERSION @ISA @EXPORT);
35 # set the version for version checking
36 $VERSION = do { my @v = '$Revision$' =~ /\d+/g; shift(@v).".".join( "_", map { sprintf "%03d", $_ } @v ); };
38 @ISA = qw( Exporter );
42 # to add biblios or items
43 push @EXPORT, qw( &AddBiblio &AddItem );
51 &GetBiblioItemByBiblioNumber
52 &GetBiblioFromItemNumber
71 &GetItemnumberFromBarcode
75 &GetAuthorisedValueDesc
79 &GetPublisherNameFromIsbn
91 &ModItemInMarconefield
102 # those functions are exported but should not be used
103 # they are usefull is few circumstances, so are exported.
104 # but don't use them unless you're a core developer ;-)
115 &TransformHtmlToMarc2
118 &PrepareItemrecordDisplay
125 C4::Biblio - cataloging management functions
129 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:
133 =item 1. in the biblio,biblioitems,items, etc tables, which are limited to a one-to-one mapping to underlying MARC data
135 =item 2. as raw MARC in the Zebra index and storage engine
137 =item 3. as raw MARC the biblioitems.marc and biblioitems.marcxml
141 In the 3.0 version of Koha, the authoritative record-level information is in biblioitems.marcxml
143 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.
147 =item 1. Compared with MySQL, Zebra is slow to update an index for small data changes -- especially for proc-intensive operations like circulation
149 =item 2. Zebra's index has been known to crash and a backup of the data is necessary to rebuild it in such cases
153 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:
157 =item 1. Add*/Mod*/Del*/ - high-level external functions suitable for being called from external scripts to manage the collection
159 =item 2. _koha_* - low-level internal functions for managing the koha tables
161 =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.
163 =item 4. Zebra functions used to update the Zebra index
165 =item 5. internal helper functions such as char_decode, checkitems, etc. Some of these probably belong in Koha.pm
169 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 :
173 =item 1. save datas in biblio and biblioitems table, that gives us a biblionumber and a biblioitemnumber
175 =item 2. add the biblionumber and biblioitemnumber into the MARC records
177 =item 3. save the marc record
181 When dealing with items, we must :
185 =item 1. save the item in items table, that gives us an itemnumber
187 =item 2. add the itemnumber to the item MARC field
189 =item 3. overwrite the MARC record (with the added item) into biblioitems.marc(xml)
191 When modifying a biblio or an item, the behaviour is quite similar.
195 =head1 EXPORTED FUNCTIONS
201 ($biblionumber,$biblioitemnumber) = AddBiblio($record,$frameworkcode);
202 Exported function (core API) for adding a new biblio to koha.
209 my ( $record, $frameworkcode ) = @_;
211 my $biblioitemnumber;
212 my $dbh = C4::Context->dbh;
213 # transform the data into koha-table style data
214 my $olddata = TransformMarcToKoha( $dbh, $record, $frameworkcode );
215 $biblionumber = _koha_add_biblio( $dbh, $olddata, $frameworkcode );
216 $olddata->{'biblionumber'} = $biblionumber;
217 $biblioitemnumber = _koha_add_biblioitem( $dbh, $olddata );
219 # we must add bibnum and bibitemnum in MARC::Record...
220 # we build the new field with biblionumber and biblioitemnumber
221 # we drop the original field
222 # we add the new builded field.
223 ( my $biblio_tag, my $biblio_subfield ) = GetMarcFromKohaField("biblio.biblionumber",$frameworkcode);
224 ( my $biblioitem_tag, my $biblioitem_subfield ) = GetMarcFromKohaField("biblioitems.biblioitemnumber",$frameworkcode);
228 # biblionumber & biblioitemnumber are in different fields
229 if ( $biblio_tag != $biblioitem_tag ) {
231 # deal with biblionumber
232 if ( $biblio_tag < 10 ) {
233 $newfield = MARC::Field->new( $biblio_tag, $biblionumber );
237 MARC::Field->new( $biblio_tag, '', '',
238 "$biblio_subfield" => $biblionumber );
241 # drop old field and create new one...
242 my $old_field = $record->field($biblio_tag);
243 $record->delete_field($old_field);
244 $record->append_fields($newfield);
246 # deal with biblioitemnumber
247 if ( $biblioitem_tag < 10 ) {
248 $newfield = MARC::Field->new( $biblioitem_tag, $biblioitemnumber, );
252 MARC::Field->new( $biblioitem_tag, '', '',
253 "$biblioitem_subfield" => $biblioitemnumber, );
255 # drop old field and create new one...
256 $old_field = $record->field($biblioitem_tag);
257 $record->delete_field($old_field);
258 $record->insert_fields_ordered($newfield);
260 # biblionumber & biblioitemnumber are in the same field (can't be <10 as fields <10 have only 1 value)
263 my $newfield = MARC::Field->new(
265 "$biblio_subfield" => $biblionumber,
266 "$biblioitem_subfield" => $biblioitemnumber
269 # drop old field and create new one...
270 my $old_field = $record->field($biblio_tag);
271 $record->delete_field($old_field);
272 $record->insert_fields_ordered($newfield);
276 $biblionumber = ModBiblioMarc( $record, $biblionumber, $frameworkcode );
278 &logaction(C4::Context->userenv->{'number'},"CATALOGUING","ADD",$biblionumber,"biblio")
279 if C4::Context->preference("CataloguingLog");
281 return ( $biblionumber, $biblioitemnumber );
288 $biblionumber = AddItem( $record, $biblionumber)
289 Exported function (core API) for adding a new item to Koha
296 my ( $record, $biblionumber ) = @_;
297 my $dbh = C4::Context->dbh;
300 my $frameworkcode = GetFrameworkCode( $biblionumber );
301 my $item = &TransformMarcToKoha( $dbh, $record, $frameworkcode );
303 # needs old biblionumber and biblioitemnumber
304 $item->{'biblionumber'} = $biblionumber;
307 "select biblioitemnumber,itemtype from biblioitems where biblionumber=?"
309 $sth->execute( $item->{'biblionumber'} );
311 ( $item->{'biblioitemnumber'}, $itemtype ) = $sth->fetchrow;
314 "select notforloan from itemtypes where itemtype='$itemtype'");
316 my $notforloan = $sth->fetchrow;
317 ##Change the notforloan field if $notforloan found
318 if ( $notforloan > 0 ) {
319 $item->{'notforloan'} = $notforloan;
320 &MARCitemchange( $record, "items.notforloan", $notforloan );
322 if ( !$item->{'dateaccessioned'} || $item->{'dateaccessioned'} eq '' ) {
325 my ( $sec, $min, $hour, $mday, $mon, $year, $wday, $yday, $isdst ) =
330 "$year-" . sprintf( "%0.2d", $mon ) . "-" . sprintf( "%0.2d", $mday );
331 $item->{'dateaccessioned'} = $date;
332 &MARCitemchange( $record, "items.dateaccessioned", $date );
334 my ( $itemnumber, $error ) =
335 &_koha_new_items( $dbh, $item, $item->{barcode} );
337 # add itemnumber to MARC::Record before adding the item.
338 $sth = $dbh->prepare(
339 "select tagfield,tagsubfield from marc_subfield_structure where frameworkcode=? and kohafield=?"
341 &TransformKohaToMarcOneField( $sth, $record, "items.itemnumber", $itemnumber,
345 &AddItemInMarc( $record, $item->{'biblionumber'},$frameworkcode );
347 &logaction(C4::Context->userenv->{'number'},"CATALOGUING","ADD",$itemnumber,"item")
348 if C4::Context->preference("CataloguingLog");
350 return ($item->{biblionumber}, $item->{biblioitemnumber},$itemnumber);
355 ModBiblio( $record,$biblionumber,$frameworkcode);
356 Exported function (core API) to modify a biblio
361 my ( $record, $biblionumber, $frameworkcode ) = @_;
362 if (C4::Context->preference("CataloguingLog")) {
363 my $newrecord = GetMarcBiblio($biblionumber);
364 &logaction(C4::Context->userenv->{'number'},"CATALOGUING","MODIFY",$biblionumber,"BEFORE=>".$newrecord->as_formatted);
367 my $dbh = C4::Context->dbh;
369 $frameworkcode = "" unless $frameworkcode;
371 # get the items before and append them to the biblio before updating the record, atm we just have the biblio
372 my ( $itemtag, $itemsubfield ) = GetMarcFromKohaField("items.itemnumber",$frameworkcode);
373 my $oldRecord = GetMarcBiblio( $biblionumber );
375 # parse each item, and, for an unknown reason, re-encode each subfield
376 # if you don't do that, the record will have encoding mixed
377 # and the biblio will be re-encoded.
378 # strange, I (Paul P.) searched more than 1 day to understand what happends
379 # but could only solve the problem this way...
380 my @fields = $oldRecord->field( $itemtag );
381 foreach my $fielditem ( @fields ){
383 foreach ($fielditem->subfields()) {
385 $field->add_subfields(Encode::encode('utf-8',$_->[0]) => Encode::encode('utf-8',$_->[1]));
387 $field = MARC::Field->new("$itemtag",'','',Encode::encode('utf-8',$_->[0]) => Encode::encode('utf-8',$_->[1]));
390 $record->append_fields($field);
393 # adding biblionumber
394 my ($tag_biblionumber, $subfield_biblionumber) = GetMarcFromKohaField('biblio.biblionumber',$frameworkcode);
395 $record->append_fields(
397 $tag_biblionumber,'','',$subfield_biblionumber => $biblionumber
399 ) unless ($record->subfield($tag_biblionumber,$subfield_biblionumber));
401 # update the MARC record (that now contains biblio and items) with the new record data
402 &ModBiblioMarc( $record, $biblionumber, $frameworkcode );
404 # load the koha-table data object
405 my $oldbiblio = TransformMarcToKoha( $dbh, $record, $frameworkcode );
407 # modify the other koha tables
408 _koha_modify_biblio( $dbh, $oldbiblio );
409 _koha_modify_biblioitem( $dbh, $oldbiblio );
417 Exported function (core API) for modifying an item in Koha.
424 my ( $record, $biblionumber, $itemnumber, $delete, $new_item_hashref )
428 &logaction(C4::Context->userenv->{'number'},"CATALOGUING","MODIFY",$itemnumber,$record->as_formatted)
429 if C4::Context->preference("CataloguingLog");
431 my $dbh = C4::Context->dbh;
433 # if we have a MARC record, we're coming from cataloging and so
434 # we do the whole routine: update the MARC and zebra, then update the koha
437 my $frameworkcode = GetFrameworkCode( $biblionumber );
438 ModItemInMarc( $record, $biblionumber, $itemnumber, $frameworkcode );
439 my $olditem = TransformMarcToKoha( $dbh, $record, $frameworkcode );
440 _koha_modify_item( $dbh, $olditem );
441 return $biblionumber;
444 # otherwise, we're just looking to modify something quickly
445 # (like a status) so we just update the koha tables
446 elsif ($new_item_hashref) {
447 _koha_modify_item( $dbh, $new_item_hashref );
451 sub ModItemTransfer {
452 my ( $itemnumber, $frombranch, $tobranch ) = @_;
454 my $dbh = C4::Context->dbh;
456 #new entry in branchtransfers....
457 my $sth = $dbh->prepare(
458 "INSERT INTO branchtransfers (itemnumber, frombranch, datesent, tobranch)
459 VALUES (?, ?, now(), ?)");
460 $sth->execute($itemnumber, $frombranch, $tobranch);
461 #update holdingbranch in items .....
463 "UPDATE items set holdingbranch = ? WHERE items.itemnumber = ?");
464 $sth->execute($tobranch,$itemnumber);
465 &ModDateLastSeen($itemnumber);
466 $sth = $dbh->prepare(
467 "SELECT biblionumber FROM items WHERE itemnumber=?"
469 $sth->execute($itemnumber);
470 while ( my ( $biblionumber ) = $sth->fetchrow ) {
471 &ModItemInMarconefield( $biblionumber, $itemnumber,
472 'items.holdingbranch', $tobranch );
477 =head2 ModBiblioframework
479 ModBiblioframework($biblionumber,$frameworkcode);
480 Exported function to modify a biblio framework
484 sub ModBiblioframework {
485 my ( $biblionumber, $frameworkcode ) = @_;
486 my $dbh = C4::Context->dbh;
487 my $sth = $dbh->prepare(
488 "UPDATE biblio SET frameworkcode=? WHERE biblionumber=$biblionumber"
490 $sth->execute($frameworkcode);
494 =head2 ModItemInMarconefield
498 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)
499 &ModItemInMarconefield( $biblionumber, $itemnumber, $itemfield, $newvalue )
505 sub ModItemInMarconefield {
506 my ( $biblionumber, $itemnumber, $itemfield, $newvalue ) = @_;
507 my $dbh = C4::Context->dbh;
508 if ( !defined $newvalue ) {
512 my $record = GetMarcItem( $biblionumber, $itemnumber );
513 my ($tagfield, $tagsubfield) = GetMarcFromKohaField( $itemfield,'');
514 if ($tagfield && $tagsubfield) {
515 my $tag = $record->field($tagfield);
517 # my $tagsubs = $record->field($tagfield)->subfield($tagsubfield);
518 $tag->update( $tagsubfield => $newvalue );
519 $record->delete_field($tag);
520 $record->insert_fields_ordered($tag);
521 &ModItemInMarc( $record, $biblionumber, $itemnumber, 0 );
530 &ModItemInMarc( $record, $biblionumber, $itemnumber )
537 my ( $ItemRecord, $biblionumber, $itemnumber, $frameworkcode) = @_;
538 my $dbh = C4::Context->dbh;
540 # get complete MARC record & replace the item field by the new one
541 my $completeRecord = GetMarcBiblio($biblionumber);
542 my ($itemtag,$itemsubfield) = GetMarcFromKohaField("items.itemnumber",$frameworkcode);
543 my $itemField = $ItemRecord->field($itemtag);
544 my @items = $completeRecord->field($itemtag);
546 if ($_->subfield($itemsubfield) eq $itemnumber) {
547 # $completeRecord->delete_field($_);
548 $_->replace_with($itemField);
552 my $sth = $dbh->prepare("update biblioitems set marc=?,marcxml=? where biblionumber=?");
553 $sth->execute( $completeRecord->as_usmarc(), $completeRecord->as_xml_record(),$biblionumber );
555 ModZebra($biblionumber,"specialUpdate","biblioserver",$completeRecord);
558 =head2 ModDateLastSeen
560 &ModDateLastSeen($itemnum)
561 Mark item as seen. Is called when an item is issued, returned or manually marked during inventory/stocktaking
562 C<$itemnum> is the item number
566 sub ModDateLastSeen {
568 my $dbh = C4::Context->dbh;
571 "update items set itemlost=0, datelastseen = now() where items.itemnumber = ?"
573 $sth->execute($itemnum);
580 my $error = &DelBiblio($dbh,$biblionumber);
581 Exported function (core API) for deleting a biblio in koha.
582 Deletes biblio record from Zebra and Koha tables (biblio,biblioitems,items)
583 Also backs it up to deleted* tables
584 Checks to make sure there are not issues on any of the items
586 C<$error> : undef unless an error occurs
593 my ( $biblionumber ) = @_;
594 my $dbh = C4::Context->dbh;
595 my $error; # for error handling
597 # First make sure there are no items with issues are still attached
600 "SELECT itemnumber FROM items WHERE biblionumber=?");
601 $sth->execute($biblionumber);
602 while ( my $itemnumber = $sth->fetchrow ) {
603 my $issues = GetItemIssues($itemnumber);
604 foreach my $issue (@$issues) {
605 if ( ( $issue->{date_due} )
606 && ( $issue->{date_due} ne "Available" ) )
609 #FIXME: we need a status system in Biblio like in Circ to return standard codes and messages
610 # instead of hard-coded strings
612 "Item is checked out to a patron -- you must return it before deleting the Biblio";
616 return $error if $error;
618 # Delete in Zebra. Be careful NOT to move this line after _koha_delete_biblio
619 # for at least 2 reasons :
620 # - we need to read the biblio if NoZebra is set (to remove it from the indexes
621 # - if something goes wrong, the biblio may be deleted from Koha but not from zebra
622 # 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)
623 ModZebra($biblionumber, "delete_record", "biblioserver", undef);
625 # delete biblio from Koha tables and save in deletedbiblio
626 $error = &_koha_delete_biblio( $dbh, $biblionumber );
628 # delete biblioitems and items from Koha tables and save in deletedbiblioitems,deleteditems
631 "SELECT biblioitemnumber FROM biblioitems WHERE biblionumber=?");
632 $sth->execute($biblionumber);
633 while ( my $biblioitemnumber = $sth->fetchrow ) {
635 # delete this biblioitem
636 $error = &_koha_delete_biblioitems( $dbh, $biblioitemnumber );
637 return $error if $error;
642 "SELECT itemnumber FROM items WHERE biblioitemnumber=?");
643 $items_sth->execute($biblioitemnumber);
644 while ( my $itemnumber = $items_sth->fetchrow ) {
645 $error = &_koha_delete_item( $dbh, $itemnumber );
646 return $error if $error;
649 &logaction(C4::Context->userenv->{'number'},"CATALOGUING","DELETE",$biblionumber,"")
650 if C4::Context->preference("CataloguingLog");
658 DelItem( $biblionumber, $itemnumber );
659 Exported function (core API) for deleting an item record in Koha.
666 my ( $biblionumber, $itemnumber ) = @_;
667 my $dbh = C4::Context->dbh;
668 &_koha_delete_item( $dbh, $itemnumber );
669 # get the MARC record
670 my $record = GetMarcBiblio($biblionumber);
671 my $frameworkcode = GetFrameworkCode($biblionumber);
675 $dbh->prepare("UPDATE deleteditems SET marc=? WHERE itemnumber=?");
676 $copy2deleted->execute( $record->as_usmarc(), $itemnumber );
678 #search item field code
679 my ( $itemtag, $itemsubfield ) = GetMarcFromKohaField("items.itemnumber",$frameworkcode);
680 my @fields = $record->field($itemtag);
681 # delete the item specified
682 foreach my $field (@fields) {
683 if ( $field->subfield($itemsubfield) eq $itemnumber ) {
684 $record->delete_field($field);
687 &ModBiblioMarc( $record, $biblionumber, $frameworkcode );
688 &logaction(C4::Context->userenv->{'number'},"CATALOGUING","DELETE",$itemnumber,"item")
689 if C4::Context->preference("CataloguingLog");
696 $data = &GetBiblioData($biblionumber);
697 Returns information about the book with the given biblionumber.
698 C<&GetBiblioData> returns a reference-to-hash. The keys are the fields in
699 the C<biblio> and C<biblioitems> tables in the
701 In addition, C<$data-E<gt>{subject}> is the list of the book's
702 subjects, separated by C<" , "> (space, comma, space).
703 If there are multiple biblioitems with the given biblionumber, only
704 the first one is considered.
712 my $dbh = C4::Context->dbh;
715 SELECT * , biblioitems.notes AS bnotes, biblio.notes
717 LEFT JOIN biblioitems ON biblio.biblionumber = biblioitems.biblionumber
718 LEFT JOIN itemtypes ON biblioitems.itemtype = itemtypes.itemtype
719 WHERE biblio.biblionumber = ?
720 AND biblioitems.biblionumber = biblio.biblionumber
722 my $sth = $dbh->prepare($query);
723 $sth->execute($bibnum);
725 $data = $sth->fetchrow_hashref;
729 } # sub GetBiblioData
736 @results = &GetItemsInfo($biblionumber, $type);
738 Returns information about books with the given biblionumber.
740 C<$type> may be either C<intra> or anything else. If it is not set to
741 C<intra>, then the search will exclude lost, very overdue, and
744 C<&GetItemsInfo> returns a list of references-to-hash. Each element
745 contains a number of keys. Most of them are table items from the
746 C<biblio>, C<biblioitems>, C<items>, and C<itemtypes> tables in the
747 Koha database. Other keys include:
751 =item C<$data-E<gt>{branchname}>
753 The name (not the code) of the branch to which the book belongs.
755 =item C<$data-E<gt>{datelastseen}>
757 This is simply C<items.datelastseen>, except that while the date is
758 stored in YYYY-MM-DD format in the database, here it is converted to
759 DD/MM/YYYY format. A NULL date is returned as C<//>.
761 =item C<$data-E<gt>{datedue}>
763 =item C<$data-E<gt>{class}>
765 This is the concatenation of C<biblioitems.classification>, the book's
766 Dewey code, and C<biblioitems.subclass>.
768 =item C<$data-E<gt>{ocount}>
770 I think this is the number of copies of the book available.
772 =item C<$data-E<gt>{order}>
774 If this is set, it is set to C<One Order>.
783 my ( $biblionumber, $type ) = @_;
784 my $dbh = C4::Context->dbh;
785 my $query = "SELECT *,items.notforloan as itemnotforloan
786 FROM items, biblio, biblioitems
787 LEFT JOIN itemtypes on biblioitems.itemtype = itemtypes.itemtype
788 WHERE items.biblionumber = ?
789 AND biblioitems.biblioitemnumber = items.biblioitemnumber
790 AND biblio.biblionumber = items.biblionumber
791 ORDER BY items.dateaccessioned desc
793 my $sth = $dbh->prepare($query);
794 $sth->execute($biblionumber);
797 my ( $date_due, $count_reserves );
799 while ( my $data = $sth->fetchrow_hashref ) {
801 my $isth = $dbh->prepare(
802 "SELECT issues.*,borrowers.cardnumber,borrowers.surname,borrowers.firstname
803 FROM issues, borrowers
805 AND returndate IS NULL
806 AND issues.borrowernumber=borrowers.borrowernumber"
808 $isth->execute( $data->{'itemnumber'} );
809 if ( my $idata = $isth->fetchrow_hashref ) {
810 $data->{borrowernumber} = $idata->{borrowernumber};
811 $data->{cardnumber} = $idata->{cardnumber};
812 $data->{surname} = $idata->{surname};
813 $data->{firstname} = $idata->{firstname};
814 $datedue = format_date( $idata->{'date_due'} );
816 if ( $datedue eq '' ) {
817 #$datedue="Available";
818 my ( $restype, $reserves ) =
819 C4::Reserves::CheckReserves( $data->{'itemnumber'} );
823 $count_reserves = $restype;
828 #get branch information.....
829 my $bsth = $dbh->prepare(
830 "SELECT * FROM branches WHERE branchcode = ?
833 $bsth->execute( $data->{'holdingbranch'} );
834 if ( my $bdata = $bsth->fetchrow_hashref ) {
835 $data->{'branchname'} = $bdata->{'branchname'};
837 my $date = format_date( $data->{'datelastseen'} );
838 $data->{'datelastseen'} = $date;
839 $data->{'datedue'} = $datedue;
840 $data->{'count_reserves'} = $count_reserves;
842 # get notforloan complete status if applicable
843 my $sthnflstatus = $dbh->prepare(
844 'SELECT authorised_value
845 FROM marc_subfield_structure
846 WHERE kohafield="items.notforloan"
850 $sthnflstatus->execute;
851 my ($authorised_valuecode) = $sthnflstatus->fetchrow;
852 if ($authorised_valuecode) {
853 $sthnflstatus = $dbh->prepare(
854 "SELECT lib FROM authorised_values
856 AND authorised_value=?"
858 $sthnflstatus->execute( $authorised_valuecode,
859 $data->{itemnotforloan} );
860 my ($lib) = $sthnflstatus->fetchrow;
861 $data->{notforloan} = $lib;
864 # my stack procedures
865 my $stackstatus = $dbh->prepare(
866 'SELECT authorised_value
867 FROM marc_subfield_structure
868 WHERE kohafield="items.stack"
871 $stackstatus->execute;
873 ($authorised_valuecode) = $stackstatus->fetchrow;
874 if ($authorised_valuecode) {
875 $stackstatus = $dbh->prepare(
877 FROM authorised_values
879 AND authorised_value=?
882 $stackstatus->execute( $authorised_valuecode, $data->{stack} );
883 my ($lib) = $stackstatus->fetchrow;
884 $data->{stack} = $lib;
886 $results[$i] = $data;
898 $itemstatushash = &getitemstatus($fwkcode);
899 returns information about status.
900 Can be MARC dependant.
902 But basically could be can be loan or not
903 Create a status selector with the following code
905 =head3 in PERL SCRIPT
907 my $itemstatushash = getitemstatus;
909 foreach my $thisstatus (keys %$itemstatushash) {
910 my %row =(value => $thisstatus,
911 statusname => $itemstatushash->{$thisstatus}->{'statusname'},
913 push @itemstatusloop, \%row;
915 $template->param(statusloop=>\@itemstatusloop);
920 <select name="statusloop">
921 <option value="">Default</option>
922 <!-- TMPL_LOOP name="statusloop" -->
923 <option value="<!-- TMPL_VAR name="value" -->" <!-- TMPL_IF name="selected" -->selected<!-- /TMPL_IF -->><!-- TMPL_VAR name="statusname" --></option>
931 # returns a reference to a hash of references to status...
934 my $dbh = C4::Context->dbh;
936 $fwk = '' unless ($fwk);
937 my ( $tag, $subfield ) =
938 GetMarcFromKohaField( "items.notforloan", $fwk );
939 if ( $tag and $subfield ) {
942 "select authorised_value from marc_subfield_structure where tagfield=? and tagsubfield=? and frameworkcode=?"
944 $sth->execute( $tag, $subfield, $fwk );
945 if ( my ($authorisedvaluecat) = $sth->fetchrow ) {
948 "select authorised_value, lib from authorised_values where category=? order by lib"
950 $authvalsth->execute($authorisedvaluecat);
951 while ( my ( $authorisedvalue, $lib ) = $authvalsth->fetchrow ) {
952 $itemstatus{$authorisedvalue} = $lib;
968 $itemstatus{"1"} = "Not For Loan";
972 =head2 getitemlocation
976 $itemlochash = &getitemlocation($fwk);
977 returns informations about location.
978 where fwk stands for an optional framework code.
979 Create a location selector with the following code
981 =head3 in PERL SCRIPT
983 my $itemlochash = getitemlocation;
985 foreach my $thisloc (keys %$itemlochash) {
986 my $selected = 1 if $thisbranch eq $branch;
987 my %row =(locval => $thisloc,
988 selected => $selected,
989 locname => $itemlochash->{$thisloc},
991 push @itemlocloop, \%row;
993 $template->param(itemlocationloop => \@itemlocloop);
997 <select name="location">
998 <option value="">Default</option>
999 <!-- TMPL_LOOP name="itemlocationloop" -->
1000 <option value="<!-- TMPL_VAR name="locval" -->" <!-- TMPL_IF name="selected" -->selected<!-- /TMPL_IF -->><!-- TMPL_VAR name="locname" --></option>
1008 sub GetItemLocation {
1010 # returns a reference to a hash of references to location...
1013 my $dbh = C4::Context->dbh;
1015 $fwk = '' unless ($fwk);
1016 my ( $tag, $subfield ) =
1017 GetMarcFromKohaField( "items.location", $fwk );
1018 if ( $tag and $subfield ) {
1021 "select authorised_value from marc_subfield_structure where tagfield=? and tagsubfield=? and frameworkcode=?"
1023 $sth->execute( $tag, $subfield, $fwk );
1024 if ( my ($authorisedvaluecat) = $sth->fetchrow ) {
1027 "select authorised_value, lib from authorised_values where category=? order by lib"
1029 $authvalsth->execute($authorisedvaluecat);
1030 while ( my ( $authorisedvalue, $lib ) = $authvalsth->fetchrow ) {
1031 $itemlocation{$authorisedvalue} = $lib;
1033 $authvalsth->finish;
1034 return \%itemlocation;
1047 $itemlocation{"1"} = "Not For Loan";
1048 return \%itemlocation;
1053 $items = GetLostItems($where,$orderby);
1055 This function get the items lost into C<$items>.
1060 C<$where> is a hashref. it containts a field of the items table as key
1061 and the value to match as value.
1062 C<$orderby> is a field of the items table.
1065 C<$items> is a reference to an array full of hasref which keys are items' table column.
1067 =item usage in the perl script:
1070 $where{barcode} = 0001548;
1071 my $items = GetLostItems( \%where, "homebranch" );
1072 $template->param(itemsloop => $items);
1079 # Getting input args.
1081 my $orderby = shift;
1082 my $dbh = C4::Context->dbh;
1087 WHERE itemlost IS NOT NULL
1090 foreach my $key (keys %$where) {
1091 $query .= " AND " . $key . " LIKE '%" . $where->{$key} . "%'";
1093 $query .= " ORDER BY ".$orderby if defined $orderby;
1095 my $sth = $dbh->prepare($query);
1098 while ( my $row = $sth->fetchrow_hashref ){
1104 =head2 GetItemsForInventory
1106 $itemlist = GetItemsForInventory($minlocation,$maxlocation,$datelastseen,$offset,$size)
1108 Retrieve a list of title/authors/barcode/callnumber, for biblio inventory.
1110 The sub returns a list of hashes, containing itemnumber, author, title, barcode & item callnumber.
1111 It is ordered by callnumber,title.
1113 The minlocation & maxlocation parameters are used to specify a range of item callnumbers
1114 the datelastseen can be used to specify that you want to see items not seen since a past date only.
1115 offset & size can be used to retrieve only a part of the whole listing (defaut behaviour)
1119 sub GetItemsForInventory {
1120 my ( $minlocation, $maxlocation,$location, $datelastseen, $branch, $offset, $size ) = @_;
1121 my $dbh = C4::Context->dbh;
1123 if ($datelastseen) {
1124 $datelastseen=format_date_in_iso($datelastseen);
1126 "SELECT itemnumber,barcode,itemcallnumber,title,author,biblio.biblionumber,datelastseen
1128 LEFT JOIN biblio ON items.biblionumber=biblio.biblionumber
1129 WHERE itemcallnumber>= ?
1130 AND itemcallnumber <=?
1131 AND (datelastseen< ? OR datelastseen IS NULL)";
1132 $query.= " AND items.location=".$dbh->quote($location) if $location;
1133 $query.= " AND items.homebranch=".$dbh->quote($branch) if $branch;
1134 $query .= " ORDER BY itemcallnumber,title";
1135 $sth = $dbh->prepare($query);
1136 $sth->execute( $minlocation, $maxlocation, $datelastseen );
1140 SELECT itemnumber,barcode,itemcallnumber,biblio.biblionumber,title,author,datelastseen
1142 LEFT JOIN biblio ON items.biblionumber=biblio.biblionumber
1143 WHERE itemcallnumber>= ?
1144 AND itemcallnumber <=?";
1145 $query.= " AND items.location=".$dbh->quote($location) if $location;
1146 $query.= " AND items.homebranch=".$dbh->quote($branch) if $branch;
1147 $query .= " ORDER BY itemcallnumber,title";
1148 $sth = $dbh->prepare($query);
1149 $sth->execute( $minlocation, $maxlocation );
1152 while ( my $row = $sth->fetchrow_hashref ) {
1153 $offset-- if ($offset);
1154 $row->{datelastseen}=format_date($row->{datelastseen});
1155 if ( ( !$offset ) && $size ) {
1156 push @results, $row;
1163 =head2 &GetBiblioItemData
1167 $itemdata = &GetBiblioItemData($biblioitemnumber);
1169 Looks up the biblioitem with the given biblioitemnumber. Returns a
1170 reference-to-hash. The keys are the fields from the C<biblio>,
1171 C<biblioitems>, and C<itemtypes> tables in the Koha database, except
1172 that C<biblioitems.notes> is given as C<$itemdata-E<gt>{bnotes}>.
1179 sub GetBiblioItemData {
1181 my $dbh = C4::Context->dbh;
1184 "Select *,biblioitems.notes as bnotes from biblioitems, biblio,itemtypes where biblio.biblionumber = biblioitems.biblionumber and biblioitemnumber = ? and biblioitems.itemtype = itemtypes.itemtype"
1188 $sth->execute($bibitem);
1190 $data = $sth->fetchrow_hashref;
1194 } # sub &GetBiblioItemData
1196 =head2 GetItemnumberFromBarcode
1200 $result = GetItemnumberFromBarcode($barcode);
1206 sub GetItemnumberFromBarcode {
1208 my $dbh = C4::Context->dbh;
1211 $dbh->prepare("SELECT itemnumber from items where items.barcode=?");
1212 $rq->execute($barcode);
1213 my ($result) = $rq->fetchrow;
1217 =head2 GetBiblioItemByBiblioNumber
1221 NOTE : This function has been copy/paste from C4/Biblio.pm from head before zebra integration.
1227 sub GetBiblioItemByBiblioNumber {
1228 my ($biblionumber) = @_;
1229 my $dbh = C4::Context->dbh;
1230 my $sth = $dbh->prepare("Select * from biblioitems where biblionumber = ?");
1234 $sth->execute($biblionumber);
1236 while ( my $data = $sth->fetchrow_hashref ) {
1237 push @results, $data;
1244 =head2 GetBiblioFromItemNumber
1248 $item = &GetBiblioFromItemNumber($itemnumber);
1250 Looks up the item with the given itemnumber.
1252 C<&itemnodata> returns a reference-to-hash whose keys are the fields
1253 from the C<biblio>, C<biblioitems>, and C<items> tables in the Koha
1261 sub GetBiblioFromItemNumber {
1262 my ( $itemnumber ) = @_;
1263 my $dbh = C4::Context->dbh;
1264 my $sth = $dbh->prepare(
1265 "SELECT * FROM biblio,items,biblioitems
1266 WHERE items.itemnumber = ?
1267 AND biblio.biblionumber = items.biblionumber
1268 AND biblioitems.biblioitemnumber = items.biblioitemnumber"
1271 $sth->execute($itemnumber);
1272 my $data = $sth->fetchrow_hashref;
1281 ( $count, @results ) = &GetBiblio($biblionumber);
1288 my ($biblionumber) = @_;
1289 my $dbh = C4::Context->dbh;
1290 my $sth = $dbh->prepare("Select * from biblio where biblionumber = ?");
1293 $sth->execute($biblionumber);
1294 while ( my $data = $sth->fetchrow_hashref ) {
1295 $results[$count] = $data;
1299 return ( $count, @results );
1306 $data = &GetItem($itemnumber,$barcode);
1308 return Item information, for a given itemnumber or barcode
1315 my ($itemnumber,$barcode) = @_;
1316 my $dbh = C4::Context->dbh;
1318 my $sth = $dbh->prepare("
1320 WHERE itemnumber = ?");
1321 $sth->execute($itemnumber);
1322 my $data = $sth->fetchrow_hashref;
1325 my $sth = $dbh->prepare("
1329 $sth->execute($barcode);
1330 my $data = $sth->fetchrow_hashref;
1335 =head2 get_itemnumbers_of
1339 my @itemnumbers_of = get_itemnumbers_of(@biblionumbers);
1341 Given a list of biblionumbers, return the list of corresponding itemnumbers
1342 for each biblionumber.
1344 Return a reference on a hash where keys are biblionumbers and values are
1345 references on array of itemnumbers.
1351 sub get_itemnumbers_of {
1352 my @biblionumbers = @_;
1354 my $dbh = C4::Context->dbh;
1360 WHERE biblionumber IN (?' . ( ',?' x scalar @biblionumbers - 1 ) . ')
1362 my $sth = $dbh->prepare($query);
1363 $sth->execute(@biblionumbers);
1367 while ( my ( $itemnumber, $biblionumber ) = $sth->fetchrow_array ) {
1368 push @{ $itemnumbers_of{$biblionumber} }, $itemnumber;
1371 return \%itemnumbers_of;
1374 =head2 GetItemInfosOf
1378 GetItemInfosOf(@itemnumbers);
1384 sub GetItemInfosOf {
1385 my @itemnumbers = @_;
1390 WHERE itemnumber IN (' . join( ',', @itemnumbers ) . ')
1392 return get_infos_of( $query, 'itemnumber' );
1395 =head2 GetBiblioItemInfosOf
1399 GetBiblioItemInfosOf(@biblioitemnumbers);
1405 sub GetBiblioItemInfosOf {
1406 my @biblioitemnumbers = @_;
1409 SELECT biblioitemnumber,
1413 WHERE biblioitemnumber IN (' . join( ',', @biblioitemnumbers ) . ')
1415 return get_infos_of( $query, 'biblioitemnumber' );
1418 =head1 FUNCTIONS FOR HANDLING MARC MANAGEMENT
1420 =head2 GetMarcStructure
1424 $res = GetMarcStructure($forlibrarian,$frameworkcode);
1426 Returns a reference to a big hash of hash, with the Marc structure for the given frameworkcode
1427 $forlibrarian :if set to 1, the MARC descriptions are the librarians ones, otherwise it's the public (OPAC) ones
1428 $frameworkcode : the framework code to read
1434 sub GetMarcStructure {
1435 my ( $forlibrarian, $frameworkcode ) = @_;
1436 my $dbh=C4::Context->dbh;
1437 $frameworkcode = "" unless $frameworkcode;
1439 my $libfield = ( $forlibrarian eq 1 ) ? 'liblibrarian' : 'libopac';
1441 # check that framework exists
1444 "select count(*) from marc_tag_structure where frameworkcode=?");
1445 $sth->execute($frameworkcode);
1446 my ($total) = $sth->fetchrow;
1447 $frameworkcode = "" unless ( $total > 0 );
1450 "select tagfield,liblibrarian,libopac,mandatory,repeatable from marc_tag_structure where frameworkcode=? order by tagfield"
1452 $sth->execute($frameworkcode);
1453 my ( $liblibrarian, $libopac, $tag, $res, $tab, $mandatory, $repeatable );
1455 while ( ( $tag, $liblibrarian, $libopac, $mandatory, $repeatable ) =
1458 $res->{$tag}->{lib} =
1459 ( $forlibrarian or !$libopac ) ? $liblibrarian : $libopac;
1460 # why the hell do we need to explicitly decode utf8 ?
1461 # that's a good question, but we must do it...
1462 $res->{$tab}->{tab} = ""; # XXX
1463 $res->{$tag}->{mandatory} = $mandatory;
1464 $res->{$tag}->{repeatable} = $repeatable;
1469 "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"
1472 $sth->execute($frameworkcode);
1475 my $authorised_value;
1487 $tag, $subfield, $liblibrarian,
1489 $mandatory, $repeatable, $authorised_value,
1490 $authtypecode, $value_builder, $kohafield,
1491 $seealso, $hidden, $isurl,
1497 $res->{$tag}->{$subfield}->{lib} =
1498 ( $forlibrarian or !$libopac ) ? $liblibrarian : $libopac;
1499 $res->{$tag}->{$subfield}->{tab} = $tab;
1500 $res->{$tag}->{$subfield}->{mandatory} = $mandatory;
1501 $res->{$tag}->{$subfield}->{repeatable} = $repeatable;
1502 $res->{$tag}->{$subfield}->{authorised_value} = $authorised_value;
1503 $res->{$tag}->{$subfield}->{authtypecode} = $authtypecode;
1504 $res->{$tag}->{$subfield}->{value_builder} = $value_builder;
1505 $res->{$tag}->{$subfield}->{kohafield} = $kohafield;
1506 $res->{$tag}->{$subfield}->{seealso} = $seealso;
1507 $res->{$tag}->{$subfield}->{hidden} = $hidden;
1508 $res->{$tag}->{$subfield}->{isurl} = $isurl;
1509 $res->{$tag}->{$subfield}->{'link'} = $link;
1510 $res->{$tag}->{$subfield}->{defaultvalue} = $defaultvalue;
1515 =head2 GetUsedMarcStructure
1517 the same function as GetMarcStructure expcet it just take field
1518 in tab 0-9. (used field)
1520 my $results = GetUsedMarcStructure($frameworkcode);
1522 L<$results> is a ref to an array which each case containts a ref
1523 to a hash which each keys is the columns from marc_subfield_structure
1525 L<$frameworkcode> is the framework code.
1529 sub GetUsedMarcStructure($){
1530 my $frameworkcode = shift || '';
1531 my $dbh = C4::Context->dbh;
1534 FROM marc_subfield_structure
1536 AND frameworkcode = ?
1539 my $sth = $dbh->prepare($query);
1540 $sth->execute($frameworkcode);
1541 while (my $row = $sth->fetchrow_hashref){
1547 =head2 GetMarcFromKohaField
1551 ($MARCfield,$MARCsubfield)=GetMarcFromKohaField($kohafield,$frameworkcode);
1552 Returns the MARC fields & subfields mapped to the koha field
1553 for the given frameworkcode
1559 sub GetMarcFromKohaField {
1560 my ( $kohafield, $frameworkcode ) = @_;
1561 return 0, 0 unless $kohafield;
1562 my $relations = C4::Context->marcfromkohafield;
1564 $relations->{$frameworkcode}->{$kohafield}->[0],
1565 $relations->{$frameworkcode}->{$kohafield}->[1]
1569 =head2 GetMarcBiblio
1573 Returns MARC::Record of the biblionumber passed in parameter.
1574 the marc record contains both biblio & item datas
1581 my $biblionumber = shift;
1582 my $dbh = C4::Context->dbh;
1584 $dbh->prepare("select marcxml from biblioitems where biblionumber=? ");
1585 $sth->execute($biblionumber);
1586 my ($marcxml) = $sth->fetchrow;
1587 MARC::File::XML->default_record_format(C4::Context->preference('marcflavour'));
1588 $marcxml =~ s/\x1e//g;
1589 $marcxml =~ s/\x1f//g;
1590 $marcxml =~ s/\x1d//g;
1591 $marcxml =~ s/\x0f//g;
1592 $marcxml =~ s/\x0c//g;
1594 my $record = MARC::Record->new();
1595 $record = MARC::Record::new_from_xml( $marcxml, "utf8",C4::Context->preference('marcflavour')) if $marcxml;
1596 # $record = MARC::Record::new_from_usmarc( $marc) if $marc;
1604 my $marcxml = GetXmlBiblio($biblionumber);
1606 Returns biblioitems.marcxml of the biblionumber passed in parameter.
1607 The XML contains both biblio & item datas
1614 my ( $biblionumber ) = @_;
1615 my $dbh = C4::Context->dbh;
1617 $dbh->prepare("select marcxml from biblioitems where biblionumber=? ");
1618 $sth->execute($biblionumber);
1619 my ($marcxml) = $sth->fetchrow;
1623 =head2 GetAuthorisedValueDesc
1627 my $subfieldvalue =get_authorised_value_desc(
1628 $tag, $subf[$i][0],$subf[$i][1], '', $taglib);
1629 Retrieve the complete description for a given authorised value.
1635 sub GetAuthorisedValueDesc {
1636 my ( $tag, $subfield, $value, $framework, $tagslib ) = @_;
1637 my $dbh = C4::Context->dbh;
1640 if ( $tagslib->{$tag}->{$subfield}->{'authorised_value'} eq "branches" ) {
1641 return C4::Branch::GetBranchName($value);
1645 if ( $tagslib->{$tag}->{$subfield}->{'authorised_value'} eq "itemtypes" ) {
1646 return getitemtypeinfo($value)->{description};
1649 #---- "true" authorized value
1650 my $category = $tagslib->{$tag}->{$subfield}->{'authorised_value'};
1651 if ( $category ne "" ) {
1654 "select lib from authorised_values where category = ? and authorised_value = ?"
1656 $sth->execute( $category, $value );
1657 my $data = $sth->fetchrow_hashref;
1658 return $data->{'lib'};
1661 return $value; # if nothing is found return the original value
1669 Returns MARC::Record of the item passed in parameter.
1676 my ( $biblionumber, $itemnumber ) = @_;
1677 my $dbh = C4::Context->dbh;
1678 my $newrecord = MARC::Record->new();
1679 my $marcflavour = C4::Context->preference('marcflavour');
1681 my $marcxml = GetXmlBiblio($biblionumber);
1682 my $record = MARC::Record->new();
1683 $record = MARC::Record::new_from_xml( $marcxml, "utf8", $marcflavour );
1684 # now, find where the itemnumber is stored & extract only the item
1685 my ( $itemnumberfield, $itemnumbersubfield ) =
1686 GetMarcFromKohaField( 'items.itemnumber', '' );
1687 my @fields = $record->field($itemnumberfield);
1688 foreach my $field (@fields) {
1689 if ( $field->subfield($itemnumbersubfield) eq $itemnumber ) {
1690 $newrecord->insert_fields_ordered($field);
1702 $marcnotesarray = GetMarcNotes( $record, $marcflavour );
1703 Get all notes from the MARC record and returns them in an array.
1704 The note are stored in differents places depending on MARC flavour
1711 my ( $record, $marcflavour ) = @_;
1713 if ( $marcflavour eq "MARC21" ) {
1716 else { # assume unimarc if not marc21
1723 foreach my $field ( $record->field($scope) ) {
1724 my $value = $field->as_string();
1725 if ( $note ne "" ) {
1726 $marcnote = { marcnote => $note, };
1727 push @marcnotes, $marcnote;
1730 if ( $note ne $value ) {
1731 $note = $note . " " . $value;
1736 $marcnote = { marcnote => $note };
1737 push @marcnotes, $marcnote; #load last tag into array
1740 } # end GetMarcNotes
1742 =head2 GetMarcSubjects
1746 $marcsubjcts = GetMarcSubjects($record,$marcflavour);
1747 Get all subjects from the MARC record and returns them in an array.
1748 The subjects are stored in differents places depending on MARC flavour
1754 sub GetMarcSubjects {
1755 my ( $record, $marcflavour ) = @_;
1756 my ( $mintag, $maxtag );
1757 if ( $marcflavour eq "MARC21" ) {
1761 else { # assume unimarc if not marc21
1768 foreach my $field ( $record->fields ) {
1769 next unless $field->tag() >= $mintag && $field->tag() <= $maxtag;
1770 my @subfields = $field->subfields();
1774 my $authoritysep=C4::Context->preference("authoritysep");
1775 for my $subject_subfield ( @subfields ) {
1777 $marcflavour ne 'MARC21'
1779 ($subject_subfield->[0] eq '3') or
1780 ($subject_subfield->[0] eq '4') or
1781 ($subject_subfield->[0] eq '5')
1787 my $code = $subject_subfield->[0];
1788 $label .= $subject_subfield->[1].$authoritysep unless ( $code == 9 );
1789 $link .= " and su-to:".$subject_subfield->[1] unless ( $code == 9 );
1791 $link = "an:".$subject_subfield->[1];
1795 $link =~ s/ and\ssu-to:$//;
1798 $label =~ s/$authoritysep$//;
1805 return \@marcsubjcts;
1806 } #end GetMarcSubjects
1808 =head2 GetMarcAuthors
1812 authors = GetMarcAuthors($record,$marcflavour);
1813 Get all authors from the MARC record and returns them in an array.
1814 The authors are stored in differents places depending on MARC flavour
1820 sub GetMarcAuthors {
1821 my ( $record, $marcflavour ) = @_;
1822 my ( $mintag, $maxtag );
1823 # tagslib useful for UNIMARC author reponsabilities
1824 my $tagslib = &GetMarcStructure( 1, '' ); # FIXME : we don't have the framework available, we take the default framework. May be bugguy on some setups, will be usually correct.
1825 if ( $marcflavour eq "MARC21" ) {
1829 else { # assume unimarc if not marc21
1836 foreach my $field ( $record->fields ) {
1837 next unless $field->tag() >= $mintag && $field->tag() <= $maxtag;
1839 my @subfields = $field->subfields();
1842 for my $authors_subfield (@subfields) {
1844 $marcflavour ne 'MARC21'
1846 ($authors_subfield->[0] eq '3') or
1847 ($authors_subfield->[0] eq '5')
1853 if ($count_auth ne '0'){
1857 my $subfieldcode = $authors_subfield->[0];
1859 # deal with UNIMARC author responsibility
1861 $marcflavour ne 'MARC21'
1862 and ($authors_subfield->[0] eq '4')
1865 $value = "(".GetAuthorisedValueDesc( $field->tag(), $authors_subfield->[0], $authors_subfield->[1], '', $tagslib ).")";
1867 $value = $authors_subfield->[1];
1869 $hash{tag} = $field->tag;
1870 $hash{value} .= $value . " " if ($subfieldcode != 9) ;
1871 $hash{link} .= $value if ($subfieldcode eq 9);
1873 push @marcauthors, \%hash;
1875 return \@marcauthors;
1878 =head2 GetMarcSeries
1882 $marcseriessarray = GetMarcSeries($record,$marcflavour);
1883 Get all series from the MARC record and returns them in an array.
1884 The series are stored in differents places depending on MARC flavour
1891 my ($record, $marcflavour) = @_;
1892 my ($mintag, $maxtag);
1893 if ($marcflavour eq "MARC21") {
1896 } else { # assume unimarc if not marc21
1906 foreach my $field ($record->field('440'), $record->field('490')) {
1908 #my $value = $field->subfield('a');
1909 #$marcsubjct = {MARCSUBJCT => $value,};
1910 my @subfields = $field->subfields();
1911 #warn "subfields:".join " ", @$subfields;
1914 for my $series_subfield (@subfields) {
1916 undef $volume_number;
1917 # see if this is an instance of a volume
1918 if ($series_subfield->[0] eq 'v') {
1922 my $code = $series_subfield->[0];
1923 my $value = $series_subfield->[1];
1924 my $linkvalue = $value;
1925 $linkvalue =~ s/(\(|\))//g;
1926 my $operator = " and " unless $counter==0;
1927 push @link_loop, {link => $linkvalue, operator => $operator };
1928 my $separator = C4::Context->preference("authoritysep") unless $counter==0;
1929 if ($volume_number) {
1930 push @subfields_loop, {volumenum => $value};
1933 push @subfields_loop, {code => $code, value => $value, link_loop => \@link_loop, separator => $separator, volumenum => $volume_number};
1937 push @marcseries, { MARCSERIES_SUBFIELDS_LOOP => \@subfields_loop };
1938 #$marcsubjct = {MARCSUBJCT => $field->as_string(),};
1939 #push @marcsubjcts, $marcsubjct;
1943 my $marcseriessarray=\@marcseries;
1944 return $marcseriessarray;
1945 } #end getMARCseriess
1947 =head2 GetFrameworkCode
1951 $frameworkcode = GetFrameworkCode( $biblionumber )
1957 sub GetFrameworkCode {
1958 my ( $biblionumber ) = @_;
1959 my $dbh = C4::Context->dbh;
1960 my $sth = $dbh->prepare("select frameworkcode from biblio where biblionumber=?");
1961 $sth->execute($biblionumber);
1962 my ($frameworkcode) = $sth->fetchrow;
1963 return $frameworkcode;
1966 =head2 GetPublisherNameFromIsbn
1968 $name = GetPublishercodeFromIsbn($isbn);
1975 sub GetPublisherNameFromIsbn($){
1977 $isbn =~ s/[- _]//g;
1979 my @codes = (split '-', DisplayISBN($isbn));
1980 my $code = $codes[0].$codes[1].$codes[2];
1981 my $dbh = C4::Context->dbh;
1983 SELECT distinct publishercode
1986 AND publishercode IS NOT NULL
1989 my $sth = $dbh->prepare($query);
1990 $sth->execute("$code%");
1991 my $name = $sth->fetchrow;
1992 return $name if length $name;
1996 =head2 TransformKohaToMarc
2000 $record = TransformKohaToMarc( $hash )
2001 This function builds partial MARC::Record from a hash
2002 Hash entries can be from biblio or biblioitems.
2003 This function is called in acquisition module, to create a basic catalogue entry from user entry
2009 sub TransformKohaToMarc {
2012 my $dbh = C4::Context->dbh;
2015 "select tagfield,tagsubfield from marc_subfield_structure where frameworkcode=? and kohafield=?"
2017 my $record = MARC::Record->new();
2018 foreach (keys %{$hash}) {
2019 &TransformKohaToMarcOneField( $sth, $record, $_,
2025 =head2 TransformKohaToMarcOneField
2029 $record = TransformKohaToMarcOneField( $sth, $record, $kohafieldname, $value, $frameworkcode );
2035 sub TransformKohaToMarcOneField {
2036 my ( $sth, $record, $kohafieldname, $value, $frameworkcode ) = @_;
2037 $frameworkcode='' unless $frameworkcode;
2041 if ( !defined $sth ) {
2042 my $dbh = C4::Context->dbh;
2043 $sth = $dbh->prepare(
2044 "select tagfield,tagsubfield from marc_subfield_structure where frameworkcode=? and kohafield=?"
2047 $sth->execute( $frameworkcode, $kohafieldname );
2048 if ( ( $tagfield, $tagsubfield ) = $sth->fetchrow ) {
2049 my $tag = $record->field($tagfield);
2051 $tag->update( $tagsubfield => $value );
2052 $record->delete_field($tag);
2053 $record->insert_fields_ordered($tag);
2056 $record->add_fields( $tagfield, " ", " ", $tagsubfield => $value );
2062 =head2 TransformHtmlToXml
2066 $xml = TransformHtmlToXml( $tags, $subfields, $values, $indicator, $ind_tag, $auth_type )
2068 $auth_type contains :
2069 - nothing : rebuild a biblio, un UNIMARC the encoding is in 100$a pos 26/27
2070 - UNIMARCAUTH : rebuild an authority. In UNIMARC, the encoding is in 100$a pos 13/14
2071 - ITEM : rebuild an item : in UNIMARC, 100$a, it's in the biblio ! (otherwise, we would get 2 100 fields !)
2077 sub TransformHtmlToXml {
2078 my ( $tags, $subfields, $values, $indicator, $ind_tag, $auth_type ) = @_;
2079 my $xml = MARC::File::XML::header('UTF-8');
2080 $auth_type = C4::Context->preference('marcflavour') unless $auth_type;
2081 MARC::File::XML->default_record_format($auth_type);
2082 # in UNIMARC, field 100 contains the encoding
2083 # check that there is one, otherwise the
2084 # MARC::Record->new_from_xml will fail (and Koha will die)
2085 my $unimarc_and_100_exist=0;
2086 $unimarc_and_100_exist=1 if $auth_type eq 'ITEM'; # if we rebuild an item, no need of a 100 field
2091 for ( my $i = 0 ; $i <= @$tags ; $i++ ) {
2092 if (C4::Context->preference('marcflavour') eq 'UNIMARC' and @$tags[$i] eq "100" and @$subfields[$i] eq "a") {
2093 # if we have a 100 field and it's values are not correct, skip them.
2094 # if we don't have any valid 100 field, we will create a default one at the end
2095 my $enc = substr( @$values[$i], 26, 2 );
2096 if ($enc eq '01' or $enc eq '50' or $enc eq '03') {
2097 $unimarc_and_100_exist=1;
2102 @$values[$i] =~ s/&/&/g;
2103 @$values[$i] =~ s/</</g;
2104 @$values[$i] =~ s/>/>/g;
2105 @$values[$i] =~ s/"/"/g;
2106 @$values[$i] =~ s/'/'/g;
2107 # if ( !utf8::is_utf8( @$values[$i] ) ) {
2108 # utf8::decode( @$values[$i] );
2110 if ( ( @$tags[$i] ne $prevtag ) ) {
2111 $j++ unless ( @$tags[$i] eq "" );
2113 $xml .= "</datafield>\n";
2114 if ( ( @$tags[$i] && @$tags[$i] > 10 )
2115 && ( @$values[$i] ne "" ) )
2117 my $ind1 = substr( @$indicator[$j], 0, 1 );
2119 if ( @$indicator[$j] ) {
2120 $ind2 = substr( @$indicator[$j], 1, 1 );
2123 warn "Indicator in @$tags[$i] is empty";
2127 "<datafield tag=\"@$tags[$i]\" ind1=\"$ind1\" ind2=\"$ind2\">\n";
2129 "<subfield code=\"@$subfields[$i]\">@$values[$i]</subfield>\n";
2137 if ( @$values[$i] ne "" ) {
2140 if ( @$tags[$i] eq "000" ) {
2141 $xml .= "<leader>@$values[$i]</leader>\n";
2144 # rest of the fixed fields
2146 elsif ( @$tags[$i] < 10 ) {
2148 "<controlfield tag=\"@$tags[$i]\">@$values[$i]</controlfield>\n";
2152 my $ind1 = substr( @$indicator[$j], 0, 1 );
2153 my $ind2 = substr( @$indicator[$j], 1, 1 );
2155 "<datafield tag=\"@$tags[$i]\" ind1=\"$ind1\" ind2=\"$ind2\">\n";
2157 "<subfield code=\"@$subfields[$i]\">@$values[$i]</subfield>\n";
2163 else { # @$tags[$i] eq $prevtag
2164 if ( @$values[$i] eq "" ) {
2168 my $ind1 = substr( @$indicator[$j], 0, 1 );
2169 my $ind2 = substr( @$indicator[$j], 1, 1 );
2171 "<datafield tag=\"@$tags[$i]\" ind1=\"$ind1\" ind2=\"$ind2\">\n";
2175 "<subfield code=\"@$subfields[$i]\">@$values[$i]</subfield>\n";
2178 $prevtag = @$tags[$i];
2180 if (C4::Context->preference('marcflavour') and !$unimarc_and_100_exist) {
2181 # warn "SETTING 100 for $auth_type";
2182 use POSIX qw(strftime);
2183 my $string = strftime( "%Y%m%d", localtime(time) );
2184 # set 50 to position 26 is biblios, 13 if authorities
2186 $pos=13 if $auth_type eq 'UNIMARCAUTH';
2187 $string = sprintf( "%-*s", 35, $string );
2188 substr( $string, $pos , 6, "50" );
2189 $xml .= "<datafield tag=\"100\" ind1=\"\" ind2=\"\">\n";
2190 $xml .= "<subfield code=\"a\">$string</subfield>\n";
2191 $xml .= "</datafield>\n";
2193 $xml .= MARC::File::XML::footer();
2197 =head2 TransformHtmlToMarc
2199 L<$record> = TransformHtmlToMarc(L<$params>,L<$cgi>)
2200 L<$params> is a ref to an array as below:
2202 'tag_010_indicator_531951' ,
2203 'tag_010_code_a_531951_145735' ,
2204 'tag_010_subfield_a_531951_145735' ,
2205 'tag_200_indicator_873510' ,
2206 'tag_200_code_a_873510_673465' ,
2207 'tag_200_subfield_a_873510_673465' ,
2208 'tag_200_code_b_873510_704318' ,
2209 'tag_200_subfield_b_873510_704318' ,
2210 'tag_200_code_e_873510_280822' ,
2211 'tag_200_subfield_e_873510_280822' ,
2212 'tag_200_code_f_873510_110730' ,
2213 'tag_200_subfield_f_873510_110730' ,
2215 L<$cgi> is the CGI object which containts the value.
2216 L<$record> is the MARC::Record object.
2220 sub TransformHtmlToMarc {
2224 # creating a new record
2225 my $record = MARC::Record->new();
2228 while ($params->[$i]){ # browse all CGI params
2229 my $param = $params->[$i];
2231 # if we are on biblionumber, store it in the MARC::Record (it may not be in the edited fields)
2232 if ($param eq 'biblionumber') {
2233 my ( $biblionumbertagfield, $biblionumbertagsubfield ) =
2234 &GetMarcFromKohaField( "biblio.biblionumber", '' );
2235 if ($biblionumbertagfield < 10) {
2236 $newfield = MARC::Field->new(
2237 $biblionumbertagfield,
2238 $cgi->param($param),
2241 $newfield = MARC::Field->new(
2242 $biblionumbertagfield,
2245 "$biblionumbertagsubfield" => $cgi->param($param),
2248 push @fields,$newfield if($newfield);
2250 elsif ($param =~ /^tag_(\d*)_indicator_/){ # new field start when having 'input name="..._indicator_..."
2253 my $ind1 = substr($cgi->param($param),0,1);
2254 my $ind2 = substr($cgi->param($param),1,1);
2258 if($tag < 10){ # no code for theses fields
2259 # in MARC editor, 000 contains the leader.
2260 if ($tag eq '000' ) {
2261 $record->leader($cgi->param($params->[$j+1])) if length($cgi->param($params->[$j+1]))==24;
2262 # between 001 and 009 (included)
2264 $newfield = MARC::Field->new(
2266 $cgi->param($params->[$j+1]),
2269 # > 009, deal with subfields
2271 while($params->[$j] =~ /_code_/){ # browse all it's subfield
2272 my $inner_param = $params->[$j];
2274 if($cgi->param($params->[$j+1])){ # only if there is a value (code => value)
2275 $newfield->add_subfields(
2276 $cgi->param($inner_param) => $cgi->param($params->[$j+1])
2280 if ( $cgi->param($params->[$j+1]) ) { # creating only if there is a value (code => value)
2281 $newfield = MARC::Field->new(
2285 $cgi->param($inner_param) => $cgi->param($params->[$j+1]),
2292 push @fields,$newfield if($newfield);
2297 $record->append_fields(@fields);
2301 =head2 TransformMarcToKoha
2305 $result = TransformMarcToKoha( $dbh, $record, $frameworkcode )
2311 sub TransformMarcToKoha {
2312 my ( $dbh, $record, $frameworkcode ) = @_;
2314 # FIXME :: This query is unused..
2317 #"select tagfield,tagsubfield from marc_subfield_structure where frameworkcode=? and kohafield=?"
2321 my $sth2 = $dbh->prepare("SHOW COLUMNS from biblio");
2324 while ( ($field) = $sth2->fetchrow ) {
2326 &TransformMarcToKohaOneField( "biblio", $field, $record, $result,
2329 my $sth2 = $dbh->prepare("SHOW COLUMNS from biblioitems");
2331 while ( ($field) = $sth2->fetchrow ) {
2332 if ( $field eq 'notes' ) { $field = 'bnotes'; }
2334 &TransformMarcToKohaOneField( "biblioitems", $field, $record, $result,
2337 $sth2 = $dbh->prepare("SHOW COLUMNS from items");
2339 while ( ($field) = $sth2->fetchrow ) {
2341 &TransformMarcToKohaOneField( "items", $field, $record, $result,
2346 # modify copyrightdate to keep only the 1st year found
2347 my $temp = $result->{'copyrightdate'};
2348 $temp =~ m/c(\d\d\d\d)/; # search cYYYY first
2350 $result->{'copyrightdate'} = $1;
2352 else { # if no cYYYY, get the 1st date.
2353 $temp =~ m/(\d\d\d\d)/;
2354 $result->{'copyrightdate'} = $1;
2357 # modify publicationyear to keep only the 1st year found
2358 $temp = $result->{'publicationyear'};
2359 $temp =~ m/c(\d\d\d\d)/; # search cYYYY first
2361 $result->{'publicationyear'} = $1;
2363 else { # if no cYYYY, get the 1st date.
2364 $temp =~ m/(\d\d\d\d)/;
2365 $result->{'publicationyear'} = $1;
2370 =head2 TransformMarcToKohaOneField
2374 $result = TransformMarcToKohaOneField( $kohatable, $kohafield, $record, $result, $frameworkcode )
2380 sub TransformMarcToKohaOneField {
2382 # FIXME ? if a field has a repeatable subfield that is used in old-db,
2383 # only the 1st will be retrieved...
2384 my ( $kohatable, $kohafield, $record, $result, $frameworkcode ) = @_;
2386 my ( $tagfield, $subfield ) =
2387 GetMarcFromKohaField( $kohatable . "." . $kohafield,
2389 foreach my $field ( $record->field($tagfield) ) {
2390 if ( $field->tag() < 10 ) {
2391 if ( $result->{$kohafield} ) {
2392 $result->{$kohafield} .= " | " . $field->data();
2395 $result->{$kohafield} = $field->data();
2399 if ( $field->subfields ) {
2400 my @subfields = $field->subfields();
2401 foreach my $subfieldcount ( 0 .. $#subfields ) {
2402 if ( $subfields[$subfieldcount][0] eq $subfield ) {
2403 if ( $result->{$kohafield} ) {
2404 $result->{$kohafield} .=
2405 " | " . $subfields[$subfieldcount][1];
2408 $result->{$kohafield} =
2409 $subfields[$subfieldcount][1];
2419 =head1 OTHER FUNCTIONS
2425 my $string = char_decode( $string, $encoding );
2427 converts ISO 5426 coded string to UTF-8
2428 sloppy code : should be improved in next issue
2435 my ( $string, $encoding ) = @_;
2438 $encoding = C4::Context->preference("marcflavour") unless $encoding;
2439 if ( $encoding eq "UNIMARC" ) {
2509 # this handles non-sorting blocks (if implementation requires this)
2510 $string = nsb_clean($_);
2512 elsif ( $encoding eq "USMARC" || $encoding eq "MARC21" ) {
2571 #Additional Turkish characters
2574 s/(\xf0)s/\xc5\x9f/gm;
2575 s/(\xf0)S/\xc5\x9e/gm;
2578 s/\xe7\x49/\\xc4\xb0/gm;
2579 s/(\xe6)G/\xc4\x9e/gm;
2580 s/(\xe6)g/ğ\xc4\x9f/gm;
2583 s/(\xe8|\xc8)o/ö/gm;
2584 s/(\xe8|\xc8)O/Ö/gm;
2585 s/(\xe8|\xc8)u/ü/gm;
2586 s/(\xe8|\xc8)U/Ü/gm;
2587 s/\xc2\xb8/\xc4\xb1/gm;
2590 # this handles non-sorting blocks (if implementation requires this)
2591 $string = nsb_clean($_);
2600 my $string = nsb_clean( $string, $encoding );
2607 my $NSB = '\x88'; # NSB : begin Non Sorting Block
2608 my $NSE = '\x89'; # NSE : Non Sorting Block end
2609 # handles non sorting blocks
2613 s/[ ]{0,1}$NSE/) /gm;
2618 =head2 PrepareItemrecordDisplay
2622 PrepareItemrecordDisplay($itemrecord,$bibnum,$itemumber);
2624 Returns a hash with all the fields for Display a given item data in a template
2630 sub PrepareItemrecordDisplay {
2632 my ( $bibnum, $itemnum ) = @_;
2634 my $dbh = C4::Context->dbh;
2635 my $frameworkcode = &GetFrameworkCode( $bibnum );
2636 my ( $itemtagfield, $itemtagsubfield ) =
2637 &GetMarcFromKohaField( "items.itemnumber", $frameworkcode );
2638 my $tagslib = &GetMarcStructure( 1, $frameworkcode );
2639 my $itemrecord = GetMarcItem( $bibnum, $itemnum) if ($itemnum);
2641 my $authorised_values_sth =
2643 "select authorised_value,lib from authorised_values where category=? order by lib"
2645 foreach my $tag ( sort keys %{$tagslib} ) {
2646 my $previous_tag = '';
2648 # loop through each subfield
2650 foreach my $subfield ( sort keys %{ $tagslib->{$tag} } ) {
2651 next if ( subfield_is_koha_internal_p($subfield) );
2652 next if ( $tagslib->{$tag}->{$subfield}->{'tab'} ne "10" );
2654 $subfield_data{tag} = $tag;
2655 $subfield_data{subfield} = $subfield;
2656 $subfield_data{countsubfield} = $cntsubf++;
2657 $subfield_data{kohafield} =
2658 $tagslib->{$tag}->{$subfield}->{'kohafield'};
2660 # $subfield_data{marc_lib}=$tagslib->{$tag}->{$subfield}->{lib};
2661 $subfield_data{marc_lib} =
2662 "<span id=\"error\" title=\""
2663 . $tagslib->{$tag}->{$subfield}->{lib} . "\">"
2664 . substr( $tagslib->{$tag}->{$subfield}->{lib}, 0, 12 )
2666 $subfield_data{mandatory} =
2667 $tagslib->{$tag}->{$subfield}->{mandatory};
2668 $subfield_data{repeatable} =
2669 $tagslib->{$tag}->{$subfield}->{repeatable};
2670 $subfield_data{hidden} = "display:none"
2671 if $tagslib->{$tag}->{$subfield}->{hidden};
2673 ( $x, $value ) = _find_value( $tag, $subfield, $itemrecord )
2675 $value =~ s/"/"/g;
2677 # search for itemcallnumber if applicable
2678 if ( $tagslib->{$tag}->{$subfield}->{kohafield} eq
2679 'items.itemcallnumber'
2680 && C4::Context->preference('itemcallnumber') )
2683 substr( C4::Context->preference('itemcallnumber'), 0, 3 );
2685 substr( C4::Context->preference('itemcallnumber'), 3, 1 );
2686 my $temp = $itemrecord->field($CNtag) if ($itemrecord);
2688 $value = $temp->subfield($CNsubfield);
2691 if ( $tagslib->{$tag}->{$subfield}->{authorised_value} ) {
2692 my @authorised_values;
2695 # builds list, depending on authorised value...
2697 if ( $tagslib->{$tag}->{$subfield}->{'authorised_value'} eq
2700 if ( ( C4::Context->preference("IndependantBranches") )
2701 && ( C4::Context->userenv->{flags} != 1 ) )
2705 "select branchcode,branchname from branches where branchcode = ? order by branchname"
2707 $sth->execute( C4::Context->userenv->{branch} );
2708 push @authorised_values, ""
2710 $tagslib->{$tag}->{$subfield}->{mandatory} );
2711 while ( my ( $branchcode, $branchname ) =
2712 $sth->fetchrow_array )
2714 push @authorised_values, $branchcode;
2715 $authorised_lib{$branchcode} = $branchname;
2721 "select branchcode,branchname from branches order by branchname"
2724 push @authorised_values, ""
2726 $tagslib->{$tag}->{$subfield}->{mandatory} );
2727 while ( my ( $branchcode, $branchname ) =
2728 $sth->fetchrow_array )
2730 push @authorised_values, $branchcode;
2731 $authorised_lib{$branchcode} = $branchname;
2737 elsif ( $tagslib->{$tag}->{$subfield}->{authorised_value} eq
2742 "select itemtype,description from itemtypes order by description"
2745 push @authorised_values, ""
2746 unless ( $tagslib->{$tag}->{$subfield}->{mandatory} );
2747 while ( my ( $itemtype, $description ) =
2748 $sth->fetchrow_array )
2750 push @authorised_values, $itemtype;
2751 $authorised_lib{$itemtype} = $description;
2754 #---- "true" authorised value
2757 $authorised_values_sth->execute(
2758 $tagslib->{$tag}->{$subfield}->{authorised_value} );
2759 push @authorised_values, ""
2760 unless ( $tagslib->{$tag}->{$subfield}->{mandatory} );
2761 while ( my ( $value, $lib ) =
2762 $authorised_values_sth->fetchrow_array )
2764 push @authorised_values, $value;
2765 $authorised_lib{$value} = $lib;
2768 $subfield_data{marc_value} = CGI::scrolling_list(
2769 -name => 'field_value',
2770 -values => \@authorised_values,
2771 -default => "$value",
2772 -labels => \%authorised_lib,
2778 elsif ( $tagslib->{$tag}->{$subfield}->{thesaurus_category} ) {
2779 $subfield_data{marc_value} =
2780 "<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>";
2783 # COMMENTED OUT because No $i is provided with this API.
2784 # And thus, no value_builder can be activated.
2785 # BUT could be thought over.
2786 # } elsif ($tagslib->{$tag}->{$subfield}->{'value_builder'}) {
2787 # my $plugin="value_builder/".$tagslib->{$tag}->{$subfield}->{'value_builder'};
2789 # my $extended_param = plugin_parameters($dbh,$itemrecord,$tagslib,$i,0);
2790 # my ($function_name,$javascript) = plugin_javascript($dbh,$record,$tagslib,$i,0);
2791 # $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";
2794 $subfield_data{marc_value} =
2795 "<input type=\"text\" name=\"field_value\" value=\"$value\" size=50 maxlength=255>";
2797 push( @loop_data, \%subfield_data );
2801 my $itemnumber = $itemrecord->subfield( $itemtagfield, $itemtagsubfield )
2802 if ( $itemrecord && $itemrecord->field($itemtagfield) );
2804 'itemtagfield' => $itemtagfield,
2805 'itemtagsubfield' => $itemtagsubfield,
2806 'itemnumber' => $itemnumber,
2807 'iteminformation' => \@loop_data
2813 # true ModZebra commented until indexdata fixes zebraDB crashes (it seems they occur on multiple updates
2815 # replaced by a zebraqueue table, that is filled with ModZebra to run.
2816 # the table is emptied by misc/cronjobs/zebraqueue_start.pl script
2817 # =head2 ModZebrafiles
2819 # &ModZebrafiles( $dbh, $biblionumber, $record, $folder, $server );
2823 # sub ModZebrafiles {
2825 # my ( $dbh, $biblionumber, $record, $folder, $server ) = @_;
2829 # C4::Context->zebraconfig($server)->{directory} . "/" . $folder . "/";
2830 # unless ( opendir( DIR, "$zebradir" ) ) {
2831 # warn "$zebradir not found";
2835 # my $filename = $zebradir . $biblionumber;
2838 # open( OUTPUT, ">", $filename . ".xml" );
2839 # print OUTPUT $record;
2848 ModZebra( $biblionumber, $op, $server, $newRecord );
2850 $biblionumber is the biblionumber we want to index
2851 $op is specialUpdate or delete, and is used to know what we want to do
2852 $server is the server that we want to update
2853 $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.
2860 ###Accepts a $server variable thus we can use it for biblios authorities or other zebra dbs
2861 my ( $biblionumber, $op, $server, $newRecord ) = @_;
2862 my $dbh=C4::Context->dbh;
2864 # true ModZebra commented until indexdata fixes zebraDB crashes (it seems they occur on multiple updates
2866 # replaced by a zebraqueue table, that is filled with ModZebra to run.
2867 # the table is emptied by misc/cronjobs/zebraqueue_start.pl script
2869 if (C4::Context->preference("NoZebra")) {
2870 # lock the nozebra table : we will read index lines, update them in Perl process
2871 # and write everything in 1 transaction.
2872 # lock the table to avoid someone else overwriting what we are doing
2873 $dbh->do('LOCK TABLES nozebra WRITE,biblio WRITE,biblioitems WRITE, systempreferences WRITE, auth_types WRITE, auth_header WRITE');
2874 my %result; # the result hash that will be builded by deletion / add, and written on mySQL at the end, to improve speed
2876 if ($server eq 'biblioserver') {
2877 $record= GetMarcBiblio($biblionumber);
2879 $record= C4::AuthoritiesMarc::GetAuthority($biblionumber);
2881 if ($op eq 'specialUpdate') {
2882 # OK, we have to add or update the record
2883 # 1st delete (virtually, in indexes) ...
2884 %result = _DelBiblioNoZebra($biblionumber,$record,$server);
2885 # ... add the record
2886 %result=_AddBiblioNoZebra($biblionumber,$newRecord, $server, %result);
2888 # it's a deletion, delete the record...
2889 # warn "DELETE the record $biblionumber on $server".$record->as_formatted;
2890 %result=_DelBiblioNoZebra($biblionumber,$record,$server);
2892 # ok, now update the database...
2893 my $sth = $dbh->prepare("UPDATE nozebra SET biblionumbers=? WHERE server=? AND indexname=? AND value=?");
2894 foreach my $key (keys %result) {
2895 foreach my $index (keys %{$result{$key}}) {
2896 $sth->execute($result{$key}->{$index}, $server, $key, $index);
2899 $dbh->do('UNLOCK TABLES');
2903 # we use zebra, just fill zebraqueue table
2905 my $sth=$dbh->prepare("insert into zebraqueue (biblio_auth_number ,server,operation) values(?,?,?)");
2906 $sth->execute($biblionumber,$server,$op);
2911 =head2 GetNoZebraIndexes
2913 %indexes = GetNoZebraIndexes;
2915 return the data from NoZebraIndexes syspref.
2919 sub GetNoZebraIndexes {
2920 my $index = C4::Context->preference('NoZebraIndexes');
2922 foreach my $line (split /('|"),/,$index) {
2923 $line =~ /(.*)=>(.*)/;
2924 my $index = substr($1,1); # get the index, don't forget to remove initial ' or "
2926 $index =~ s/'|"| //g;
2927 $fields =~ s/'|"| //g;
2928 $indexes{$index}=$fields;
2933 =head1 INTERNAL FUNCTIONS
2935 =head2 _DelBiblioNoZebra($biblionumber,$record,$server);
2937 function to delete a biblio in NoZebra indexes
2938 This function does NOT delete anything in database : it reads all the indexes entries
2939 that have to be deleted & delete them in the hash
2940 The SQL part is done either :
2941 - after the Add if we are modifying a biblio (delete + add again)
2942 - immediatly after this sub if we are doing a true deletion.
2943 $server can be 'biblioserver' or 'authorityserver' : it indexes biblios or authorities (in the same table, $server being part of the table itself
2948 sub _DelBiblioNoZebra {
2949 my ($biblionumber, $record, $server)=@_;
2952 my $dbh = C4::Context->dbh;
2956 if ($server eq 'biblioserver') {
2957 %index=GetNoZebraIndexes;
2958 # get title of the record (to store the 10 first letters with the index)
2959 my ($titletag,$titlesubfield) = GetMarcFromKohaField('biblio.title');
2960 $title = lc($record->subfield($titletag,$titlesubfield));
2962 # for authorities, the "title" is the $a mainentry
2963 my $authref = C4::AuthoritiesMarc::GetAuthType($record->subfield(152,'b'));
2964 warn "ERROR : authtype undefined for ".$record->as_formatted unless $authref;
2965 $title = $record->subfield($authref->{auth_tag_to_report},'a');
2966 $index{'mainmainentry'}= $authref->{'auth_tag_to_report'}.'a';
2967 $index{'mainentry'} = $authref->{'auth_tag_to_report'}.'*';
2968 $index{'auth_type'} = '152b';
2972 # remove blancks comma (that could cause problem when decoding the string for CQL retrieval) and regexp specific values
2973 $title =~ s/ |,|;|\[|\]|\(|\)|\*|-|'|=//g;
2974 # limit to 10 char, should be enough, and limit the DB size
2975 $title = substr($title,0,10);
2977 my $sth2=$dbh->prepare('SELECT biblionumbers FROM nozebra WHERE server=? AND indexname=? AND value=?');
2978 foreach my $field ($record->fields()) {
2979 #parse each subfield
2980 next if $field->tag <10;
2981 foreach my $subfield ($field->subfields()) {
2982 my $tag = $field->tag();
2983 my $subfieldcode = $subfield->[0];
2985 # check each index to see if the subfield is stored somewhere
2986 # otherwise, store it in __RAW__ index
2987 foreach my $key (keys %index) {
2988 # warn "examining $key index : ".$index{$key}." for $tag $subfieldcode";
2989 if ($index{$key} =~ /$tag\*/ or $index{$key} =~ /$tag$subfieldcode/) {
2991 my $line= lc $subfield->[1];
2992 # remove meaningless value in the field...
2993 $line =~ s/-|\.|\?|,|;|!|'|\(|\)|\[|\]|{|}|"|<|>|&|\+|\*|\/|=|:/ /g;
2994 # ... and split in words
2995 foreach (split / /,$line) {
2996 next unless $_; # skip empty values (multiple spaces)
2997 # if the entry is already here, do nothing, the biblionumber has already be removed
2998 unless ($result{$key}->{$_} =~ /$biblionumber,$title\-(\d);/) {
2999 # get the index value if it exist in the nozebra table and remove the entry, otherwise, do nothing
3000 $sth2->execute($server,$key,$_);
3001 my $existing_biblionumbers = $sth2->fetchrow;
3003 if ($existing_biblionumbers) {
3004 # warn " existing for $key $_: $existing_biblionumbers";
3005 $result{$key}->{$_} =$existing_biblionumbers;
3006 $result{$key}->{$_} =~ s/$biblionumber,$title\-(\d);//;
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, do nothing, the biblionumber has already be removed
3020 unless ($result{'__RAW__'}->{$_} =~ /$biblionumber,$title\-(\d);/) {
3021 # get the index value if it exist in the nozebra table and remove the entry, otherwise, do nothing
3022 $sth2->execute($server,'__RAW__',$_);
3023 my $existing_biblionumbers = $sth2->fetchrow;
3025 if ($existing_biblionumbers) {
3026 $result{'__RAW__'}->{$_} =$existing_biblionumbers;
3027 $result{'__RAW__'}->{$_} =~ s/$biblionumber,$title\-(\d);//;
3037 =head2 _AddBiblioNoZebra($biblionumber, $record, $server, %result);
3039 function to add a biblio in NoZebra indexes
3043 sub _AddBiblioNoZebra {
3044 my ($biblionumber, $record, $server, %result)=@_;
3045 my $dbh = C4::Context->dbh;
3049 if ($server eq 'biblioserver') {
3050 %index=GetNoZebraIndexes;
3051 # get title of the record (to store the 10 first letters with the index)
3052 my ($titletag,$titlesubfield) = GetMarcFromKohaField('biblio.title');
3053 $title = lc($record->subfield($titletag,$titlesubfield));
3055 # warn "server : $server";
3056 # for authorities, the "title" is the $a mainentry
3057 my $authref = C4::AuthoritiesMarc::GetAuthType($record->subfield(152,'b'));
3058 warn "ERROR : authtype undefined for ".$record->as_formatted unless $authref;
3059 $title = $record->subfield($authref->{auth_tag_to_report},'a');
3060 $index{'mainmainentry'} = $authref->{auth_tag_to_report}.'a';
3061 $index{'mainentry'} = $authref->{auth_tag_to_report}.'*';
3062 $index{'auth_type'} = '152b';
3065 # remove blancks comma (that could cause problem when decoding the string for CQL retrieval) and regexp specific values
3066 $title =~ s/ |,|;|\[|\]|\(|\)|\*|-|'|=//g;
3067 # limit to 10 char, should be enough, and limit the DB size
3068 $title = substr($title,0,10);
3070 my $sth2=$dbh->prepare('SELECT biblionumbers FROM nozebra WHERE server=? AND indexname=? AND value=?');
3071 foreach my $field ($record->fields()) {
3072 #parse each subfield
3073 next if $field->tag <10;
3074 foreach my $subfield ($field->subfields()) {
3075 my $tag = $field->tag();
3076 my $subfieldcode = $subfield->[0];
3078 # check each index to see if the subfield is stored somewhere
3079 # otherwise, store it in __RAW__ index
3080 foreach my $key (keys %index) {
3081 # warn "examining $key index : ".$index{$key}." for $tag $subfieldcode";
3082 if ($index{$key} =~ /$tag\*/ or $index{$key} =~ /$tag$subfieldcode/) {
3084 my $line= lc $subfield->[1];
3085 # remove meaningless value in the field...
3086 $line =~ s/-|\.|\?|,|;|!|'|\(|\)|\[|\]|{|}|"|<|>|&|\+|\*|\/|=|:/ /g;
3087 # ... and split in words
3088 foreach (split / /,$line) {
3089 next unless $_; # skip empty values (multiple spaces)
3090 # if the entry is already here, improve weight
3091 # warn "managing $_";
3092 if ($result{$key}->{"$_"} =~ /$biblionumber,$title\-(\d);/) {
3094 $result{$key}->{"$_"} =~ s/$biblionumber,$title\-(\d);//;
3095 $result{$key}->{"$_"} .= "$biblionumber,$title-$weight;";
3097 # get the value if it exist in the nozebra table, otherwise, create it
3098 $sth2->execute($server,$key,$_);
3099 my $existing_biblionumbers = $sth2->fetchrow;
3101 if ($existing_biblionumbers) {
3102 $result{$key}->{"$_"} =$existing_biblionumbers;
3104 $result{$key}->{"$_"} =~ s/$biblionumber,$title\-(\d);//;
3105 $result{$key}->{"$_"} .= "$biblionumber,$title-$weight;";
3106 # create a new ligne for this entry
3108 # warn "INSERT : $server / $key / $_";
3109 $dbh->do('INSERT INTO nozebra SET server='.$dbh->quote($server).', indexname='.$dbh->quote($key).',value='.$dbh->quote($_));
3110 $result{$key}->{"$_"}.="$biblionumber,$title-1;";
3116 # the subfield is not indexed, store it in __RAW__ index anyway
3118 my $line= lc $subfield->[1];
3119 $line =~ s/-|\.|\?|,|;|!|'|\(|\)|\[|\]|{|}|"|<|>|&|\+|\*|\/|=|:/ /g;
3120 # ... and split in words
3121 foreach (split / /,$line) {
3122 next unless $_; # skip empty values (multiple spaces)
3123 # if the entry is already here, improve weight
3124 if ($result{'__RAW__'}->{"$_"} =~ /$biblionumber,$title\-(\d);/) {
3126 $result{'__RAW__'}->{"$_"} =~ s/$biblionumber,$title\-(\d);//;
3127 $result{'__RAW__'}->{"$_"} .= "$biblionumber,$title-$weight;";
3129 # get the value if it exist in the nozebra table, otherwise, create it
3130 $sth2->execute($server,'__RAW__',$_);
3131 my $existing_biblionumbers = $sth2->fetchrow;
3133 if ($existing_biblionumbers) {
3134 $result{'__RAW__'}->{"$_"} =$existing_biblionumbers;
3136 $result{'__RAW__'}->{"$_"} =~ s/$biblionumber,$title\-(\d);//;
3137 $result{'__RAW__'}->{"$_"} .= "$biblionumber,$title-$weight;";
3138 # create a new ligne for this entry
3140 $dbh->do('INSERT INTO nozebra SET server='.$dbh->quote($server).', indexname="__RAW__",value='.$dbh->quote($_));
3141 $result{'__RAW__'}->{"$_"}.="$biblionumber,$title-1;";
3152 =head2 MARCitemchange
3156 &MARCitemchange( $record, $itemfield, $newvalue )
3158 Function to update a single value in an item field.
3159 Used twice, could probably be replaced by something else, but works well...
3167 sub MARCitemchange {
3168 my ( $record, $itemfield, $newvalue ) = @_;
3169 my $dbh = C4::Context->dbh;
3171 my ( $tagfield, $tagsubfield ) =
3172 GetMarcFromKohaField( $itemfield, "" );
3173 if ( ($tagfield) && ($tagsubfield) ) {
3174 my $tag = $record->field($tagfield);
3176 $tag->update( $tagsubfield => $newvalue );
3177 $record->delete_field($tag);
3178 $record->insert_fields_ordered($tag);
3183 =head2 _koha_add_biblio
3187 _koha_add_biblio($dbh,$biblioitem);
3189 Internal function to add a biblio ($biblio is a hash with the values)
3195 sub _koha_add_biblio {
3196 my ( $dbh, $biblio, $frameworkcode ) = @_;
3197 my $sth = $dbh->prepare("Select max(biblionumber) from biblio");
3199 my $data = $sth->fetchrow_arrayref;
3200 my $biblionumber = $$data[0] + 1;
3203 if ( $biblio->{'seriestitle'} ) { $series = 1 }
3205 $sth = $dbh->prepare(
3207 SET biblionumber = ?, title = ?, author = ?, copyrightdate = ?, serial = ?, seriestitle = ?, notes = ?, abstract = ?, unititle = ?, frameworkcode = ? "
3210 $biblionumber, $biblio->{'title'},
3211 $biblio->{'author'}, $biblio->{'copyrightdate'},
3212 $biblio->{'serial'}, $biblio->{'seriestitle'},
3213 $biblio->{'notes'}, $biblio->{'abstract'},
3214 $biblio->{'unititle'}, $frameworkcode
3218 return ($biblionumber);
3225 ($indicators, $value) = _find_value($tag, $subfield, $record,$encoding);
3227 Find the given $subfield in the given $tag in the given
3228 MARC::Record $record. If the subfield is found, returns
3229 the (indicators, value) pair; otherwise, (undef, undef) is
3233 Such a function is used in addbiblio AND additem and serial-edit and maybe could be used in Authorities.
3234 I suggest we export it from this module.
3241 my ( $tagfield, $insubfield, $record, $encoding ) = @_;
3244 if ( $tagfield < 10 ) {
3245 if ( $record->field($tagfield) ) {
3246 push @result, $record->field($tagfield)->data();
3253 foreach my $field ( $record->field($tagfield) ) {
3254 my @subfields = $field->subfields();
3255 foreach my $subfield (@subfields) {
3256 if ( @$subfield[0] eq $insubfield ) {
3257 push @result, @$subfield[1];
3258 $indicator = $field->indicator(1) . $field->indicator(2);
3263 return ( $indicator, @result );
3266 =head2 _koha_modify_biblio
3270 $biblionumber = _koha_modify_biblio($dbh,$biblio);
3271 Internal function for updating the biblio table
3277 sub _koha_modify_biblio {
3278 my ( $dbh, $biblio ) = @_;
3279 # FIXME: this code could be made more portable by not hard-coding
3280 # the values that are supposed to be in biblio table
3291 WHERE biblionumber = ?
3293 my $sth = $dbh->prepare($query);
3297 $biblio->{'author'},
3298 $biblio->{'abstract'},
3299 $biblio->{'copyrightdate'},
3300 $biblio->{'seriestitle'},
3301 $biblio->{'serial'},
3302 $biblio->{'unititle'},
3304 $biblio->{'biblionumber'}
3305 ) if $biblio->{'biblionumber'};
3307 warn $sth->err if $sth->err;
3308 warn "BIG ERROR :: No biblionumber for $biblio->{title}" if $biblio->{biblionumber} !~ /\d+/; # if it is not a number
3309 return ( $biblio->{'biblionumber'} );
3312 =head2 _koha_modify_biblioitem
3316 _koha_modify_biblioitem( $dbh, $biblioitem );
3322 sub _koha_modify_biblioitem {
3323 my ( $dbh, $biblioitem ) = @_;
3325 ##Recalculate LC in case it changed --TG
3327 $biblioitem->{'itemtype'} = $dbh->quote( $biblioitem->{'itemtype'} );
3328 $biblioitem->{'url'} = $dbh->quote( $biblioitem->{'url'} );
3329 $biblioitem->{'isbn'} = $dbh->quote( $biblioitem->{'isbn'} );
3330 $biblioitem->{'issn'} = $dbh->quote( $biblioitem->{'issn'} );
3331 $biblioitem->{'publishercode'} =
3332 $dbh->quote( $biblioitem->{'publishercode'} );
3333 $biblioitem->{'publicationyear'} =
3334 $dbh->quote( $biblioitem->{'publicationyear'} );
3335 $biblioitem->{'classification'} =
3336 $dbh->quote( $biblioitem->{'classification'} );
3337 $biblioitem->{'dewey'} = $dbh->quote( $biblioitem->{'dewey'} );
3338 $biblioitem->{'subclass'} = $dbh->quote( $biblioitem->{'subclass'} );
3339 $biblioitem->{'illus'} = $dbh->quote( $biblioitem->{'illus'} );
3340 $biblioitem->{'pages'} = $dbh->quote( $biblioitem->{'pages'} );
3341 $biblioitem->{'volumeddesc'} = $dbh->quote( $biblioitem->{'volumeddesc'} );
3342 $biblioitem->{'bnotes'} = $dbh->quote( $biblioitem->{'bnotes'} );
3343 $biblioitem->{'size'} = $dbh->quote( $biblioitem->{'size'} );
3344 $biblioitem->{'place'} = $dbh->quote( $biblioitem->{'place'} );
3345 $biblioitem->{'collectiontitle'} = $dbh->quote( $biblioitem->{'collectiontitle'} );
3346 $biblioitem->{'collectionissn'} = $dbh->quote( $biblioitem->{'collectionissn'} );
3347 $biblioitem->{'collectionvolume'} = $dbh->quote( $biblioitem->{'collectionvolume'} );
3348 $biblioitem->{'editionstatement'} = $dbh->quote( $biblioitem->{'editionstatement'} );
3349 $biblioitem->{'editionresponsibility'} = $dbh->quote( $biblioitem->{'editionresponsibility'} );
3350 $biblioitem->{'ccode'} = $dbh->quote( $biblioitem->{'ccode'} );
3351 $biblioitem->{'biblionumber'} =
3352 $dbh->quote( $biblioitem->{'biblionumber'} );
3354 $query = "UPDATE biblioitems SET
3355 itemtype = $biblioitem->{'itemtype'},
3356 url = $biblioitem->{'url'},
3357 isbn = $biblioitem->{'isbn'},
3358 issn = $biblioitem->{'issn'},
3359 publishercode = $biblioitem->{'publishercode'},
3360 publicationyear = $biblioitem->{'publicationyear'},
3361 classification = $biblioitem->{'classification'},
3362 dewey = $biblioitem->{'dewey'},
3363 subclass = $biblioitem->{'subclass'},
3364 illus = $biblioitem->{'illus'},
3365 pages = $biblioitem->{'pages'},
3366 volumeddesc = $biblioitem->{'volumeddesc'},
3367 notes = $biblioitem->{'bnotes'},
3368 size = $biblioitem->{'size'},
3369 place = $biblioitem->{'place'},
3370 collectiontitle = $biblioitem->{'collectiontitle'},
3371 collectionissn = $biblioitem->{'collectionissn'},
3372 collectionvolume= $biblioitem->{'collectionvolume'},
3373 editionstatement= $biblioitem->{'editionstatement'},
3374 editionresponsibility= $biblioitem->{'editionresponsibility'},
3375 ccode = $biblioitem->{'ccode'}
3376 where biblionumber = $biblioitem->{'biblionumber'}";
3379 if ( $dbh->errstr ) {
3380 warn "ERROR in _koha_modify_biblioitem $query";
3384 =head2 _koha_add_biblioitem
3388 _koha_add_biblioitem( $dbh, $biblioitem );
3390 Internal function to add a biblioitem
3396 sub _koha_add_biblioitem {
3397 my ( $dbh, $biblioitem ) = @_;
3399 # my $dbh = C4Connect;
3400 my $sth = $dbh->prepare("SELECT max(biblioitemnumber) FROM biblioitems");
3405 $data = $sth->fetchrow_arrayref;
3406 $bibitemnum = $$data[0] + 1;
3410 $sth = $dbh->prepare(
3411 "INSERT INTO biblioitems SET
3412 biblioitemnumber = ?, biblionumber = ?,
3413 volume = ?, number = ?,
3414 classification = ?, itemtype = ?,
3416 issn = ?, dewey = ?,
3417 subclass = ?, publicationyear = ?,
3418 publishercode = ?, volumedate = ?,
3419 volumeddesc = ?, illus = ?,
3420 pages = ?, notes = ?,
3422 marc = ?, lcsort = ?,
3423 place = ?, ccode = ?,
3424 collectiontitle = ?, collectionissn = ?,
3425 collectionvolume = ?, editionstatement= ?,
3426 editionresponsibility= ?
3430 calculatelc( $biblioitem->{'classification'} )
3431 . $biblioitem->{'subclass'};
3433 $bibitemnum, $biblioitem->{'biblionumber'},
3434 $biblioitem->{'volume'}, $biblioitem->{'number'},
3435 $biblioitem->{'classification'}, $biblioitem->{'itemtype'},
3436 $biblioitem->{'url'}, $biblioitem->{'isbn'},
3437 $biblioitem->{'issn'}, $biblioitem->{'dewey'},
3438 $biblioitem->{'subclass'}, $biblioitem->{'publicationyear'},
3439 $biblioitem->{'publishercode'}, $biblioitem->{'volumedate'},
3440 $biblioitem->{'volumeddesc'}, $biblioitem->{'illus'},
3441 $biblioitem->{'pages'}, $biblioitem->{'bnotes'},
3442 $biblioitem->{'size'}, $biblioitem->{'lccn'},
3443 $biblioitem->{'marc'}, $biblioitem->{'place'},
3444 $lcsort, $biblioitem->{'ccode'},
3445 $biblioitem->{'collectiontitle'},$biblioitem->{'collectionissn'},
3446 $biblioitem->{'collectionvolume'},$biblioitem->{'editionstatement'},
3447 $biblioitem->{'editionresponsibility'}
3450 return ($bibitemnum);
3453 =head2 _koha_new_items
3457 _koha_new_items( $dbh, $item, $barcode );
3463 sub _koha_new_items {
3464 my ( $dbh, $item, $barcode ) = @_;
3466 # my $dbh = C4Connect;
3467 my $sth = $dbh->prepare("Select max(itemnumber) from items");
3473 $data = $sth->fetchrow_hashref;
3474 $itemnumber = $data->{'max(itemnumber)'} + 1;
3476 ## Now calculate lccalnumber
3477 my ($cutterextra) = itemcalculator(
3479 $item->{'biblioitemnumber'},
3480 $item->{'itemcallnumber'}
3483 # FIXME the "notforloan" field seems to be named "loan" in some places. workaround bugfix.
3484 if ( $item->{'loan'} ) {
3485 $item->{'notforloan'} = $item->{'loan'};
3488 # if dateaccessioned is provided, use it. Otherwise, set to NOW()
3489 if ( $item->{'dateaccessioned'} eq '' || !$item->{'dateaccessioned'} ) {
3491 $sth = $dbh->prepare(
3492 "Insert into items set
3493 itemnumber = ?, biblionumber = ?,
3494 multivolumepart = ?,
3495 biblioitemnumber = ?, barcode = ?,
3496 booksellerid = ?, dateaccessioned = NOW(),
3497 homebranch = ?, holdingbranch = ?,
3498 price = ?, replacementprice = ?,
3499 replacementpricedate = NOW(), datelastseen = NOW(),
3500 multivolume = ?, stack = ?,
3501 itemlost = ?, wthdrawn = ?,
3502 paidfor = ?, itemnotes = ?,
3503 itemcallnumber =?, notforloan = ?,
3504 location = ?, Cutterextra = ?
3508 $itemnumber, $item->{'biblionumber'},
3509 $item->{'multivolumepart'}, $item->{'biblioitemnumber'},
3510 $barcode, $item->{'booksellerid'},
3511 $item->{'homebranch'}, $item->{'holdingbranch'},
3512 $item->{'price'}, $item->{'replacementprice'},
3513 $item->{multivolume}, $item->{stack},
3514 $item->{itemlost}, $item->{wthdrawn},
3515 $item->{paidfor}, $item->{'itemnotes'},
3516 $item->{'itemcallnumber'}, $item->{'notforloan'},
3517 $item->{'location'}, $cutterextra
3521 $sth = $dbh->prepare(
3522 "INSERT INTO items SET
3523 itemnumber = ?, biblionumber = ?,
3524 multivolumepart = ?,
3525 biblioitemnumber = ?, barcode = ?,
3526 booksellerid = ?, dateaccessioned = ?,
3527 homebranch = ?, holdingbranch = ?,
3528 price = ?, replacementprice = ?,
3529 replacementpricedate = NOW(), datelastseen = NOW(),
3530 multivolume = ?, stack = ?,
3531 itemlost = ?, wthdrawn = ?,
3532 paidfor = ?, itemnotes = ?,
3533 itemcallnumber = ?, notforloan = ?,
3539 $itemnumber, $item->{'biblionumber'},
3540 $item->{'multivolumepart'}, $item->{'biblioitemnumber'},
3541 $barcode, $item->{'booksellerid'},
3542 $item->{'dateaccessioned'}, $item->{'homebranch'},
3543 $item->{'holdingbranch'}, $item->{'price'},
3544 $item->{'replacementprice'}, $item->{multivolume},
3545 $item->{stack}, $item->{itemlost},
3546 $item->{wthdrawn}, $item->{paidfor},
3547 $item->{'itemnotes'}, $item->{'itemcallnumber'},
3548 $item->{'notforloan'}, $item->{'location'},
3552 if ( defined $sth->errstr ) {
3553 $error .= $sth->errstr;
3555 return ( $itemnumber, $error );
3558 =head2 _koha_modify_item
3562 _koha_modify_item( $dbh, $item, $op );
3568 sub _koha_modify_item {
3569 my ( $dbh, $item, $op ) = @_;
3570 $item->{'itemnum'} = $item->{'itemnumber'} unless $item->{'itemnum'};
3572 # if all we're doing is setting statuses, just update those and get out
3573 if ( $op eq "setstatus" ) {
3575 "UPDATE items SET itemlost=?,wthdrawn=?,binding=? WHERE itemnumber=?";
3577 $item->{'itemlost'}, $item->{'wthdrawn'},
3578 $item->{'binding'}, $item->{'itemnumber'}
3580 my $sth = $dbh->prepare($query);
3581 $sth->execute(@bind);
3585 ## Now calculate lccalnumber
3587 itemcalculator( $dbh, $item->{'bibitemnum'}, $item->{'itemcallnumber'} );
3589 my $query = "UPDATE items SET
3590 barcode=?,itemnotes=?,itemcallnumber=?,notforloan=?,location=?,multivolumepart=?,multivolume=?,stack=?,wthdrawn=?,holdingbranch=?,homebranch=?,cutterextra=?, onloan=?, binding=?";
3593 $item->{'barcode'}, $item->{'notes'},
3594 $item->{'itemcallnumber'}, $item->{'notforloan'},
3595 $item->{'location'}, $item->{multivolumepart},
3596 $item->{multivolume}, $item->{stack},
3597 $item->{wthdrawn}, $item->{holdingbranch},
3598 $item->{homebranch}, $cutterextra,
3599 $item->{onloan}, $item->{binding}
3601 if ( $item->{'lost'} ne '' ) {
3603 "update items set biblioitemnumber=?,barcode=?,itemnotes=?,homebranch=?,
3604 itemlost=?,wthdrawn=?,itemcallnumber=?,notforloan=?,
3605 location=?,multivolumepart=?,multivolume=?,stack=?,wthdrawn=?,holdingbranch=?,cutterextra=?,onloan=?, binding=?";
3607 $item->{'bibitemnum'}, $item->{'barcode'},
3608 $item->{'notes'}, $item->{'homebranch'},
3609 $item->{'lost'}, $item->{'wthdrawn'},
3610 $item->{'itemcallnumber'}, $item->{'notforloan'},
3611 $item->{'location'}, $item->{multivolumepart},
3612 $item->{multivolume}, $item->{stack},
3613 $item->{wthdrawn}, $item->{holdingbranch},
3614 $cutterextra, $item->{onloan},
3617 if ( $item->{homebranch} ) {
3618 $query .= ",homebranch=?";
3619 push @bind, $item->{homebranch};
3621 if ( $item->{holdingbranch} ) {
3622 $query .= ",holdingbranch=?";
3623 push @bind, $item->{holdingbranch};
3626 $query .= " where itemnumber=?";
3627 push @bind, $item->{'itemnum'};
3628 if ( $item->{'replacement'} ne '' ) {
3629 $query =~ s/ where/,replacementprice='$item->{'replacement'}' where/;
3631 my $sth = $dbh->prepare($query);
3632 $sth->execute(@bind);
3636 =head2 _koha_delete_biblio
3640 $error = _koha_delete_biblio($dbh,$biblionumber);
3642 Internal sub for deleting from biblio table -- also saves to deletedbiblio
3644 C<$dbh> - the database handle
3645 C<$biblionumber> - the biblionumber of the biblio to be deleted
3651 # FIXME: add error handling
3653 sub _koha_delete_biblio {
3654 my ( $dbh, $biblionumber ) = @_;
3656 # get all the data for this biblio
3657 my $sth = $dbh->prepare("SELECT * FROM biblio WHERE biblionumber=?");
3658 $sth->execute($biblionumber);
3660 if ( my $data = $sth->fetchrow_hashref ) {
3662 # save the record in deletedbiblio
3663 # find the fields to save
3664 my $query = "INSERT INTO deletedbiblio SET ";
3666 foreach my $temp ( keys %$data ) {
3667 $query .= "$temp = ?,";
3668 push( @bind, $data->{$temp} );
3671 # replace the last , by ",?)"
3673 my $bkup_sth = $dbh->prepare($query);
3674 $bkup_sth->execute(@bind);
3678 my $del_sth = $dbh->prepare("DELETE FROM biblio WHERE biblionumber=?");
3679 $del_sth->execute($biblionumber);
3686 =head2 _koha_delete_biblioitems
3690 $error = _koha_delete_biblioitems($dbh,$biblioitemnumber);
3692 Internal sub for deleting from biblioitems table -- also saves to deletedbiblioitems
3694 C<$dbh> - the database handle
3695 C<$biblionumber> - the biblioitemnumber of the biblioitem to be deleted
3701 # FIXME: add error handling
3703 sub _koha_delete_biblioitems {
3704 my ( $dbh, $biblioitemnumber ) = @_;
3706 # get all the data for this biblioitem
3708 $dbh->prepare("SELECT * FROM biblioitems WHERE biblioitemnumber=?");
3709 $sth->execute($biblioitemnumber);
3711 if ( my $data = $sth->fetchrow_hashref ) {
3713 # save the record in deletedbiblioitems
3714 # find the fields to save
3715 my $query = "INSERT INTO deletedbiblioitems SET ";
3717 foreach my $temp ( keys %$data ) {
3718 $query .= "$temp = ?,";
3719 push( @bind, $data->{$temp} );
3722 # replace the last , by ",?)"
3724 my $bkup_sth = $dbh->prepare($query);
3725 $bkup_sth->execute(@bind);
3728 # delete the biblioitem
3730 $dbh->prepare("DELETE FROM biblioitems WHERE biblioitemnumber=?");
3731 $del_sth->execute($biblioitemnumber);
3738 =head2 _koha_delete_item
3742 _koha_delete_item( $dbh, $itemnum );
3744 Internal function to delete an item record from the koha tables
3750 sub _koha_delete_item {
3751 my ( $dbh, $itemnum ) = @_;
3753 my $sth = $dbh->prepare("select * from items where itemnumber=?");
3754 $sth->execute($itemnum);
3755 my $data = $sth->fetchrow_hashref;
3757 my $query = "Insert into deleteditems set ";
3759 foreach my $temp ( keys %$data ) {
3760 $query .= "$temp = ?,";
3761 push( @bind, $data->{$temp} );
3766 $sth = $dbh->prepare($query);
3767 $sth->execute(@bind);
3769 $sth = $dbh->prepare("Delete from items where itemnumber=?");
3770 $sth->execute($itemnum);
3774 =head1 UNEXPORTED FUNCTIONS
3780 $lc = calculatelc($classification);
3787 my ($classification) = @_;
3788 $classification =~ s/^\s+|\s+$//g;
3793 for ( $i = 0 ; $i < length($classification) ; $i++ ) {
3794 my $c = ( substr( $classification, $i, 1 ) );
3795 if ( $c ge '0' && $c le '9' ) {
3797 $lc2 = substr( $classification, $i );
3801 $lc1 .= substr( $classification, $i, 1 );
3806 my $other = length($lc1);
3813 for ( 1 .. ( 4 - $other ) ) {
3822 ##Find the decimal part of $lc2
3823 my $pos = index( $lc2, "." );
3824 if ( $pos < 0 ) { $pos = length($lc2); }
3825 if ( $pos >= 0 && $pos < 5 ) {
3826 ##Pad lc2 with zeros to create a 5digit decimal needed in marc record to sort as numeric
3828 for ( 1 .. ( 5 - $pos ) ) {
3832 $lc2 = $extras . $lc2;
3833 return ( $lc1 . $lc2 );
3836 =head2 itemcalculator
3840 $cutterextra = itemcalculator( $dbh, $biblioitem, $callnumber );
3846 sub itemcalculator {
3847 my ( $dbh, $biblioitem, $callnumber ) = @_;
3850 "select classification, subclass from biblioitems where biblioitemnumber=?"
3853 $sth->execute($biblioitem);
3854 my ( $classification, $subclass ) = $sth->fetchrow;
3855 my $all = $classification . " " . $subclass;
3856 my $total = length($all);
3857 my $cutterextra = substr( $callnumber, $total - 1 );
3859 return $cutterextra;
3862 =head2 ModBiblioMarc
3864 &ModBiblioMarc($newrec,$biblionumber,$frameworkcode);
3866 Add MARC data for a biblio to koha
3868 Function exported, but should NOT be used, unless you really know what you're doing
3874 # pass the MARC::Record to this function, and it will create the records in the marc field
3875 my ( $record, $biblionumber, $frameworkcode ) = @_;
3876 my $dbh = C4::Context->dbh;
3877 my @fields = $record->fields();
3878 if ( !$frameworkcode ) {
3879 $frameworkcode = "";
3882 $dbh->prepare("UPDATE biblio SET frameworkcode=? WHERE biblionumber=?");
3883 $sth->execute( $frameworkcode, $biblionumber );
3885 my $encoding = C4::Context->preference("marcflavour");
3887 # deal with UNIMARC field 100 (encoding) : create it if needed & set encoding to unicode
3888 if ( $encoding eq "UNIMARC" ) {
3890 if ( length($record->subfield( 100, "a" )) == 35 ) {
3891 $string = $record->subfield( 100, "a" );
3892 my $f100 = $record->field(100);
3893 $record->delete_field($f100);
3896 $string = POSIX::strftime( "%Y%m%d", localtime );
3898 $string = sprintf( "%-*s", 35, $string );
3900 substr( $string, 22, 6, "frey50" );
3901 unless ( $record->subfield( 100, "a" ) ) {
3902 $record->insert_grouped_field(
3903 MARC::Field->new( 100, "", "", "a" => $string ) );
3906 ModZebra($biblionumber,"specialUpdate","biblioserver",$record);
3909 "update biblioitems set marc=?,marcxml=? where biblionumber=?");
3910 $sth->execute( $record->as_usmarc(), $record->as_xml_record($encoding),
3913 return $biblionumber;
3916 =head2 AddItemInMarc
3920 $newbiblionumber = AddItemInMarc( $record, $biblionumber, $frameworkcode );
3922 Add an item in a MARC record and save the MARC record
3924 Function exported, but should NOT be used, unless you really know what you're doing
3932 # pass the MARC::Record to this function, and it will create the records in the marc tables
3933 my ( $record, $biblionumber, $frameworkcode ) = @_;
3934 my $newrec = &GetMarcBiblio($biblionumber);
3937 my @fields = $record->fields();
3938 foreach my $field (@fields) {
3939 $newrec->append_fields($field);
3942 # FIXME: should we be making sure the biblionumbers are the same?
3943 my $newbiblionumber =
3944 &ModBiblioMarc( $newrec, $biblionumber, $frameworkcode );
3945 return $newbiblionumber;
3948 =head2 z3950_extended_services
3950 z3950_extended_services($serviceType,$serviceOptions,$record);
3952 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.
3954 C<$serviceType> one of: itemorder,create,drop,commit,update,xmlupdate
3956 C<$serviceOptions> a has of key/value pairs. For instance, if service_type is 'update', $service_options should contain:
3958 action => update action, one of specialUpdate, recordInsert, recordReplace, recordDelete, elementUpdate.
3962 recordidOpaque => Opaque Record ID (user supplied) or recordidNumber => Record ID number (system number).
3963 syntax => the record syntax (transfer syntax)
3964 databaseName = Database from connection object
3966 To set serviceOptions, call set_service_options($serviceType)
3968 C<$record> the record, if one is needed for the service type
3970 A record should be in XML. You can convert it to XML from MARC by running it through marc2xml().
3974 sub z3950_extended_services {
3975 my ( $server, $serviceType, $action, $serviceOptions ) = @_;
3977 # get our connection object
3978 my $Zconn = C4::Context->Zconn( $server, 0, 1 );
3980 # create a new package object
3981 my $Zpackage = $Zconn->package();
3984 $Zpackage->option( action => $action );
3986 if ( $serviceOptions->{'databaseName'} ) {
3987 $Zpackage->option( databaseName => $serviceOptions->{'databaseName'} );
3989 if ( $serviceOptions->{'recordIdNumber'} ) {
3991 recordIdNumber => $serviceOptions->{'recordIdNumber'} );
3993 if ( $serviceOptions->{'recordIdOpaque'} ) {
3995 recordIdOpaque => $serviceOptions->{'recordIdOpaque'} );
3998 # this is an ILL request (Zebra doesn't support it, but Koha could eventually)
3999 #if ($serviceType eq 'itemorder') {
4000 # $Zpackage->option('contact-name' => $serviceOptions->{'contact-name'});
4001 # $Zpackage->option('contact-phone' => $serviceOptions->{'contact-phone'});
4002 # $Zpackage->option('contact-email' => $serviceOptions->{'contact-email'});
4003 # $Zpackage->option('itemorder-item' => $serviceOptions->{'itemorder-item'});
4006 if ( $serviceOptions->{record} ) {
4007 $Zpackage->option( record => $serviceOptions->{record} );
4009 # can be xml or marc
4010 if ( $serviceOptions->{'syntax'} ) {
4011 $Zpackage->option( syntax => $serviceOptions->{'syntax'} );
4015 # send the request, handle any exception encountered
4016 eval { $Zpackage->send($serviceType) };
4017 if ( $@ && $@->isa("ZOOM::Exception") ) {
4018 return "error: " . $@->code() . " " . $@->message() . "\n";
4021 # free up package resources
4022 $Zpackage->destroy();
4025 =head2 set_service_options
4027 my $serviceOptions = set_service_options($serviceType);
4029 C<$serviceType> itemorder,create,drop,commit,update,xmlupdate
4031 Currently, we only support 'create', 'commit', and 'update'. 'drop' support will be added as soon as Zebra supports it.
4035 sub set_service_options {
4036 my ($serviceType) = @_;
4039 # FIXME: This needs to be an OID ... if we ever need 'syntax' this sub will need to change
4040 # $serviceOptions->{ 'syntax' } = ''; #zebra doesn't support syntaxes other than xml
4042 if ( $serviceType eq 'commit' ) {
4046 if ( $serviceType eq 'create' ) {
4050 if ( $serviceType eq 'drop' ) {
4051 die "ERROR: 'drop' not currently supported (by Zebra)";
4053 return $serviceOptions;
4056 =head2 GetItemsCount
4058 $count = &GetItemsCount( $biblionumber);
4059 this function return count of item with $biblionumber
4063 my ( $biblionumber ) = @_;
4064 my $dbh = C4::Context->dbh;
4065 my $query = qq|SELECT count(*)
4067 WHERE biblionumber=?|;
4068 my $sth = $dbh->prepare($query);
4069 $sth->execute($biblionumber);
4070 my $count = $sth->fetchrow;
4075 END { } # module clean-up code here (global destructor)
4083 Koha Developement team <info@koha.org>
4085 Paul POULAIN paul.poulain@free.fr
4087 Joshua Ferraro jmf@liblime.com
4093 # Revision 1.221 2007/07/31 16:01:11 toins
4094 # Some new functions.
4095 # TransformHTMLtoMarc rewrited.
4097 # Revision 1.220 2007/07/20 15:43:16 hdl
4098 # Bug Fixing GetMarcSubjects.
4099 # Links parameters were mixed.
4101 # Revision 1.218 2007/07/19 07:40:08 hdl
4102 # Adding selection by location for inventory
4104 # Revision 1.217 2007/07/03 13:47:44 tipaul
4105 # fixing some display bugs (itemtype not properly returned and a html table bug that makes items appear strangely
4107 # Revision 1.216 2007/07/03 09:40:58 tipaul
4108 # return itemtype description properly
4110 # Revision 1.215 2007/07/03 09:33:05 tipaul
4111 # 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
4113 # Revision 1.214 2007/07/02 09:13:22 tipaul
4114 # 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
4116 # Revision 1.213 2007/06/25 15:01:45 tipaul
4117 # bugfixes on unimarc 100 handling (the field used for encoding)
4119 # Revision 1.212 2007/06/15 13:44:44 tipaul
4120 # some fixes (and only fixes)
4122 # Revision 1.211 2007/06/15 09:40:06 toins
4123 # do not get $3 $4 and $5 on GetMarcSubjects GetMarcAuthors on unimarc flavour.
4125 # Revision 1.210 2007/06/13 13:03:34 toins
4126 # removing warn compilation.
4128 # Revision 1.209 2007/05/23 16:19:40 tipaul
4129 # various bugfixes (minor) and french translation updated
4131 # Revision 1.208 2007/05/22 09:13:54 tipaul
4132 # Bugfixes & improvements (various and minor) :
4133 # - updating templates to have tmpl_process3.pl running without any errors
4134 # - adding a drupal-like css for prog templates (with 3 small images)
4135 # - fixing some bugs in circulation & other scripts
4136 # - updating french translation
4137 # - fixing some typos in templates
4139 # Revision 1.207 2007/05/22 08:51:19 hdl
4140 # Changing GetMarcStructure signature.
4141 # Deleting first parameter $dbh
4143 # Revision 1.206 2007/05/21 08:44:17 btoumi
4144 # add security when u delete biblio :
4145 # u must delete linked items before delete biblio
4147 # Revision 1.205 2007/05/11 16:04:03 btoumi
4149 # problem in displayed label link with subject in detail.tmpl
4150 # ex: label random => rdom
4152 # Revision 1.204 2007/05/10 14:45:15 tipaul
4154 # - support for authorities
4155 # - some bugfixes in ordering and "CCL" parsing
4156 # - support for authorities <=> biblios walking
4158 # Seems I can do what I want now, so I consider its done, except for bugfixes that will be needed i m sure !
4160 # Revision 1.203 2007/05/03 15:16:02 tipaul
4161 # BUGFIX for : NoZebra
4162 # - NoZebra features : seems they work fine now (adding, modifying, deleting)
4163 # - Biblio edition major bugfix : before this commit editing a biblio resulted in an item removal in marcxml field
4165 # Revision 1.202 2007/05/02 16:44:31 tipaul
4166 # NoZebra SQL index management :
4167 # * adding 3 subs in Biblio.pm
4168 # - GetNoZebraIndexes, that get the index structure in a new systempreference (added with this commit)
4169 # - _DelBiblioNoZebra, that retrieve all index entries for a biblio and remove in a variable the biblio reference
4170 # - _AddBiblioNoZebra, that add index entries for a biblio.
4171 # 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).
4172 # I think the code has to be more deeply tested, but it works at least partially.
4174 # Revision 1.201 2007/04/27 14:00:49 hdl
4175 # Removing $dbh from GetMarcFromKohaField (dbh is not used in this function.)
4177 # Revision 1.200 2007/04/25 16:26:42 tipaul
4178 # 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 :
4179 # - add nozebra table management on biblio editing
4180 # - the index table content is hardcoded. I still have to add some specific systempref to let the library update it
4181 # - manage pagination (next/previous)
4184 # - NZgetRecords : has exactly the same API & returns as zebra getQuery, except that some parameters are unused
4185 # - search & sort works quite good
4186 # - CQL parser is better that what I thought I could do : title="harry and sally" and publicationyear>2000 not itemtype=LIVR should work fine
4188 # Revision 1.199 2007/04/24 09:07:53 tipaul
4189 # moving dotransfer to Biblio.pm::ModItemTransfer + some CheckReserves fixes
4191 # Revision 1.198 2007/04/23 15:21:17 tipaul
4192 # renaming currenttransfers to transferstoreceive
4194 # Revision 1.197 2007/04/18 17:00:14 tipaul
4195 # removing all useless %env / $env
4197 # Revision 1.196 2007/04/17 08:48:00 tipaul
4198 # circulation cleaning continued: bufixing
4200 # Revision 1.195 2007/04/04 16:46:22 tipaul
4201 # HUGE COMMIT : code cleaning circulation.
4203 # some stuff to do, i'll write a mail on koha-devel NOW !
4205 # Revision 1.194 2007/03/30 12:00:42 tipaul
4206 # 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...
4208 # Revision 1.193 2007/03/29 16:45:53 tipaul
4209 # Code cleaning of Biblio.pm (continued)
4211 # All subs have be cleaned :
4214 # - reordering Biblio.pm completly
4215 # - using only naming conventions
4217 # Seems to have broken nothing, but it still has to be heavily tested.
4218 # Note that Biblio.pm is now much more efficient than previously & probably more reliable as well.
4220 # Revision 1.192 2007/03/29 13:30:31 tipaul
4222 # == Biblio.pm cleaning (useless) ==
4223 # * some sub declaration dropped
4224 # * removed modbiblio sub
4225 # * removed moditem sub
4226 # * removed newitems. It was used only in finishrecieve. Replaced by a TransformKohaToMarc+AddItem, that is better.
4227 # * removed MARCkoha2marcItem
4228 # * removed MARCdelsubfield declaration
4229 # * removed MARCkoha2marcBiblio
4231 # == Biblio.pm cleaning (naming conventions) ==
4232 # * MARCgettagslib renamed to GetMarcStructure
4233 # * MARCgetitems renamed to GetMarcItem
4234 # * MARCfind_frameworkcode renamed to GetFrameworkCode
4235 # * MARCmarc2koha renamed to TransformMarcToKoha
4236 # * MARChtml2marc renamed to TransformHtmlToMarc
4237 # * MARChtml2xml renamed to TranformeHtmlToXml
4238 # * zebraop renamed to ModZebra
4241 # * removing MARC=OFF related scripts (in cataloguing directory)
4242 # * removed checkitems (function related to MARC=off feature, that is completly broken in head. If someone want to reintroduce it, hard work coming...)
4243 # * removed getitemsbybiblioitem (used only by MARC=OFF scripts, that is removed as well)
4245 # Revision 1.191 2007/03/29 09:42:13 tipaul
4246 # adding default value new feature into cataloguing. The system (definition) part has already been added by toins
4248 # Revision 1.190 2007/03/29 08:45:19 hdl
4249 # Deleting ignore_errors(1) pour MARC::Charset
4251 # Revision 1.189 2007/03/28 10:39:16 hdl
4252 # removing $dbh as a parameter in AuthoritiesMarc functions
4253 # And reporting all differences into the scripts taht relies on those functions.