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, $auth_type )
1989
1990 $auth_type contains :
1991 - nothing : rebuild a biblio, un UNIMARC the encoding is in 100$a pos 26/27
1992 - UNIMARCAUTH : rebuild an authority. In UNIMARC, the encoding is in 100$a pos 13/14
1993 - ITEM : rebuild an item : in UNIMARC, 100$a, it's in the biblio ! (otherwise, we would get 2 100 fields !)
1994 =back
1995
1996 =cut
1997
1998 sub TransformHtmlToXml {
1999     my ( $tags, $subfields, $values, $indicator, $ind_tag, $auth_type ) = @_;
2000     my $xml = MARC::File::XML::header('UTF-8');
2001     $auth_type = C4::Context->preference('marcflavour') unless $auth_type;
2002     MARC::File::XML->default_record_format($auth_type);
2003     # in UNIMARC, field 100 contains the encoding
2004     # check that there is one, otherwise the
2005     # MARC::Record->new_from_xml will fail (and Koha will die)
2006     my $unimarc_and_100_exist=0;
2007     $unimarc_and_100_exist=1 if $auth_type eq 'ITEM'; # if we rebuild an item, no need of a 100 field
2008     my $prevvalue;
2009     my $prevtag = -1;
2010     my $first   = 1;
2011     my $j       = -1;
2012     for ( my $i = 0 ; $i <= @$tags ; $i++ ) {
2013         if (C4::Context->preference('marcflavour') eq 'UNIMARC' and @$tags[$i] eq "100" and @$subfields[$i] eq "a") {
2014             # if we have a 100 field and it's values are not correct, skip them.
2015             # if we don't have any valid 100 field, we will create a default one at the end
2016             my $enc = substr( @$values[$i], 26, 2 );
2017             if ($enc eq '01' or $enc eq '50' or $enc eq '03') {
2018                 $unimarc_and_100_exist=1;
2019             } else {
2020                 next;
2021             }
2022         }
2023         @$values[$i] =~ s/&/&amp;/g;
2024         @$values[$i] =~ s/</&lt;/g;
2025         @$values[$i] =~ s/>/&gt;/g;
2026         @$values[$i] =~ s/"/&quot;/g;
2027         @$values[$i] =~ s/'/&apos;/g;
2028         if ( !utf8::is_utf8( @$values[$i] ) ) {
2029             utf8::decode( @$values[$i] );
2030         }
2031         if ( ( @$tags[$i] ne $prevtag ) ) {
2032             $j++ unless ( @$tags[$i] eq "" );
2033             if ( !$first ) {
2034                 $xml .= "</datafield>\n";
2035                 if (   ( @$tags[$i] && @$tags[$i] > 10 )
2036                     && ( @$values[$i] ne "" ) )
2037                 {
2038                     my $ind1 = substr( @$indicator[$j], 0, 1 );
2039                     my $ind2;
2040                     if ( @$indicator[$j] ) {
2041                         $ind2 = substr( @$indicator[$j], 1, 1 );
2042                     }
2043                     else {
2044                         warn "Indicator in @$tags[$i] is empty";
2045                         $ind2 = " ";
2046                     }
2047                     $xml .=
2048 "<datafield tag=\"@$tags[$i]\" ind1=\"$ind1\" ind2=\"$ind2\">\n";
2049                     $xml .=
2050 "<subfield code=\"@$subfields[$i]\">@$values[$i]</subfield>\n";
2051                     $first = 0;
2052                 }
2053                 else {
2054                     $first = 1;
2055                 }
2056             }
2057             else {
2058                 if ( @$values[$i] ne "" ) {
2059
2060                     # leader
2061                     if ( @$tags[$i] eq "000" ) {
2062                         $xml .= "<leader>@$values[$i]</leader>\n";
2063                         $first = 1;
2064
2065                         # rest of the fixed fields
2066                     }
2067                     elsif ( @$tags[$i] < 10 ) {
2068                         $xml .=
2069 "<controlfield tag=\"@$tags[$i]\">@$values[$i]</controlfield>\n";
2070                         $first = 1;
2071                     }
2072                     else {
2073                         my $ind1 = substr( @$indicator[$j], 0, 1 );
2074                         my $ind2 = substr( @$indicator[$j], 1, 1 );
2075                         $xml .=
2076 "<datafield tag=\"@$tags[$i]\" ind1=\"$ind1\" ind2=\"$ind2\">\n";
2077                         $xml .=
2078 "<subfield code=\"@$subfields[$i]\">@$values[$i]</subfield>\n";
2079                         $first = 0;
2080                     }
2081                 }
2082             }
2083         }
2084         else {    # @$tags[$i] eq $prevtag
2085             if ( @$values[$i] eq "" ) {
2086             }
2087             else {
2088                 if ($first) {
2089                     my $ind1 = substr( @$indicator[$j], 0, 1 );
2090                     my $ind2 = substr( @$indicator[$j], 1, 1 );
2091                     $xml .=
2092 "<datafield tag=\"@$tags[$i]\" ind1=\"$ind1\" ind2=\"$ind2\">\n";
2093                     $first = 0;
2094                 }
2095                 $xml .=
2096 "<subfield code=\"@$subfields[$i]\">@$values[$i]</subfield>\n";
2097             }
2098         }
2099         $prevtag = @$tags[$i];
2100     }
2101     if (C4::Context->preference('marcflavour') and !$unimarc_and_100_exist) {
2102 #     warn "SETTING 100 for $auth_type";
2103         use POSIX qw(strftime);
2104         my $string = strftime( "%Y%m%d", localtime(time) );
2105         # set 50 to position 26 is biblios, 13 if authorities
2106         my $pos=26;
2107         $pos=13 if $auth_type eq 'UNIMARCAUTH';
2108         $string = sprintf( "%-*s", 35, $string );
2109         substr( $string, $pos , 6, "50" );
2110         $xml .= "<datafield tag=\"100\" ind1=\"\" ind2=\"\">\n";
2111         $xml .= "<subfield code=\"a\">$string</subfield>\n";
2112         $xml .= "</datafield>\n";
2113     }
2114     $xml .= MARC::File::XML::footer();
2115     return $xml;
2116 }
2117
2118 =head2 TransformHtmlToMarc
2119
2120 =over 4
2121
2122 $record = TransformHtmlToMarc( $dbh, $rtags, $rsubfields, $rvalues, %indicators )
2123
2124 =back
2125
2126 =cut
2127
2128 sub TransformHtmlToMarc {
2129     my ( $dbh, $rtags, $rsubfields, $rvalues, %indicators ) = @_;
2130     my $prevtag = -1;
2131     my $record  = MARC::Record->new();
2132
2133     #     my %subfieldlist=();
2134     my $prevvalue;    # if tag <10
2135     my $field;        # if tag >=10
2136     for ( my $i = 0 ; $i < @$rtags ; $i++ ) {
2137         next unless @$rvalues[$i];
2138
2139  # rebuild MARC::Record
2140  #             warn "0=>".@$rtags[$i].@$rsubfields[$i]." = ".@$rvalues[$i].": ";
2141         if ( @$rtags[$i] ne $prevtag ) {
2142             if ( $prevtag < 10 ) {
2143                 if ($prevvalue) {
2144
2145                     if ( $prevtag ne '000' ) {
2146                         $record->insert_fields_ordered(
2147                             ( sprintf "%03s", $prevtag ), $prevvalue );
2148                     }
2149                     else {
2150
2151                         $record->leader($prevvalue);
2152
2153                     }
2154                 }
2155             }
2156             else {
2157                 if ($field) {
2158                     $record->insert_fields_ordered($field);
2159                 }
2160             }
2161             $indicators{ @$rtags[$i] } .= '  ';
2162             if ( @$rtags[$i] < 10 ) {
2163                 $prevvalue = @$rvalues[$i];
2164                 undef $field;
2165             }
2166             else {
2167                 undef $prevvalue;
2168                 $field = MARC::Field->new(
2169                     ( sprintf "%03s", @$rtags[$i] ),
2170                     substr( $indicators{ @$rtags[$i] }, 0, 1 ),
2171                     substr( $indicators{ @$rtags[$i] }, 1, 1 ),
2172                     @$rsubfields[$i] => @$rvalues[$i]
2173                 );
2174             }
2175             $prevtag = @$rtags[$i];
2176         }
2177         else {
2178             if ( @$rtags[$i] < 10 ) {
2179                 $prevvalue = @$rvalues[$i];
2180             }
2181             else {
2182                 if ( length( @$rvalues[$i] ) > 0 ) {
2183                     $field->add_subfields( @$rsubfields[$i] => @$rvalues[$i] );
2184                 }
2185             }
2186             $prevtag = @$rtags[$i];
2187         }
2188     }
2189
2190     # the last has not been included inside the loop... do it now !
2191     $record->insert_fields_ordered($field) if $field;
2192
2193     $record->encoding('UTF-8');
2194
2195     #    $record->MARC::File::USMARC::update_leader();
2196     return $record;
2197 }
2198
2199 =head2 TransformMarcToKoha
2200
2201 =over 4
2202
2203 $result = TransformMarcToKoha( $dbh, $record, $frameworkcode )
2204
2205 =back
2206
2207 =cut
2208
2209 sub TransformMarcToKoha {
2210     my ( $dbh, $record, $frameworkcode ) = @_;
2211     my $sth =
2212       $dbh->prepare(
2213 "select tagfield,tagsubfield from marc_subfield_structure where frameworkcode=? and kohafield=?"
2214       );
2215     my $result;
2216     my $sth2 = $dbh->prepare("SHOW COLUMNS from biblio");
2217     $sth2->execute;
2218     my $field;
2219     while ( ($field) = $sth2->fetchrow ) {
2220         $result =
2221           &TransformMarcToKohaOneField( "biblio", $field, $record, $result,
2222             $frameworkcode );
2223     }
2224     $sth2 = $dbh->prepare("SHOW COLUMNS from biblioitems");
2225     $sth2->execute;
2226     while ( ($field) = $sth2->fetchrow ) {
2227         if ( $field eq 'notes' ) { $field = 'bnotes'; }
2228         $result =
2229           &TransformMarcToKohaOneField( "biblioitems", $field, $record, $result,
2230             $frameworkcode );
2231     }
2232     $sth2 = $dbh->prepare("SHOW COLUMNS from items");
2233     $sth2->execute;
2234     while ( ($field) = $sth2->fetchrow ) {
2235         $result =
2236           &TransformMarcToKohaOneField( "items", $field, $record, $result,
2237             $frameworkcode );
2238     }
2239
2240     #
2241     # modify copyrightdate to keep only the 1st year found
2242     my $temp = $result->{'copyrightdate'};
2243     $temp =~ m/c(\d\d\d\d)/;    # search cYYYY first
2244     if ( $1 > 0 ) {
2245         $result->{'copyrightdate'} = $1;
2246     }
2247     else {                      # if no cYYYY, get the 1st date.
2248         $temp =~ m/(\d\d\d\d)/;
2249         $result->{'copyrightdate'} = $1;
2250     }
2251
2252     # modify publicationyear to keep only the 1st year found
2253     $temp = $result->{'publicationyear'};
2254     $temp =~ m/c(\d\d\d\d)/;    # search cYYYY first
2255     if ( $1 > 0 ) {
2256         $result->{'publicationyear'} = $1;
2257     }
2258     else {                      # if no cYYYY, get the 1st date.
2259         $temp =~ m/(\d\d\d\d)/;
2260         $result->{'publicationyear'} = $1;
2261     }
2262     return $result;
2263 }
2264
2265 =head2 TransformMarcToKohaOneField
2266
2267 =over 4
2268
2269 $result = TransformMarcToKohaOneField( $kohatable, $kohafield, $record, $result, $frameworkcode )
2270
2271 =back
2272
2273 =cut
2274
2275 sub TransformMarcToKohaOneField {
2276
2277 # FIXME ? if a field has a repeatable subfield that is used in old-db, only the 1st will be retrieved...
2278     my ( $kohatable, $kohafield, $record, $result, $frameworkcode ) = @_;
2279
2280     my $res = "";
2281     my ( $tagfield, $subfield ) =
2282       GetMarcFromKohaField( $kohatable . "." . $kohafield,
2283         $frameworkcode );
2284     foreach my $field ( $record->field($tagfield) ) {
2285         if ( $field->tag() < 10 ) {
2286             if ( $result->{$kohafield} ) {
2287                 $result->{$kohafield} .= " | " . $field->data();
2288             }
2289             else {
2290                 $result->{$kohafield} = $field->data();
2291             }
2292         }
2293         else {
2294             if ( $field->subfields ) {
2295                 my @subfields = $field->subfields();
2296                 foreach my $subfieldcount ( 0 .. $#subfields ) {
2297                     if ( $subfields[$subfieldcount][0] eq $subfield ) {
2298                         if ( $result->{$kohafield} ) {
2299                             $result->{$kohafield} .=
2300                               " | " . $subfields[$subfieldcount][1];
2301                         }
2302                         else {
2303                             $result->{$kohafield} =
2304                               $subfields[$subfieldcount][1];
2305                         }
2306                     }
2307                 }
2308             }
2309         }
2310     }
2311     return $result;
2312 }
2313 =head1  OTHER FUNCTIONS
2314
2315 =head2 char_decode
2316
2317 =over 4
2318
2319 my $string = char_decode( $string, $encoding );
2320
2321 converts ISO 5426 coded string to UTF-8
2322 sloppy code : should be improved in next issue
2323
2324 =back
2325
2326 =cut
2327
2328 sub char_decode {
2329     my ( $string, $encoding ) = @_;
2330     $_ = $string;
2331
2332     $encoding = C4::Context->preference("marcflavour") unless $encoding;
2333     if ( $encoding eq "UNIMARC" ) {
2334
2335         #         s/\xe1/Æ/gm;
2336         s/\xe2/Ğ/gm;
2337         s/\xe9/Ø/gm;
2338         s/\xec/ş/gm;
2339         s/\xf1/æ/gm;
2340         s/\xf3/ğ/gm;
2341         s/\xf9/ø/gm;
2342         s/\xfb/ß/gm;
2343         s/\xc1\x61/à/gm;
2344         s/\xc1\x65/è/gm;
2345         s/\xc1\x69/ì/gm;
2346         s/\xc1\x6f/ò/gm;
2347         s/\xc1\x75/ù/gm;
2348         s/\xc1\x41/À/gm;
2349         s/\xc1\x45/È/gm;
2350         s/\xc1\x49/Ì/gm;
2351         s/\xc1\x4f/Ò/gm;
2352         s/\xc1\x55/Ù/gm;
2353         s/\xc2\x41/Á/gm;
2354         s/\xc2\x45/É/gm;
2355         s/\xc2\x49/Í/gm;
2356         s/\xc2\x4f/Ó/gm;
2357         s/\xc2\x55/Ú/gm;
2358         s/\xc2\x59/İ/gm;
2359         s/\xc2\x61/á/gm;
2360         s/\xc2\x65/é/gm;
2361         s/\xc2\x69/í/gm;
2362         s/\xc2\x6f/ó/gm;
2363         s/\xc2\x75/ú/gm;
2364         s/\xc2\x79/ı/gm;
2365         s/\xc3\x41/Â/gm;
2366         s/\xc3\x45/Ê/gm;
2367         s/\xc3\x49/Î/gm;
2368         s/\xc3\x4f/Ô/gm;
2369         s/\xc3\x55/Û/gm;
2370         s/\xc3\x61/â/gm;
2371         s/\xc3\x65/ê/gm;
2372         s/\xc3\x69/î/gm;
2373         s/\xc3\x6f/ô/gm;
2374         s/\xc3\x75/û/gm;
2375         s/\xc4\x41/Ã/gm;
2376         s/\xc4\x4e/Ñ/gm;
2377         s/\xc4\x4f/Õ/gm;
2378         s/\xc4\x61/ã/gm;
2379         s/\xc4\x6e/ñ/gm;
2380         s/\xc4\x6f/õ/gm;
2381         s/\xc8\x41/Ä/gm;
2382         s/\xc8\x45/Ë/gm;
2383         s/\xc8\x49/Ï/gm;
2384         s/\xc8\x61/ä/gm;
2385         s/\xc8\x65/ë/gm;
2386         s/\xc8\x69/ï/gm;
2387         s/\xc8\x6F/ö/gm;
2388         s/\xc8\x75/ü/gm;
2389         s/\xc8\x76/ÿ/gm;
2390         s/\xc9\x41/Ä/gm;
2391         s/\xc9\x45/Ë/gm;
2392         s/\xc9\x49/Ï/gm;
2393         s/\xc9\x4f/Ö/gm;
2394         s/\xc9\x55/Ü/gm;
2395         s/\xc9\x61/ä/gm;
2396         s/\xc9\x6f/ö/gm;
2397         s/\xc9\x75/ü/gm;
2398         s/\xca\x41/Å/gm;
2399         s/\xca\x61/å/gm;
2400         s/\xd0\x43/Ç/gm;
2401         s/\xd0\x63/ç/gm;
2402
2403         # this handles non-sorting blocks (if implementation requires this)
2404         $string = nsb_clean($_);
2405     }
2406     elsif ( $encoding eq "USMARC" || $encoding eq "MARC21" ) {
2407         ##MARC-8 to UTF-8
2408
2409         s/\xe1\x61/à/gm;
2410         s/\xe1\x65/è/gm;
2411         s/\xe1\x69/ì/gm;
2412         s/\xe1\x6f/ò/gm;
2413         s/\xe1\x75/ù/gm;
2414         s/\xe1\x41/À/gm;
2415         s/\xe1\x45/È/gm;
2416         s/\xe1\x49/Ì/gm;
2417         s/\xe1\x4f/Ò/gm;
2418         s/\xe1\x55/Ù/gm;
2419         s/\xe2\x41/Á/gm;
2420         s/\xe2\x45/É/gm;
2421         s/\xe2\x49/Í/gm;
2422         s/\xe2\x4f/Ó/gm;
2423         s/\xe2\x55/Ú/gm;
2424         s/\xe2\x59/İ/gm;
2425         s/\xe2\x61/á/gm;
2426         s/\xe2\x65/é/gm;
2427         s/\xe2\x69/í/gm;
2428         s/\xe2\x6f/ó/gm;
2429         s/\xe2\x75/ú/gm;
2430         s/\xe2\x79/ı/gm;
2431         s/\xe3\x41/Â/gm;
2432         s/\xe3\x45/Ê/gm;
2433         s/\xe3\x49/Î/gm;
2434         s/\xe3\x4f/Ô/gm;
2435         s/\xe3\x55/Û/gm;
2436         s/\xe3\x61/â/gm;
2437         s/\xe3\x65/ê/gm;
2438         s/\xe3\x69/î/gm;
2439         s/\xe3\x6f/ô/gm;
2440         s/\xe3\x75/û/gm;
2441         s/\xe4\x41/Ã/gm;
2442         s/\xe4\x4e/Ñ/gm;
2443         s/\xe4\x4f/Õ/gm;
2444         s/\xe4\x61/ã/gm;
2445         s/\xe4\x6e/ñ/gm;
2446         s/\xe4\x6f/õ/gm;
2447         s/\xe6\x41/Ă/gm;
2448         s/\xe6\x45/Ĕ/gm;
2449         s/\xe6\x65/ĕ/gm;
2450         s/\xe6\x61/ă/gm;
2451         s/\xe8\x45/Ë/gm;
2452         s/\xe8\x49/Ï/gm;
2453         s/\xe8\x65/ë/gm;
2454         s/\xe8\x69/ï/gm;
2455         s/\xe8\x76/ÿ/gm;
2456         s/\xe9\x41/A/gm;
2457         s/\xe9\x4f/O/gm;
2458         s/\xe9\x55/U/gm;
2459         s/\xe9\x61/a/gm;
2460         s/\xe9\x6f/o/gm;
2461         s/\xe9\x75/u/gm;
2462         s/\xea\x41/A/gm;
2463         s/\xea\x61/a/gm;
2464
2465         #Additional Turkish characters
2466         s/\x1b//gm;
2467         s/\x1e//gm;
2468         s/(\xf0)s/\xc5\x9f/gm;
2469         s/(\xf0)S/\xc5\x9e/gm;
2470         s/(\xf0)c/ç/gm;
2471         s/(\xf0)C/Ç/gm;
2472         s/\xe7\x49/\\xc4\xb0/gm;
2473         s/(\xe6)G/\xc4\x9e/gm;
2474         s/(\xe6)g/ğ\xc4\x9f/gm;
2475         s/\xB8/ı/gm;
2476         s/\xB9/£/gm;
2477         s/(\xe8|\xc8)o/ö/gm;
2478         s/(\xe8|\xc8)O/Ö/gm;
2479         s/(\xe8|\xc8)u/ü/gm;
2480         s/(\xe8|\xc8)U/Ü/gm;
2481         s/\xc2\xb8/\xc4\xb1/gm;
2482         s/¸/\xc4\xb1/gm;
2483
2484         # this handles non-sorting blocks (if implementation requires this)
2485         $string = nsb_clean($_);
2486     }
2487     return ($string);
2488 }
2489
2490 =head2 nsb_clean
2491
2492 =over 4
2493
2494 my $string = nsb_clean( $string, $encoding );
2495
2496 =back
2497
2498 =cut
2499
2500 sub nsb_clean {
2501     my $NSB      = '\x88';    # NSB : begin Non Sorting Block
2502     my $NSE      = '\x89';    # NSE : Non Sorting Block end
2503                               # handles non sorting blocks
2504     my ($string) = @_;
2505     $_ = $string;
2506     s/$NSB/(/gm;
2507     s/[ ]{0,1}$NSE/) /gm;
2508     $string = $_;
2509     return ($string);
2510 }
2511
2512 =head2 PrepareItemrecordDisplay
2513
2514 =over 4
2515
2516 PrepareItemrecordDisplay($itemrecord,$bibnum,$itemumber);
2517
2518 Returns a hash with all the fields for Display a given item data in a template
2519
2520 =back
2521
2522 =cut
2523
2524 sub PrepareItemrecordDisplay {
2525
2526     my ( $bibnum, $itemnum ) = @_;
2527
2528     my $dbh = C4::Context->dbh;
2529     my $frameworkcode = &GetFrameworkCode( $bibnum );
2530     my ( $itemtagfield, $itemtagsubfield ) =
2531       &GetMarcFromKohaField( "items.itemnumber", $frameworkcode );
2532     my $tagslib = &GetMarcStructure( 1, $frameworkcode );
2533     my $itemrecord = GetMarcItem( $bibnum, $itemnum) if ($itemnum);
2534     my @loop_data;
2535     my $authorised_values_sth =
2536       $dbh->prepare(
2537 "select authorised_value,lib from authorised_values where category=? order by lib"
2538       );
2539     foreach my $tag ( sort keys %{$tagslib} ) {
2540         my $previous_tag = '';
2541         if ( $tag ne '' ) {
2542             # loop through each subfield
2543             my $cntsubf;
2544             foreach my $subfield ( sort keys %{ $tagslib->{$tag} } ) {
2545                 next if ( subfield_is_koha_internal_p($subfield) );
2546                 next if ( $tagslib->{$tag}->{$subfield}->{'tab'} ne "10" );
2547                 my %subfield_data;
2548                 $subfield_data{tag}           = $tag;
2549                 $subfield_data{subfield}      = $subfield;
2550                 $subfield_data{countsubfield} = $cntsubf++;
2551                 $subfield_data{kohafield}     =
2552                   $tagslib->{$tag}->{$subfield}->{'kohafield'};
2553
2554          #        $subfield_data{marc_lib}=$tagslib->{$tag}->{$subfield}->{lib};
2555                 $subfield_data{marc_lib} =
2556                     "<span id=\"error\" title=\""
2557                   . $tagslib->{$tag}->{$subfield}->{lib} . "\">"
2558                   . substr( $tagslib->{$tag}->{$subfield}->{lib}, 0, 12 )
2559                   . "</span>";
2560                 $subfield_data{mandatory} =
2561                   $tagslib->{$tag}->{$subfield}->{mandatory};
2562                 $subfield_data{repeatable} =
2563                   $tagslib->{$tag}->{$subfield}->{repeatable};
2564                 $subfield_data{hidden} = "display:none"
2565                   if $tagslib->{$tag}->{$subfield}->{hidden};
2566                 my ( $x, $value );
2567                 ( $x, $value ) = _find_value( $tag, $subfield, $itemrecord )
2568                   if ($itemrecord);
2569                 $value =~ s/"/&quot;/g;
2570
2571                 # search for itemcallnumber if applicable
2572                 if ( $tagslib->{$tag}->{$subfield}->{kohafield} eq
2573                     'items.itemcallnumber'
2574                     && C4::Context->preference('itemcallnumber') )
2575                 {
2576                     my $CNtag =
2577                       substr( C4::Context->preference('itemcallnumber'), 0, 3 );
2578                     my $CNsubfield =
2579                       substr( C4::Context->preference('itemcallnumber'), 3, 1 );
2580                     my $temp = $itemrecord->field($CNtag) if ($itemrecord);
2581                     if ($temp) {
2582                         $value = $temp->subfield($CNsubfield);
2583                     }
2584                 }
2585                 if ( $tagslib->{$tag}->{$subfield}->{authorised_value} ) {
2586                     my @authorised_values;
2587                     my %authorised_lib;
2588
2589                     # builds list, depending on authorised value...
2590                     #---- branch
2591                     if ( $tagslib->{$tag}->{$subfield}->{'authorised_value'} eq
2592                         "branches" )
2593                     {
2594                         if ( ( C4::Context->preference("IndependantBranches") )
2595                             && ( C4::Context->userenv->{flags} != 1 ) )
2596                         {
2597                             my $sth =
2598                               $dbh->prepare(
2599 "select branchcode,branchname from branches where branchcode = ? order by branchname"
2600                               );
2601                             $sth->execute( C4::Context->userenv->{branch} );
2602                             push @authorised_values, ""
2603                               unless (
2604                                 $tagslib->{$tag}->{$subfield}->{mandatory} );
2605                             while ( my ( $branchcode, $branchname ) =
2606                                 $sth->fetchrow_array )
2607                             {
2608                                 push @authorised_values, $branchcode;
2609                                 $authorised_lib{$branchcode} = $branchname;
2610                             }
2611                         }
2612                         else {
2613                             my $sth =
2614                               $dbh->prepare(
2615 "select branchcode,branchname from branches order by branchname"
2616                               );
2617                             $sth->execute;
2618                             push @authorised_values, ""
2619                               unless (
2620                                 $tagslib->{$tag}->{$subfield}->{mandatory} );
2621                             while ( my ( $branchcode, $branchname ) =
2622                                 $sth->fetchrow_array )
2623                             {
2624                                 push @authorised_values, $branchcode;
2625                                 $authorised_lib{$branchcode} = $branchname;
2626                             }
2627                         }
2628
2629                         #----- itemtypes
2630                     }
2631                     elsif ( $tagslib->{$tag}->{$subfield}->{authorised_value} eq
2632                         "itemtypes" )
2633                     {
2634                         my $sth =
2635                           $dbh->prepare(
2636 "select itemtype,description from itemtypes order by description"
2637                           );
2638                         $sth->execute;
2639                         push @authorised_values, ""
2640                           unless ( $tagslib->{$tag}->{$subfield}->{mandatory} );
2641                         while ( my ( $itemtype, $description ) =
2642                             $sth->fetchrow_array )
2643                         {
2644                             push @authorised_values, $itemtype;
2645                             $authorised_lib{$itemtype} = $description;
2646                         }
2647
2648                         #---- "true" authorised value
2649                     }
2650                     else {
2651                         $authorised_values_sth->execute(
2652                             $tagslib->{$tag}->{$subfield}->{authorised_value} );
2653                         push @authorised_values, ""
2654                           unless ( $tagslib->{$tag}->{$subfield}->{mandatory} );
2655                         while ( my ( $value, $lib ) =
2656                             $authorised_values_sth->fetchrow_array )
2657                         {
2658                             push @authorised_values, $value;
2659                             $authorised_lib{$value} = $lib;
2660                         }
2661                     }
2662                     $subfield_data{marc_value} = CGI::scrolling_list(
2663                         -name     => 'field_value',
2664                         -values   => \@authorised_values,
2665                         -default  => "$value",
2666                         -labels   => \%authorised_lib,
2667                         -size     => 1,
2668                         -tabindex => '',
2669                         -multiple => 0,
2670                     );
2671                 }
2672                 elsif ( $tagslib->{$tag}->{$subfield}->{thesaurus_category} ) {
2673                     $subfield_data{marc_value} =
2674 "<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>";
2675
2676 #"
2677 # COMMENTED OUT because No $i is provided with this API.
2678 # And thus, no value_builder can be activated.
2679 # BUT could be thought over.
2680 #         } elsif ($tagslib->{$tag}->{$subfield}->{'value_builder'}) {
2681 #             my $plugin="value_builder/".$tagslib->{$tag}->{$subfield}->{'value_builder'};
2682 #             require $plugin;
2683 #             my $extended_param = plugin_parameters($dbh,$itemrecord,$tagslib,$i,0);
2684 #             my ($function_name,$javascript) = plugin_javascript($dbh,$record,$tagslib,$i,0);
2685 #             $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";
2686                 }
2687                 else {
2688                     $subfield_data{marc_value} =
2689 "<input type=\"text\" name=\"field_value\" value=\"$value\" size=50 maxlength=255>";
2690                 }
2691                 push( @loop_data, \%subfield_data );
2692             }
2693         }
2694     }
2695     my $itemnumber = $itemrecord->subfield( $itemtagfield, $itemtagsubfield )
2696       if ( $itemrecord && $itemrecord->field($itemtagfield) );
2697     return {
2698         'itemtagfield'    => $itemtagfield,
2699         'itemtagsubfield' => $itemtagsubfield,
2700         'itemnumber'      => $itemnumber,
2701         'iteminformation' => \@loop_data
2702     };
2703 }
2704 #"
2705
2706 #
2707 # true ModZebra commented until indexdata fixes zebraDB crashes (it seems they occur on multiple updates
2708 # at the same time
2709 # replaced by a zebraqueue table, that is filled with ModZebra to run.
2710 # the table is emptied by misc/cronjobs/zebraqueue_start.pl script
2711 # =head2 ModZebrafiles
2712 #
2713 # &ModZebrafiles( $dbh, $biblionumber, $record, $folder, $server );
2714 #
2715 # =cut
2716 #
2717 # sub ModZebrafiles {
2718 #
2719 #     my ( $dbh, $biblionumber, $record, $folder, $server ) = @_;
2720 #
2721 #     my $op;
2722 #     my $zebradir =
2723 #       C4::Context->zebraconfig($server)->{directory} . "/" . $folder . "/";
2724 #     unless ( opendir( DIR, "$zebradir" ) ) {
2725 #         warn "$zebradir not found";
2726 #         return;
2727 #     }
2728 #     closedir DIR;
2729 #     my $filename = $zebradir . $biblionumber;
2730 #
2731 #     if ($record) {
2732 #         open( OUTPUT, ">", $filename . ".xml" );
2733 #         print OUTPUT $record;
2734 #         close OUTPUT;
2735 #     }
2736 # }
2737
2738 =head2 ModZebra
2739
2740 =over 4
2741
2742 ModZebra( $biblionumber, $op, $server, $newRecord );
2743
2744     $biblionumber is the biblionumber we want to index
2745     $op is specialUpdate or delete, and is used to know what we want to do
2746     $server is the server that we want to update
2747     $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.
2748 =back
2749
2750 =cut
2751
2752 sub ModZebra {
2753 ###Accepts a $server variable thus we can use it for biblios authorities or other zebra dbs
2754     my ( $biblionumber, $op, $server, $newRecord ) = @_;
2755 #     warn "ModZebra with : ( $biblionumber, $op, $server, $newRecord )";
2756     my $dbh=C4::Context->dbh;
2757     #warn "SERVER:".$server;
2758 #
2759 # true ModZebra commented until indexdata fixes zebraDB crashes (it seems they occur on multiple updates
2760 # at the same time
2761 # replaced by a zebraqueue table, that is filled with ModZebra to run.
2762 # the table is emptied by misc/cronjobs/zebraqueue_start.pl script
2763
2764     if (C4::Context->preference("NoZebra")) {
2765         # lock the nozebra table : we will read index lines, update them in Perl process
2766         # and write everything in 1 transaction.
2767         # lock the table to avoid someone else overwriting what we are doing
2768         $dbh->do('LOCK TABLES nozebra WRITE,biblio WRITE,biblioitems WRITE, systempreferences WRITE, auth_types WRITE, auth_header WRITE');
2769         my %result; # the result hash that will be builded by deletion / add, and written on mySQL at the end, to improve speed
2770         my $record;
2771         if ($server eq 'biblioserver') {
2772             $record= GetMarcBiblio($biblionumber);
2773         } else {
2774             $record= C4::AuthoritiesMarc::GetAuthority($biblionumber);
2775         }
2776         if ($op eq 'specialUpdate') {
2777             # OK, we have to add or update the record
2778             # 1st delete (virtually, in indexes) ...
2779             %result = _DelBiblioNoZebra($biblionumber,$record,$server);
2780             # ... add the record
2781             %result=_AddBiblioNoZebra($biblionumber,$newRecord, $server, %result);
2782         } else {
2783             # it's a deletion, delete the record...
2784 #             warn "DELETE the record $biblionumber on $server".$record->as_formatted;
2785             %result=_DelBiblioNoZebra($biblionumber,$record,$server);
2786         }
2787         # ok, now update the database...
2788         my $sth = $dbh->prepare("UPDATE nozebra SET biblionumbers=? WHERE server=? AND indexname=? AND value=?");
2789         foreach my $key (keys %result) {
2790             foreach my $index (keys %{$result{$key}}) {
2791 #                 warn "UPDATING : $server $key , $index with :".$result{$key}->{$index};
2792                 $sth->execute($result{$key}->{$index}, $server, $key, $index);
2793             }
2794         }
2795     $dbh->do('UNLOCK TABLES');
2796
2797     } else {
2798         #
2799         # we use zebra, just fill zebraqueue table
2800         #
2801         my $sth=$dbh->prepare("insert into zebraqueue  (biblio_auth_number ,server,operation) values(?,?,?)");
2802         $sth->execute($biblionumber,$server,$op);
2803         $sth->finish;
2804     }
2805 }
2806
2807 =head2 GetNoZebraIndexes
2808
2809 =cut
2810
2811 sub GetNoZebraIndexes {
2812     my $index = C4::Context->preference('NoZebraIndexes');
2813     my %indexes;
2814     foreach my $line (split /('|"),/,$index) {
2815         $line =~ /(.*)=>(.*)/;
2816         my $index = substr($1,1); # get the index, don't forget to remove initial ' or "
2817         my $fields = $2;
2818         $index =~ s/'|"| //g;
2819         $fields =~ s/'|"| //g;
2820         $indexes{$index}=$fields;
2821     }
2822     return %indexes;
2823 }
2824
2825 =head1 INTERNAL FUNCTIONS
2826
2827 =head2 _DelBiblioNoZebra($biblionumber,$record,$server);
2828
2829     function to delete a biblio in NoZebra indexes
2830     This function does NOT delete anything in database : it reads all the indexes entries
2831     that have to be deleted & delete them in the hash
2832     The SQL part is done either :
2833     - after the Add if we are modifying a biblio (delete + add again)
2834     - immediatly after this sub if we are doing a true deletion.
2835     $server can be 'biblioserver' or 'authorityserver' : it indexes biblios or authorities (in the same table, $server being part of the table itself
2836
2837 =cut
2838
2839
2840 sub _DelBiblioNoZebra {
2841     my ($biblionumber, $record, $server)=@_;
2842
2843     # Get the indexes
2844     my $dbh = C4::Context->dbh;
2845     # Get the indexes
2846     my %index;
2847     my $title;
2848     if ($server eq 'biblioserver') {
2849         %index=GetNoZebraIndexes;
2850         # get title of the record (to store the 10 first letters with the index)
2851         my ($titletag,$titlesubfield) = GetMarcFromKohaField('biblio.title');
2852         $title = lc($record->subfield($titletag,$titlesubfield));
2853     } else {
2854         # for authorities, the "title" is the $a mainentry
2855         my $authref = C4::AuthoritiesMarc::GetAuthType($record->subfield(152,'b'));
2856         warn "ERROR : authtype undefined for ".$record->as_formatted unless $authref;
2857         $title = $record->subfield($authref->{auth_tag_to_report},'a');
2858         $index{'mainmainentry'}= $authref->{'auth_tag_to_report'}.'a';
2859         $index{'mainentry'}    = $authref->{'auth_tag_to_report'}.'*';
2860         $index{'auth_type'}    = '152b';
2861     }
2862
2863     my %result;
2864     # remove blancks comma (that could cause problem when decoding the string for CQL retrieval) and regexp specific values
2865     $title =~ s/ |,|;|\[|\]|\(|\)|\*|-|'|=//g;
2866     # limit to 10 char, should be enough, and limit the DB size
2867     $title = substr($title,0,10);
2868     #parse each field
2869     my $sth2=$dbh->prepare('SELECT biblionumbers FROM nozebra WHERE server=? AND indexname=? AND value=?');
2870     foreach my $field ($record->fields()) {
2871         #parse each subfield
2872         next if $field->tag <10;
2873         foreach my $subfield ($field->subfields()) {
2874             my $tag = $field->tag();
2875             my $subfieldcode = $subfield->[0];
2876             my $indexed=0;
2877             # check each index to see if the subfield is stored somewhere
2878             # otherwise, store it in __RAW__ index
2879             foreach my $key (keys %index) {
2880 #                 warn "examining $key index : ".$index{$key}." for $tag $subfieldcode";
2881                 if ($index{$key} =~ /$tag\*/ or $index{$key} =~ /$tag$subfieldcode/) {
2882                     $indexed=1;
2883                     my $line= lc $subfield->[1];
2884                     # remove meaningless value in the field...
2885                     $line =~ s/-|\.|\?|,|;|!|'|\(|\)|\[|\]|{|}|"|<|>|&|\+|\*|\/|=|:/ /g;
2886                     # ... and split in words
2887                     foreach (split / /,$line) {
2888                         next unless $_; # skip  empty values (multiple spaces)
2889                         # if the entry is already here, do nothing, the biblionumber has already be removed
2890                         unless ($result{$key}->{$_} =~ /$biblionumber,$title\-(\d);/) {
2891                             # get the index value if it exist in the nozebra table and remove the entry, otherwise, do nothing
2892                             $sth2->execute($server,$key,$_);
2893                             my $existing_biblionumbers = $sth2->fetchrow;
2894                             # it exists
2895                             if ($existing_biblionumbers) {
2896 #                                 warn " existing for $key $_: $existing_biblionumbers";
2897                                 $result{$key}->{$_} =$existing_biblionumbers;
2898                                 $result{$key}->{$_} =~ s/$biblionumber,$title\-(\d);//;
2899                             }
2900                         }
2901                     }
2902                 }
2903             }
2904             # the subfield is not indexed, store it in __RAW__ index anyway
2905             unless ($indexed) {
2906                 my $line= lc $subfield->[1];
2907                 $line =~ s/-|\.|\?|,|;|!|'|\(|\)|\[|\]|{|}|"|<|>|&|\+|\*|\/|=|:/ /g;
2908                 # ... and split in words
2909                 foreach (split / /,$line) {
2910                     next unless $_; # skip  empty values (multiple spaces)
2911                     # if the entry is already here, do nothing, the biblionumber has already be removed
2912                     unless ($result{'__RAW__'}->{$_} =~ /$biblionumber,$title\-(\d);/) {
2913                         # get the index value if it exist in the nozebra table and remove the entry, otherwise, do nothing
2914                         $sth2->execute($server,'__RAW__',$_);
2915                         my $existing_biblionumbers = $sth2->fetchrow;
2916                         # it exists
2917                         if ($existing_biblionumbers) {
2918                             $result{'__RAW__'}->{$_} =$existing_biblionumbers;
2919                             $result{'__RAW__'}->{$_} =~ s/$biblionumber,$title\-(\d);//;
2920                         }
2921                     }
2922                 }
2923             }
2924         }
2925     }
2926     return %result;
2927 }
2928
2929 =head2 _DelBiblioNoZebra($biblionumber,$record);
2930
2931     function to delete a biblio in NoZebra indexes
2932
2933 =cut
2934
2935
2936 sub _AddBiblioNoZebra {
2937     my ($biblionumber, $record, $server, %result)=@_;
2938     my $dbh = C4::Context->dbh;
2939     # Get the indexes
2940     my %index;
2941     my $title;
2942     if ($server eq 'biblioserver') {
2943         %index=GetNoZebraIndexes;
2944         # get title of the record (to store the 10 first letters with the index)
2945         my ($titletag,$titlesubfield) = GetMarcFromKohaField('biblio.title');
2946         $title = lc($record->subfield($titletag,$titlesubfield));
2947     } else {
2948 #     warn "server : $server";
2949         # for authorities, the "title" is the $a mainentry
2950         my $authref = C4::AuthoritiesMarc::GetAuthType($record->subfield(152,'b'));
2951         warn "ERROR : authtype undefined for ".$record->as_formatted unless $authref;
2952         $title = $record->subfield($authref->{auth_tag_to_report},'a');
2953         $index{'mainmainentry'}=$authref->{auth_tag_to_report}.'a';
2954         $index{'mainentry'}    = $authref->{auth_tag_to_report}.'*';
2955         $index{'auth_type'}    = '152b';
2956     }
2957
2958     # remove blancks comma (that could cause problem when decoding the string for CQL retrieval) and regexp specific values
2959     $title =~ s/ |,|;|\[|\]|\(|\)|\*|-|'|=//g;
2960     # limit to 10 char, should be enough, and limit the DB size
2961     $title = substr($title,0,10);
2962     #parse each field
2963     my $sth2=$dbh->prepare('SELECT biblionumbers FROM nozebra WHERE server=? AND indexname=? AND value=?');
2964     foreach my $field ($record->fields()) {
2965         #parse each subfield
2966         next if $field->tag <10;
2967         foreach my $subfield ($field->subfields()) {
2968             my $tag = $field->tag();
2969             my $subfieldcode = $subfield->[0];
2970             my $indexed=0;
2971             # check each index to see if the subfield is stored somewhere
2972             # otherwise, store it in __RAW__ index
2973             foreach my $key (keys %index) {
2974 #                 warn "examining $key index : ".$index{$key}." for $tag $subfieldcode";
2975                 if ($index{$key} =~ /$tag\*/ or $index{$key} =~ /$tag$subfieldcode/) {
2976                     $indexed=1;
2977                     my $line= lc $subfield->[1];
2978                     # remove meaningless value in the field...
2979                     $line =~ s/-|\.|\?|,|;|!|'|\(|\)|\[|\]|{|}|"|<|>|&|\+|\*|\/|=|:/ /g;
2980                     # ... and split in words
2981                     foreach (split / /,$line) {
2982                         next unless $_; # skip  empty values (multiple spaces)
2983                         # if the entry is already here, improve weight
2984 #                         warn "managing $_";
2985                         if ($result{$key}->{$_} =~ /$biblionumber,$title\-(\d);/) {
2986                             my $weight=$1+1;
2987                             $result{$key}->{$_} =~ s/$biblionumber,$title\-(\d);//;
2988                             $result{$key}->{$_} .= "$biblionumber,$title-$weight;";
2989                         } else {
2990                             # get the value if it exist in the nozebra table, otherwise, create it
2991                             $sth2->execute($server,$key,$_);
2992                             my $existing_biblionumbers = $sth2->fetchrow;
2993                             # it exists
2994                             if ($existing_biblionumbers) {
2995                                 $result{$key}->{$_} =$existing_biblionumbers;
2996                                 my $weight=$1+1;
2997                                 $result{$key}->{$_} =~ s/$biblionumber,$title\-(\d);//;
2998                                 $result{$key}->{$_} .= "$biblionumber,$title-$weight;";
2999                             # create a new ligne for this entry
3000                             } else {
3001 #                             warn "INSERT : $server / $key / $_";
3002                                 $dbh->do('INSERT INTO nozebra SET server='.$dbh->quote($server).', indexname='.$dbh->quote($key).',value='.$dbh->quote($_));
3003                                 $result{$key}->{$_}.="$biblionumber,$title-1;";
3004                             }
3005                         }
3006                     }
3007                 }
3008             }
3009             # the subfield is not indexed, store it in __RAW__ index anyway
3010             unless ($indexed) {
3011                 my $line= lc $subfield->[1];
3012                 $line =~ s/-|\.|\?|,|;|!|'|\(|\)|\[|\]|{|}|"|<|>|&|\+|\*|\/|=|:/ /g;
3013                 # ... and split in words
3014                 foreach (split / /,$line) {
3015                     next unless $_; # skip  empty values (multiple spaces)
3016                     # if the entry is already here, improve weight
3017                     if ($result{'__RAW__'}->{$_} =~ /$biblionumber,$title\-(\d);/) {
3018                         my $weight=$1+1;
3019                         $result{'__RAW__'}->{$_} =~ s/$biblionumber,$title\-(\d);//;
3020                         $result{'__RAW__'}->{$_} .= "$biblionumber,$title-$weight;";
3021                     } else {
3022                         # get the value if it exist in the nozebra table, otherwise, create it
3023                         $sth2->execute($server,'__RAW__',$_);
3024                         my $existing_biblionumbers = $sth2->fetchrow;
3025                         # it exists
3026                         if ($existing_biblionumbers) {
3027                             $result{'__RAW__'}->{$_} =$existing_biblionumbers;
3028                             my $weight=$1+1;
3029                             $result{'__RAW__'}->{$_} =~ s/$biblionumber,$title\-(\d);//;
3030                             $result{'__RAW__'}->{$_} .= "$biblionumber,$title-$weight;";
3031                         # create a new ligne for this entry
3032                         } else {
3033                             $dbh->do('INSERT INTO nozebra SET server='.$dbh->quote($server).',  indexname="__RAW__",value='.$dbh->quote($_));
3034                             $result{'__RAW__'}->{$_}.="$biblionumber,$title-1;";
3035                         }
3036                     }
3037                 }
3038             }
3039         }
3040     }
3041     return %result;
3042 }
3043
3044
3045 =head2 MARCitemchange
3046
3047 =over 4
3048
3049 &MARCitemchange( $record, $itemfield, $newvalue )
3050
3051 Function to update a single value in an item field.
3052 Used twice, could probably be replaced by something else, but works well...
3053
3054 =back
3055
3056 =back
3057
3058 =cut
3059
3060 sub MARCitemchange {
3061     my ( $record, $itemfield, $newvalue ) = @_;
3062     my $dbh = C4::Context->dbh;
3063
3064     my ( $tagfield, $tagsubfield ) =
3065       GetMarcFromKohaField( $itemfield, "" );
3066     if ( ($tagfield) && ($tagsubfield) ) {
3067         my $tag = $record->field($tagfield);
3068         if ($tag) {
3069             $tag->update( $tagsubfield => $newvalue );
3070             $record->delete_field($tag);
3071             $record->insert_fields_ordered($tag);
3072         }
3073     }
3074 }
3075
3076 =head2 _koha_add_biblio
3077
3078 =over 4
3079
3080 _koha_add_biblio($dbh,$biblioitem);
3081
3082 Internal function to add a biblio ($biblio is a hash with the values)
3083
3084 =back
3085
3086 =cut
3087
3088 sub _koha_add_biblio {
3089     my ( $dbh, $biblio, $frameworkcode ) = @_;
3090     my $sth = $dbh->prepare("Select max(biblionumber) from biblio");
3091     $sth->execute;
3092     my $data         = $sth->fetchrow_arrayref;
3093     my $biblionumber = $$data[0] + 1;
3094     my $series       = 0;
3095
3096     if ( $biblio->{'seriestitle'} ) { $series = 1 }
3097     $sth->finish;
3098     $sth = $dbh->prepare(
3099         "INSERT INTO biblio
3100     SET biblionumber  = ?, title = ?, author = ?, copyrightdate = ?, serial = ?, seriestitle = ?, notes = ?, abstract = ?, unititle = ?, frameworkcode = ? "
3101     );
3102     $sth->execute(
3103         $biblionumber,         $biblio->{'title'},
3104         $biblio->{'author'},   $biblio->{'copyrightdate'},
3105         $biblio->{'serial'},   $biblio->{'seriestitle'},
3106         $biblio->{'notes'},    $biblio->{'abstract'},
3107         $biblio->{'unititle'}, $frameworkcode
3108     );
3109
3110     $sth->finish;
3111     return ($biblionumber);
3112 }
3113
3114 =head2 _find_value
3115
3116 =over 4
3117
3118 ($indicators, $value) = _find_value($tag, $subfield, $record,$encoding);
3119
3120 Find the given $subfield in the given $tag in the given
3121 MARC::Record $record.  If the subfield is found, returns
3122 the (indicators, value) pair; otherwise, (undef, undef) is
3123 returned.
3124
3125 PROPOSITION :
3126 Such a function is used in addbiblio AND additem and serial-edit and maybe could be used in Authorities.
3127 I suggest we export it from this module.
3128
3129 =back
3130
3131 =cut
3132
3133 sub _find_value {
3134     my ( $tagfield, $insubfield, $record, $encoding ) = @_;
3135     my @result;
3136     my $indicator;
3137     if ( $tagfield < 10 ) {
3138         if ( $record->field($tagfield) ) {
3139             push @result, $record->field($tagfield)->data();
3140         }
3141         else {
3142             push @result, "";
3143         }
3144     }
3145     else {
3146         foreach my $field ( $record->field($tagfield) ) {
3147             my @subfields = $field->subfields();
3148             foreach my $subfield (@subfields) {
3149                 if ( @$subfield[0] eq $insubfield ) {
3150                     push @result, @$subfield[1];
3151                     $indicator = $field->indicator(1) . $field->indicator(2);
3152                 }
3153             }
3154         }
3155     }
3156     return ( $indicator, @result );
3157 }
3158
3159 =head2 _koha_modify_biblio
3160
3161 =over 4
3162
3163 Internal function for updating the biblio table
3164
3165 =back
3166
3167 =cut
3168
3169 sub _koha_modify_biblio {
3170     my ( $dbh, $biblio ) = @_;
3171
3172 # FIXME: this code could be made more portable by not hard-coding the values that are supposed to be in biblio table
3173     my $sth =
3174       $dbh->prepare(
3175 "Update biblio set title = ?, author = ?, abstract = ?, copyrightdate = ?, seriestitle = ?, serial = ?, unititle = ?, notes = ? where biblionumber = ?"
3176       );
3177     $sth->execute(
3178         $biblio->{'title'},       $biblio->{'author'},
3179         $biblio->{'abstract'},    $biblio->{'copyrightdate'},
3180         $biblio->{'seriestitle'}, $biblio->{'serial'},
3181         $biblio->{'unititle'},    $biblio->{'notes'},
3182         $biblio->{'biblionumber'}
3183     );
3184     $sth->finish;
3185     return ( $biblio->{'biblionumber'} );
3186 }
3187
3188 =head2 _koha_modify_biblioitem
3189
3190 =over 4
3191
3192 _koha_modify_biblioitem( $dbh, $biblioitem );
3193
3194 =back
3195
3196 =cut
3197
3198 sub _koha_modify_biblioitem {
3199     my ( $dbh, $biblioitem ) = @_;
3200     my $query;
3201 ##Recalculate LC in case it changed --TG
3202
3203     $biblioitem->{'itemtype'}      = $dbh->quote( $biblioitem->{'itemtype'} );
3204     $biblioitem->{'url'}           = $dbh->quote( $biblioitem->{'url'} );
3205     $biblioitem->{'isbn'}          = $dbh->quote( $biblioitem->{'isbn'} );
3206     $biblioitem->{'issn'}          = $dbh->quote( $biblioitem->{'issn'} );
3207     $biblioitem->{'publishercode'} =
3208       $dbh->quote( $biblioitem->{'publishercode'} );
3209     $biblioitem->{'publicationyear'} =
3210       $dbh->quote( $biblioitem->{'publicationyear'} );
3211     $biblioitem->{'classification'} =
3212       $dbh->quote( $biblioitem->{'classification'} );
3213     $biblioitem->{'dewey'}        = $dbh->quote( $biblioitem->{'dewey'} );
3214     $biblioitem->{'subclass'}     = $dbh->quote( $biblioitem->{'subclass'} );
3215     $biblioitem->{'illus'}        = $dbh->quote( $biblioitem->{'illus'} );
3216     $biblioitem->{'pages'}        = $dbh->quote( $biblioitem->{'pages'} );
3217     $biblioitem->{'volumeddesc'}  = $dbh->quote( $biblioitem->{'volumeddesc'} );
3218     $biblioitem->{'bnotes'}       = $dbh->quote( $biblioitem->{'bnotes'} );
3219     $biblioitem->{'size'}         = $dbh->quote( $biblioitem->{'size'} );
3220     $biblioitem->{'place'}        = $dbh->quote( $biblioitem->{'place'} );
3221     $biblioitem->{'ccode'}        = $dbh->quote( $biblioitem->{'ccode'} );
3222     $biblioitem->{'biblionumber'} =
3223       $dbh->quote( $biblioitem->{'biblionumber'} );
3224
3225     $query = "Update biblioitems set
3226         itemtype        = $biblioitem->{'itemtype'},
3227         url             = $biblioitem->{'url'},
3228         isbn            = $biblioitem->{'isbn'},
3229         issn            = $biblioitem->{'issn'},
3230         publishercode   = $biblioitem->{'publishercode'},
3231         publicationyear = $biblioitem->{'publicationyear'},
3232         classification  = $biblioitem->{'classification'},
3233         dewey           = $biblioitem->{'dewey'},
3234         subclass        = $biblioitem->{'subclass'},
3235         illus           = $biblioitem->{'illus'},
3236         pages           = $biblioitem->{'pages'},
3237         volumeddesc     = $biblioitem->{'volumeddesc'},
3238         notes           = $biblioitem->{'bnotes'},
3239         size            = $biblioitem->{'size'},
3240         place           = $biblioitem->{'place'},
3241         ccode           = $biblioitem->{'ccode'}
3242         where biblionumber = $biblioitem->{'biblionumber'}";
3243
3244     $dbh->do($query);
3245     if ( $dbh->errstr ) {
3246         warn "ERROR in _koha_modify_biblioitem $query";
3247     }
3248 }
3249
3250 =head2 _koha_add_biblioitem
3251
3252 =over 4
3253
3254 _koha_add_biblioitem( $dbh, $biblioitem );
3255
3256 Internal function to add a biblioitem
3257
3258 =back
3259
3260 =cut
3261
3262 sub _koha_add_biblioitem {
3263     my ( $dbh, $biblioitem ) = @_;
3264
3265     #  my $dbh   = C4Connect;
3266     my $sth = $dbh->prepare("SELECT max(biblioitemnumber) FROM biblioitems");
3267     my $data;
3268     my $bibitemnum;
3269
3270     $sth->execute;
3271     $data       = $sth->fetchrow_arrayref;
3272     $bibitemnum = $$data[0] + 1;
3273
3274     $sth->finish;
3275
3276     $sth = $dbh->prepare(
3277         "INSERT INTO biblioitems SET
3278             biblioitemnumber = ?, biblionumber    = ?,
3279             volume           = ?, number          = ?,
3280             classification   = ?, itemtype        = ?,
3281             url              = ?, isbn            = ?,
3282             issn             = ?, dewey           = ?,
3283             subclass         = ?, publicationyear = ?,
3284             publishercode    = ?, volumedate      = ?,
3285             volumeddesc      = ?, illus           = ?,
3286             pages            = ?, notes           = ?,
3287             size             = ?, lccn            = ?,
3288             marc             = ?, lcsort          =?,
3289             place            = ?, ccode           = ?
3290           "
3291     );
3292     my ($lcsort) =
3293       calculatelc( $biblioitem->{'classification'} )
3294       . $biblioitem->{'subclass'};
3295     $sth->execute(
3296         $bibitemnum,                     $biblioitem->{'biblionumber'},
3297         $biblioitem->{'volume'},         $biblioitem->{'number'},
3298         $biblioitem->{'classification'}, $biblioitem->{'itemtype'},
3299         $biblioitem->{'url'},            $biblioitem->{'isbn'},
3300         $biblioitem->{'issn'},           $biblioitem->{'dewey'},
3301         $biblioitem->{'subclass'},       $biblioitem->{'publicationyear'},
3302         $biblioitem->{'publishercode'},  $biblioitem->{'volumedate'},
3303         $biblioitem->{'volumeddesc'},    $biblioitem->{'illus'},
3304         $biblioitem->{'pages'},          $biblioitem->{'bnotes'},
3305         $biblioitem->{'size'},           $biblioitem->{'lccn'},
3306         $biblioitem->{'marc'},           $biblioitem->{'place'},
3307         $lcsort,                         $biblioitem->{'ccode'}
3308     );
3309     $sth->finish;
3310     return ($bibitemnum);
3311 }
3312
3313 =head2 _koha_new_items
3314
3315 =over 4
3316
3317 _koha_new_items( $dbh, $item, $barcode );
3318
3319 =back
3320
3321 =cut
3322
3323 sub _koha_new_items {
3324     my ( $dbh, $item, $barcode ) = @_;
3325
3326     #  my $dbh   = C4Connect;
3327     my $sth = $dbh->prepare("Select max(itemnumber) from items");
3328     my $data;
3329     my $itemnumber;
3330     my $error = "";
3331
3332     $sth->execute;
3333     $data       = $sth->fetchrow_hashref;
3334     $itemnumber = $data->{'max(itemnumber)'} + 1;
3335     $sth->finish;
3336 ## Now calculate lccalnumber
3337     my ($cutterextra) = itemcalculator(
3338         $dbh,
3339         $item->{'biblioitemnumber'},
3340         $item->{'itemcallnumber'}
3341     );
3342
3343 # FIXME the "notforloan" field seems to be named "loan" in some places. workaround bugfix.
3344     if ( $item->{'loan'} ) {
3345         $item->{'notforloan'} = $item->{'loan'};
3346     }
3347
3348     # if dateaccessioned is provided, use it. Otherwise, set to NOW()
3349     if ( $item->{'dateaccessioned'} eq '' || !$item->{'dateaccessioned'} ) {
3350
3351         $sth = $dbh->prepare(
3352             "Insert into items set
3353             itemnumber           = ?,     biblionumber     = ?,
3354             multivolumepart      = ?,
3355             biblioitemnumber     = ?,     barcode          = ?,
3356             booksellerid         = ?,     dateaccessioned  = NOW(),
3357             homebranch           = ?,     holdingbranch    = ?,
3358             price                = ?,     replacementprice = ?,
3359             replacementpricedate = NOW(), datelastseen     = NOW(),
3360             multivolume          = ?,     stack            = ?,
3361             itemlost             = ?,     wthdrawn         = ?,
3362             paidfor              = ?,     itemnotes        = ?,
3363             itemcallnumber       =?,      notforloan       = ?,
3364             location             = ?,     Cutterextra      = ?
3365           "
3366         );
3367         $sth->execute(
3368             $itemnumber,                $item->{'biblionumber'},
3369             $item->{'multivolumepart'}, $item->{'biblioitemnumber'},
3370             $barcode,                   $item->{'booksellerid'},
3371             $item->{'homebranch'},      $item->{'holdingbranch'},
3372             $item->{'price'},           $item->{'replacementprice'},
3373             $item->{multivolume},       $item->{stack},
3374             $item->{itemlost},          $item->{wthdrawn},
3375             $item->{paidfor},           $item->{'itemnotes'},
3376             $item->{'itemcallnumber'},  $item->{'notforloan'},
3377             $item->{'location'},        $cutterextra
3378         );
3379     }
3380     else {
3381         $sth = $dbh->prepare(
3382             "INSERT INTO items SET
3383             itemnumber           = ?,     biblionumber     = ?,
3384             multivolumepart      = ?,
3385             biblioitemnumber     = ?,     barcode          = ?,
3386             booksellerid         = ?,     dateaccessioned  = ?,
3387             homebranch           = ?,     holdingbranch    = ?,
3388             price                = ?,     replacementprice = ?,
3389             replacementpricedate = NOW(), datelastseen     = NOW(),
3390             multivolume          = ?,     stack            = ?,
3391             itemlost             = ?,     wthdrawn         = ?,
3392             paidfor              = ?,     itemnotes        = ?,
3393             itemcallnumber       = ?,     notforloan       = ?,
3394             location             = ?,
3395             Cutterextra          = ?
3396                             "
3397         );
3398         $sth->execute(
3399             $itemnumber,                 $item->{'biblionumber'},
3400             $item->{'multivolumepart'},  $item->{'biblioitemnumber'},
3401             $barcode,                    $item->{'booksellerid'},
3402             $item->{'dateaccessioned'},  $item->{'homebranch'},
3403             $item->{'holdingbranch'},    $item->{'price'},
3404             $item->{'replacementprice'}, $item->{multivolume},
3405             $item->{stack},              $item->{itemlost},
3406             $item->{wthdrawn},           $item->{paidfor},
3407             $item->{'itemnotes'},        $item->{'itemcallnumber'},
3408             $item->{'notforloan'},       $item->{'location'},
3409             $cutterextra
3410         );
3411     }
3412     if ( defined $sth->errstr ) {
3413         $error .= $sth->errstr;
3414     }
3415     return ( $itemnumber, $error );
3416 }
3417
3418 =head2 _koha_modify_item
3419
3420 =over 4
3421
3422 _koha_modify_item( $dbh, $item, $op );
3423
3424 =back
3425
3426 =cut
3427
3428 sub _koha_modify_item {
3429     my ( $dbh, $item, $op ) = @_;
3430     $item->{'itemnum'} = $item->{'itemnumber'} unless $item->{'itemnum'};
3431
3432     # if all we're doing is setting statuses, just update those and get out
3433     if ( $op eq "setstatus" ) {
3434         my $query =
3435           "UPDATE items SET itemlost=?,wthdrawn=?,binding=? WHERE itemnumber=?";
3436         my @bind = (
3437             $item->{'itemlost'}, $item->{'wthdrawn'},
3438             $item->{'binding'},  $item->{'itemnumber'}
3439         );
3440         my $sth = $dbh->prepare($query);
3441         $sth->execute(@bind);
3442         $sth->finish;
3443         return undef;
3444     }
3445 ## Now calculate lccalnumber
3446     my ($cutterextra) =
3447       itemcalculator( $dbh, $item->{'bibitemnum'}, $item->{'itemcallnumber'} );
3448
3449     my $query = "UPDATE items SET
3450 barcode=?,itemnotes=?,itemcallnumber=?,notforloan=?,location=?,multivolumepart=?,multivolume=?,stack=?,wthdrawn=?,holdingbranch=?,homebranch=?,cutterextra=?, onloan=?, binding=?";
3451
3452     my @bind = (
3453         $item->{'barcode'},        $item->{'notes'},
3454         $item->{'itemcallnumber'}, $item->{'notforloan'},
3455         $item->{'location'},       $item->{multivolumepart},
3456         $item->{multivolume},      $item->{stack},
3457         $item->{wthdrawn},         $item->{holdingbranch},
3458         $item->{homebranch},       $cutterextra,
3459         $item->{onloan},           $item->{binding}
3460     );
3461     if ( $item->{'lost'} ne '' ) {
3462         $query =
3463 "update items set biblioitemnumber=?,barcode=?,itemnotes=?,homebranch=?,
3464                             itemlost=?,wthdrawn=?,itemcallnumber=?,notforloan=?,
3465                              location=?,multivolumepart=?,multivolume=?,stack=?,wthdrawn=?,holdingbranch=?,cutterextra=?,onloan=?, binding=?";
3466         @bind = (
3467             $item->{'bibitemnum'},     $item->{'barcode'},
3468             $item->{'notes'},          $item->{'homebranch'},
3469             $item->{'lost'},           $item->{'wthdrawn'},
3470             $item->{'itemcallnumber'}, $item->{'notforloan'},
3471             $item->{'location'},       $item->{multivolumepart},
3472             $item->{multivolume},      $item->{stack},
3473             $item->{wthdrawn},         $item->{holdingbranch},
3474             $cutterextra,              $item->{onloan},
3475             $item->{binding}
3476         );
3477         if ( $item->{homebranch} ) {
3478             $query .= ",homebranch=?";
3479             push @bind, $item->{homebranch};
3480         }
3481         if ( $item->{holdingbranch} ) {
3482             $query .= ",holdingbranch=?";
3483             push @bind, $item->{holdingbranch};
3484         }
3485     }
3486     $query .= " where itemnumber=?";
3487     push @bind, $item->{'itemnum'};
3488     if ( $item->{'replacement'} ne '' ) {
3489         $query =~ s/ where/,replacementprice='$item->{'replacement'}' where/;
3490     }
3491     my $sth = $dbh->prepare($query);
3492     $sth->execute(@bind);
3493     $sth->finish;
3494 }
3495
3496 =head2 _koha_delete_biblio
3497
3498 =over 4
3499
3500 $error = _koha_delete_biblio($dbh,$biblionumber);
3501
3502 Internal sub for deleting from biblio table -- also saves to deletedbiblio
3503
3504 C<$dbh> - the database handle
3505 C<$biblionumber> - the biblionumber of the biblio to be deleted
3506
3507 =back
3508
3509 =cut
3510
3511 # FIXME: add error handling
3512
3513 sub _koha_delete_biblio {
3514     my ( $dbh, $biblionumber ) = @_;
3515
3516     # get all the data for this biblio
3517     my $sth = $dbh->prepare("SELECT * FROM biblio WHERE biblionumber=?");
3518     $sth->execute($biblionumber);
3519
3520     if ( my $data = $sth->fetchrow_hashref ) {
3521
3522         # save the record in deletedbiblio
3523         # find the fields to save
3524         my $query = "INSERT INTO deletedbiblio SET ";
3525         my @bind  = ();
3526         foreach my $temp ( keys %$data ) {
3527             $query .= "$temp = ?,";
3528             push( @bind, $data->{$temp} );
3529         }
3530
3531         # replace the last , by ",?)"
3532         $query =~ s/\,$//;
3533         my $bkup_sth = $dbh->prepare($query);
3534         $bkup_sth->execute(@bind);
3535         $bkup_sth->finish;
3536
3537         # delete the biblio
3538         my $del_sth = $dbh->prepare("DELETE FROM biblio WHERE biblionumber=?");
3539         $del_sth->execute($biblionumber);
3540         $del_sth->finish;
3541     }
3542     $sth->finish;
3543     return undef;
3544 }
3545
3546 =head2 _koha_delete_biblioitems
3547
3548 =over 4
3549
3550 $error = _koha_delete_biblioitems($dbh,$biblioitemnumber);
3551
3552 Internal sub for deleting from biblioitems table -- also saves to deletedbiblioitems
3553
3554 C<$dbh> - the database handle
3555 C<$biblionumber> - the biblioitemnumber of the biblioitem to be deleted
3556
3557 =back
3558
3559 =cut
3560
3561 # FIXME: add error handling
3562
3563 sub _koha_delete_biblioitems {
3564     my ( $dbh, $biblioitemnumber ) = @_;
3565
3566     # get all the data for this biblioitem
3567     my $sth =
3568       $dbh->prepare("SELECT * FROM biblioitems WHERE biblioitemnumber=?");
3569     $sth->execute($biblioitemnumber);
3570
3571     if ( my $data = $sth->fetchrow_hashref ) {
3572
3573         # save the record in deletedbiblioitems
3574         # find the fields to save
3575         my $query = "INSERT INTO deletedbiblioitems SET ";
3576         my @bind  = ();
3577         foreach my $temp ( keys %$data ) {
3578             $query .= "$temp = ?,";
3579             push( @bind, $data->{$temp} );
3580         }
3581
3582         # replace the last , by ",?)"
3583         $query =~ s/\,$//;
3584         my $bkup_sth = $dbh->prepare($query);
3585         $bkup_sth->execute(@bind);
3586         $bkup_sth->finish;
3587
3588         # delete the biblioitem
3589         my $del_sth =
3590           $dbh->prepare("DELETE FROM biblioitems WHERE biblioitemnumber=?");
3591         $del_sth->execute($biblioitemnumber);
3592         $del_sth->finish;
3593     }
3594     $sth->finish;
3595     return undef;
3596 }
3597
3598 =head2 _koha_delete_item
3599
3600 =over 4
3601
3602 _koha_delete_item( $dbh, $itemnum );
3603
3604 Internal function to delete an item record from the koha tables
3605
3606 =back
3607
3608 =cut
3609
3610 sub _koha_delete_item {
3611     my ( $dbh, $itemnum ) = @_;
3612
3613     my $sth = $dbh->prepare("select * from items where itemnumber=?");
3614     $sth->execute($itemnum);
3615     my $data = $sth->fetchrow_hashref;
3616     $sth->finish;
3617     my $query = "Insert into deleteditems set ";
3618     my @bind  = ();
3619     foreach my $temp ( keys %$data ) {
3620         $query .= "$temp = ?,";
3621         push( @bind, $data->{$temp} );
3622     }
3623     $query =~ s/\,$//;
3624
3625     #  print $query;
3626     $sth = $dbh->prepare($query);
3627     $sth->execute(@bind);
3628     $sth->finish;
3629     $sth = $dbh->prepare("Delete from items where itemnumber=?");
3630     $sth->execute($itemnum);
3631     $sth->finish;
3632 }
3633
3634 =head1 UNEXPORTED FUNCTIONS
3635
3636 =over 4
3637
3638 =head2 calculatelc
3639
3640 $lc = calculatelc($classification);
3641
3642 =back
3643
3644 =cut
3645
3646 sub calculatelc {
3647     my ($classification) = @_;
3648     $classification =~ s/^\s+|\s+$//g;
3649     my $i = 0;
3650     my $lc2;
3651     my $lc1;
3652
3653     for ( $i = 0 ; $i < length($classification) ; $i++ ) {
3654         my $c = ( substr( $classification, $i, 1 ) );
3655         if ( $c ge '0' && $c le '9' ) {
3656
3657             $lc2 = substr( $classification, $i );
3658             last;
3659         }
3660         else {
3661             $lc1 .= substr( $classification, $i, 1 );
3662
3663         }
3664     }    #while
3665
3666     my $other = length($lc1);
3667     if ( !$lc1 ) {
3668         $other = 0;
3669     }
3670
3671     my $extras;
3672     if ( $other < 4 ) {
3673         for ( 1 .. ( 4 - $other ) ) {
3674             $extras .= "0";
3675         }
3676     }
3677     $lc1 .= $extras;
3678     $lc2 =~ s/^ //g;
3679
3680     $lc2 =~ s/ //g;
3681     $extras = "";
3682     ##Find the decimal part of $lc2
3683     my $pos = index( $lc2, "." );
3684     if ( $pos < 0 ) { $pos = length($lc2); }
3685     if ( $pos >= 0 && $pos < 5 ) {
3686         ##Pad lc2 with zeros to create a 5digit decimal needed in marc record to sort as numeric
3687
3688         for ( 1 .. ( 5 - $pos ) ) {
3689             $extras .= "0";
3690         }
3691     }
3692     $lc2 = $extras . $lc2;
3693     return ( $lc1 . $lc2 );
3694 }
3695
3696 =head2 itemcalculator
3697
3698 =over 4
3699
3700 $cutterextra = itemcalculator( $dbh, $biblioitem, $callnumber );
3701
3702 =back
3703
3704 =cut
3705
3706 sub itemcalculator {
3707     my ( $dbh, $biblioitem, $callnumber ) = @_;
3708     my $sth =
3709       $dbh->prepare(
3710 "select classification, subclass from biblioitems where biblioitemnumber=?"
3711       );
3712
3713     $sth->execute($biblioitem);
3714     my ( $classification, $subclass ) = $sth->fetchrow;
3715     my $all         = $classification . " " . $subclass;
3716     my $total       = length($all);
3717     my $cutterextra = substr( $callnumber, $total - 1 );
3718
3719     return $cutterextra;
3720 }
3721
3722 =head2 ModBiblioMarc
3723
3724 =over 4
3725
3726 &ModBiblioMarc($newrec,$biblionumber,$frameworkcode);
3727
3728 Add MARC data for a biblio to koha
3729
3730 Function exported, but should NOT be used, unless you really know what you're doing
3731
3732 =back
3733
3734 =cut
3735
3736 sub ModBiblioMarc {
3737
3738 # pass the MARC::Record to this function, and it will create the records in the marc field
3739     my ( $record, $biblionumber, $frameworkcode ) = @_;
3740     my $dbh = C4::Context->dbh;
3741     my @fields = $record->fields();
3742     if ( !$frameworkcode ) {
3743         $frameworkcode = "";
3744     }
3745     my $sth =
3746       $dbh->prepare("UPDATE biblio SET frameworkcode=? WHERE biblionumber=?");
3747     $sth->execute( $frameworkcode, $biblionumber );
3748     $sth->finish;
3749     my $encoding = C4::Context->preference("marcflavour");
3750
3751 # deal with UNIMARC field 100 (encoding) : create it if needed & set encoding to unicode
3752     if ( $encoding eq "UNIMARC" ) {
3753         my $string;
3754         if ( length($record->subfield( 100, "a" )) == 35 ) {
3755             $string = $record->subfield( 100, "a" );
3756             my $f100 = $record->field(100);
3757             $record->delete_field($f100);
3758         }
3759         else {
3760             $string = POSIX::strftime( "%Y%m%d", localtime );
3761             $string =~ s/\-//g;
3762             $string = sprintf( "%-*s", 35, $string );
3763         }
3764         substr( $string, 22, 6, "frey50" );
3765         unless ( $record->subfield( 100, "a" ) ) {
3766             $record->insert_grouped_field(
3767                 MARC::Field->new( 100, "", "", "a" => $string ) );
3768         }
3769     }
3770 #     warn "biblionumber : ".$biblionumber;
3771     ModZebra($biblionumber,"specialUpdate","biblioserver",$record);
3772     $sth =
3773       $dbh->prepare(
3774         "update biblioitems set marc=?,marcxml=?  where biblionumber=?");
3775     $sth->execute( $record->as_usmarc(), $record->as_xml_record(),
3776         $biblionumber );
3777 #     warn $record->as_xml_record();
3778     $sth->finish;
3779     return $biblionumber;
3780 }
3781
3782 =head2 AddItemInMarc
3783
3784 =over 4
3785
3786 $newbiblionumber = AddItemInMarc( $record, $biblionumber, $frameworkcode );
3787
3788 Add an item in a MARC record and save the MARC record
3789
3790 Function exported, but should NOT be used, unless you really know what you're doing
3791
3792 =back
3793
3794 =cut
3795
3796 sub AddItemInMarc {
3797
3798 # pass the MARC::Record to this function, and it will create the records in the marc tables
3799     my ( $record, $biblionumber, $frameworkcode ) = @_;
3800     my $newrec = &GetMarcBiblio($biblionumber);
3801
3802     # create it
3803     my @fields = $record->fields();
3804     foreach my $field (@fields) {
3805         $newrec->append_fields($field);
3806     }
3807
3808     # FIXME: should we be making sure the biblionumbers are the same?
3809     my $newbiblionumber =
3810       &ModBiblioMarc( $newrec, $biblionumber, $frameworkcode );
3811     return $newbiblionumber;
3812 }
3813
3814 =head2 z3950_extended_services
3815
3816 z3950_extended_services($serviceType,$serviceOptions,$record);
3817
3818     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.
3819
3820 C<$serviceType> one of: itemorder,create,drop,commit,update,xmlupdate
3821
3822 C<$serviceOptions> a has of key/value pairs. For instance, if service_type is 'update', $service_options should contain:
3823
3824     action => update action, one of specialUpdate, recordInsert, recordReplace, recordDelete, elementUpdate.
3825
3826 and maybe
3827
3828     recordidOpaque => Opaque Record ID (user supplied) or recordidNumber => Record ID number (system number).
3829     syntax => the record syntax (transfer syntax)
3830     databaseName = Database from connection object
3831
3832     To set serviceOptions, call set_service_options($serviceType)
3833
3834 C<$record> the record, if one is needed for the service type
3835
3836     A record should be in XML. You can convert it to XML from MARC by running it through marc2xml().
3837
3838 =cut
3839
3840 sub z3950_extended_services {
3841     my ( $server, $serviceType, $action, $serviceOptions ) = @_;
3842
3843     # get our connection object
3844     my $Zconn = C4::Context->Zconn( $server, 0, 1 );
3845
3846     # create a new package object
3847     my $Zpackage = $Zconn->package();
3848
3849     # set our options
3850     $Zpackage->option( action => $action );
3851
3852     if ( $serviceOptions->{'databaseName'} ) {
3853         $Zpackage->option( databaseName => $serviceOptions->{'databaseName'} );
3854     }
3855     if ( $serviceOptions->{'recordIdNumber'} ) {
3856         $Zpackage->option(
3857             recordIdNumber => $serviceOptions->{'recordIdNumber'} );
3858     }
3859     if ( $serviceOptions->{'recordIdOpaque'} ) {
3860         $Zpackage->option(
3861             recordIdOpaque => $serviceOptions->{'recordIdOpaque'} );
3862     }
3863
3864  # this is an ILL request (Zebra doesn't support it, but Koha could eventually)
3865  #if ($serviceType eq 'itemorder') {
3866  #   $Zpackage->option('contact-name' => $serviceOptions->{'contact-name'});
3867  #   $Zpackage->option('contact-phone' => $serviceOptions->{'contact-phone'});
3868  #   $Zpackage->option('contact-email' => $serviceOptions->{'contact-email'});
3869  #   $Zpackage->option('itemorder-item' => $serviceOptions->{'itemorder-item'});
3870  #}
3871
3872     if ( $serviceOptions->{record} ) {
3873         $Zpackage->option( record => $serviceOptions->{record} );
3874
3875         # can be xml or marc
3876         if ( $serviceOptions->{'syntax'} ) {
3877             $Zpackage->option( syntax => $serviceOptions->{'syntax'} );
3878         }
3879     }
3880
3881     # send the request, handle any exception encountered
3882     eval { $Zpackage->send($serviceType) };
3883     if ( $@ && $@->isa("ZOOM::Exception") ) {
3884         return "error:  " . $@->code() . " " . $@->message() . "\n";
3885     }
3886
3887     # free up package resources
3888     $Zpackage->destroy();
3889 }
3890
3891 =head2 set_service_options
3892
3893 my $serviceOptions = set_service_options($serviceType);
3894
3895 C<$serviceType> itemorder,create,drop,commit,update,xmlupdate
3896
3897 Currently, we only support 'create', 'commit', and 'update'. 'drop' support will be added as soon as Zebra supports it.
3898
3899 =cut
3900
3901 sub set_service_options {
3902     my ($serviceType) = @_;
3903     my $serviceOptions;
3904
3905 # FIXME: This needs to be an OID ... if we ever need 'syntax' this sub will need to change
3906 #   $serviceOptions->{ 'syntax' } = ''; #zebra doesn't support syntaxes other than xml
3907
3908     if ( $serviceType eq 'commit' ) {
3909
3910         # nothing to do
3911     }
3912     if ( $serviceType eq 'create' ) {
3913
3914         # nothing to do
3915     }
3916     if ( $serviceType eq 'drop' ) {
3917         die "ERROR: 'drop' not currently supported (by Zebra)";
3918     }
3919     return $serviceOptions;
3920 }
3921
3922 =head2 GetItemsCount
3923
3924 $count = &GetItemsCount( $biblionumber);
3925 this function return count of item with $biblionumber
3926 =cut
3927
3928 sub GetItemsCount {
3929     my ( $biblionumber ) = @_;
3930     my $dbh = C4::Context->dbh;
3931     my $query = qq|SELECT count(*)
3932                   FROM  items
3933                   WHERE biblionumber=?|;
3934     my $sth = $dbh->prepare($query);
3935     $sth->execute($biblionumber);
3936     my $count = $sth->fetchrow;
3937     $sth->finish;
3938     return ($count);
3939 }
3940
3941
3942
3943
3944 END { }    # module clean-up code here (global destructor)
3945
3946 1;
3947
3948 __END__
3949
3950 =head1 AUTHOR
3951
3952 Koha Developement team <info@koha.org>
3953
3954 Paul POULAIN paul.poulain@free.fr
3955
3956 Joshua Ferraro jmf@liblime.com
3957
3958 =cut
3959
3960 # $Id$
3961 # $Log$
3962 # Revision 1.214  2007/07/02 09:13:22  tipaul
3963 # unimarc bugfix : the encoding is in field 100 in UNIMARC. when TransformHTMLtoXML on an item, you must not automatically add a 100 field in items, otherwise there will be 2 100 fields in the biblio, which is wrong
3964 #
3965 # Revision 1.213  2007/06/25 15:01:45  tipaul
3966 # bugfixes on unimarc 100 handling (the field used for encoding)
3967 #
3968 # Revision 1.212  2007/06/15 13:44:44  tipaul
3969 # some fixes (and only fixes)
3970 #
3971 # Revision 1.211  2007/06/15 09:40:06  toins
3972 # do not get $3 $4 and $5 on GetMarcSubjects GetMarcAuthors on unimarc flavour.
3973 #
3974 # Revision 1.210  2007/06/13 13:03:34  toins
3975 # removing warn compilation.
3976 #
3977 # Revision 1.209  2007/05/23 16:19:40  tipaul
3978 # various bugfixes (minor) and french translation updated
3979 #
3980 # Revision 1.208  2007/05/22 09:13:54  tipaul
3981 # Bugfixes & improvements (various and minor) :
3982 # - updating templates to have tmpl_process3.pl running without any errors
3983 # - adding a drupal-like css for prog templates (with 3 small images)
3984 # - fixing some bugs in circulation & other scripts
3985 # - updating french translation
3986 # - fixing some typos in templates
3987 #
3988 # Revision 1.207  2007/05/22 08:51:19  hdl
3989 # Changing GetMarcStructure signature.
3990 # Deleting first parameter $dbh
3991 #
3992 # Revision 1.206  2007/05/21 08:44:17  btoumi
3993 # add security when u delete biblio :
3994 # u must delete linked items before delete biblio
3995 #
3996 # Revision 1.205  2007/05/11 16:04:03  btoumi
3997 # bug fix:
3998 # problem in  displayed label link  with subject in detail.tmpl
3999 # ex: label random => rdom
4000 #
4001 # Revision 1.204  2007/05/10 14:45:15  tipaul
4002 # Koha NoZebra :
4003 # - support for authorities
4004 # - some bugfixes in ordering and "CCL" parsing
4005 # - support for authorities <=> biblios walking
4006 #
4007 # Seems I can do what I want now, so I consider its done, except for bugfixes that will be needed i m sure !
4008 #
4009 # Revision 1.203  2007/05/03 15:16:02  tipaul
4010 # BUGFIX for : NoZebra
4011 # - NoZebra features : seems they work fine now (adding, modifying, deleting)
4012 # - Biblio edition major bugfix : before this commit editing a biblio resulted in an item removal in marcxml field
4013 #
4014 # Revision 1.202  2007/05/02 16:44:31  tipaul
4015 # NoZebra SQL index management :
4016 # * adding 3 subs in Biblio.pm
4017 # - GetNoZebraIndexes, that get the index structure in a new systempreference (added with this commit)
4018 # - _DelBiblioNoZebra, that retrieve all index entries for a biblio and remove in a variable the biblio reference
4019 # - _AddBiblioNoZebra, that add index entries for a biblio.
4020 # 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).
4021 # I think the code has to be more deeply tested, but it works at least partially.
4022 #
4023 # Revision 1.201  2007/04/27 14:00:49  hdl
4024 # Removing $dbh from GetMarcFromKohaField (dbh is not used in this function.)
4025 #
4026 # Revision 1.200  2007/04/25 16:26:42  tipaul
4027 # 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 :
4028 # - add nozebra table management on biblio editing
4029 # - the index table content is hardcoded. I still have to add some specific systempref to let the library update it
4030 # - manage pagination (next/previous)
4031 # - manage facets
4032 # WHAT works :
4033 # - NZgetRecords : has exactly the same API & returns as zebra getQuery, except that some parameters are unused
4034 # - search & sort works quite good
4035 # - CQL parser is better that what I thought I could do : title="harry and sally" and publicationyear>2000 not itemtype=LIVR should work fine
4036 #
4037 # Revision 1.199  2007/04/24 09:07:53  tipaul
4038 # moving dotransfer to Biblio.pm::ModItemTransfer + some CheckReserves fixes
4039 #
4040 # Revision 1.198  2007/04/23 15:21:17  tipaul
4041 # renaming currenttransfers to transferstoreceive
4042 #
4043 # Revision 1.197  2007/04/18 17:00:14  tipaul
4044 # removing all useless %env / $env
4045 #
4046 # Revision 1.196  2007/04/17 08:48:00  tipaul
4047 # circulation cleaning continued: bufixing
4048 #
4049 # Revision 1.195  2007/04/04 16:46:22  tipaul
4050 # HUGE COMMIT : code cleaning circulation.
4051 #
4052 # some stuff to do, i'll write a mail on koha-devel NOW !
4053 #
4054 # Revision 1.194  2007/03/30 12:00:42  tipaul
4055 # 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...
4056 #
4057 # Revision 1.193  2007/03/29 16:45:53  tipaul
4058 # Code cleaning of Biblio.pm (continued)
4059 #
4060 # All subs have be cleaned :
4061 # - removed useless
4062 # - merged some
4063 # - reordering Biblio.pm completly
4064 # - using only naming conventions
4065 #
4066 # Seems to have broken nothing, but it still has to be heavily tested.
4067 # Note that Biblio.pm is now much more efficient than previously & probably more reliable as well.
4068 #
4069 # Revision 1.192  2007/03/29 13:30:31  tipaul
4070 # Code cleaning :
4071 # == Biblio.pm cleaning (useless) ==
4072 # * some sub declaration dropped
4073 # * removed modbiblio sub
4074 # * removed moditem sub
4075 # * removed newitems. It was used only in finishrecieve. Replaced by a TransformKohaToMarc+AddItem, that is better.
4076 # * removed MARCkoha2marcItem
4077 # * removed MARCdelsubfield declaration
4078 # * removed MARCkoha2marcBiblio
4079 #
4080 # == Biblio.pm cleaning (naming conventions) ==
4081 # * MARCgettagslib renamed to GetMarcStructure
4082 # * MARCgetitems renamed to GetMarcItem
4083 # * MARCfind_frameworkcode renamed to GetFrameworkCode
4084 # * MARCmarc2koha renamed to TransformMarcToKoha
4085 # * MARChtml2marc renamed to TransformHtmlToMarc
4086 # * MARChtml2xml renamed to TranformeHtmlToXml
4087 # * zebraop renamed to ModZebra
4088 #
4089 # == MARC=OFF ==
4090 # * removing MARC=OFF related scripts (in cataloguing directory)
4091 # * removed checkitems (function related to MARC=off feature, that is completly broken in head. If someone want to reintroduce it, hard work coming...)
4092 # * removed getitemsbybiblioitem (used only by MARC=OFF scripts, that is removed as well)
4093 #
4094 # Revision 1.191  2007/03/29 09:42:13  tipaul
4095 # adding default value new feature into cataloguing. The system (definition) part has already been added by toins
4096 #
4097 # Revision 1.190  2007/03/29 08:45:19  hdl
4098 # Deleting ignore_errors(1) pour MARC::Charset
4099 #
4100 # Revision 1.189  2007/03/28 10:39:16  hdl
4101 # removing $dbh as a parameter in AuthoritiesMarc functions
4102 # And reporting all differences into the scripts taht relies on those functions.