just reindent
[koha.git] / C4 / Biblio.pm
1 package C4::Biblio;
2
3 # Copyright 2000-2002 Katipo Communications
4 #
5 # This file is part of Koha.
6 #
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
10 # version.
11 #
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.
15 #
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
19
20 use strict;
21
22 require Exporter;
23 use C4::Context;
24 use MARC::Record;
25 use MARC::File::USMARC;
26 use MARC::File::XML;
27 use ZOOM;
28 use C4::Koha;
29 use C4::Date;
30 use utf8;
31 use C4::Log; # logaction
32
33 use vars qw($VERSION @ISA @EXPORT);
34
35 # set the version for version checking
36 $VERSION = do { my @v = '$Revision$' =~ /\d+/g; shift(@v).".".join( "_", map { sprintf "%03d", $_ } @v ); };
37
38 @ISA = qw( Exporter );
39
40 # EXPORTED FUNCTIONS.
41
42 # to add biblios or items
43 push @EXPORT, qw( &AddBiblio &AddItem );
44
45 # to get something
46 push @EXPORT, qw(
47   &GetBiblio
48   &GetBiblioData
49   &GetBiblioItemData
50   &GetBiblioItemInfosOf
51   &GetBiblioItemByBiblioNumber
52   &GetBiblioFromItemNumber
53   
54   &GetMarcItem
55   &GetItem
56   &GetItemInfosOf
57   &GetItemStatus
58   &GetItemLocation
59   &GetLostItems
60   &GetItemsForInventory
61   &GetItemsCount
62
63   &GetMarcNotes
64   &GetMarcSubjects
65   &GetMarcBiblio
66   &GetMarcAuthors
67   &GetMarcSeries
68
69   &GetItemsInfo
70   &GetItemnumberFromBarcode
71   &get_itemnumbers_of
72   &GetXmlBiblio
73
74   &GetAuthorisedValueDesc
75   &GetMarcStructure
76   &GetMarcFromKohaField
77   &GetFrameworkCode
78   &TransformKohaToMarc
79 );
80
81 # To modify something
82 push @EXPORT, qw(
83   &ModBiblio
84   &ModItem
85   &ModItemTransfer
86   &ModBiblioframework
87   &ModZebra
88   &ModItemInMarc
89   &ModItemInMarconefield
90   &ModDateLastSeen
91 );
92
93 # To delete something
94 push @EXPORT, qw(
95   &DelBiblio
96   &DelItem
97 );
98
99 # Internal functions
100 # those functions are exported but should not be used
101 # they are usefull is few circumstances, so are exported.
102 # but don't use them unless you're a core developer ;-)
103 push @EXPORT, qw(
104   &ModBiblioMarc
105   &AddItemInMarc
106   &calculatelc
107   &itemcalculator
108 );
109
110 # Others functions
111 push @EXPORT, qw(
112   &TransformMarcToKoha
113   &TransformHtmlToMarc
114   &TransformHtmlToXml
115   &PrepareItemrecordDisplay
116   &char_decode
117   &GetNoZebraIndexes
118 );
119
120 =head1 NAME
121
122 C4::Biblio - cataloging management functions
123
124 =head1 DESCRIPTION
125
126 Biblio.pm contains functions for managing storage and editing of bibliographic data within Koha. Most of the functions in this module are used for cataloging records: adding, editing, or removing biblios, biblioitems, or items. Koha's stores bibliographic information in three places:
127
128 =over 4
129
130 =item 1. in the biblio,biblioitems,items, etc tables, which are limited to a one-to-one mapping to underlying MARC data
131
132 =item 2. as raw MARC in the Zebra index and storage engine
133
134 =item 3. as raw MARC the biblioitems.marc and biblioitems.marcxml
135
136 =back
137
138 In the 3.0 version of Koha, the authoritative record-level information is in biblioitems.marcxml
139
140 Because the data isn't completely normalized there's a chance for information to get out of sync. The design choice to go with a un-normalized schema was driven by performance and stability concerns. However, if this occur, it can be considered as a bug : The API is (or should be) complete & the only entry point for all biblio/items managements.
141
142 =over 4
143
144 =item 1. Compared with MySQL, Zebra is slow to update an index for small data changes -- especially for proc-intensive operations like circulation
145
146 =item 2. Zebra's index has been known to crash and a backup of the data is necessary to rebuild it in such cases
147
148 =back
149
150 Because of this design choice, the process of managing storage and editing is a bit convoluted. Historically, Biblio.pm's grown to an unmanagable size and as a result we have several types of functions currently:
151
152 =over 4
153
154 =item 1. Add*/Mod*/Del*/ - high-level external functions suitable for being called from external scripts to manage the collection
155
156 =item 2. _koha_* - low-level internal functions for managing the koha tables
157
158 =item 3. Marc management function : as the MARC record is stored in biblioitems.marc(xml), some subs dedicated to it's management are in this package. They should be used only internally by Biblio.pm, the only official entry points being AddBiblio, AddItem, ModBiblio, ModItem.
159
160 =item 4. Zebra functions used to update the Zebra index
161
162 =item 5. internal helper functions such as char_decode, checkitems, etc. Some of these probably belong in Koha.pm
163
164 =back
165
166 The MARC record (in biblioitems.marcxml) contains the complete marc record, including items. It also contains the biblionumber. That is the reason why it is not stored directly by AddBiblio, with all other fields . To save a biblio, we need to :
167
168 =over 4
169
170 =item 1. save datas in biblio and biblioitems table, that gives us a biblionumber and a biblioitemnumber
171
172 =item 2. add the biblionumber and biblioitemnumber into the MARC records
173
174 =item 3. save the marc record
175
176 =back
177
178 When dealing with items, we must :
179
180 =over 4
181
182 =item 1. save the item in items table, that gives us an itemnumber
183
184 =item 2. add the itemnumber to the item MARC field
185
186 =item 3. overwrite the MARC record (with the added item) into biblioitems.marc(xml)
187
188 When modifying a biblio or an item, the behaviour is quite similar.
189
190 =back
191
192 =head1 EXPORTED FUNCTIONS
193
194 =head2 AddBiblio
195
196 =over 4
197
198 ($biblionumber,$biblioitemnumber) = AddBiblio($record,$frameworkcode);
199 Exported function (core API) for adding a new biblio to koha.
200
201 =back
202
203 =cut
204
205 sub AddBiblio {
206     my ( $record, $frameworkcode ) = @_;
207     my $biblionumber;
208     my $biblioitemnumber;
209     my $dbh = C4::Context->dbh;
210     # transform the data into koha-table style data
211     my $olddata = TransformMarcToKoha( $dbh, $record, $frameworkcode );
212     $biblionumber = _koha_add_biblio( $dbh, $olddata, $frameworkcode );
213     $olddata->{'biblionumber'} = $biblionumber;
214     $biblioitemnumber = _koha_add_biblioitem( $dbh, $olddata );
215
216     # we must add bibnum and bibitemnum in MARC::Record...
217     # we build the new field with biblionumber and biblioitemnumber
218     # we drop the original field
219     # we add the new builded field.
220     ( my $biblio_tag, my $biblio_subfield ) = GetMarcFromKohaField("biblio.biblionumber",$frameworkcode);
221     ( my $biblioitem_tag, my $biblioitem_subfield ) = GetMarcFromKohaField("biblioitems.biblioitemnumber",$frameworkcode);
222
223     my $newfield;
224
225     # biblionumber & biblioitemnumber are in different fields
226     if ( $biblio_tag != $biblioitem_tag ) {
227
228         # deal with biblionumber
229         if ( $biblio_tag < 10 ) {
230             $newfield = MARC::Field->new( $biblio_tag, $biblionumber );
231         }
232         else {
233             $newfield =
234               MARC::Field->new( $biblio_tag, '', '',
235                 "$biblio_subfield" => $biblionumber );
236         }
237
238         # drop old field and create new one...
239         my $old_field = $record->field($biblio_tag);
240         $record->delete_field($old_field);
241         $record->append_fields($newfield);
242
243         # deal with biblioitemnumber
244         if ( $biblioitem_tag < 10 ) {
245             $newfield = MARC::Field->new( $biblioitem_tag, $biblioitemnumber, );
246         }
247         else {
248             $newfield =
249               MARC::Field->new( $biblioitem_tag, '', '',
250                 "$biblioitem_subfield" => $biblioitemnumber, );
251         }
252         # drop old field and create new one...
253         $old_field = $record->field($biblioitem_tag);
254         $record->delete_field($old_field);
255         $record->insert_fields_ordered($newfield);
256
257 # biblionumber & biblioitemnumber are in the same field (can't be <10 as fields <10 have only 1 value)
258     }
259     else {
260         my $newfield = MARC::Field->new(
261             $biblio_tag, '', '',
262             "$biblio_subfield" => $biblionumber,
263             "$biblioitem_subfield" => $biblioitemnumber
264         );
265
266         # drop old field and create new one...
267         my $old_field = $record->field($biblio_tag);
268         $record->delete_field($old_field);
269         $record->insert_fields_ordered($newfield);
270     }
271
272     # now add the record
273     $biblionumber = ModBiblioMarc( $record, $biblionumber, $frameworkcode );
274       
275     &logaction(C4::Context->userenv->{'number'},"CATALOGUING","ADD",$biblionumber,"biblio") 
276         if C4::Context->preference("CataloguingLog");
277       
278     return ( $biblionumber, $biblioitemnumber );
279 }
280
281 =head2 AddItem
282
283 =over
284
285 $biblionumber = AddItem( $record, $biblionumber)
286 Exported function (core API) for adding a new item to Koha
287
288 =back
289
290 =cut
291
292 sub AddItem {
293     my ( $record, $biblionumber ) = @_;
294     my $dbh = C4::Context->dbh;
295     
296     # add item in old-DB
297     my $frameworkcode = GetFrameworkCode( $biblionumber );
298     my $item = &TransformMarcToKoha( $dbh, $record, $frameworkcode );
299
300     # needs old biblionumber and biblioitemnumber
301     $item->{'biblionumber'} = $biblionumber;
302     my $sth =
303       $dbh->prepare(
304         "select biblioitemnumber,itemtype from biblioitems where biblionumber=?"
305       );
306     $sth->execute( $item->{'biblionumber'} );
307     my $itemtype;
308     ( $item->{'biblioitemnumber'}, $itemtype ) = $sth->fetchrow;
309     $sth =
310       $dbh->prepare(
311         "select notforloan from itemtypes where itemtype='$itemtype'");
312     $sth->execute();
313     my $notforloan = $sth->fetchrow;
314     ##Change the notforloan field if $notforloan found
315     if ( $notforloan > 0 ) {
316         $item->{'notforloan'} = $notforloan;
317         &MARCitemchange( $record, "items.notforloan", $notforloan );
318     }
319     if ( !$item->{'dateaccessioned'} || $item->{'dateaccessioned'} eq '' ) {
320
321         # find today's date
322         my ( $sec, $min, $hour, $mday, $mon, $year, $wday, $yday, $isdst ) =
323           localtime(time);
324         $year += 1900;
325         $mon  += 1;
326         my $date =
327           "$year-" . sprintf( "%0.2d", $mon ) . "-" . sprintf( "%0.2d", $mday );
328         $item->{'dateaccessioned'} = $date;
329         &MARCitemchange( $record, "items.dateaccessioned", $date );
330     }
331     my ( $itemnumber, $error ) =
332       &_koha_new_items( $dbh, $item, $item->{barcode} );
333
334     # add itemnumber to MARC::Record before adding the item.
335     $sth =
336       $dbh->prepare(
337 "select tagfield,tagsubfield from marc_subfield_structure where frameworkcode=? and kohafield=?"
338       );
339     &TransformKohaToMarcOneField( $sth, $record, "items.itemnumber", $itemnumber,
340         $frameworkcode );
341
342     # add the item
343     &AddItemInMarc( $record, $item->{'biblionumber'},$frameworkcode );
344     
345     &logaction(C4::Context->userenv->{'number'},"CATALOGUING","ADD",$itemnumber,"item") 
346         if C4::Context->preference("CataloguingLog");
347     
348     return ($item->{biblionumber}, $item->{biblioitemnumber},$itemnumber);
349 }
350
351 =head2 ModBiblio
352
353 =over
354
355 ModBiblio( $record,$biblionumber,$frameworkcode);
356 Exported function (core API) to modify a biblio
357
358 =back
359
360 =cut
361
362 sub ModBiblio {
363     my ( $record, $biblionumber, $frameworkcode ) = @_;
364     
365     if (C4::Context->preference("CataloguingLog")) {    
366         my $newrecord = GetMarcBiblio($biblionumber);
367         &logaction(C4::Context->userenv->{'number'},"CATALOGUING","MODIFY",$biblionumber,$newrecord->as_formatted) 
368     }
369     
370     my $dbh = C4::Context->dbh;
371     
372     $frameworkcode = "" unless $frameworkcode;
373
374     # get the items before and append them to the biblio before updating the record, atm we just have the biblio
375     my ( $itemtag, $itemsubfield ) = GetMarcFromKohaField("items.itemnumber",$frameworkcode);
376     my $oldRecord = GetMarcBiblio($biblionumber);
377     my @fields = $oldRecord->field($itemtag);
378     $record->append_fields(@fields);
379
380     # update the MARC record (that now contains biblio and items) with the new record data
381     &ModBiblioMarc($record, $biblionumber, $frameworkcode );
382
383     # load the koha-table data object
384     my $oldbiblio = TransformMarcToKoha( $dbh, $record, $frameworkcode );
385
386     # modify the other koha tables
387     $biblionumber = _koha_modify_biblio( $dbh, $oldbiblio );
388     _koha_modify_biblioitem( $dbh, $oldbiblio );
389
390     return 1;
391 }
392
393 =head2 ModItem
394
395 =over
396
397 Exported function (core API) for modifying an item in Koha.
398
399 =back
400
401 =cut
402
403 sub ModItem {
404     my ( $record, $biblionumber, $itemnumber, $delete, $new_item_hashref )
405       = @_;
406     
407     #logging
408     &logaction(C4::Context->userenv->{'number'},"CATALOGUING","MODIFY",$itemnumber,$record->as_formatted) 
409         if C4::Context->preference("CataloguingLog");
410       
411     my $dbh = C4::Context->dbh;
412     
413     # if we have a MARC record, we're coming from cataloging and so
414     # we do the whole routine: update the MARC and zebra, then update the koha
415     # tables
416     if ($record) {
417         my $frameworkcode = GetFrameworkCode( $biblionumber );
418         ModItemInMarc( $record, $biblionumber, $itemnumber, $frameworkcode );
419         my $olditem       = TransformMarcToKoha( $dbh, $record, $frameworkcode );
420         _koha_modify_item( $dbh, $olditem );
421         return $biblionumber;
422     }
423
424     # otherwise, we're just looking to modify something quickly
425     # (like a status) so we just update the koha tables
426     elsif ($new_item_hashref) {
427         _koha_modify_item( $dbh, $new_item_hashref );
428     }
429 }
430
431 sub ModItemTransfer {
432     my ( $itemnumber, $frombranch, $tobranch ) = @_;
433     
434     my $dbh = C4::Context->dbh;
435     
436     #new entry in branchtransfers....
437     my $sth = $dbh->prepare(
438         "INSERT INTO branchtransfers (itemnumber, frombranch, datesent, tobranch)
439         VALUES (?, ?, now(), ?)");
440     $sth->execute($itemnumber, $frombranch, $tobranch);
441     #update holdingbranch in items .....
442      $sth= $dbh->prepare(
443           "UPDATE items set holdingbranch = ? WHERE items.itemnumber = ?");
444     $sth->execute($tobranch,$itemnumber);
445     &ModDateLastSeen($itemnumber);
446     $sth = $dbh->prepare(
447         "SELECT biblionumber FROM items WHERE itemnumber=?"
448       );
449     $sth->execute($itemnumber);
450     while ( my ( $biblionumber ) = $sth->fetchrow ) {
451         &ModItemInMarconefield( $biblionumber, $itemnumber,
452             'items.holdingbranch', $tobranch );
453     }
454     return;
455 }
456
457 ##New sub to dotransfer in marc tables as well. Not exported -TG 10/04/2006
458 # sub domarctransfer {
459 #     my ( $dbh, $itemnumber ) = @_;
460 #     $itemnumber =~ s /\'//g;    ##itemnumber seems to come with quotes-TG
461 #     my $sth =
462 #       $dbh->prepare(
463 #         "select biblionumber,holdingbranch from items where itemnumber=$itemnumber"
464 #       );
465 #     $sth->execute();
466 #     while ( my ( $biblionumber, $holdingbranch ) = $sth->fetchrow ) {
467 #         &ModItemInMarconefield( $biblionumber, $itemnumber,
468 #             'items.holdingbranch', $holdingbranch );
469 #     }
470 #     return;
471 # }
472 =head2 ModBiblioframework
473
474 =over
475
476 ModBiblioframework($biblionumber,$frameworkcode);
477 Exported function to modify a biblio framework
478
479 =back
480
481 =cut
482
483 sub ModBiblioframework {
484     my ( $biblionumber, $frameworkcode ) = @_;
485     my $dbh = C4::Context->dbh;
486     my $sth =
487       $dbh->prepare(
488         "UPDATE biblio SET frameworkcode=? WHERE biblionumber=$biblionumber");
489     $sth->execute($frameworkcode);
490     return 1;
491 }
492
493 =head2 ModItemInMarconefield
494
495 =over
496
497 modify only 1 field in a MARC item (mainly used for holdingbranch, but could also be used for status modif - moving a book to "lost" on a long overdu for example)
498 &ModItemInMarconefield( $biblionumber, $itemnumber, $itemfield, $newvalue )
499
500 =back
501
502 =cut
503
504 sub ModItemInMarconefield {
505     my ( $biblionumber, $itemnumber, $itemfield, $newvalue ) = @_;
506     my $dbh = C4::Context->dbh;
507     if ( !defined $newvalue ) {
508         $newvalue = "";
509     }
510
511     my $record = GetMarcItem( $biblionumber, $itemnumber );
512     my ($tagfield, $tagsubfield) = GetMarcFromKohaField( $itemfield,'');
513     if ($tagfield && $tagsubfield) {
514         my $tag = $record->field($tagfield);
515         if ($tag) {
516 #             my $tagsubs = $record->field($tagfield)->subfield($tagsubfield);
517             $tag->update( $tagsubfield => $newvalue );
518             $record->delete_field($tag);
519             $record->insert_fields_ordered($tag);
520             &ModItemInMarc( $record, $biblionumber, $itemnumber, 0 );
521         }
522     }
523 }
524
525 =head2 ModItemInMarc
526
527 =over
528
529 &ModItemInMarc( $record, $biblionumber, $itemnumber )
530
531 =back
532
533 =cut
534
535 sub ModItemInMarc {
536     my ( $ItemRecord, $biblionumber, $itemnumber, $frameworkcode) = @_;
537     my $dbh = C4::Context->dbh;
538     
539     # get complete MARC record & replace the item field by the new one
540     my $completeRecord = GetMarcBiblio($biblionumber);
541     my ($itemtag,$itemsubfield) = GetMarcFromKohaField("items.itemnumber",$frameworkcode);
542     my $itemField = $ItemRecord->field($itemtag);
543     my @items = $completeRecord->field($itemtag);
544     foreach (@items) {
545         if ($_->subfield($itemsubfield) eq $itemnumber) {
546 #             $completeRecord->delete_field($_);
547             $_->replace_with($itemField);
548         }
549     }
550     # save the record
551     my $sth = $dbh->prepare("update biblioitems set marc=?,marcxml=?  where biblionumber=?");
552     $sth->execute( $completeRecord->as_usmarc(), $completeRecord->as_xml_record(),$biblionumber );
553     $sth->finish;
554     ModZebra($biblionumber,"specialUpdate","biblioserver",$completeRecord);
555 }
556
557 =head2 ModDateLastSeen
558
559 &ModDateLastSeen($itemnum)
560 Mark item as seen. Is called when an item is issued, returned or manually marked during inventory/stocktaking
561 C<$itemnum> is the item number
562
563 =cut
564
565 sub ModDateLastSeen {
566     my ($itemnum) = @_;
567     my $dbh       = C4::Context->dbh;
568     my $sth       =
569       $dbh->prepare(
570           "update items set itemlost=0, datelastseen  = now() where items.itemnumber = ?"
571       );
572     $sth->execute($itemnum);
573     return;
574 }
575 =head2 DelBiblio
576
577 =over
578
579 my $error = &DelBiblio($dbh,$biblionumber);
580 Exported function (core API) for deleting a biblio in koha.
581 Deletes biblio record from Zebra and Koha tables (biblio,biblioitems,items)
582 Also backs it up to deleted* tables
583 Checks to make sure there are not issues on any of the items
584 return:
585 C<$error> : undef unless an error occurs
586
587 =back
588
589 =cut
590
591 sub DelBiblio {
592     my ( $biblionumber ) = @_;
593     my $dbh = C4::Context->dbh;
594     my $error;    # for error handling
595
596     # First make sure there are no items with issues are still attached
597     my $sth =
598       $dbh->prepare(
599         "SELECT itemnumber FROM items WHERE biblionumber=?");
600     $sth->execute($biblionumber);
601     while ( my $itemnumber = $sth->fetchrow ) {
602         my $issues = GetItemIssues($itemnumber);
603         foreach my $issue (@$issues) {
604             if (   ( $issue->{date_due} )
605                 && ( $issue->{date_due} ne "Available" ) )
606             {
607
608 #FIXME: we need a status system in Biblio like in Circ to return standard codes and messages
609 # instead of hard-coded strings
610                 $error .=
611 "Item is checked out to a patron -- you must return it before deleting the Biblio";
612             }
613         }
614     }
615     return $error if $error;
616
617     # Delete in Zebra. Be careful NOT to move this line after _koha_delete_biblio
618     # for at least 2 reasons :
619     # - we need to read the biblio if NoZebra is set (to remove it from the indexes
620     # - if something goes wrong, the biblio may be deleted from Koha but not from zebra
621     #   and we would have no way to remove it (except manually in zebra, but I bet it would be very hard to handle the problem)
622     ModZebra($biblionumber, "delete_record", "biblioserver", undef);
623
624     # delete biblio from Koha tables and save in deletedbiblio
625     $error = &_koha_delete_biblio( $dbh, $biblionumber );
626
627     # delete biblioitems and items from Koha tables and save in deletedbiblioitems,deleteditems
628     $sth =
629       $dbh->prepare(
630         "SELECT biblioitemnumber FROM biblioitems WHERE biblionumber=?");
631     $sth->execute($biblionumber);
632     while ( my $biblioitemnumber = $sth->fetchrow ) {
633
634         # delete this biblioitem
635         $error = &_koha_delete_biblioitems( $dbh, $biblioitemnumber );
636         return $error if $error;
637
638         # delete items
639         my $items_sth =
640           $dbh->prepare(
641             "SELECT itemnumber FROM items WHERE biblioitemnumber=?");
642         $items_sth->execute($biblioitemnumber);
643         while ( my $itemnumber = $items_sth->fetchrow ) {
644             $error = &_koha_delete_item( $dbh, $itemnumber );
645             return $error if $error;
646         }
647     }
648     &logaction(C4::Context->userenv->{'number'},"CATALOGUING","DELETE",$biblionumber,"") 
649         if C4::Context->preference("CataloguingLog");
650     return;
651 }
652
653 =head2 DelItem
654
655 =over
656
657 DelItem( $biblionumber, $itemnumber );
658 Exported function (core API) for deleting an item record in Koha.
659
660 =back
661
662 =cut
663
664 sub DelItem {
665     my ( $biblionumber, $itemnumber ) = @_;
666     my $dbh = C4::Context->dbh;
667     &_koha_delete_item( $dbh, $itemnumber );
668     # get the MARC record
669     my $record = GetMarcBiblio($biblionumber);
670     my $frameworkcode = GetFrameworkCode($biblionumber);
671
672     # backup the record
673     my $copy2deleted =
674       $dbh->prepare("UPDATE deleteditems SET marc=? WHERE itemnumber=?");
675     $copy2deleted->execute( $record->as_usmarc(), $itemnumber );
676
677     #search item field code
678     my ( $itemtag, $itemsubfield ) = GetMarcFromKohaField("items.itemnumber",$frameworkcode);
679     my @fields = $record->field($itemtag);
680     # delete the item specified
681     foreach my $field (@fields) {
682         if ( $field->subfield($itemsubfield) eq $itemnumber ) {
683             $record->delete_field($field);
684         }
685     }
686     &ModBiblioMarc( $record, $biblionumber, $frameworkcode );
687     &logaction(C4::Context->userenv->{'number'},"CATALOGUING","DELETE",$itemnumber,"item") 
688         if C4::Context->preference("CataloguingLog");
689 }
690
691 =head2 GetBiblioData
692
693 =over 4
694
695 $data = &GetBiblioData($biblionumber);
696 Returns information about the book with the given biblionumber.
697 C<&GetBiblioData> returns a reference-to-hash. The keys are the fields in
698 the C<biblio> and C<biblioitems> tables in the
699 Koha database.
700 In addition, C<$data-E<gt>{subject}> is the list of the book's
701 subjects, separated by C<" , "> (space, comma, space).
702 If there are multiple biblioitems with the given biblionumber, only
703 the first one is considered.
704
705 =back
706
707 =cut
708
709 sub GetBiblioData {
710     my ( $bibnum ) = @_;
711     my $dbh = C4::Context->dbh;
712
713     my $query = "
714         SELECT * , biblioitems.notes AS bnotes, biblio.notes
715         FROM biblio
716             LEFT JOIN biblioitems ON biblio.biblionumber = biblioitems.biblionumber
717             LEFT JOIN itemtypes ON biblioitems.itemtype = itemtypes.itemtype
718         WHERE biblio.biblionumber = ?
719             AND biblioitems.biblionumber = biblio.biblionumber
720     ";
721     my $sth = $dbh->prepare($query);
722     $sth->execute($bibnum);
723     my $data;
724     $data = $sth->fetchrow_hashref;
725     $sth->finish;
726
727     return ($data);
728 }    # sub GetBiblioData
729
730
731 =head2 GetItemsInfo
732
733 =over 4
734
735   @results = &GetItemsInfo($biblionumber, $type);
736
737 Returns information about books with the given biblionumber.
738
739 C<$type> may be either C<intra> or anything else. If it is not set to
740 C<intra>, then the search will exclude lost, very overdue, and
741 withdrawn items.
742
743 C<&GetItemsInfo> returns a list of references-to-hash. Each element
744 contains a number of keys. Most of them are table items from the
745 C<biblio>, C<biblioitems>, C<items>, and C<itemtypes> tables in the
746 Koha database. Other keys include:
747
748 =over 4
749
750 =item C<$data-E<gt>{branchname}>
751
752 The name (not the code) of the branch to which the book belongs.
753
754 =item C<$data-E<gt>{datelastseen}>
755
756 This is simply C<items.datelastseen>, except that while the date is
757 stored in YYYY-MM-DD format in the database, here it is converted to
758 DD/MM/YYYY format. A NULL date is returned as C<//>.
759
760 =item C<$data-E<gt>{datedue}>
761
762 =item C<$data-E<gt>{class}>
763
764 This is the concatenation of C<biblioitems.classification>, the book's
765 Dewey code, and C<biblioitems.subclass>.
766
767 =item C<$data-E<gt>{ocount}>
768
769 I think this is the number of copies of the book available.
770
771 =item C<$data-E<gt>{order}>
772
773 If this is set, it is set to C<One Order>.
774
775 =back
776
777 =back
778
779 =cut
780
781 sub GetItemsInfo {
782     my ( $biblionumber, $type ) = @_;
783     my $dbh   = C4::Context->dbh;
784     my $query = "SELECT *,items.notforloan as itemnotforloan
785                  FROM items, biblio, biblioitems
786                  LEFT JOIN itemtypes on biblioitems.itemtype = itemtypes.itemtype
787                 WHERE items.biblionumber = ?
788                     AND biblioitems.biblioitemnumber = items.biblioitemnumber
789                     AND biblio.biblionumber = items.biblionumber
790                 ORDER BY items.dateaccessioned desc
791                  ";
792     my $sth = $dbh->prepare($query);
793     $sth->execute($biblionumber);
794     my $i = 0;
795     my @results;
796     my ( $date_due, $count_reserves );
797
798     while ( my $data = $sth->fetchrow_hashref ) {
799         my $datedue = '';
800         my $isth    = $dbh->prepare(
801             "SELECT issues.*,borrowers.cardnumber
802             FROM   issues, borrowers
803             WHERE  itemnumber = ?
804                 AND returndate IS NULL
805                 AND issues.borrowernumber=borrowers.borrowernumber"
806         );
807         $isth->execute( $data->{'itemnumber'} );
808         if ( my $idata = $isth->fetchrow_hashref ) {
809             $data->{borrowernumber} = $idata->{borrowernumber};
810             $data->{cardnumber}     = $idata->{cardnumber};
811             $datedue                = format_date( $idata->{'date_due'} );
812         }
813         if ( $datedue eq '' ) {
814             #$datedue="Available";
815             my ( $restype, $reserves ) =
816               C4::Reserves::CheckReserves( $data->{'itemnumber'} );
817             if ($restype) {
818
819                 #$datedue=$restype;
820                 $count_reserves = $restype;
821             }
822         }
823         $isth->finish;
824
825         #get branch information.....
826         my $bsth = $dbh->prepare(
827             "SELECT * FROM branches WHERE branchcode = ?
828         "
829         );
830         $bsth->execute( $data->{'holdingbranch'} );
831         if ( my $bdata = $bsth->fetchrow_hashref ) {
832             $data->{'branchname'} = $bdata->{'branchname'};
833         }
834         my $date = format_date( $data->{'datelastseen'} );
835         $data->{'datelastseen'}   = $date;
836         $data->{'datedue'}        = $datedue;
837         $data->{'count_reserves'} = $count_reserves;
838
839         # get notforloan complete status if applicable
840         my $sthnflstatus = $dbh->prepare(
841             'SELECT authorised_value
842             FROM   marc_subfield_structure
843             WHERE  kohafield="items.notforloan"
844         '
845         );
846
847         $sthnflstatus->execute;
848         my ($authorised_valuecode) = $sthnflstatus->fetchrow;
849         if ($authorised_valuecode) {
850             $sthnflstatus = $dbh->prepare(
851                 "SELECT lib FROM authorised_values
852                  WHERE  category=?
853                  AND authorised_value=?"
854             );
855             $sthnflstatus->execute( $authorised_valuecode,
856                 $data->{itemnotforloan} );
857             my ($lib) = $sthnflstatus->fetchrow;
858             $data->{notforloan} = $lib;
859         }
860
861         # my stack procedures
862         my $stackstatus = $dbh->prepare(
863             'SELECT authorised_value
864              FROM   marc_subfield_structure
865              WHERE  kohafield="items.stack"
866         '
867         );
868         $stackstatus->execute;
869
870         ($authorised_valuecode) = $stackstatus->fetchrow;
871         if ($authorised_valuecode) {
872             $stackstatus = $dbh->prepare(
873                 "SELECT lib
874                  FROM   authorised_values
875                  WHERE  category=?
876                  AND    authorised_value=?
877             "
878             );
879             $stackstatus->execute( $authorised_valuecode, $data->{stack} );
880             my ($lib) = $stackstatus->fetchrow;
881             $data->{stack} = $lib;
882         }
883         $results[$i] = $data;
884         $i++;
885     }
886     $sth->finish;
887
888     return (@results);
889 }
890
891 =head2 getitemstatus
892
893 =over 4
894
895 $itemstatushash = &getitemstatus($fwkcode);
896 returns information about status.
897 Can be MARC dependant.
898 fwkcode is optional.
899 But basically could be can be loan or not
900 Create a status selector with the following code
901
902 =head3 in PERL SCRIPT
903
904 my $itemstatushash = getitemstatus;
905 my @itemstatusloop;
906 foreach my $thisstatus (keys %$itemstatushash) {
907     my %row =(value => $thisstatus,
908                 statusname => $itemstatushash->{$thisstatus}->{'statusname'},
909             );
910     push @itemstatusloop, \%row;
911 }
912 $template->param(statusloop=>\@itemstatusloop);
913
914
915 =head3 in TEMPLATE
916
917             <select name="statusloop">
918                 <option value="">Default</option>
919             <!-- TMPL_LOOP name="statusloop" -->
920                 <option value="<!-- TMPL_VAR name="value" -->" <!-- TMPL_IF name="selected" -->selected<!-- /TMPL_IF -->><!-- TMPL_VAR name="statusname" --></option>
921             <!-- /TMPL_LOOP -->
922             </select>
923
924 =cut
925
926 sub GetItemStatus {
927
928     # returns a reference to a hash of references to status...
929     my ($fwk) = @_;
930     my %itemstatus;
931     my $dbh = C4::Context->dbh;
932     my $sth;
933     $fwk = '' unless ($fwk);
934     my ( $tag, $subfield ) =
935       GetMarcFromKohaField( "items.notforloan", $fwk );
936     if ( $tag and $subfield ) {
937         my $sth =
938           $dbh->prepare(
939 "select authorised_value from marc_subfield_structure where tagfield=? and tagsubfield=? and frameworkcode=?"
940           );
941         $sth->execute( $tag, $subfield, $fwk );
942         if ( my ($authorisedvaluecat) = $sth->fetchrow ) {
943             my $authvalsth =
944               $dbh->prepare(
945 "select authorised_value, lib from authorised_values where category=? order by lib"
946               );
947             $authvalsth->execute($authorisedvaluecat);
948             while ( my ( $authorisedvalue, $lib ) = $authvalsth->fetchrow ) {
949                 $itemstatus{$authorisedvalue} = $lib;
950             }
951             $authvalsth->finish;
952             return \%itemstatus;
953             exit 1;
954         }
955         else {
956
957             #No authvalue list
958             # build default
959         }
960         $sth->finish;
961     }
962
963     #No authvalue list
964     #build default
965     $itemstatus{"1"} = "Not For Loan";
966     return \%itemstatus;
967 }
968
969 =head2 getitemlocation
970
971 =over 4
972
973 $itemlochash = &getitemlocation($fwk);
974 returns informations about location.
975 where fwk stands for an optional framework code.
976 Create a location selector with the following code
977
978 =head3 in PERL SCRIPT
979
980 my $itemlochash = getitemlocation;
981 my @itemlocloop;
982 foreach my $thisloc (keys %$itemlochash) {
983     my $selected = 1 if $thisbranch eq $branch;
984     my %row =(locval => $thisloc,
985                 selected => $selected,
986                 locname => $itemlochash->{$thisloc},
987             );
988     push @itemlocloop, \%row;
989 }
990 $template->param(itemlocationloop => \@itemlocloop);
991
992 =head3 in TEMPLATE
993
994 <select name="location">
995     <option value="">Default</option>
996 <!-- TMPL_LOOP name="itemlocationloop" -->
997     <option value="<!-- TMPL_VAR name="locval" -->" <!-- TMPL_IF name="selected" -->selected<!-- /TMPL_IF -->><!-- TMPL_VAR name="locname" --></option>
998 <!-- /TMPL_LOOP -->
999 </select>
1000
1001 =back
1002
1003 =cut
1004
1005 sub GetItemLocation {
1006
1007     # returns a reference to a hash of references to location...
1008     my ($fwk) = @_;
1009     my %itemlocation;
1010     my $dbh = C4::Context->dbh;
1011     my $sth;
1012     $fwk = '' unless ($fwk);
1013     my ( $tag, $subfield ) =
1014       GetMarcFromKohaField( "items.location", $fwk );
1015     if ( $tag and $subfield ) {
1016         my $sth =
1017           $dbh->prepare(
1018 "select authorised_value from marc_subfield_structure where tagfield=? and tagsubfield=? and frameworkcode=?"
1019           );
1020         $sth->execute( $tag, $subfield, $fwk );
1021         if ( my ($authorisedvaluecat) = $sth->fetchrow ) {
1022             my $authvalsth =
1023               $dbh->prepare(
1024 "select authorised_value, lib from authorised_values where category=? order by lib"
1025               );
1026             $authvalsth->execute($authorisedvaluecat);
1027             while ( my ( $authorisedvalue, $lib ) = $authvalsth->fetchrow ) {
1028                 $itemlocation{$authorisedvalue} = $lib;
1029             }
1030             $authvalsth->finish;
1031             return \%itemlocation;
1032             exit 1;
1033         }
1034         else {
1035
1036             #No authvalue list
1037             # build default
1038         }
1039         $sth->finish;
1040     }
1041
1042     #No authvalue list
1043     #build default
1044     $itemlocation{"1"} = "Not For Loan";
1045     return \%itemlocation;
1046 }
1047
1048 =head2 GetLostItems
1049
1050 $items = GetLostItems($where,$orderby);
1051
1052 This function get the items lost into C<$items>.
1053
1054 =over 2
1055
1056 =item input:
1057 C<$where> is a hashref. it containts a field of the items table as key
1058 and the value to match as value.
1059 C<$orderby> is a field of the items table.
1060
1061 =item return:
1062 C<$items> is a reference to an array full of hasref which keys are items' table column.
1063
1064 =item usage in the perl script:
1065
1066 my %where;
1067 $where{barcode} = 0001548;
1068 my $items = GetLostItems( \%where, "homebranch" );
1069 $template->param(itemsloop => $items);
1070
1071 =back
1072
1073 =cut
1074
1075 sub GetLostItems {
1076     # Getting input args.
1077     my $where   = shift;
1078     my $orderby = shift;
1079     my $dbh     = C4::Context->dbh;
1080
1081     my $query   = "
1082         SELECT *
1083         FROM   items
1084         WHERE  itemlost IS NOT NULL
1085           AND  itemlost <> 0
1086     ";
1087     foreach my $key (keys %$where) {
1088         $query .= " AND " . $key . " LIKE '%" . $where->{$key} . "%'";
1089     }
1090     $query .= " ORDER BY ".$orderby if defined $orderby;
1091
1092     my $sth = $dbh->prepare($query);
1093     $sth->execute;
1094     my @items;
1095     while ( my $row = $sth->fetchrow_hashref ){
1096         push @items, $row;
1097     }
1098     return \@items;
1099 }
1100
1101 =head2 GetItemsForInventory
1102
1103 $itemlist = GetItemsForInventory($minlocation,$maxlocation,$datelastseen,$offset,$size)
1104
1105 Retrieve a list of title/authors/barcode/callnumber, for biblio inventory.
1106
1107 The sub returns a list of hashes, containing itemnumber, author, title, barcode & item callnumber.
1108 It is ordered by callnumber,title.
1109
1110 The minlocation & maxlocation parameters are used to specify a range of item callnumbers
1111 the datelastseen can be used to specify that you want to see items not seen since a past date only.
1112 offset & size can be used to retrieve only a part of the whole listing (defaut behaviour)
1113
1114 =cut
1115
1116 sub GetItemsForInventory {
1117     my ( $minlocation, $maxlocation, $datelastseen, $branch, $offset, $size ) = @_;
1118     my $dbh = C4::Context->dbh;
1119     my $sth;
1120     if ($datelastseen) {
1121         my $query =
1122                 "SELECT itemnumber,barcode,itemcallnumber,title,author,datelastseen
1123                  FROM items
1124                    LEFT JOIN biblio ON items.biblionumber=biblio.biblionumber 
1125                  WHERE itemcallnumber>= ?
1126                    AND itemcallnumber <=?
1127                    AND (datelastseen< ? OR datelastseen IS NULL)";
1128         $query.= " AND items.homebranch=".$dbh->quote($branch) if $branch;
1129         $query .= " ORDER BY itemcallnumber,title";
1130         $sth = $dbh->prepare($query);
1131         $sth->execute( $minlocation, $maxlocation, $datelastseen );
1132     }
1133     else {
1134         my $query ="
1135                 SELECT itemnumber,barcode,itemcallnumber,title,author,datelastseen
1136                 FROM items 
1137                   LEFT JOIN biblio ON items.biblionumber=biblio.biblionumber 
1138                 WHERE itemcallnumber>= ?
1139                   AND itemcallnumber <=?";
1140         $query.= " AND items.homebranch=".$dbh->quote($branch) if $branch;
1141         $query .= " ORDER BY itemcallnumber,title";
1142         $sth = $dbh->prepare($query);
1143         $sth->execute( $minlocation, $maxlocation );
1144     }
1145     my @results;
1146     while ( my $row = $sth->fetchrow_hashref ) {
1147         $offset-- if ($offset);
1148         if ( ( !$offset ) && $size ) {
1149             push @results, $row;
1150             $size--;
1151         }
1152     }
1153     return \@results;
1154 }
1155
1156 =head2 &GetBiblioItemData
1157
1158 =over 4
1159
1160 $itemdata = &GetBiblioItemData($biblioitemnumber);
1161
1162 Looks up the biblioitem with the given biblioitemnumber. Returns a
1163 reference-to-hash. The keys are the fields from the C<biblio>,
1164 C<biblioitems>, and C<itemtypes> tables in the Koha database, except
1165 that C<biblioitems.notes> is given as C<$itemdata-E<gt>{bnotes}>.
1166
1167 =back
1168
1169 =cut
1170
1171 #'
1172 sub GetBiblioItemData {
1173     my ($bibitem) = @_;
1174     my $dbh       = C4::Context->dbh;
1175     my $sth       =
1176       $dbh->prepare(
1177 "Select *,biblioitems.notes as bnotes from biblioitems, biblio,itemtypes where biblio.biblionumber = biblioitems.biblionumber and biblioitemnumber = ? and biblioitems.itemtype = itemtypes.itemtype"
1178       );
1179     my $data;
1180
1181     $sth->execute($bibitem);
1182
1183     $data = $sth->fetchrow_hashref;
1184
1185     $sth->finish;
1186     return ($data);
1187 }    # sub &GetBiblioItemData
1188
1189 =head2 GetItemnumberFromBarcode
1190
1191 =over 4
1192
1193 $result = GetItemnumberFromBarcode($barcode);
1194
1195 =back
1196
1197 =cut
1198
1199 sub GetItemnumberFromBarcode {
1200     my ($barcode) = @_;
1201     my $dbh = C4::Context->dbh;
1202
1203     my $rq =
1204       $dbh->prepare("SELECT itemnumber from items where items.barcode=?");
1205     $rq->execute($barcode);
1206     my ($result) = $rq->fetchrow;
1207     return ($result);
1208 }
1209
1210 =head2 GetBiblioItemByBiblioNumber
1211
1212 =over 4
1213
1214 NOTE : This function has been copy/paste from C4/Biblio.pm from head before zebra integration.
1215
1216 =back
1217
1218 =cut
1219
1220 sub GetBiblioItemByBiblioNumber {
1221     my ($biblionumber) = @_;
1222     my $dbh = C4::Context->dbh;
1223     my $sth = $dbh->prepare("Select * from biblioitems where biblionumber = ?");
1224     my $count = 0;
1225     my @results;
1226
1227     $sth->execute($biblionumber);
1228
1229     while ( my $data = $sth->fetchrow_hashref ) {
1230         push @results, $data;
1231     }
1232
1233     $sth->finish;
1234     return @results;
1235 }
1236
1237 =head2 GetBiblioFromItemNumber
1238
1239 =over 4
1240
1241 $item = &GetBiblioFromItemNumber($itemnumber);
1242
1243 Looks up the item with the given itemnumber.
1244
1245 C<&itemnodata> returns a reference-to-hash whose keys are the fields
1246 from the C<biblio>, C<biblioitems>, and C<items> tables in the Koha
1247 database.
1248
1249 =back
1250
1251 =cut
1252
1253 #'
1254 sub GetBiblioFromItemNumber {
1255     my ( $itemnumber ) = @_;
1256     my $dbh = C4::Context->dbh;
1257     my $sth = $dbh->prepare(
1258         "SELECT * FROM biblio,items,biblioitems
1259          WHERE items.itemnumber = ?
1260            AND biblio.biblionumber = items.biblionumber
1261            AND biblioitems.biblioitemnumber = items.biblioitemnumber"
1262     );
1263
1264     $sth->execute($itemnumber);
1265     my $data = $sth->fetchrow_hashref;
1266     $sth->finish;
1267     return ($data);
1268 }
1269
1270 =head2 GetBiblio
1271
1272 =over 4
1273
1274 ( $count, @results ) = &GetBiblio($biblionumber);
1275
1276 =back
1277
1278 =cut
1279
1280 sub GetBiblio {
1281     my ($biblionumber) = @_;
1282     my $dbh = C4::Context->dbh;
1283     my $sth = $dbh->prepare("Select * from biblio where biblionumber = ?");
1284     my $count = 0;
1285     my @results;
1286     $sth->execute($biblionumber);
1287     while ( my $data = $sth->fetchrow_hashref ) {
1288         $results[$count] = $data;
1289         $count++;
1290     }    # while
1291     $sth->finish;
1292     return ( $count, @results );
1293 }    # sub GetBiblio
1294
1295 =head2 GetItem
1296
1297 =over 4
1298
1299 $data = &GetItem($itemnumber,$barcode);
1300
1301 return Item information, for a given itemnumber or barcode
1302
1303 =back
1304
1305 =cut
1306
1307 sub GetItem {
1308     my ($itemnumber,$barcode) = @_;
1309     my $dbh = C4::Context->dbh;
1310     if ($itemnumber) {
1311         my $sth = $dbh->prepare("
1312             SELECT * FROM items 
1313             WHERE itemnumber = ?");
1314         $sth->execute($itemnumber);
1315         my $data = $sth->fetchrow_hashref;
1316         return $data;
1317     } else {
1318         my $sth = $dbh->prepare("
1319             SELECT * FROM items 
1320             WHERE barcode = ?"
1321             );
1322         $sth->execute($barcode);
1323         my $data = $sth->fetchrow_hashref;
1324         return $data;
1325     }
1326 }    # sub GetItem
1327
1328 =head2 get_itemnumbers_of
1329
1330 =over 4
1331
1332 my @itemnumbers_of = get_itemnumbers_of(@biblionumbers);
1333
1334 Given a list of biblionumbers, return the list of corresponding itemnumbers
1335 for each biblionumber.
1336
1337 Return a reference on a hash where keys are biblionumbers and values are
1338 references on array of itemnumbers.
1339
1340 =back
1341
1342 =cut
1343
1344 sub get_itemnumbers_of {
1345     my @biblionumbers = @_;
1346
1347     my $dbh = C4::Context->dbh;
1348
1349     my $query = '
1350         SELECT itemnumber,
1351             biblionumber
1352         FROM items
1353         WHERE biblionumber IN (?' . ( ',?' x scalar @biblionumbers - 1 ) . ')
1354     ';
1355     my $sth = $dbh->prepare($query);
1356     $sth->execute(@biblionumbers);
1357
1358     my %itemnumbers_of;
1359
1360     while ( my ( $itemnumber, $biblionumber ) = $sth->fetchrow_array ) {
1361         push @{ $itemnumbers_of{$biblionumber} }, $itemnumber;
1362     }
1363
1364     return \%itemnumbers_of;
1365 }
1366
1367 =head2 GetItemInfosOf
1368
1369 =over 4
1370
1371 GetItemInfosOf(@itemnumbers);
1372
1373 =back
1374
1375 =cut
1376
1377 sub GetItemInfosOf {
1378     my @itemnumbers = @_;
1379
1380     my $query = '
1381         SELECT *
1382         FROM items
1383         WHERE itemnumber IN (' . join( ',', @itemnumbers ) . ')
1384     ';
1385     return get_infos_of( $query, 'itemnumber' );
1386 }
1387
1388 =head2 GetBiblioItemInfosOf
1389
1390 =over 4
1391
1392 GetBiblioItemInfosOf(@biblioitemnumbers);
1393
1394 =back
1395
1396 =cut
1397
1398 sub GetBiblioItemInfosOf {
1399     my @biblioitemnumbers = @_;
1400
1401     my $query = '
1402         SELECT biblioitemnumber,
1403             publicationyear,
1404             itemtype
1405         FROM biblioitems
1406         WHERE biblioitemnumber IN (' . join( ',', @biblioitemnumbers ) . ')
1407     ';
1408     return get_infos_of( $query, 'biblioitemnumber' );
1409 }
1410
1411 =head1 FUNCTIONS FOR HANDLING MARC MANAGEMENT
1412
1413 =head2 GetMarcStructure
1414
1415 =over 4
1416
1417 $res = GetMarcStructure($forlibrarian,$frameworkcode);
1418
1419 Returns a reference to a big hash of hash, with the Marc structure for the given frameworkcode
1420 $forlibrarian  :if set to 1, the MARC descriptions are the librarians ones, otherwise it's the public (OPAC) ones
1421 $frameworkcode : the framework code to read
1422
1423 =back
1424
1425 =cut
1426
1427 sub GetMarcStructure {
1428     my ( $forlibrarian, $frameworkcode ) = @_;
1429     my $dbh=C4::Context->dbh;
1430     $frameworkcode = "" unless $frameworkcode;
1431     my $sth;
1432     my $libfield = ( $forlibrarian eq 1 ) ? 'liblibrarian' : 'libopac';
1433
1434     # check that framework exists
1435     $sth =
1436       $dbh->prepare(
1437         "select count(*) from marc_tag_structure where frameworkcode=?");
1438     $sth->execute($frameworkcode);
1439     my ($total) = $sth->fetchrow;
1440     $frameworkcode = "" unless ( $total > 0 );
1441     $sth =
1442       $dbh->prepare(
1443 "select tagfield,liblibrarian,libopac,mandatory,repeatable from marc_tag_structure where frameworkcode=? order by tagfield"
1444       );
1445     $sth->execute($frameworkcode);
1446     my ( $liblibrarian, $libopac, $tag, $res, $tab, $mandatory, $repeatable );
1447
1448     while ( ( $tag, $liblibrarian, $libopac, $mandatory, $repeatable ) =
1449         $sth->fetchrow )
1450     {
1451         $res->{$tag}->{lib} =
1452           ( $forlibrarian or !$libopac ) ? $liblibrarian : $libopac;
1453           # why the hell do we need to explicitly decode utf8 ? 
1454           # that's a good question, but we must do it...
1455         $res->{$tab}->{tab}        = "";            # XXX
1456         $res->{$tag}->{mandatory}  = $mandatory;
1457         $res->{$tag}->{repeatable} = $repeatable;
1458     }
1459
1460     $sth =
1461       $dbh->prepare(
1462 "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"
1463       );
1464     $sth->execute($frameworkcode);
1465
1466     my $subfield;
1467     my $authorised_value;
1468     my $authtypecode;
1469     my $value_builder;
1470     my $kohafield;
1471     my $seealso;
1472     my $hidden;
1473     my $isurl;
1474     my $link;
1475     my $defaultvalue;
1476
1477     while (
1478         (
1479             $tag,          $subfield,      $liblibrarian,
1480             ,              $libopac,       $tab,
1481             $mandatory,    $repeatable,    $authorised_value,
1482             $authtypecode, $value_builder, $kohafield,
1483             $seealso,      $hidden,        $isurl,
1484             $link,$defaultvalue
1485         )
1486         = $sth->fetchrow
1487       )
1488     {
1489         $res->{$tag}->{$subfield}->{lib} =
1490           ( $forlibrarian or !$libopac ) ? $liblibrarian : $libopac;
1491         $res->{$tag}->{$subfield}->{tab}              = $tab;
1492         $res->{$tag}->{$subfield}->{mandatory}        = $mandatory;
1493         $res->{$tag}->{$subfield}->{repeatable}       = $repeatable;
1494         $res->{$tag}->{$subfield}->{authorised_value} = $authorised_value;
1495         $res->{$tag}->{$subfield}->{authtypecode}     = $authtypecode;
1496         $res->{$tag}->{$subfield}->{value_builder}    = $value_builder;
1497         $res->{$tag}->{$subfield}->{kohafield}        = $kohafield;
1498         $res->{$tag}->{$subfield}->{seealso}          = $seealso;
1499         $res->{$tag}->{$subfield}->{hidden}           = $hidden;
1500         $res->{$tag}->{$subfield}->{isurl}            = $isurl;
1501         $res->{$tag}->{$subfield}->{link}             = $link;
1502         $res->{$tag}->{$subfield}->{defaultvalue}     = $defaultvalue;
1503     }
1504     return $res;
1505 }
1506
1507 =head2 GetMarcFromKohaField
1508
1509 =over 4
1510
1511 ($MARCfield,$MARCsubfield)=GetMarcFromKohaField($kohafield,$frameworkcode);
1512 Returns the MARC fields & subfields mapped to the koha field 
1513 for the given frameworkcode
1514
1515 =back
1516
1517 =cut
1518
1519 sub GetMarcFromKohaField {
1520     my ( $kohafield, $frameworkcode ) = @_;
1521     return 0, 0 unless $kohafield;
1522     my $relations = C4::Context->marcfromkohafield;
1523     return (
1524         $relations->{$frameworkcode}->{$kohafield}->[0],
1525         $relations->{$frameworkcode}->{$kohafield}->[1]
1526     );
1527 }
1528
1529 =head2 GetMarcBiblio
1530
1531 =over 4
1532
1533 Returns MARC::Record of the biblionumber passed in parameter.
1534 the marc record contains both biblio & item datas
1535
1536 =back
1537
1538 =cut
1539
1540 sub GetMarcBiblio {
1541     my $biblionumber = shift;
1542     my $dbh          = C4::Context->dbh;
1543     my $sth          =
1544       $dbh->prepare("select marcxml from biblioitems where biblionumber=? ");
1545     $sth->execute($biblionumber);
1546     my ($marcxml) = $sth->fetchrow;
1547     MARC::File::XML->default_record_format(C4::Context->preference('marcflavour'));
1548     $marcxml =~ s/\x1e//g;
1549     $marcxml =~ s/\x1f//g;
1550     $marcxml =~ s/\x1d//g;
1551     $marcxml =~ s/\x0f//g;
1552     $marcxml =~ s/\x0c//g;
1553     my $record = MARC::Record->new();
1554     $record = MARC::Record::new_from_xml( $marcxml, "utf8",C4::Context->preference('marcflavour')) if $marcxml;
1555     return $record;
1556 }
1557
1558 =head2 GetXmlBiblio
1559
1560 =over 4
1561
1562 my $marcxml = GetXmlBiblio($biblionumber);
1563
1564 Returns biblioitems.marcxml of the biblionumber passed in parameter.
1565 The XML contains both biblio & item datas
1566
1567 =back
1568
1569 =cut
1570
1571 sub GetXmlBiblio {
1572     my ( $biblionumber ) = @_;
1573     my $dbh = C4::Context->dbh;
1574     my $sth =
1575       $dbh->prepare("select marcxml from biblioitems where biblionumber=? ");
1576     $sth->execute($biblionumber);
1577     my ($marcxml) = $sth->fetchrow;
1578     return $marcxml;
1579 }
1580
1581 =head2 GetAuthorisedValueDesc
1582
1583 =over 4
1584
1585 my $subfieldvalue =get_authorised_value_desc(
1586     $tag, $subf[$i][0],$subf[$i][1], '', $taglib);
1587 Retrieve the complete description for a given authorised value.
1588
1589 =back
1590
1591 =cut
1592
1593 sub GetAuthorisedValueDesc {
1594     my ( $tag, $subfield, $value, $framework, $tagslib ) = @_;
1595     my $dbh = C4::Context->dbh;
1596     
1597     #---- branch
1598     if ( $tagslib->{$tag}->{$subfield}->{'authorised_value'} eq "branches" ) {
1599         return C4::Branch::GetBranchName($value);
1600     }
1601
1602     #---- itemtypes
1603     if ( $tagslib->{$tag}->{$subfield}->{'authorised_value'} eq "itemtypes" ) {
1604         return getitemtypeinfo($value);
1605     }
1606
1607     #---- "true" authorized value
1608     my $category = $tagslib->{$tag}->{$subfield}->{'authorised_value'};
1609
1610     if ( $category ne "" ) {
1611         my $sth =
1612           $dbh->prepare(
1613             "select lib from authorised_values where category = ? and authorised_value = ?"
1614           );
1615         $sth->execute( $category, $value );
1616         my $data = $sth->fetchrow_hashref;
1617         return $data->{'lib'};
1618     }
1619     else {
1620         return $value;    # if nothing is found return the original value
1621     }
1622 }
1623
1624 =head2 GetMarcItem
1625
1626 =over 4
1627
1628 Returns MARC::Record of the item passed in parameter.
1629
1630 =back
1631
1632 =cut
1633
1634 sub GetMarcItem {
1635     my ( $biblionumber, $itemnumber ) = @_;
1636     my $dbh = C4::Context->dbh;
1637     my $newrecord = MARC::Record->new();
1638     my $marcflavour = C4::Context->preference('marcflavour');
1639     
1640     my $marcxml = GetXmlBiblio($biblionumber);
1641     my $record = MARC::Record->new();
1642     $record = MARC::Record::new_from_xml( $marcxml, "utf8", $marcflavour );
1643     # now, find where the itemnumber is stored & extract only the item
1644     my ( $itemnumberfield, $itemnumbersubfield ) =
1645       GetMarcFromKohaField( 'items.itemnumber', '' );
1646     my @fields = $record->field($itemnumberfield);
1647     foreach my $field (@fields) {
1648         if ( $field->subfield($itemnumbersubfield) eq $itemnumber ) {
1649             $newrecord->insert_fields_ordered($field);
1650         }
1651     }
1652     return $newrecord;
1653 }
1654
1655
1656
1657 =head2 GetMarcNotes
1658
1659 =over 4
1660
1661 $marcnotesarray = GetMarcNotes( $record, $marcflavour );
1662 Get all notes from the MARC record and returns them in an array.
1663 The note are stored in differents places depending on MARC flavour
1664
1665 =back
1666
1667 =cut
1668
1669 sub GetMarcNotes {
1670     my ( $record, $marcflavour ) = @_;
1671     my $scope;
1672     if ( $marcflavour eq "MARC21" ) {
1673         $scope = '5..';
1674     }
1675     else {    # assume unimarc if not marc21
1676         $scope = '3..';
1677     }
1678     my @marcnotes;
1679     my $note = "";
1680     my $tag  = "";
1681     my $marcnote;
1682     foreach my $field ( $record->field($scope) ) {
1683         my $value = $field->as_string();
1684         if ( $note ne "" ) {
1685             $marcnote = { marcnote => $note, };
1686             push @marcnotes, $marcnote;
1687             $note = $value;
1688         }
1689         if ( $note ne $value ) {
1690             $note = $note . " " . $value;
1691         }
1692     }
1693
1694     if ( $note ) {
1695         $marcnote = { marcnote => $note };
1696         push @marcnotes, $marcnote;    #load last tag into array
1697     }
1698     return \@marcnotes;
1699 }    # end GetMarcNotes
1700
1701 =head2 GetMarcSubjects
1702
1703 =over 4
1704
1705 $marcsubjcts = GetMarcSubjects($record,$marcflavour);
1706 Get all subjects from the MARC record and returns them in an array.
1707 The subjects are stored in differents places depending on MARC flavour
1708
1709 =back
1710
1711 =cut
1712
1713 sub GetMarcSubjects {
1714     my ( $record, $marcflavour ) = @_;
1715     my ( $mintag, $maxtag );
1716     if ( $marcflavour eq "MARC21" ) {
1717         $mintag = "600";
1718         $maxtag = "699";
1719     }
1720     else {    # assume unimarc if not marc21
1721         $mintag = "600";
1722         $maxtag = "611";
1723     }
1724
1725     my @marcsubjcts;
1726
1727     foreach my $field ( $record->fields ) {
1728         next unless $field->tag() >= $mintag && $field->tag() <= $maxtag;
1729         my @subfields = $field->subfields();
1730         my $link;
1731         my $label = "su:";
1732         my $flag = 0;
1733         for my $subject_subfield ( @subfields ) {
1734             if (
1735                 $marcflavour ne 'MARC21'
1736                 and (
1737                     ($subject_subfield->[0] eq '3') or
1738                     ($subject_subfield->[0] eq '4') or
1739                     ($subject_subfield->[0] eq '5')
1740                 )
1741             )
1742             {
1743                 next;
1744             }
1745             my $code = $subject_subfield->[0];
1746             $label .= $subject_subfield->[1] . " and su-to:" unless ( $code == 9 );
1747             if ( $code == 9 ) {
1748                 $link = "Koha-Auth-Number:".$subject_subfield->[1];
1749                 $flag = 1;
1750             }
1751             elsif ( ! $flag ) {
1752                 $link = $label;
1753                 $link =~ s/ and\ssu-to:$//;
1754             }
1755         }
1756         $label =~ s/su/ /g;
1757         $label =~ s/://g;
1758         $label =~ s/-to//g;
1759         $label =~ s/ and //g;
1760         push @marcsubjcts,
1761           {
1762             label => $label,
1763             link  => $link
1764           }
1765     }
1766     return \@marcsubjcts;
1767 }    #end GetMarcSubjects
1768
1769 =head2 GetMarcAuthors
1770
1771 =over 4
1772
1773 authors = GetMarcAuthors($record,$marcflavour);
1774 Get all authors from the MARC record and returns them in an array.
1775 The authors are stored in differents places depending on MARC flavour
1776
1777 =back
1778
1779 =cut
1780
1781 sub GetMarcAuthors {
1782     my ( $record, $marcflavour ) = @_;
1783     my ( $mintag, $maxtag );
1784     if ( $marcflavour eq "MARC21" ) {
1785         $mintag = "100";
1786         $maxtag = "111"; 
1787     }
1788     else {    # assume unimarc if not marc21
1789         $mintag = "701";
1790         $maxtag = "712";
1791     }
1792
1793     my @marcauthors;
1794
1795     foreach my $field ( $record->fields ) {
1796         next unless $field->tag() >= $mintag && $field->tag() <= $maxtag;
1797         my %hash;
1798         my @subfields = $field->subfields();
1799         my $count_auth = 0;
1800         my $and ;
1801         for my $authors_subfield (@subfields) {
1802             if (
1803                 $marcflavour ne 'MARC21'
1804                 and (
1805                     ($authors_subfield->[0] eq '3') or
1806                     ($authors_subfield->[0] eq '4') or
1807                     ($authors_subfield->[0] eq '5')
1808                 )
1809             )
1810             {
1811                 next;
1812             }
1813             if ($count_auth ne '0'){
1814                 $and = " and au:";
1815             }
1816             $count_auth++;
1817             my $subfieldcode = $authors_subfield->[0];
1818             my $value        = $authors_subfield->[1];
1819             $hash{tag}       = $field->tag;
1820             $hash{value}    .= $value . " " if ($subfieldcode != 9) ;
1821             $hash{link}     .= $value if ($subfieldcode eq 9);
1822         }
1823         push @marcauthors, \%hash;
1824     }
1825     return \@marcauthors;
1826 }
1827
1828 =head2 GetMarcSeries
1829
1830 =over 4
1831
1832 $marcseriessarray = GetMarcSeries($record,$marcflavour);
1833 Get all series from the MARC record and returns them in an array.
1834 The series are stored in differents places depending on MARC flavour
1835
1836 =back
1837
1838 =cut
1839
1840 sub GetMarcSeries {
1841     my ($record, $marcflavour) = @_;
1842     my ($mintag, $maxtag);
1843     if ($marcflavour eq "MARC21") {
1844         $mintag = "440";
1845         $maxtag = "490";
1846     } else {           # assume unimarc if not marc21
1847         $mintag = "600";
1848         $maxtag = "619";
1849     }
1850
1851     my @marcseries;
1852     my $subjct = "";
1853     my $subfield = "";
1854     my $marcsubjct;
1855
1856     foreach my $field ($record->field('440'), $record->field('490')) {
1857         my @subfields_loop;
1858         #my $value = $field->subfield('a');
1859         #$marcsubjct = {MARCSUBJCT => $value,};
1860         my @subfields = $field->subfields();
1861         #warn "subfields:".join " ", @$subfields;
1862         my $counter = 0;
1863         my @link_loop;
1864         for my $series_subfield (@subfields) {
1865                         my $volume_number;
1866                         undef $volume_number;
1867                         # see if this is an instance of a volume
1868                         if ($series_subfield->[0] eq 'v') {
1869                                 $volume_number=1;
1870                         }
1871
1872             my $code = $series_subfield->[0];
1873             my $value = $series_subfield->[1];
1874             my $linkvalue = $value;
1875             $linkvalue =~ s/(\(|\))//g;
1876             my $operator = " and " unless $counter==0;
1877             push @link_loop, {link => $linkvalue, operator => $operator };
1878             my $separator = C4::Context->preference("authoritysep") unless $counter==0;
1879                         if ($volume_number) {
1880                         push @subfields_loop, {volumenum => $value};
1881                         }
1882                         else {
1883             push @subfields_loop, {code => $code, value => $value, link_loop => \@link_loop, separator => $separator, volumenum => $volume_number};
1884                         }
1885             $counter++;
1886         }
1887         push @marcseries, { MARCSERIES_SUBFIELDS_LOOP => \@subfields_loop };
1888         #$marcsubjct = {MARCSUBJCT => $field->as_string(),};
1889         #push @marcsubjcts, $marcsubjct;
1890         #$subjct = $value;
1891
1892     }
1893     my $marcseriessarray=\@marcseries;
1894     return $marcseriessarray;
1895 }  #end getMARCseriess
1896
1897 =head2 GetFrameworkCode
1898
1899 =over 4
1900
1901 $frameworkcode = GetFrameworkCode( $biblionumber )
1902
1903 =back
1904
1905 =cut
1906
1907 sub GetFrameworkCode {
1908     my ( $biblionumber ) = @_;
1909     my $dbh = C4::Context->dbh;
1910     my $sth =
1911       $dbh->prepare("select frameworkcode from biblio where biblionumber=?");
1912     $sth->execute($biblionumber);
1913     my ($frameworkcode) = $sth->fetchrow;
1914     return $frameworkcode;
1915 }
1916
1917 =head2 TransformKohaToMarc
1918
1919 =over 4
1920
1921 $record = TransformKohaToMarc( $hash )
1922 This function builds partial MARC::Record from a hash
1923 Hash entries can be from biblio or biblioitems.
1924 This function is called in acquisition module, to create a basic catalogue entry from user entry
1925
1926 =back
1927
1928 =cut
1929
1930 sub TransformKohaToMarc {
1931
1932     my ( $hash ) = @_;
1933     my $dbh = C4::Context->dbh;
1934     my $sth =
1935     $dbh->prepare(
1936         "select tagfield,tagsubfield from marc_subfield_structure where frameworkcode=? and kohafield=?"
1937     );
1938     my $record = MARC::Record->new();
1939     foreach (keys %{$hash}) {
1940         &TransformKohaToMarcOneField( $sth, $record, $_,
1941             $hash->{$_}, '' );
1942         }
1943     return $record;
1944 }
1945
1946 =head2 TransformKohaToMarcOneField
1947
1948 =over 4
1949
1950 $record = TransformKohaToMarcOneField( $sth, $record, $kohafieldname, $value, $frameworkcode );
1951
1952 =back
1953
1954 =cut
1955
1956 sub TransformKohaToMarcOneField {
1957     my ( $sth, $record, $kohafieldname, $value, $frameworkcode ) = @_;
1958     $frameworkcode='' unless $frameworkcode;
1959     my $tagfield;
1960     my $tagsubfield;
1961
1962     if ( !defined $sth ) {
1963         my $dbh = C4::Context->dbh;
1964         $sth =
1965           $dbh->prepare(
1966 "select tagfield,tagsubfield from marc_subfield_structure where frameworkcode=? and kohafield=?"
1967           );
1968     }
1969     $sth->execute( $frameworkcode, $kohafieldname );
1970     if ( ( $tagfield, $tagsubfield ) = $sth->fetchrow ) {
1971         my $tag = $record->field($tagfield);
1972         if ($tag) {
1973             $tag->update( $tagsubfield => $value );
1974             $record->delete_field($tag);
1975             $record->insert_fields_ordered($tag);
1976         }
1977         else {
1978             $record->add_fields( $tagfield, " ", " ", $tagsubfield => $value );
1979         }
1980     }
1981     return $record;
1982 }
1983
1984 =head2 TransformHtmlToXml
1985
1986 =over 4
1987
1988 $xml = TransformHtmlToXml( $tags, $subfields, $values, $indicator, $ind_tag )
1989
1990 =back
1991
1992 =cut
1993
1994 sub TransformHtmlToXml {
1995     my ( $tags, $subfields, $values, $indicator, $ind_tag, $auth_type ) = @_;
1996     my $xml = MARC::File::XML::header('UTF-8');
1997     $auth_type = C4::Context->preference('marcflavour') unless $auth_type;
1998     MARC::File::XML->default_record_format($auth_type);
1999     # in UNIMARC, field 100 contains the encoding
2000     # check that there is one, otherwise the 
2001     # MARC::Record->new_from_xml will fail (and Koha will die)
2002     my $unimarc_and_100_exist=0;
2003     my $prevvalue;
2004     my $prevtag = -1;
2005     my $first   = 1;
2006     my $j       = -1;
2007     for ( my $i = 0 ; $i <= @$tags ; $i++ ) {
2008         if (C4::Context->preference('marcflavour') eq 'UNIMARC' and @$tags[$i] eq "100" and @$subfields[$i] eq "a") {
2009             # if we have a 100 field and it's values are not correct, skip them.
2010             # if we don't have any valid 100 field, we will create a default one at the end
2011             my $enc = substr( @$values[$i], 26, 2 );
2012             if ($enc eq '01' or $enc eq '50' or $enc eq '03') {
2013                 $unimarc_and_100_exist=1;
2014             } else {
2015                 next;
2016             }
2017         }
2018         @$values[$i] =~ s/&/&amp;/g;
2019         @$values[$i] =~ s/</&lt;/g;
2020         @$values[$i] =~ s/>/&gt;/g;
2021         @$values[$i] =~ s/"/&quot;/g;
2022         @$values[$i] =~ s/'/&apos;/g;
2023         if ( !utf8::is_utf8( @$values[$i] ) ) {
2024             utf8::decode( @$values[$i] );
2025         }
2026         if ( ( @$tags[$i] ne $prevtag ) ) {
2027             $j++ unless ( @$tags[$i] eq "" );
2028             if ( !$first ) {
2029                 $xml .= "</datafield>\n";
2030                 if (   ( @$tags[$i] && @$tags[$i] > 10 )
2031                     && ( @$values[$i] ne "" ) )
2032                 {
2033                     my $ind1 = substr( @$indicator[$j], 0, 1 );
2034                     my $ind2;
2035                     if ( @$indicator[$j] ) {
2036                         $ind2 = substr( @$indicator[$j], 1, 1 );
2037                     }
2038                     else {
2039                         warn "Indicator in @$tags[$i] is empty";
2040                         $ind2 = " ";
2041                     }
2042                     $xml .=
2043 "<datafield tag=\"@$tags[$i]\" ind1=\"$ind1\" ind2=\"$ind2\">\n";
2044                     $xml .=
2045 "<subfield code=\"@$subfields[$i]\">@$values[$i]</subfield>\n";
2046                     $first = 0;
2047                 }
2048                 else {
2049                     $first = 1;
2050                 }
2051             }
2052             else {
2053                 if ( @$values[$i] ne "" ) {
2054
2055                     # leader
2056                     if ( @$tags[$i] eq "000" ) {
2057                         $xml .= "<leader>@$values[$i]</leader>\n";
2058                         $first = 1;
2059
2060                         # rest of the fixed fields
2061                     }
2062                     elsif ( @$tags[$i] < 10 ) {
2063                         $xml .=
2064 "<controlfield tag=\"@$tags[$i]\">@$values[$i]</controlfield>\n";
2065                         $first = 1;
2066                     }
2067                     else {
2068                         my $ind1 = substr( @$indicator[$j], 0, 1 );
2069                         my $ind2 = substr( @$indicator[$j], 1, 1 );
2070                         $xml .=
2071 "<datafield tag=\"@$tags[$i]\" ind1=\"$ind1\" ind2=\"$ind2\">\n";
2072                         $xml .=
2073 "<subfield code=\"@$subfields[$i]\">@$values[$i]</subfield>\n";
2074                         $first = 0;
2075                     }
2076                 }
2077             }
2078         }
2079         else {    # @$tags[$i] eq $prevtag
2080             if ( @$values[$i] eq "" ) {
2081             }
2082             else {
2083                 if ($first) {
2084                     my $ind1 = substr( @$indicator[$j], 0, 1 );
2085                     my $ind2 = substr( @$indicator[$j], 1, 1 );
2086                     $xml .=
2087 "<datafield tag=\"@$tags[$i]\" ind1=\"$ind1\" ind2=\"$ind2\">\n";
2088                     $first = 0;
2089                 }
2090                 $xml .=
2091 "<subfield code=\"@$subfields[$i]\">@$values[$i]</subfield>\n";
2092             }
2093         }
2094         $prevtag = @$tags[$i];
2095     }
2096     if (C4::Context->preference('marcflavour') and !$unimarc_and_100_exist) {
2097 #     warn "SETTING 100 for $auth_type";
2098         use POSIX qw(strftime);
2099         my $string = strftime( "%Y%m%d", localtime(time) );
2100         # set 50 to position 26 is biblios, 13 if authorities
2101         my $pos=26;
2102         $pos=13 if $auth_type eq 'UNIMARCAUTH';
2103         $string = sprintf( "%-*s", 35, $string );
2104         substr( $string, $pos , 6, "50" );
2105         $xml .= "<datafield tag=\"100\" ind1=\"\" ind2=\"\">\n";
2106         $xml .= "<subfield code=\"a\">$string</subfield>\n";
2107         $xml .= "</datafield>\n";
2108     } 
2109     $xml .= MARC::File::XML::footer();
2110     return $xml;
2111 }
2112
2113 =head2 TransformHtmlToMarc
2114
2115 =over 4
2116
2117 $record = TransformHtmlToMarc( $dbh, $rtags, $rsubfields, $rvalues, %indicators )
2118
2119 =back
2120
2121 =cut
2122
2123 sub TransformHtmlToMarc {
2124     my ( $dbh, $rtags, $rsubfields, $rvalues, %indicators ) = @_;
2125     my $prevtag = -1;
2126     my $record  = MARC::Record->new();
2127
2128     #     my %subfieldlist=();
2129     my $prevvalue;    # if tag <10
2130     my $field;        # if tag >=10
2131     for ( my $i = 0 ; $i < @$rtags ; $i++ ) {
2132         next unless @$rvalues[$i];
2133
2134  # rebuild MARC::Record
2135  #             warn "0=>".@$rtags[$i].@$rsubfields[$i]." = ".@$rvalues[$i].": ";
2136         if ( @$rtags[$i] ne $prevtag ) {
2137             if ( $prevtag < 10 ) {
2138                 if ($prevvalue) {
2139
2140                     if ( $prevtag ne '000' ) {
2141                         $record->insert_fields_ordered(
2142                             ( sprintf "%03s", $prevtag ), $prevvalue );
2143                     }
2144                     else {
2145
2146                         $record->leader($prevvalue);
2147
2148                     }
2149                 }
2150             }
2151             else {
2152                 if ($field) {
2153                     $record->insert_fields_ordered($field);
2154                 }
2155             }
2156             $indicators{ @$rtags[$i] } .= '  ';
2157             if ( @$rtags[$i] < 10 ) {
2158                 $prevvalue = @$rvalues[$i];
2159                 undef $field;
2160             }
2161             else {
2162                 undef $prevvalue;
2163                 $field = MARC::Field->new(
2164                     ( sprintf "%03s", @$rtags[$i] ),
2165                     substr( $indicators{ @$rtags[$i] }, 0, 1 ),
2166                     substr( $indicators{ @$rtags[$i] }, 1, 1 ),
2167                     @$rsubfields[$i] => @$rvalues[$i]
2168                 );
2169             }
2170             $prevtag = @$rtags[$i];
2171         }
2172         else {
2173             if ( @$rtags[$i] < 10 ) {
2174                 $prevvalue = @$rvalues[$i];
2175             }
2176             else {
2177                 if ( length( @$rvalues[$i] ) > 0 ) {
2178                     $field->add_subfields( @$rsubfields[$i] => @$rvalues[$i] );
2179                 }
2180             }
2181             $prevtag = @$rtags[$i];
2182         }
2183     }
2184
2185     # the last has not been included inside the loop... do it now !
2186     $record->insert_fields_ordered($field) if $field;
2187
2188     $record->encoding('UTF-8');
2189
2190     #    $record->MARC::File::USMARC::update_leader();
2191     return $record;
2192 }
2193
2194 =head2 TransformMarcToKoha
2195
2196 =over 4
2197
2198 $result = TransformMarcToKoha( $dbh, $record, $frameworkcode )
2199
2200 =back
2201
2202 =cut
2203
2204 sub TransformMarcToKoha {
2205     my ( $dbh, $record, $frameworkcode ) = @_;
2206     my $sth =
2207       $dbh->prepare(
2208 "select tagfield,tagsubfield from marc_subfield_structure where frameworkcode=? and kohafield=?"
2209       );
2210     my $result;
2211     my $sth2 = $dbh->prepare("SHOW COLUMNS from biblio");
2212     $sth2->execute;
2213     my $field;
2214     while ( ($field) = $sth2->fetchrow ) {
2215         $result =
2216           &TransformMarcToKohaOneField( "biblio", $field, $record, $result,
2217             $frameworkcode );
2218     }
2219     $sth2 = $dbh->prepare("SHOW COLUMNS from biblioitems");
2220     $sth2->execute;
2221     while ( ($field) = $sth2->fetchrow ) {
2222         if ( $field eq 'notes' ) { $field = 'bnotes'; }
2223         $result =
2224           &TransformMarcToKohaOneField( "biblioitems", $field, $record, $result,
2225             $frameworkcode );
2226     }
2227     $sth2 = $dbh->prepare("SHOW COLUMNS from items");
2228     $sth2->execute;
2229     while ( ($field) = $sth2->fetchrow ) {
2230         $result =
2231           &TransformMarcToKohaOneField( "items", $field, $record, $result,
2232             $frameworkcode );
2233     }
2234
2235     #
2236     # modify copyrightdate to keep only the 1st year found
2237     my $temp = $result->{'copyrightdate'};
2238     $temp =~ m/c(\d\d\d\d)/;    # search cYYYY first
2239     if ( $1 > 0 ) {
2240         $result->{'copyrightdate'} = $1;
2241     }
2242     else {                      # if no cYYYY, get the 1st date.
2243         $temp =~ m/(\d\d\d\d)/;
2244         $result->{'copyrightdate'} = $1;
2245     }
2246
2247     # modify publicationyear to keep only the 1st year found
2248     $temp = $result->{'publicationyear'};
2249     $temp =~ m/c(\d\d\d\d)/;    # search cYYYY first
2250     if ( $1 > 0 ) {
2251         $result->{'publicationyear'} = $1;
2252     }
2253     else {                      # if no cYYYY, get the 1st date.
2254         $temp =~ m/(\d\d\d\d)/;
2255         $result->{'publicationyear'} = $1;
2256     }
2257     return $result;
2258 }
2259
2260 =head2 TransformMarcToKohaOneField
2261
2262 =over 4
2263
2264 $result = TransformMarcToKohaOneField( $kohatable, $kohafield, $record, $result, $frameworkcode )
2265
2266 =back
2267
2268 =cut
2269
2270 sub TransformMarcToKohaOneField {
2271
2272 # FIXME ? if a field has a repeatable subfield that is used in old-db, only the 1st will be retrieved...
2273     my ( $kohatable, $kohafield, $record, $result, $frameworkcode ) = @_;
2274
2275     my $res = "";
2276     my ( $tagfield, $subfield ) =
2277       GetMarcFromKohaField( $kohatable . "." . $kohafield,
2278         $frameworkcode );
2279     foreach my $field ( $record->field($tagfield) ) {
2280         if ( $field->tag() < 10 ) {
2281             if ( $result->{$kohafield} ) {
2282                 $result->{$kohafield} .= " | " . $field->data();
2283             }
2284             else {
2285                 $result->{$kohafield} = $field->data();
2286             }
2287         }
2288         else {
2289             if ( $field->subfields ) {
2290                 my @subfields = $field->subfields();
2291                 foreach my $subfieldcount ( 0 .. $#subfields ) {
2292                     if ( $subfields[$subfieldcount][0] eq $subfield ) {
2293                         if ( $result->{$kohafield} ) {
2294                             $result->{$kohafield} .=
2295                               " | " . $subfields[$subfieldcount][1];
2296                         }
2297                         else {
2298                             $result->{$kohafield} =
2299                               $subfields[$subfieldcount][1];
2300                         }
2301                     }
2302                 }
2303             }
2304         }
2305     }
2306     return $result;
2307 }
2308 =head1  OTHER FUNCTIONS
2309
2310 =head2 char_decode
2311
2312 =over 4
2313
2314 my $string = char_decode( $string, $encoding );
2315
2316 converts ISO 5426 coded string to UTF-8
2317 sloppy code : should be improved in next issue
2318
2319 =back
2320
2321 =cut
2322
2323 sub char_decode {
2324     my ( $string, $encoding ) = @_;
2325     $_ = $string;
2326
2327     $encoding = C4::Context->preference("marcflavour") unless $encoding;
2328     if ( $encoding eq "UNIMARC" ) {
2329
2330         #         s/\xe1/Æ/gm;
2331         s/\xe2/Ğ/gm;
2332         s/\xe9/Ø/gm;
2333         s/\xec/ş/gm;
2334         s/\xf1/æ/gm;
2335         s/\xf3/ğ/gm;
2336         s/\xf9/ø/gm;
2337         s/\xfb/ß/gm;
2338         s/\xc1\x61/à/gm;
2339         s/\xc1\x65/è/gm;
2340         s/\xc1\x69/ì/gm;
2341         s/\xc1\x6f/ò/gm;
2342         s/\xc1\x75/ù/gm;
2343         s/\xc1\x41/À/gm;
2344         s/\xc1\x45/È/gm;
2345         s/\xc1\x49/Ì/gm;
2346         s/\xc1\x4f/Ò/gm;
2347         s/\xc1\x55/Ù/gm;
2348         s/\xc2\x41/Á/gm;
2349         s/\xc2\x45/É/gm;
2350         s/\xc2\x49/Í/gm;
2351         s/\xc2\x4f/Ó/gm;
2352         s/\xc2\x55/Ú/gm;
2353         s/\xc2\x59/İ/gm;
2354         s/\xc2\x61/á/gm;
2355         s/\xc2\x65/é/gm;
2356         s/\xc2\x69/í/gm;
2357         s/\xc2\x6f/ó/gm;
2358         s/\xc2\x75/ú/gm;
2359         s/\xc2\x79/ı/gm;
2360         s/\xc3\x41/Â/gm;
2361         s/\xc3\x45/Ê/gm;
2362         s/\xc3\x49/Î/gm;
2363         s/\xc3\x4f/Ô/gm;
2364         s/\xc3\x55/Û/gm;
2365         s/\xc3\x61/â/gm;
2366         s/\xc3\x65/ê/gm;
2367         s/\xc3\x69/î/gm;
2368         s/\xc3\x6f/ô/gm;
2369         s/\xc3\x75/û/gm;
2370         s/\xc4\x41/Ã/gm;
2371         s/\xc4\x4e/Ñ/gm;
2372         s/\xc4\x4f/Õ/gm;
2373         s/\xc4\x61/ã/gm;
2374         s/\xc4\x6e/ñ/gm;
2375         s/\xc4\x6f/õ/gm;
2376         s/\xc8\x41/Ä/gm;
2377         s/\xc8\x45/Ë/gm;
2378         s/\xc8\x49/Ï/gm;
2379         s/\xc8\x61/ä/gm;
2380         s/\xc8\x65/ë/gm;
2381         s/\xc8\x69/ï/gm;
2382         s/\xc8\x6F/ö/gm;
2383         s/\xc8\x75/ü/gm;
2384         s/\xc8\x76/ÿ/gm;
2385         s/\xc9\x41/Ä/gm;
2386         s/\xc9\x45/Ë/gm;
2387         s/\xc9\x49/Ï/gm;
2388         s/\xc9\x4f/Ö/gm;
2389         s/\xc9\x55/Ü/gm;
2390         s/\xc9\x61/ä/gm;
2391         s/\xc9\x6f/ö/gm;
2392         s/\xc9\x75/ü/gm;
2393         s/\xca\x41/Å/gm;
2394         s/\xca\x61/å/gm;
2395         s/\xd0\x43/Ç/gm;
2396         s/\xd0\x63/ç/gm;
2397
2398         # this handles non-sorting blocks (if implementation requires this)
2399         $string = nsb_clean($_);
2400     }
2401     elsif ( $encoding eq "USMARC" || $encoding eq "MARC21" ) {
2402         ##MARC-8 to UTF-8
2403
2404         s/\xe1\x61/à/gm;
2405         s/\xe1\x65/è/gm;
2406         s/\xe1\x69/ì/gm;
2407         s/\xe1\x6f/ò/gm;
2408         s/\xe1\x75/ù/gm;
2409         s/\xe1\x41/À/gm;
2410         s/\xe1\x45/È/gm;
2411         s/\xe1\x49/Ì/gm;
2412         s/\xe1\x4f/Ò/gm;
2413         s/\xe1\x55/Ù/gm;
2414         s/\xe2\x41/Á/gm;
2415         s/\xe2\x45/É/gm;
2416         s/\xe2\x49/Í/gm;
2417         s/\xe2\x4f/Ó/gm;
2418         s/\xe2\x55/Ú/gm;
2419         s/\xe2\x59/İ/gm;
2420         s/\xe2\x61/á/gm;
2421         s/\xe2\x65/é/gm;
2422         s/\xe2\x69/í/gm;
2423         s/\xe2\x6f/ó/gm;
2424         s/\xe2\x75/ú/gm;
2425         s/\xe2\x79/ı/gm;
2426         s/\xe3\x41/Â/gm;
2427         s/\xe3\x45/Ê/gm;
2428         s/\xe3\x49/Î/gm;
2429         s/\xe3\x4f/Ô/gm;
2430         s/\xe3\x55/Û/gm;
2431         s/\xe3\x61/â/gm;
2432         s/\xe3\x65/ê/gm;
2433         s/\xe3\x69/î/gm;
2434         s/\xe3\x6f/ô/gm;
2435         s/\xe3\x75/û/gm;
2436         s/\xe4\x41/Ã/gm;
2437         s/\xe4\x4e/Ñ/gm;
2438         s/\xe4\x4f/Õ/gm;
2439         s/\xe4\x61/ã/gm;
2440         s/\xe4\x6e/ñ/gm;
2441         s/\xe4\x6f/õ/gm;
2442         s/\xe6\x41/Ă/gm;
2443         s/\xe6\x45/Ĕ/gm;
2444         s/\xe6\x65/ĕ/gm;
2445         s/\xe6\x61/ă/gm;
2446         s/\xe8\x45/Ë/gm;
2447         s/\xe8\x49/Ï/gm;
2448         s/\xe8\x65/ë/gm;
2449         s/\xe8\x69/ï/gm;
2450         s/\xe8\x76/ÿ/gm;
2451         s/\xe9\x41/A/gm;
2452         s/\xe9\x4f/O/gm;
2453         s/\xe9\x55/U/gm;
2454         s/\xe9\x61/a/gm;
2455         s/\xe9\x6f/o/gm;
2456         s/\xe9\x75/u/gm;
2457         s/\xea\x41/A/gm;
2458         s/\xea\x61/a/gm;
2459
2460         #Additional Turkish characters
2461         s/\x1b//gm;
2462         s/\x1e//gm;
2463         s/(\xf0)s/\xc5\x9f/gm;
2464         s/(\xf0)S/\xc5\x9e/gm;
2465         s/(\xf0)c/ç/gm;
2466         s/(\xf0)C/Ç/gm;
2467         s/\xe7\x49/\\xc4\xb0/gm;
2468         s/(\xe6)G/\xc4\x9e/gm;
2469         s/(\xe6)g/ğ\xc4\x9f/gm;
2470         s/\xB8/ı/gm;
2471         s/\xB9/£/gm;
2472         s/(\xe8|\xc8)o/ö/gm;
2473         s/(\xe8|\xc8)O/Ö/gm;
2474         s/(\xe8|\xc8)u/ü/gm;
2475         s/(\xe8|\xc8)U/Ü/gm;
2476         s/\xc2\xb8/\xc4\xb1/gm;
2477         s/¸/\xc4\xb1/gm;
2478
2479         # this handles non-sorting blocks (if implementation requires this)
2480         $string = nsb_clean($_);
2481     }
2482     return ($string);
2483 }
2484
2485 =head2 nsb_clean
2486
2487 =over 4
2488
2489 my $string = nsb_clean( $string, $encoding );
2490
2491 =back
2492
2493 =cut
2494
2495 sub nsb_clean {
2496     my $NSB      = '\x88';    # NSB : begin Non Sorting Block
2497     my $NSE      = '\x89';    # NSE : Non Sorting Block end
2498                               # handles non sorting blocks
2499     my ($string) = @_;
2500     $_ = $string;
2501     s/$NSB/(/gm;
2502     s/[ ]{0,1}$NSE/) /gm;
2503     $string = $_;
2504     return ($string);
2505 }
2506
2507 =head2 PrepareItemrecordDisplay
2508
2509 =over 4
2510
2511 PrepareItemrecordDisplay($itemrecord,$bibnum,$itemumber);
2512
2513 Returns a hash with all the fields for Display a given item data in a template
2514
2515 =back
2516
2517 =cut
2518
2519 sub PrepareItemrecordDisplay {
2520
2521     my ( $bibnum, $itemnum ) = @_;
2522
2523     my $dbh = C4::Context->dbh;
2524     my $frameworkcode = &GetFrameworkCode( $bibnum );
2525     my ( $itemtagfield, $itemtagsubfield ) =
2526       &GetMarcFromKohaField( "items.itemnumber", $frameworkcode );
2527     my $tagslib = &GetMarcStructure( 1, $frameworkcode );
2528     my $itemrecord = GetMarcItem( $bibnum, $itemnum) if ($itemnum);
2529     my @loop_data;
2530     my $authorised_values_sth =
2531       $dbh->prepare(
2532 "select authorised_value,lib from authorised_values where category=? order by lib"
2533       );
2534     foreach my $tag ( sort keys %{$tagslib} ) {
2535         my $previous_tag = '';
2536         if ( $tag ne '' ) {
2537             # loop through each subfield
2538             my $cntsubf;
2539             foreach my $subfield ( sort keys %{ $tagslib->{$tag} } ) {
2540                 next if ( subfield_is_koha_internal_p($subfield) );
2541                 next if ( $tagslib->{$tag}->{$subfield}->{'tab'} ne "10" );
2542                 my %subfield_data;
2543                 $subfield_data{tag}           = $tag;
2544                 $subfield_data{subfield}      = $subfield;
2545                 $subfield_data{countsubfield} = $cntsubf++;
2546                 $subfield_data{kohafield}     =
2547                   $tagslib->{$tag}->{$subfield}->{'kohafield'};
2548
2549          #        $subfield_data{marc_lib}=$tagslib->{$tag}->{$subfield}->{lib};
2550                 $subfield_data{marc_lib} =
2551                     "<span id=\"error\" title=\""
2552                   . $tagslib->{$tag}->{$subfield}->{lib} . "\">"
2553                   . substr( $tagslib->{$tag}->{$subfield}->{lib}, 0, 12 )
2554                   . "</span>";
2555                 $subfield_data{mandatory} =
2556                   $tagslib->{$tag}->{$subfield}->{mandatory};
2557                 $subfield_data{repeatable} =
2558                   $tagslib->{$tag}->{$subfield}->{repeatable};
2559                 $subfield_data{hidden} = "display:none"
2560                   if $tagslib->{$tag}->{$subfield}->{hidden};
2561                 my ( $x, $value );
2562                 ( $x, $value ) = _find_value( $tag, $subfield, $itemrecord )
2563                   if ($itemrecord);
2564                 $value =~ s/"/&quot;/g;
2565
2566                 # search for itemcallnumber if applicable
2567                 if ( $tagslib->{$tag}->{$subfield}->{kohafield} eq
2568                     'items.itemcallnumber'
2569                     && C4::Context->preference('itemcallnumber') )
2570                 {
2571                     my $CNtag =
2572                       substr( C4::Context->preference('itemcallnumber'), 0, 3 );
2573                     my $CNsubfield =
2574                       substr( C4::Context->preference('itemcallnumber'), 3, 1 );
2575                     my $temp = $itemrecord->field($CNtag) if ($itemrecord);
2576                     if ($temp) {
2577                         $value = $temp->subfield($CNsubfield);
2578                     }
2579                 }
2580                 if ( $tagslib->{$tag}->{$subfield}->{authorised_value} ) {
2581                     my @authorised_values;
2582                     my %authorised_lib;
2583
2584                     # builds list, depending on authorised value...
2585                     #---- branch
2586                     if ( $tagslib->{$tag}->{$subfield}->{'authorised_value'} eq
2587                         "branches" )
2588                     {
2589                         if ( ( C4::Context->preference("IndependantBranches") )
2590                             && ( C4::Context->userenv->{flags} != 1 ) )
2591                         {
2592                             my $sth =
2593                               $dbh->prepare(
2594 "select branchcode,branchname from branches where branchcode = ? order by branchname"
2595                               );
2596                             $sth->execute( C4::Context->userenv->{branch} );
2597                             push @authorised_values, ""
2598                               unless (
2599                                 $tagslib->{$tag}->{$subfield}->{mandatory} );
2600                             while ( my ( $branchcode, $branchname ) =
2601                                 $sth->fetchrow_array )
2602                             {
2603                                 push @authorised_values, $branchcode;
2604                                 $authorised_lib{$branchcode} = $branchname;
2605                             }
2606                         }
2607                         else {
2608                             my $sth =
2609                               $dbh->prepare(
2610 "select branchcode,branchname from branches order by branchname"
2611                               );
2612                             $sth->execute;
2613                             push @authorised_values, ""
2614                               unless (
2615                                 $tagslib->{$tag}->{$subfield}->{mandatory} );
2616                             while ( my ( $branchcode, $branchname ) =
2617                                 $sth->fetchrow_array )
2618                             {
2619                                 push @authorised_values, $branchcode;
2620                                 $authorised_lib{$branchcode} = $branchname;
2621                             }
2622                         }
2623
2624                         #----- itemtypes
2625                     }
2626                     elsif ( $tagslib->{$tag}->{$subfield}->{authorised_value} eq
2627                         "itemtypes" )
2628                     {
2629                         my $sth =
2630                           $dbh->prepare(
2631 "select itemtype,description from itemtypes order by description"
2632                           );
2633                         $sth->execute;
2634                         push @authorised_values, ""
2635                           unless ( $tagslib->{$tag}->{$subfield}->{mandatory} );
2636                         while ( my ( $itemtype, $description ) =
2637                             $sth->fetchrow_array )
2638                         {
2639                             push @authorised_values, $itemtype;
2640                             $authorised_lib{$itemtype} = $description;
2641                         }
2642
2643                         #---- "true" authorised value
2644                     }
2645                     else {
2646                         $authorised_values_sth->execute(
2647                             $tagslib->{$tag}->{$subfield}->{authorised_value} );
2648                         push @authorised_values, ""
2649                           unless ( $tagslib->{$tag}->{$subfield}->{mandatory} );
2650                         while ( my ( $value, $lib ) =
2651                             $authorised_values_sth->fetchrow_array )
2652                         {
2653                             push @authorised_values, $value;
2654                             $authorised_lib{$value} = $lib;
2655                         }
2656                     }
2657                     $subfield_data{marc_value} = CGI::scrolling_list(
2658                         -name     => 'field_value',
2659                         -values   => \@authorised_values,
2660                         -default  => "$value",
2661                         -labels   => \%authorised_lib,
2662                         -size     => 1,
2663                         -tabindex => '',
2664                         -multiple => 0,
2665                     );
2666                 }
2667                 elsif ( $tagslib->{$tag}->{$subfield}->{thesaurus_category} ) {
2668                     $subfield_data{marc_value} =
2669 "<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>";
2670
2671 #"
2672 # COMMENTED OUT because No $i is provided with this API.
2673 # And thus, no value_builder can be activated.
2674 # BUT could be thought over.
2675 #         } elsif ($tagslib->{$tag}->{$subfield}->{'value_builder'}) {
2676 #             my $plugin="value_builder/".$tagslib->{$tag}->{$subfield}->{'value_builder'};
2677 #             require $plugin;
2678 #             my $extended_param = plugin_parameters($dbh,$itemrecord,$tagslib,$i,0);
2679 #             my ($function_name,$javascript) = plugin_javascript($dbh,$record,$tagslib,$i,0);
2680 #             $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";
2681                 }
2682                 else {
2683                     $subfield_data{marc_value} =
2684 "<input type=\"text\" name=\"field_value\" value=\"$value\" size=50 maxlength=255>";
2685                 }
2686                 push( @loop_data, \%subfield_data );
2687             }
2688         }
2689     }
2690     my $itemnumber = $itemrecord->subfield( $itemtagfield, $itemtagsubfield )
2691       if ( $itemrecord && $itemrecord->field($itemtagfield) );
2692     return {
2693         'itemtagfield'    => $itemtagfield,
2694         'itemtagsubfield' => $itemtagsubfield,
2695         'itemnumber'      => $itemnumber,
2696         'iteminformation' => \@loop_data
2697     };
2698 }
2699 #"
2700
2701 #
2702 # true ModZebra commented until indexdata fixes zebraDB crashes (it seems they occur on multiple updates
2703 # at the same time
2704 # replaced by a zebraqueue table, that is filled with ModZebra to run.
2705 # the table is emptied by misc/cronjobs/zebraqueue_start.pl script
2706 # =head2 ModZebrafiles
2707
2708 # &ModZebrafiles( $dbh, $biblionumber, $record, $folder, $server );
2709
2710 # =cut
2711
2712 # sub ModZebrafiles {
2713
2714 #     my ( $dbh, $biblionumber, $record, $folder, $server ) = @_;
2715
2716 #     my $op;
2717 #     my $zebradir =
2718 #       C4::Context->zebraconfig($server)->{directory} . "/" . $folder . "/";
2719 #     unless ( opendir( DIR, "$zebradir" ) ) {
2720 #         warn "$zebradir not found";
2721 #         return;
2722 #     }
2723 #     closedir DIR;
2724 #     my $filename = $zebradir . $biblionumber;
2725
2726 #     if ($record) {
2727 #         open( OUTPUT, ">", $filename . ".xml" );
2728 #         print OUTPUT $record;
2729 #         close OUTPUT;
2730 #     }
2731 # }
2732
2733 =head2 ModZebra
2734
2735 =over 4
2736
2737 ModZebra( $biblionumber, $op, $server, $newRecord );
2738
2739     $biblionumber is the biblionumber we want to index
2740     $op is specialUpdate or delete, and is used to know what we want to do
2741     $server is the server that we want to update
2742     $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.
2743 =back
2744
2745 =cut
2746
2747 sub ModZebra {
2748 ###Accepts a $server variable thus we can use it for biblios authorities or other zebra dbs
2749     my ( $biblionumber, $op, $server, $newRecord ) = @_;
2750 #     warn "ModZebra with : ( $biblionumber, $op, $server, $newRecord )";
2751     my $dbh=C4::Context->dbh;
2752     #warn "SERVER:".$server;
2753 #
2754 # true ModZebra commented until indexdata fixes zebraDB crashes (it seems they occur on multiple updates
2755 # at the same time
2756 # replaced by a zebraqueue table, that is filled with ModZebra to run.
2757 # the table is emptied by misc/cronjobs/zebraqueue_start.pl script
2758
2759     if (C4::Context->preference("NoZebra")) {
2760         # lock the nozebra table : we will read index lines, update them in Perl process
2761         # and write everything in 1 transaction.
2762         # lock the table to avoid someone else overwriting what we are doing
2763         $dbh->do('LOCK TABLES nozebra WRITE,biblio WRITE,biblioitems WRITE, systempreferences WRITE, auth_types WRITE, auth_header WRITE');
2764         my %result; # the result hash that will be builded by deletion / add, and written on mySQL at the end, to improve speed
2765         my $record;
2766         if ($server eq 'biblioserver') {
2767             $record= GetMarcBiblio($biblionumber);
2768         } else {
2769             $record= C4::AuthoritiesMarc::GetAuthority($biblionumber);
2770         }
2771         if ($op eq 'specialUpdate') {
2772             # OK, we have to add or update the record
2773             # 1st delete (virtually, in indexes) ...
2774             %result = _DelBiblioNoZebra($biblionumber,$record,$server);
2775             # ... add the record
2776             %result=_AddBiblioNoZebra($biblionumber,$newRecord, $server, %result);
2777         } else {
2778             # it's a deletion, delete the record...
2779 #             warn "DELETE the record $biblionumber on $server".$record->as_formatted;
2780             %result=_DelBiblioNoZebra($biblionumber,$record,$server);
2781         }
2782         # ok, now update the database...
2783         my $sth = $dbh->prepare("UPDATE nozebra SET biblionumbers=? WHERE server=? AND indexname=? AND value=?");
2784         foreach my $key (keys %result) {
2785             foreach my $index (keys %{$result{$key}}) {
2786 #                 warn "UPDATING : $server $key , $index with :".$result{$key}->{$index};
2787                 $sth->execute($result{$key}->{$index}, $server, $key, $index);
2788             }
2789         }
2790     $dbh->do('UNLOCK TABLES');
2791
2792     } else {
2793         #
2794         # we use zebra, just fill zebraqueue table
2795         #
2796         my $sth=$dbh->prepare("insert into zebraqueue  (biblio_auth_number ,server,operation) values(?,?,?)");
2797         $sth->execute($biblionumber,$server,$op);
2798         $sth->finish;
2799     }
2800 }
2801
2802 =head2 GetNoZebraIndexes
2803
2804 =cut
2805
2806 sub GetNoZebraIndexes {
2807     my $index = C4::Context->preference('NoZebraIndexes');
2808     my %indexes;
2809     foreach my $line (split /('|"),/,$index) {
2810         $line =~ /(.*)=>(.*)/;
2811         my $index = substr($1,1); # get the index, don't forget to remove initial ' or "
2812         my $fields = $2;
2813         $index =~ s/'|"| //g;
2814         $fields =~ s/'|"| //g;
2815         $indexes{$index}=$fields;
2816     }
2817     return %indexes;
2818 }
2819
2820 =head1 INTERNAL FUNCTIONS
2821
2822 =head2 _DelBiblioNoZebra($biblionumber,$record,$server);
2823
2824     function to delete a biblio in NoZebra indexes
2825     This function does NOT delete anything in database : it reads all the indexes entries
2826     that have to be deleted & delete them in the hash
2827     The SQL part is done either :
2828     - after the Add if we are modifying a biblio (delete + add again)
2829     - immediatly after this sub if we are doing a true deletion.
2830     $server can be 'biblioserver' or 'authorityserver' : it indexes biblios or authorities (in the same table, $server being part of the table itself
2831
2832 =cut
2833
2834
2835 sub _DelBiblioNoZebra {
2836     my ($biblionumber, $record, $server)=@_;
2837     
2838     # Get the indexes
2839     my $dbh = C4::Context->dbh;
2840     # Get the indexes
2841     my %index;
2842     my $title;
2843     if ($server eq 'biblioserver') {
2844         %index=GetNoZebraIndexes;
2845         # get title of the record (to store the 10 first letters with the index)
2846         my ($titletag,$titlesubfield) = GetMarcFromKohaField('biblio.title');
2847         $title = lc($record->subfield($titletag,$titlesubfield));
2848     } else {
2849         # for authorities, the "title" is the $a mainentry
2850         my $authref = C4::AuthoritiesMarc::GetAuthType($record->subfield(152,'b'));
2851         warn "ERROR : authtype undefined for ".$record->as_formatted unless $authref;
2852         $title = $record->subfield($authref->{auth_tag_to_report},'a');
2853         $index{'mainmainentry'}= $authref->{'auth_tag_to_report'}.'a';
2854         $index{'mainentry'}    = $authref->{'auth_tag_to_report'}.'*';
2855         $index{'auth_type'}    = '152b';
2856     }
2857     
2858     my %result;
2859     # remove blancks comma (that could cause problem when decoding the string for CQL retrieval) and regexp specific values
2860     $title =~ s/ |,|;|\[|\]|\(|\)|\*|-|'|=//g;
2861     # limit to 10 char, should be enough, and limit the DB size
2862     $title = substr($title,0,10);
2863     #parse each field
2864     my $sth2=$dbh->prepare('SELECT biblionumbers FROM nozebra WHERE server=? AND indexname=? AND value=?');
2865     foreach my $field ($record->fields()) {
2866         #parse each subfield
2867         next if $field->tag <10;
2868         foreach my $subfield ($field->subfields()) {
2869             my $tag = $field->tag();
2870             my $subfieldcode = $subfield->[0];
2871             my $indexed=0;
2872             # check each index to see if the subfield is stored somewhere
2873             # otherwise, store it in __RAW__ index
2874             foreach my $key (keys %index) {
2875 #                 warn "examining $key index : ".$index{$key}." for $tag $subfieldcode";
2876                 if ($index{$key} =~ /$tag\*/ or $index{$key} =~ /$tag$subfieldcode/) {
2877                     $indexed=1;
2878                     my $line= lc $subfield->[1];
2879                     # remove meaningless value in the field...
2880                     $line =~ s/-|\.|\?|,|;|!|'|\(|\)|\[|\]|{|}|"|<|>|&|\+|\*|\/|=|:/ /g;
2881                     # ... and split in words
2882                     foreach (split / /,$line) {
2883                         next unless $_; # skip  empty values (multiple spaces)
2884                         # if the entry is already here, do nothing, the biblionumber has already be removed
2885                         unless ($result{$key}->{$_} =~ /$biblionumber,$title\-(\d);/) {
2886                             # get the index value if it exist in the nozebra table and remove the entry, otherwise, do nothing
2887                             $sth2->execute($server,$key,$_);
2888                             my $existing_biblionumbers = $sth2->fetchrow;
2889                             # it exists
2890                             if ($existing_biblionumbers) {
2891 #                                 warn " existing for $key $_: $existing_biblionumbers";
2892                                 $result{$key}->{$_} =$existing_biblionumbers;
2893                                 $result{$key}->{$_} =~ s/$biblionumber,$title\-(\d);//;
2894                             }
2895                         }
2896                     }
2897                 }
2898             }
2899             # the subfield is not indexed, store it in __RAW__ index anyway
2900             unless ($indexed) {
2901                 my $line= lc $subfield->[1];
2902                 $line =~ s/-|\.|\?|,|;|!|'|\(|\)|\[|\]|{|}|"|<|>|&|\+|\*|\/|=|:/ /g;
2903                 # ... and split in words
2904                 foreach (split / /,$line) {
2905                     next unless $_; # skip  empty values (multiple spaces)
2906                     # if the entry is already here, do nothing, the biblionumber has already be removed
2907                     unless ($result{'__RAW__'}->{$_} =~ /$biblionumber,$title\-(\d);/) {
2908                         # get the index value if it exist in the nozebra table and remove the entry, otherwise, do nothing
2909                         $sth2->execute($server,'__RAW__',$_);
2910                         my $existing_biblionumbers = $sth2->fetchrow;
2911                         # it exists
2912                         if ($existing_biblionumbers) {
2913                             $result{'__RAW__'}->{$_} =$existing_biblionumbers;
2914                             $result{'__RAW__'}->{$_} =~ s/$biblionumber,$title\-(\d);//;
2915                         }
2916                     }
2917                 }
2918             }
2919         }
2920     }
2921     return %result;
2922 }
2923
2924 =head2 _DelBiblioNoZebra($biblionumber,$record);
2925
2926     function to delete a biblio in NoZebra indexes
2927
2928 =cut
2929
2930
2931 sub _AddBiblioNoZebra {
2932     my ($biblionumber, $record, $server, %result)=@_;
2933     my $dbh = C4::Context->dbh;
2934     # Get the indexes
2935     my %index;
2936     my $title;
2937     if ($server eq 'biblioserver') {
2938         %index=GetNoZebraIndexes;
2939         # get title of the record (to store the 10 first letters with the index)
2940         my ($titletag,$titlesubfield) = GetMarcFromKohaField('biblio.title');
2941         $title = lc($record->subfield($titletag,$titlesubfield));
2942     } else {
2943 #     warn "server : $server";
2944         # for authorities, the "title" is the $a mainentry
2945         my $authref = C4::AuthoritiesMarc::GetAuthType($record->subfield(152,'b'));
2946         warn "ERROR : authtype undefined for ".$record->as_formatted unless $authref;
2947         $title = $record->subfield($authref->{auth_tag_to_report},'a');
2948         $index{'mainmainentry'}=$authref->{auth_tag_to_report}.'a';
2949         $index{'mainentry'}    = $authref->{auth_tag_to_report}.'*';
2950         $index{'auth_type'}    = '152b';
2951     }
2952
2953     # remove blancks comma (that could cause problem when decoding the string for CQL retrieval) and regexp specific values
2954     $title =~ s/ |,|;|\[|\]|\(|\)|\*|-|'|=//g;
2955     # limit to 10 char, should be enough, and limit the DB size
2956     $title = substr($title,0,10);
2957     #parse each field
2958     my $sth2=$dbh->prepare('SELECT biblionumbers FROM nozebra WHERE server=? AND indexname=? AND value=?');
2959     foreach my $field ($record->fields()) {
2960         #parse each subfield
2961         next if $field->tag <10;
2962         foreach my $subfield ($field->subfields()) {
2963             my $tag = $field->tag();
2964             my $subfieldcode = $subfield->[0];
2965             my $indexed=0;
2966             # check each index to see if the subfield is stored somewhere
2967             # otherwise, store it in __RAW__ index
2968             foreach my $key (keys %index) {
2969 #                 warn "examining $key index : ".$index{$key}." for $tag $subfieldcode";
2970                 if ($index{$key} =~ /$tag\*/ or $index{$key} =~ /$tag$subfieldcode/) {
2971                     $indexed=1;
2972                     my $line= lc $subfield->[1];
2973                     # remove meaningless value in the field...
2974                     $line =~ s/-|\.|\?|,|;|!|'|\(|\)|\[|\]|{|}|"|<|>|&|\+|\*|\/|=|:/ /g;
2975                     # ... and split in words
2976                     foreach (split / /,$line) {
2977                         next unless $_; # skip  empty values (multiple spaces)
2978                         # if the entry is already here, improve weight
2979 #                         warn "managing $_";
2980                         if ($result{$key}->{$_} =~ /$biblionumber,$title\-(\d);/) {
2981                             my $weight=$1+1;
2982                             $result{$key}->{$_} =~ s/$biblionumber,$title\-(\d);//;
2983                             $result{$key}->{$_} .= "$biblionumber,$title-$weight;";
2984                         } else {
2985                             # get the value if it exist in the nozebra table, otherwise, create it
2986                             $sth2->execute($server,$key,$_);
2987                             my $existing_biblionumbers = $sth2->fetchrow;
2988                             # it exists
2989                             if ($existing_biblionumbers) {
2990                                 $result{$key}->{$_} =$existing_biblionumbers;
2991                                 my $weight=$1+1;
2992                                 $result{$key}->{$_} =~ s/$biblionumber,$title\-(\d);//;
2993                                 $result{$key}->{$_} .= "$biblionumber,$title-$weight;";
2994                             # create a new ligne for this entry
2995                             } else {
2996 #                             warn "INSERT : $server / $key / $_";
2997                                 $dbh->do('INSERT INTO nozebra SET server='.$dbh->quote($server).', indexname='.$dbh->quote($key).',value='.$dbh->quote($_));
2998                                 $result{$key}->{$_}.="$biblionumber,$title-1;";
2999                             }
3000                         }
3001                     }
3002                 }
3003             }
3004             # the subfield is not indexed, store it in __RAW__ index anyway
3005             unless ($indexed) {
3006                 my $line= lc $subfield->[1];
3007                 $line =~ s/-|\.|\?|,|;|!|'|\(|\)|\[|\]|{|}|"|<|>|&|\+|\*|\/|=|:/ /g;
3008                 # ... and split in words
3009                 foreach (split / /,$line) {
3010                     next unless $_; # skip  empty values (multiple spaces)
3011                     # if the entry is already here, improve weight
3012                     if ($result{'__RAW__'}->{$_} =~ /$biblionumber,$title\-(\d);/) {
3013                         my $weight=$1+1;
3014                         $result{'__RAW__'}->{$_} =~ s/$biblionumber,$title\-(\d);//;
3015                         $result{'__RAW__'}->{$_} .= "$biblionumber,$title-$weight;";
3016                     } else {
3017                         # get the value if it exist in the nozebra table, otherwise, create it
3018                         $sth2->execute($server,'__RAW__',$_);
3019                         my $existing_biblionumbers = $sth2->fetchrow;
3020                         # it exists
3021                         if ($existing_biblionumbers) {
3022                             $result{'__RAW__'}->{$_} =$existing_biblionumbers;
3023                             my $weight=$1+1;
3024                             $result{'__RAW__'}->{$_} =~ s/$biblionumber,$title\-(\d);//;
3025                             $result{'__RAW__'}->{$_} .= "$biblionumber,$title-$weight;";
3026                         # create a new ligne for this entry
3027                         } else {
3028                             $dbh->do('INSERT INTO nozebra SET server='.$dbh->quote($server).',  indexname="__RAW__",value='.$dbh->quote($_));
3029                             $result{'__RAW__'}->{$_}.="$biblionumber,$title-1;";
3030                         }
3031                     }
3032                 }
3033             }
3034         }
3035     }
3036     return %result;
3037 }
3038
3039
3040 =head2 MARCitemchange
3041
3042 =over 4
3043
3044 &MARCitemchange( $record, $itemfield, $newvalue )
3045
3046 Function to update a single value in an item field.
3047 Used twice, could probably be replaced by something else, but works well...
3048
3049 =back
3050
3051 =back
3052
3053 =cut
3054
3055 sub MARCitemchange {
3056     my ( $record, $itemfield, $newvalue ) = @_;
3057     my $dbh = C4::Context->dbh;
3058     
3059     my ( $tagfield, $tagsubfield ) =
3060       GetMarcFromKohaField( $itemfield, "" );
3061     if ( ($tagfield) && ($tagsubfield) ) {
3062         my $tag = $record->field($tagfield);
3063         if ($tag) {
3064             $tag->update( $tagsubfield => $newvalue );
3065             $record->delete_field($tag);
3066             $record->insert_fields_ordered($tag);
3067         }
3068     }
3069 }
3070
3071 =head2 _koha_add_biblio
3072
3073 =over 4
3074
3075 _koha_add_biblio($dbh,$biblioitem);
3076
3077 Internal function to add a biblio ($biblio is a hash with the values)
3078
3079 =back
3080
3081 =cut
3082
3083 sub _koha_add_biblio {
3084     my ( $dbh, $biblio, $frameworkcode ) = @_;
3085     my $sth = $dbh->prepare("Select max(biblionumber) from biblio");
3086     $sth->execute;
3087     my $data         = $sth->fetchrow_arrayref;
3088     my $biblionumber = $$data[0] + 1;
3089     my $series       = 0;
3090
3091     if ( $biblio->{'seriestitle'} ) { $series = 1 }
3092     $sth->finish;
3093     $sth = $dbh->prepare(
3094         "INSERT INTO biblio
3095     SET biblionumber  = ?, title = ?, author = ?, copyrightdate = ?, serial = ?, seriestitle = ?, notes = ?, abstract = ?, unititle = ?, frameworkcode = ? "
3096     );
3097     $sth->execute(
3098         $biblionumber,         $biblio->{'title'},
3099         $biblio->{'author'},   $biblio->{'copyrightdate'},
3100         $biblio->{'serial'},   $biblio->{'seriestitle'},
3101         $biblio->{'notes'},    $biblio->{'abstract'},
3102         $biblio->{'unititle'}, $frameworkcode
3103     );
3104
3105     $sth->finish;
3106     return ($biblionumber);
3107 }
3108
3109 =head2 _find_value
3110
3111 =over 4
3112
3113 ($indicators, $value) = _find_value($tag, $subfield, $record,$encoding);
3114
3115 Find the given $subfield in the given $tag in the given
3116 MARC::Record $record.  If the subfield is found, returns
3117 the (indicators, value) pair; otherwise, (undef, undef) is
3118 returned.
3119
3120 PROPOSITION :
3121 Such a function is used in addbiblio AND additem and serial-edit and maybe could be used in Authorities.
3122 I suggest we export it from this module.
3123
3124 =back
3125
3126 =cut
3127
3128 sub _find_value {
3129     my ( $tagfield, $insubfield, $record, $encoding ) = @_;
3130     my @result;
3131     my $indicator;
3132     if ( $tagfield < 10 ) {
3133         if ( $record->field($tagfield) ) {
3134             push @result, $record->field($tagfield)->data();
3135         }
3136         else {
3137             push @result, "";
3138         }
3139     }
3140     else {
3141         foreach my $field ( $record->field($tagfield) ) {
3142             my @subfields = $field->subfields();
3143             foreach my $subfield (@subfields) {
3144                 if ( @$subfield[0] eq $insubfield ) {
3145                     push @result, @$subfield[1];
3146                     $indicator = $field->indicator(1) . $field->indicator(2);
3147                 }
3148             }
3149         }
3150     }
3151     return ( $indicator, @result );
3152 }
3153
3154 =head2 _koha_modify_biblio
3155
3156 =over 4
3157
3158 Internal function for updating the biblio table
3159
3160 =back
3161
3162 =cut
3163
3164 sub _koha_modify_biblio {
3165     my ( $dbh, $biblio ) = @_;
3166
3167 # FIXME: this code could be made more portable by not hard-coding the values that are supposed to be in biblio table
3168     my $sth =
3169       $dbh->prepare(
3170 "Update biblio set title = ?, author = ?, abstract = ?, copyrightdate = ?, seriestitle = ?, serial = ?, unititle = ?, notes = ? where biblionumber = ?"
3171       );
3172     $sth->execute(
3173         $biblio->{'title'},       $biblio->{'author'},
3174         $biblio->{'abstract'},    $biblio->{'copyrightdate'},
3175         $biblio->{'seriestitle'}, $biblio->{'serial'},
3176         $biblio->{'unititle'},    $biblio->{'notes'},
3177         $biblio->{'biblionumber'}
3178     );
3179     $sth->finish;
3180     return ( $biblio->{'biblionumber'} );
3181 }
3182
3183 =head2 _koha_modify_biblioitem
3184
3185 =over 4
3186
3187 _koha_modify_biblioitem( $dbh, $biblioitem );
3188
3189 =back
3190
3191 =cut
3192
3193 sub _koha_modify_biblioitem {
3194     my ( $dbh, $biblioitem ) = @_;
3195     my $query;
3196 ##Recalculate LC in case it changed --TG
3197
3198     $biblioitem->{'itemtype'}      = $dbh->quote( $biblioitem->{'itemtype'} );
3199     $biblioitem->{'url'}           = $dbh->quote( $biblioitem->{'url'} );
3200     $biblioitem->{'isbn'}          = $dbh->quote( $biblioitem->{'isbn'} );
3201     $biblioitem->{'issn'}          = $dbh->quote( $biblioitem->{'issn'} );
3202     $biblioitem->{'publishercode'} =
3203       $dbh->quote( $biblioitem->{'publishercode'} );
3204     $biblioitem->{'publicationyear'} =
3205       $dbh->quote( $biblioitem->{'publicationyear'} );
3206     $biblioitem->{'classification'} =
3207       $dbh->quote( $biblioitem->{'classification'} );
3208     $biblioitem->{'dewey'}        = $dbh->quote( $biblioitem->{'dewey'} );
3209     $biblioitem->{'subclass'}     = $dbh->quote( $biblioitem->{'subclass'} );
3210     $biblioitem->{'illus'}        = $dbh->quote( $biblioitem->{'illus'} );
3211     $biblioitem->{'pages'}        = $dbh->quote( $biblioitem->{'pages'} );
3212     $biblioitem->{'volumeddesc'}  = $dbh->quote( $biblioitem->{'volumeddesc'} );
3213     $biblioitem->{'bnotes'}       = $dbh->quote( $biblioitem->{'bnotes'} );
3214     $biblioitem->{'size'}         = $dbh->quote( $biblioitem->{'size'} );
3215     $biblioitem->{'place'}        = $dbh->quote( $biblioitem->{'place'} );
3216     $biblioitem->{'ccode'}        = $dbh->quote( $biblioitem->{'ccode'} );
3217     $biblioitem->{'biblionumber'} =
3218       $dbh->quote( $biblioitem->{'biblionumber'} );
3219
3220     $query = "Update biblioitems set
3221         itemtype        = $biblioitem->{'itemtype'},
3222         url             = $biblioitem->{'url'},
3223         isbn            = $biblioitem->{'isbn'},
3224         issn            = $biblioitem->{'issn'},
3225         publishercode   = $biblioitem->{'publishercode'},
3226         publicationyear = $biblioitem->{'publicationyear'},
3227         classification  = $biblioitem->{'classification'},
3228         dewey           = $biblioitem->{'dewey'},
3229         subclass        = $biblioitem->{'subclass'},
3230         illus           = $biblioitem->{'illus'},
3231         pages           = $biblioitem->{'pages'},
3232         volumeddesc     = $biblioitem->{'volumeddesc'},
3233         notes           = $biblioitem->{'bnotes'},
3234         size            = $biblioitem->{'size'},
3235         place           = $biblioitem->{'place'},
3236         ccode           = $biblioitem->{'ccode'}
3237         where biblionumber = $biblioitem->{'biblionumber'}";
3238
3239     $dbh->do($query);
3240     if ( $dbh->errstr ) {
3241         warn "ERROR in _koha_modify_biblioitem $query";
3242     }
3243 }
3244
3245 =head2 _koha_add_biblioitem
3246
3247 =over 4
3248
3249 _koha_add_biblioitem( $dbh, $biblioitem );
3250
3251 Internal function to add a biblioitem
3252
3253 =back
3254
3255 =cut
3256
3257 sub _koha_add_biblioitem {
3258     my ( $dbh, $biblioitem ) = @_;
3259
3260     #  my $dbh   = C4Connect;
3261     my $sth = $dbh->prepare("SELECT max(biblioitemnumber) FROM biblioitems");
3262     my $data;
3263     my $bibitemnum;
3264
3265     $sth->execute;
3266     $data       = $sth->fetchrow_arrayref;
3267     $bibitemnum = $$data[0] + 1;
3268
3269     $sth->finish;
3270
3271     $sth = $dbh->prepare(
3272         "INSERT INTO biblioitems SET
3273             biblioitemnumber = ?, biblionumber    = ?,
3274             volume           = ?, number          = ?,
3275             classification   = ?, itemtype        = ?,
3276             url              = ?, isbn            = ?,
3277             issn             = ?, dewey           = ?,
3278             subclass         = ?, publicationyear = ?,
3279             publishercode    = ?, volumedate      = ?,
3280             volumeddesc      = ?, illus           = ?,
3281             pages            = ?, notes           = ?,
3282             size             = ?, lccn            = ?,
3283             marc             = ?, lcsort          =?,
3284             place            = ?, ccode           = ?
3285           "
3286     );
3287     my ($lcsort) =
3288       calculatelc( $biblioitem->{'classification'} )
3289       . $biblioitem->{'subclass'};
3290     $sth->execute(
3291         $bibitemnum,                     $biblioitem->{'biblionumber'},
3292         $biblioitem->{'volume'},         $biblioitem->{'number'},
3293         $biblioitem->{'classification'}, $biblioitem->{'itemtype'},
3294         $biblioitem->{'url'},            $biblioitem->{'isbn'},
3295         $biblioitem->{'issn'},           $biblioitem->{'dewey'},
3296         $biblioitem->{'subclass'},       $biblioitem->{'publicationyear'},
3297         $biblioitem->{'publishercode'},  $biblioitem->{'volumedate'},
3298         $biblioitem->{'volumeddesc'},    $biblioitem->{'illus'},
3299         $biblioitem->{'pages'},          $biblioitem->{'bnotes'},
3300         $biblioitem->{'size'},           $biblioitem->{'lccn'},
3301         $biblioitem->{'marc'},           $biblioitem->{'place'},
3302         $lcsort,                         $biblioitem->{'ccode'}
3303     );
3304     $sth->finish;
3305     return ($bibitemnum);
3306 }
3307
3308 =head2 _koha_new_items
3309
3310 =over 4
3311
3312 _koha_new_items( $dbh, $item, $barcode );
3313
3314 =back
3315
3316 =cut
3317
3318 sub _koha_new_items {
3319     my ( $dbh, $item, $barcode ) = @_;
3320
3321     #  my $dbh   = C4Connect;
3322     my $sth = $dbh->prepare("Select max(itemnumber) from items");
3323     my $data;
3324     my $itemnumber;
3325     my $error = "";
3326
3327     $sth->execute;
3328     $data       = $sth->fetchrow_hashref;
3329     $itemnumber = $data->{'max(itemnumber)'} + 1;
3330     $sth->finish;
3331 ## Now calculate lccalnumber
3332     my ($cutterextra) = itemcalculator(
3333         $dbh,
3334         $item->{'biblioitemnumber'},
3335         $item->{'itemcallnumber'}
3336     );
3337
3338 # FIXME the "notforloan" field seems to be named "loan" in some places. workaround bugfix.
3339     if ( $item->{'loan'} ) {
3340         $item->{'notforloan'} = $item->{'loan'};
3341     }
3342
3343     # if dateaccessioned is provided, use it. Otherwise, set to NOW()
3344     if ( $item->{'dateaccessioned'} eq '' || !$item->{'dateaccessioned'} ) {
3345
3346         $sth = $dbh->prepare(
3347             "Insert into items set
3348             itemnumber           = ?,     biblionumber     = ?,
3349             multivolumepart      = ?,
3350             biblioitemnumber     = ?,     barcode          = ?,
3351             booksellerid         = ?,     dateaccessioned  = NOW(),
3352             homebranch           = ?,     holdingbranch    = ?,
3353             price                = ?,     replacementprice = ?,
3354             replacementpricedate = NOW(), datelastseen     = NOW(),
3355             multivolume          = ?,     stack            = ?,
3356             itemlost             = ?,     wthdrawn         = ?,
3357             paidfor              = ?,     itemnotes        = ?,
3358             itemcallnumber       =?,      notforloan       = ?,
3359             location             = ?,     Cutterextra      = ?
3360           "
3361         );
3362         $sth->execute(
3363             $itemnumber,                $item->{'biblionumber'},
3364             $item->{'multivolumepart'}, $item->{'biblioitemnumber'},
3365             $barcode,                   $item->{'booksellerid'},
3366             $item->{'homebranch'},      $item->{'holdingbranch'},
3367             $item->{'price'},           $item->{'replacementprice'},
3368             $item->{multivolume},       $item->{stack},
3369             $item->{itemlost},          $item->{wthdrawn},
3370             $item->{paidfor},           $item->{'itemnotes'},
3371             $item->{'itemcallnumber'},  $item->{'notforloan'},
3372             $item->{'location'},        $cutterextra
3373         );
3374     }
3375     else {
3376         $sth = $dbh->prepare(
3377             "INSERT INTO items SET
3378             itemnumber           = ?,     biblionumber     = ?,
3379             multivolumepart      = ?,
3380             biblioitemnumber     = ?,     barcode          = ?,
3381             booksellerid         = ?,     dateaccessioned  = ?,
3382             homebranch           = ?,     holdingbranch    = ?,
3383             price                = ?,     replacementprice = ?,
3384             replacementpricedate = NOW(), datelastseen     = NOW(),
3385             multivolume          = ?,     stack            = ?,
3386             itemlost             = ?,     wthdrawn         = ?,
3387             paidfor              = ?,     itemnotes        = ?,
3388             itemcallnumber       = ?,     notforloan       = ?,
3389             location             = ?,
3390             Cutterextra          = ?
3391                             "
3392         );
3393         $sth->execute(
3394             $itemnumber,                 $item->{'biblionumber'},
3395             $item->{'multivolumepart'},  $item->{'biblioitemnumber'},
3396             $barcode,                    $item->{'booksellerid'},
3397             $item->{'dateaccessioned'},  $item->{'homebranch'},
3398             $item->{'holdingbranch'},    $item->{'price'},
3399             $item->{'replacementprice'}, $item->{multivolume},
3400             $item->{stack},              $item->{itemlost},
3401             $item->{wthdrawn},           $item->{paidfor},
3402             $item->{'itemnotes'},        $item->{'itemcallnumber'},
3403             $item->{'notforloan'},       $item->{'location'},
3404             $cutterextra
3405         );
3406     }
3407     if ( defined $sth->errstr ) {
3408         $error .= $sth->errstr;
3409     }
3410     return ( $itemnumber, $error );
3411 }
3412
3413 =head2 _koha_modify_item
3414
3415 =over 4
3416
3417 _koha_modify_item( $dbh, $item, $op );
3418
3419 =back
3420
3421 =cut
3422
3423 sub _koha_modify_item {
3424     my ( $dbh, $item, $op ) = @_;
3425     $item->{'itemnum'} = $item->{'itemnumber'} unless $item->{'itemnum'};
3426
3427     # if all we're doing is setting statuses, just update those and get out
3428     if ( $op eq "setstatus" ) {
3429         my $query =
3430           "UPDATE items SET itemlost=?,wthdrawn=?,binding=? WHERE itemnumber=?";
3431         my @bind = (
3432             $item->{'itemlost'}, $item->{'wthdrawn'},
3433             $item->{'binding'},  $item->{'itemnumber'}
3434         );
3435         my $sth = $dbh->prepare($query);
3436         $sth->execute(@bind);
3437         $sth->finish;
3438         return undef;
3439     }
3440 ## Now calculate lccalnumber
3441     my ($cutterextra) =
3442       itemcalculator( $dbh, $item->{'bibitemnum'}, $item->{'itemcallnumber'} );
3443
3444     my $query = "UPDATE items SET
3445 barcode=?,itemnotes=?,itemcallnumber=?,notforloan=?,location=?,multivolumepart=?,multivolume=?,stack=?,wthdrawn=?,holdingbranch=?,homebranch=?,cutterextra=?, onloan=?, binding=?";
3446
3447     my @bind = (
3448         $item->{'barcode'},        $item->{'notes'},
3449         $item->{'itemcallnumber'}, $item->{'notforloan'},
3450         $item->{'location'},       $item->{multivolumepart},
3451         $item->{multivolume},      $item->{stack},
3452         $item->{wthdrawn},         $item->{holdingbranch},
3453         $item->{homebranch},       $cutterextra,
3454         $item->{onloan},           $item->{binding}
3455     );
3456     if ( $item->{'lost'} ne '' ) {
3457         $query =
3458 "update items set biblioitemnumber=?,barcode=?,itemnotes=?,homebranch=?,
3459                             itemlost=?,wthdrawn=?,itemcallnumber=?,notforloan=?,
3460                              location=?,multivolumepart=?,multivolume=?,stack=?,wthdrawn=?,holdingbranch=?,cutterextra=?,onloan=?, binding=?";
3461         @bind = (
3462             $item->{'bibitemnum'},     $item->{'barcode'},
3463             $item->{'notes'},          $item->{'homebranch'},
3464             $item->{'lost'},           $item->{'wthdrawn'},
3465             $item->{'itemcallnumber'}, $item->{'notforloan'},
3466             $item->{'location'},       $item->{multivolumepart},
3467             $item->{multivolume},      $item->{stack},
3468             $item->{wthdrawn},         $item->{holdingbranch},
3469             $cutterextra,              $item->{onloan},
3470             $item->{binding}
3471         );
3472         if ( $item->{homebranch} ) {
3473             $query .= ",homebranch=?";
3474             push @bind, $item->{homebranch};
3475         }
3476         if ( $item->{holdingbranch} ) {
3477             $query .= ",holdingbranch=?";
3478             push @bind, $item->{holdingbranch};
3479         }
3480     }
3481     $query .= " where itemnumber=?";
3482     push @bind, $item->{'itemnum'};
3483     if ( $item->{'replacement'} ne '' ) {
3484         $query =~ s/ where/,replacementprice='$item->{'replacement'}' where/;
3485     }
3486     my $sth = $dbh->prepare($query);
3487     $sth->execute(@bind);
3488     $sth->finish;
3489 }
3490
3491 =head2 _koha_delete_biblio
3492
3493 =over 4
3494
3495 $error = _koha_delete_biblio($dbh,$biblionumber);
3496
3497 Internal sub for deleting from biblio table -- also saves to deletedbiblio
3498
3499 C<$dbh> - the database handle
3500 C<$biblionumber> - the biblionumber of the biblio to be deleted
3501
3502 =back
3503
3504 =cut
3505
3506 # FIXME: add error handling
3507
3508 sub _koha_delete_biblio {
3509     my ( $dbh, $biblionumber ) = @_;
3510
3511     # get all the data for this biblio
3512     my $sth = $dbh->prepare("SELECT * FROM biblio WHERE biblionumber=?");
3513     $sth->execute($biblionumber);
3514
3515     if ( my $data = $sth->fetchrow_hashref ) {
3516
3517         # save the record in deletedbiblio
3518         # find the fields to save
3519         my $query = "INSERT INTO deletedbiblio SET ";
3520         my @bind  = ();
3521         foreach my $temp ( keys %$data ) {
3522             $query .= "$temp = ?,";
3523             push( @bind, $data->{$temp} );
3524         }
3525
3526         # replace the last , by ",?)"
3527         $query =~ s/\,$//;
3528         my $bkup_sth = $dbh->prepare($query);
3529         $bkup_sth->execute(@bind);
3530         $bkup_sth->finish;
3531
3532         # delete the biblio
3533         my $del_sth = $dbh->prepare("DELETE FROM biblio WHERE biblionumber=?");
3534         $del_sth->execute($biblionumber);
3535         $del_sth->finish;
3536     }
3537     $sth->finish;
3538     return undef;
3539 }
3540
3541 =head2 _koha_delete_biblioitems
3542
3543 =over 4
3544
3545 $error = _koha_delete_biblioitems($dbh,$biblioitemnumber);
3546
3547 Internal sub for deleting from biblioitems table -- also saves to deletedbiblioitems
3548
3549 C<$dbh> - the database handle
3550 C<$biblionumber> - the biblioitemnumber of the biblioitem to be deleted
3551
3552 =back
3553
3554 =cut
3555
3556 # FIXME: add error handling
3557
3558 sub _koha_delete_biblioitems {
3559     my ( $dbh, $biblioitemnumber ) = @_;
3560
3561     # get all the data for this biblioitem
3562     my $sth =
3563       $dbh->prepare("SELECT * FROM biblioitems WHERE biblioitemnumber=?");
3564     $sth->execute($biblioitemnumber);
3565
3566     if ( my $data = $sth->fetchrow_hashref ) {
3567
3568         # save the record in deletedbiblioitems
3569         # find the fields to save
3570         my $query = "INSERT INTO deletedbiblioitems SET ";
3571         my @bind  = ();
3572         foreach my $temp ( keys %$data ) {
3573             $query .= "$temp = ?,";
3574             push( @bind, $data->{$temp} );
3575         }
3576
3577         # replace the last , by ",?)"
3578         $query =~ s/\,$//;
3579         my $bkup_sth = $dbh->prepare($query);
3580         $bkup_sth->execute(@bind);
3581         $bkup_sth->finish;
3582
3583         # delete the biblioitem
3584         my $del_sth =
3585           $dbh->prepare("DELETE FROM biblioitems WHERE biblioitemnumber=?");
3586         $del_sth->execute($biblioitemnumber);
3587         $del_sth->finish;
3588     }
3589     $sth->finish;
3590     return undef;
3591 }
3592
3593 =head2 _koha_delete_item
3594
3595 =over 4
3596
3597 _koha_delete_item( $dbh, $itemnum );
3598
3599 Internal function to delete an item record from the koha tables
3600
3601 =back
3602
3603 =cut
3604
3605 sub _koha_delete_item {
3606     my ( $dbh, $itemnum ) = @_;
3607
3608     my $sth = $dbh->prepare("select * from items where itemnumber=?");
3609     $sth->execute($itemnum);
3610     my $data = $sth->fetchrow_hashref;
3611     $sth->finish;
3612     my $query = "Insert into deleteditems set ";
3613     my @bind  = ();
3614     foreach my $temp ( keys %$data ) {
3615         $query .= "$temp = ?,";
3616         push( @bind, $data->{$temp} );
3617     }
3618     $query =~ s/\,$//;
3619
3620     #  print $query;
3621     $sth = $dbh->prepare($query);
3622     $sth->execute(@bind);
3623     $sth->finish;
3624     $sth = $dbh->prepare("Delete from items where itemnumber=?");
3625     $sth->execute($itemnum);
3626     $sth->finish;
3627 }
3628
3629 =head1 UNEXPORTED FUNCTIONS
3630
3631 =over 4
3632
3633 =head2 calculatelc
3634
3635 $lc = calculatelc($classification);
3636
3637 =back
3638
3639 =cut
3640
3641 sub calculatelc {
3642     my ($classification) = @_;
3643     $classification =~ s/^\s+|\s+$//g;
3644     my $i = 0;
3645     my $lc2;
3646     my $lc1;
3647
3648     for ( $i = 0 ; $i < length($classification) ; $i++ ) {
3649         my $c = ( substr( $classification, $i, 1 ) );
3650         if ( $c ge '0' && $c le '9' ) {
3651
3652             $lc2 = substr( $classification, $i );
3653             last;
3654         }
3655         else {
3656             $lc1 .= substr( $classification, $i, 1 );
3657
3658         }
3659     }    #while
3660
3661     my $other = length($lc1);
3662     if ( !$lc1 ) {
3663         $other = 0;
3664     }
3665
3666     my $extras;
3667     if ( $other < 4 ) {
3668         for ( 1 .. ( 4 - $other ) ) {
3669             $extras .= "0";
3670         }
3671     }
3672     $lc1 .= $extras;
3673     $lc2 =~ s/^ //g;
3674
3675     $lc2 =~ s/ //g;
3676     $extras = "";
3677     ##Find the decimal part of $lc2
3678     my $pos = index( $lc2, "." );
3679     if ( $pos < 0 ) { $pos = length($lc2); }
3680     if ( $pos >= 0 && $pos < 5 ) {
3681         ##Pad lc2 with zeros to create a 5digit decimal needed in marc record to sort as numeric
3682
3683         for ( 1 .. ( 5 - $pos ) ) {
3684             $extras .= "0";
3685         }
3686     }
3687     $lc2 = $extras . $lc2;
3688     return ( $lc1 . $lc2 );
3689 }
3690
3691 =head2 itemcalculator
3692
3693 =over 4
3694
3695 $cutterextra = itemcalculator( $dbh, $biblioitem, $callnumber );
3696
3697 =back
3698
3699 =cut
3700
3701 sub itemcalculator {
3702     my ( $dbh, $biblioitem, $callnumber ) = @_;
3703     my $sth =
3704       $dbh->prepare(
3705 "select classification, subclass from biblioitems where biblioitemnumber=?"
3706       );
3707
3708     $sth->execute($biblioitem);
3709     my ( $classification, $subclass ) = $sth->fetchrow;
3710     my $all         = $classification . " " . $subclass;
3711     my $total       = length($all);
3712     my $cutterextra = substr( $callnumber, $total - 1 );
3713
3714     return $cutterextra;
3715 }
3716
3717 =head2 ModBiblioMarc
3718
3719 =over 4
3720
3721 &ModBiblioMarc($newrec,$biblionumber,$frameworkcode);
3722
3723 Add MARC data for a biblio to koha 
3724
3725 Function exported, but should NOT be used, unless you really know what you're doing
3726
3727 =back
3728
3729 =cut
3730
3731 sub ModBiblioMarc {
3732
3733 # pass the MARC::Record to this function, and it will create the records in the marc field
3734     my ( $record, $biblionumber, $frameworkcode ) = @_;
3735     my $dbh = C4::Context->dbh;
3736     my @fields = $record->fields();
3737     if ( !$frameworkcode ) {
3738         $frameworkcode = "";
3739     }
3740     my $sth =
3741       $dbh->prepare("UPDATE biblio SET frameworkcode=? WHERE biblionumber=?");
3742     $sth->execute( $frameworkcode, $biblionumber );
3743     $sth->finish;
3744     my $encoding = C4::Context->preference("marcflavour");
3745
3746 # deal with UNIMARC field 100 (encoding) : create it if needed & set encoding to unicode
3747     if ( $encoding eq "UNIMARC" ) {
3748         my $string;
3749         if ( length($record->subfield( 100, "a" )) == 35 ) {
3750             $string = $record->subfield( 100, "a" );
3751             my $f100 = $record->field(100);
3752             $record->delete_field($f100);
3753         }
3754         else {
3755             $string = POSIX::strftime( "%Y%m%d", localtime );
3756             $string =~ s/\-//g;
3757             $string = sprintf( "%-*s", 35, $string );
3758         }
3759         substr( $string, 22, 6, "frey50" );
3760         unless ( $record->subfield( 100, "a" ) ) {
3761             $record->insert_grouped_field(
3762                 MARC::Field->new( 100, "", "", "a" => $string ) );
3763         }
3764     }
3765 #     warn "biblionumber : ".$biblionumber;
3766     ModZebra($biblionumber,"specialUpdate","biblioserver",$record);
3767     $sth =
3768       $dbh->prepare(
3769         "update biblioitems set marc=?,marcxml=?  where biblionumber=?");
3770     $sth->execute( $record->as_usmarc(), $record->as_xml_record(),
3771         $biblionumber );
3772 #     warn $record->as_xml_record();
3773     $sth->finish;
3774     return $biblionumber;
3775 }
3776
3777 =head2 AddItemInMarc
3778
3779 =over 4
3780
3781 $newbiblionumber = AddItemInMarc( $record, $biblionumber, $frameworkcode );
3782
3783 Add an item in a MARC record and save the MARC record
3784
3785 Function exported, but should NOT be used, unless you really know what you're doing
3786
3787 =back
3788
3789 =cut
3790
3791 sub AddItemInMarc {
3792
3793 # pass the MARC::Record to this function, and it will create the records in the marc tables
3794     my ( $record, $biblionumber, $frameworkcode ) = @_;
3795     my $newrec = &GetMarcBiblio($biblionumber);
3796
3797     # create it
3798     my @fields = $record->fields();
3799     foreach my $field (@fields) {
3800         $newrec->append_fields($field);
3801     }
3802
3803     # FIXME: should we be making sure the biblionumbers are the same?
3804     my $newbiblionumber =
3805       &ModBiblioMarc( $newrec, $biblionumber, $frameworkcode );
3806     return $newbiblionumber;
3807 }
3808
3809 =head2 z3950_extended_services
3810
3811 z3950_extended_services($serviceType,$serviceOptions,$record);
3812
3813     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.
3814
3815 C<$serviceType> one of: itemorder,create,drop,commit,update,xmlupdate
3816
3817 C<$serviceOptions> a has of key/value pairs. For instance, if service_type is 'update', $service_options should contain:
3818
3819     action => update action, one of specialUpdate, recordInsert, recordReplace, recordDelete, elementUpdate.
3820
3821 and maybe
3822
3823     recordidOpaque => Opaque Record ID (user supplied) or recordidNumber => Record ID number (system number).
3824     syntax => the record syntax (transfer syntax)
3825     databaseName = Database from connection object
3826
3827     To set serviceOptions, call set_service_options($serviceType)
3828
3829 C<$record> the record, if one is needed for the service type
3830
3831     A record should be in XML. You can convert it to XML from MARC by running it through marc2xml().
3832
3833 =cut
3834
3835 sub z3950_extended_services {
3836     my ( $server, $serviceType, $action, $serviceOptions ) = @_;
3837
3838     # get our connection object
3839     my $Zconn = C4::Context->Zconn( $server, 0, 1 );
3840
3841     # create a new package object
3842     my $Zpackage = $Zconn->package();
3843
3844     # set our options
3845     $Zpackage->option( action => $action );
3846
3847     if ( $serviceOptions->{'databaseName'} ) {
3848         $Zpackage->option( databaseName => $serviceOptions->{'databaseName'} );
3849     }
3850     if ( $serviceOptions->{'recordIdNumber'} ) {
3851         $Zpackage->option(
3852             recordIdNumber => $serviceOptions->{'recordIdNumber'} );
3853     }
3854     if ( $serviceOptions->{'recordIdOpaque'} ) {
3855         $Zpackage->option(
3856             recordIdOpaque => $serviceOptions->{'recordIdOpaque'} );
3857     }
3858
3859  # this is an ILL request (Zebra doesn't support it, but Koha could eventually)
3860  #if ($serviceType eq 'itemorder') {
3861  #   $Zpackage->option('contact-name' => $serviceOptions->{'contact-name'});
3862  #   $Zpackage->option('contact-phone' => $serviceOptions->{'contact-phone'});
3863  #   $Zpackage->option('contact-email' => $serviceOptions->{'contact-email'});
3864  #   $Zpackage->option('itemorder-item' => $serviceOptions->{'itemorder-item'});
3865  #}
3866
3867     if ( $serviceOptions->{record} ) {
3868         $Zpackage->option( record => $serviceOptions->{record} );
3869
3870         # can be xml or marc
3871         if ( $serviceOptions->{'syntax'} ) {
3872             $Zpackage->option( syntax => $serviceOptions->{'syntax'} );
3873         }
3874     }
3875
3876     # send the request, handle any exception encountered
3877     eval { $Zpackage->send($serviceType) };
3878     if ( $@ && $@->isa("ZOOM::Exception") ) {
3879         return "error:  " . $@->code() . " " . $@->message() . "\n";
3880     }
3881
3882     # free up package resources
3883     $Zpackage->destroy();
3884 }
3885
3886 =head2 set_service_options
3887
3888 my $serviceOptions = set_service_options($serviceType);
3889
3890 C<$serviceType> itemorder,create,drop,commit,update,xmlupdate
3891
3892 Currently, we only support 'create', 'commit', and 'update'. 'drop' support will be added as soon as Zebra supports it.
3893
3894 =cut
3895
3896 sub set_service_options {
3897     my ($serviceType) = @_;
3898     my $serviceOptions;
3899
3900 # FIXME: This needs to be an OID ... if we ever need 'syntax' this sub will need to change
3901 #   $serviceOptions->{ 'syntax' } = ''; #zebra doesn't support syntaxes other than xml
3902
3903     if ( $serviceType eq 'commit' ) {
3904
3905         # nothing to do
3906     }
3907     if ( $serviceType eq 'create' ) {
3908
3909         # nothing to do
3910     }
3911     if ( $serviceType eq 'drop' ) {
3912         die "ERROR: 'drop' not currently supported (by Zebra)";
3913     }
3914     return $serviceOptions;
3915 }
3916
3917 =head2 GetItemsCount
3918
3919 $count = &GetItemsCount( $biblionumber);
3920 this function return count of item with $biblionumber
3921 =cut
3922
3923 sub GetItemsCount {
3924     my ( $biblionumber ) = @_;
3925     my $dbh = C4::Context->dbh;
3926     my $query = qq|SELECT count(*)
3927                   FROM  items 
3928                   WHERE biblionumber=?|;
3929     my $sth = $dbh->prepare($query);
3930     $sth->execute($biblionumber);
3931     my $count = $sth->fetchrow;  
3932     $sth->finish;
3933     return ($count);
3934 }
3935
3936
3937
3938
3939 END { }    # module clean-up code here (global destructor)
3940
3941 1;
3942
3943 __END__
3944
3945 =head1 AUTHOR
3946
3947 Koha Developement team <info@koha.org>
3948
3949 Paul POULAIN paul.poulain@free.fr
3950
3951 Joshua Ferraro jmf@liblime.com
3952
3953 =cut
3954
3955 # $Id$
3956 # $Log$
3957 # Revision 1.213  2007/06/25 15:01:45  tipaul
3958 # bugfixes on unimarc 100 handling (the field used for encoding)
3959 #
3960 # Revision 1.212  2007/06/15 13:44:44  tipaul
3961 # some fixes (and only fixes)
3962 #
3963 # Revision 1.211  2007/06/15 09:40:06  toins
3964 # do not get $3 $4 and $5 on GetMarcSubjects GetMarcAuthors on unimarc flavour.
3965 #
3966 # Revision 1.210  2007/06/13 13:03:34  toins
3967 # removing warn compilation.
3968 #
3969 # Revision 1.209  2007/05/23 16:19:40  tipaul
3970 # various bugfixes (minor) and french translation updated
3971 #
3972 # Revision 1.208  2007/05/22 09:13:54  tipaul
3973 # Bugfixes & improvements (various and minor) :
3974 # - updating templates to have tmpl_process3.pl running without any errors
3975 # - adding a drupal-like css for prog templates (with 3 small images)
3976 # - fixing some bugs in circulation & other scripts
3977 # - updating french translation
3978 # - fixing some typos in templates
3979 #
3980 # Revision 1.207  2007/05/22 08:51:19  hdl
3981 # Changing GetMarcStructure signature.
3982 # Deleting first parameter $dbh
3983 #
3984 # Revision 1.206  2007/05/21 08:44:17  btoumi
3985 # add security when u delete biblio :
3986 # u must delete linked items before delete biblio
3987 #
3988 # Revision 1.205  2007/05/11 16:04:03  btoumi
3989 # bug fix:
3990 # problem in  displayed label link  with subject in detail.tmpl
3991 # ex: label random => rdom
3992 #
3993 # Revision 1.204  2007/05/10 14:45:15  tipaul
3994 # Koha NoZebra :
3995 # - support for authorities
3996 # - some bugfixes in ordering and "CCL" parsing
3997 # - support for authorities <=> biblios walking
3998 #
3999 # Seems I can do what I want now, so I consider its done, except for bugfixes that will be needed i m sure !
4000 #
4001 # Revision 1.203  2007/05/03 15:16:02  tipaul
4002 # BUGFIX for : NoZebra
4003 # - NoZebra features : seems they work fine now (adding, modifying, deleting)
4004 # - Biblio edition major bugfix : before this commit editing a biblio resulted in an item removal in marcxml field
4005 #
4006 # Revision 1.202  2007/05/02 16:44:31  tipaul
4007 # NoZebra SQL index management :
4008 # * adding 3 subs in Biblio.pm
4009 # - GetNoZebraIndexes, that get the index structure in a new systempreference (added with this commit)
4010 # - _DelBiblioNoZebra, that retrieve all index entries for a biblio and remove in a variable the biblio reference
4011 # - _AddBiblioNoZebra, that add index entries for a biblio.
4012 # 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).
4013 # I think the code has to be more deeply tested, but it works at least partially.
4014 #
4015 # Revision 1.201  2007/04/27 14:00:49  hdl
4016 # Removing $dbh from GetMarcFromKohaField (dbh is not used in this function.)
4017 #
4018 # Revision 1.200  2007/04/25 16:26:42  tipaul
4019 # 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 :
4020 # - add nozebra table management on biblio editing
4021 # - the index table content is hardcoded. I still have to add some specific systempref to let the library update it
4022 # - manage pagination (next/previous)
4023 # - manage facets
4024 # WHAT works :
4025 # - NZgetRecords : has exactly the same API & returns as zebra getQuery, except that some parameters are unused
4026 # - search & sort works quite good
4027 # - CQL parser is better that what I thought I could do : title="harry and sally" and publicationyear>2000 not itemtype=LIVR should work fine
4028 #
4029 # Revision 1.199  2007/04/24 09:07:53  tipaul
4030 # moving dotransfer to Biblio.pm::ModItemTransfer + some CheckReserves fixes
4031 #
4032 # Revision 1.198  2007/04/23 15:21:17  tipaul
4033 # renaming currenttransfers to transferstoreceive
4034 #
4035 # Revision 1.197  2007/04/18 17:00:14  tipaul
4036 # removing all useless %env / $env
4037 #
4038 # Revision 1.196  2007/04/17 08:48:00  tipaul
4039 # circulation cleaning continued: bufixing
4040 #
4041 # Revision 1.195  2007/04/04 16:46:22  tipaul
4042 # HUGE COMMIT : code cleaning circulation.
4043 #
4044 # some stuff to do, i'll write a mail on koha-devel NOW !
4045 #
4046 # Revision 1.194  2007/03/30 12:00:42  tipaul
4047 # 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...
4048 #
4049 # Revision 1.193  2007/03/29 16:45:53  tipaul
4050 # Code cleaning of Biblio.pm (continued)
4051 #
4052 # All subs have be cleaned :
4053 # - removed useless
4054 # - merged some
4055 # - reordering Biblio.pm completly
4056 # - using only naming conventions
4057 #
4058 # Seems to have broken nothing, but it still has to be heavily tested.
4059 # Note that Biblio.pm is now much more efficient than previously & probably more reliable as well.
4060 #
4061 # Revision 1.192  2007/03/29 13:30:31  tipaul
4062 # Code cleaning :
4063 # == Biblio.pm cleaning (useless) ==
4064 # * some sub declaration dropped
4065 # * removed modbiblio sub
4066 # * removed moditem sub
4067 # * removed newitems. It was used only in finishrecieve. Replaced by a TransformKohaToMarc+AddItem, that is better.
4068 # * removed MARCkoha2marcItem
4069 # * removed MARCdelsubfield declaration
4070 # * removed MARCkoha2marcBiblio
4071 #
4072 # == Biblio.pm cleaning (naming conventions) ==
4073 # * MARCgettagslib renamed to GetMarcStructure
4074 # * MARCgetitems renamed to GetMarcItem
4075 # * MARCfind_frameworkcode renamed to GetFrameworkCode
4076 # * MARCmarc2koha renamed to TransformMarcToKoha
4077 # * MARChtml2marc renamed to TransformHtmlToMarc
4078 # * MARChtml2xml renamed to TranformeHtmlToXml
4079 # * zebraop renamed to ModZebra
4080 #
4081 # == MARC=OFF ==
4082 # * removing MARC=OFF related scripts (in cataloguing directory)
4083 # * removed checkitems (function related to MARC=off feature, that is completly broken in head. If someone want to reintroduce it, hard work coming...)
4084 # * removed getitemsbybiblioitem (used only by MARC=OFF scripts, that is removed as well)
4085 #
4086 # Revision 1.191  2007/03/29 09:42:13  tipaul
4087 # adding default value new feature into cataloguing. The system (definition) part has already been added by toins
4088 #
4089 # Revision 1.190  2007/03/29 08:45:19  hdl
4090 # Deleting ignore_errors(1) pour MARC::Charset
4091 #
4092 # Revision 1.189  2007/03/28 10:39:16  hdl
4093 # removing $dbh as a parameter in AuthoritiesMarc functions
4094 # And reporting all differences into the scripts taht relies on those functions.