C4/Serials.pm

   1 package C4::Serials;
   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
  17 # with Koha; if not, write to the Free Software Foundation, Inc.,
  18 # 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  19
  20 use strict;
  21 use warnings;
  22 use C4::Dates qw(format_date format_date_in_iso);
  23 use Date::Calc qw(:all);
  24 use POSIX qw(strftime);
  25 use C4::Suggestions;
  26 use C4::Koha;
  27 use C4::Biblio;
  28 use C4::Branch;
  29 use C4::Items;
  30 use C4::Search;
  31 use C4::Letters;
  32 use C4::Log;    # logaction
  33 use C4::Debug;
  34
  35 use vars qw($VERSION @ISA @EXPORT @EXPORT_OK %EXPORT_TAGS);
  36
  37 BEGIN {
  38     $VERSION = 3.01;    # set version for version checking
  39     require Exporter;
  40     @ISA    = qw(Exporter);
  41     @EXPORT = qw(
  42       &NewSubscription    &ModSubscription    &DelSubscription    &GetSubscriptions
  43       &GetSubscription    &CountSubscriptionFromBiblionumber      &GetSubscriptionsFromBiblionumber
  44       &GetFullSubscriptionsFromBiblionumber   &GetFullSubscription &ModSubscriptionHistory
  45       &HasSubscriptionStrictlyExpired &HasSubscriptionExpired &GetExpirationDate &abouttoexpire
  46
  47       &GetNextSeq         &NewIssue           &ItemizeSerials    &GetSerials
  48       &GetLatestSerials   &ModSerialStatus    &GetNextDate       &GetSerials2
  49       &ReNewSubscription  &GetLateIssues      &GetLateOrMissingIssues
  50       &GetSerialInformation                   &AddItem2Serial
  51       &PrepareSerialsData &GetNextExpected    &ModNextExpected
  52
  53       &UpdateClaimdateIssues
  54       &GetSuppliersWithLateIssues             &getsupplierbyserialid
  55       &GetDistributedTo   &SetDistributedTo
  56       &getroutinglist     &delroutingmember   &addroutingmember
  57       &reorder_members
  58       &check_routing &updateClaim &removeMissingIssue
  59       &CountIssues
  60       HasItems
  61
  62     );
  63 }
  64
  65 =head1 NAME
  66
  67 C4::Serials - Serials Module Functions
  68
  69 =head1 SYNOPSIS
  70
  71   use C4::Serials;
  72
  73 =head1 DESCRIPTION
  74
  75 Functions for handling subscriptions, claims routing etc.
  76
  77
  78 =head1 SUBROUTINES
  79
  80 =head2 GetSuppliersWithLateIssues
  81
  82 $supplierlist = GetSuppliersWithLateIssues()
  83
  84 this function get all suppliers with late issues.
  85
  86 return :
  87 an array_ref of suppliers each entry is a hash_ref containing id and name
  88 the array is in name order
  89
  90 =cut
  91
  92 sub GetSuppliersWithLateIssues {
  93     my $dbh   = C4::Context->dbh;
  94     my $query = q|
  95     SELECT DISTINCT aqbooksellerid as id, aqbooksellers.name as name
  96     FROM            subscription
  97     LEFT JOIN       serial ON serial.subscriptionid=subscription.subscriptionid
  98     LEFT JOIN aqbooksellers ON subscription.aqbooksellerid = aqbooksellers.id
  99     WHERE id > 0 AND (planneddate < now() OR serial.STATUS = 3 OR serial.STATUS = 4) ORDER BY name|;
 100     return $dbh->selectall_arrayref($query, { Slice => {} });
 101 }
 102
 103 =head2 GetLateIssues
 104
 105 @issuelist = GetLateIssues($supplierid)
 106
 107 this function selects late issues from the database
 108
 109 return :
 110 the issuelist as an array. Each element of this array contains a hashi_ref containing
 111 name,title,planneddate,serialseq,serial.subscriptionid from tables : subscription, serial & biblio
 112
 113 =cut
 114
 115 sub GetLateIssues {
 116     my ($supplierid) = @_;
 117     my $dbh = C4::Context->dbh;
 118     my $sth;
 119     if ($supplierid) {
 120         my $query = qq|
 121             SELECT     name,title,planneddate,serialseq,serial.subscriptionid
 122             FROM       subscription
 123             LEFT JOIN  serial ON subscription.subscriptionid = serial.subscriptionid
 124             LEFT JOIN  biblio ON biblio.biblionumber = subscription.biblionumber
 125             LEFT JOIN  aqbooksellers ON subscription.aqbooksellerid = aqbooksellers.id
 126             WHERE      ((planneddate < now() AND serial.STATUS =1) OR serial.STATUS = 3)
 127             AND        subscription.aqbooksellerid=$supplierid
 128             ORDER BY   title
 129         |;
 130         $sth = $dbh->prepare($query);
 131     } else {
 132         my $query = qq|
 133             SELECT     name,title,planneddate,serialseq,serial.subscriptionid
 134             FROM       subscription
 135             LEFT JOIN  serial ON subscription.subscriptionid = serial.subscriptionid
 136             LEFT JOIN  biblio ON biblio.biblionumber = subscription.biblionumber
 137             LEFT JOIN  aqbooksellers ON subscription.aqbooksellerid = aqbooksellers.id
 138             WHERE      ((planneddate < now() AND serial.STATUS =1) OR serial.STATUS = 3)
 139             ORDER BY   title
 140         |;
 141         $sth = $dbh->prepare($query);
 142     }
 143     $sth->execute;
 144     my @issuelist;
 145     my $last_title;
 146     my $odd   = 0;
 147     while ( my $line = $sth->fetchrow_hashref ) {
 148         $odd++ unless $line->{title} eq $last_title;
 149         $line->{title} = "" if $line->{title} eq $last_title;
 150         $last_title = $line->{title} if ( $line->{title} );
 151         $line->{planneddate} = format_date( $line->{planneddate} );
 152         push @issuelist, $line;
 153     }
 154     return @issuelist;
 155 }
 156
 157 =head2 GetSubscriptionHistoryFromSubscriptionId
 158
 159 $sth = GetSubscriptionHistoryFromSubscriptionId()
 160 this function prepares the SQL request and returns the statement handle
 161 After this function, don't forget to execute it by using $sth->execute($subscriptionid)
 162
 163 =cut
 164
 165 sub GetSubscriptionHistoryFromSubscriptionId() {
 166     my $dbh   = C4::Context->dbh;
 167     my $query = qq|
 168         SELECT *
 169         FROM   subscriptionhistory
 170         WHERE  subscriptionid = ?
 171     |;
 172     return $dbh->prepare($query);
 173 }
 174
 175 =head2 GetSerialStatusFromSerialId
 176
 177 $sth = GetSerialStatusFromSerialId();
 178 this function returns a statement handle
 179 After this function, don't forget to execute it by using $sth->execute($serialid)
 180 return :
 181 $sth = $dbh->prepare($query).
 182
 183 =cut
 184
 185 sub GetSerialStatusFromSerialId() {
 186     my $dbh   = C4::Context->dbh;
 187     my $query = qq|
 188         SELECT status
 189         FROM   serial
 190         WHERE  serialid = ?
 191     |;
 192     return $dbh->prepare($query);
 193 }
 194
 195 =head2 GetSerialInformation
 196
 197
 198 $data = GetSerialInformation($serialid);
 199 returns a hash_ref containing :
 200   items : items marcrecord (can be an array)
 201   serial table field
 202   subscription table field
 203   + information about subscription expiration
 204
 205 =cut
 206
 207 sub GetSerialInformation {
 208     my ($serialid) = @_;
 209     my $dbh        = C4::Context->dbh;
 210     my $query      = qq|
 211         SELECT serial.*, serial.notes as sernotes, serial.status as serstatus,subscription.*,subscription.subscriptionid as subsid |;
 212     if (   C4::Context->preference('IndependantBranches')
 213         && C4::Context->userenv
 214         && C4::Context->userenv->{'flags'} != 1
 215         && C4::Context->userenv->{'branch'} ) {
 216         $query .= "
 217       , ((subscription.branchcode <>\"" . C4::Context->userenv->{'branch'} . "\") and subscription.branchcode <>\"\" and subscription.branchcode IS NOT NULL) as cannotedit ";
 218     }
 219     $query .= qq|
 220         FROM   serial LEFT JOIN subscription ON subscription.subscriptionid=serial.subscriptionid
 221         WHERE  serialid = ?
 222     |;
 223     my $rq = $dbh->prepare($query);
 224     $rq->execute($serialid);
 225     my $data = $rq->fetchrow_hashref;
 226
 227     # create item information if we have serialsadditems for this subscription
 228     if ( $data->{'serialsadditems'} ) {
 229         my $queryitem = $dbh->prepare("SELECT itemnumber from serialitems where serialid=?");
 230         $queryitem->execute($serialid);
 231         my $itemnumbers = $queryitem->fetchall_arrayref( [0] );
 232         if ( scalar(@$itemnumbers) > 0 ) {
 233             foreach my $itemnum (@$itemnumbers) {
 234
 235                 #It is ASSUMED that GetMarcItem ALWAYS WORK...
 236                 #Maybe GetMarcItem should return values on failure
 237                 $debug and warn "itemnumber :$itemnum->[0], bibnum :" . $data->{'biblionumber'};
 238                 my $itemprocessed = PrepareItemrecordDisplay( $data->{'biblionumber'}, $itemnum->[0], $data );
 239                 $itemprocessed->{'itemnumber'}   = $itemnum->[0];
 240                 $itemprocessed->{'itemid'}       = $itemnum->[0];
 241                 $itemprocessed->{'serialid'}     = $serialid;
 242                 $itemprocessed->{'biblionumber'} = $data->{'biblionumber'};
 243                 push @{ $data->{'items'} }, $itemprocessed;
 244             }
 245         } else {
 246             my $itemprocessed = PrepareItemrecordDisplay( $data->{'biblionumber'}, '', $data );
 247             $itemprocessed->{'itemid'}       = "N$serialid";
 248             $itemprocessed->{'serialid'}     = $serialid;
 249             $itemprocessed->{'biblionumber'} = $data->{'biblionumber'};
 250             $itemprocessed->{'countitems'}   = 0;
 251             push @{ $data->{'items'} }, $itemprocessed;
 252         }
 253     }
 254     $data->{ "status" . $data->{'serstatus'} } = 1;
 255     $data->{'subscriptionexpired'} = HasSubscriptionExpired( $data->{'subscriptionid'} ) && $data->{'status'} == 1;
 256     $data->{'abouttoexpire'} = abouttoexpire( $data->{'subscriptionid'} );
 257     return $data;
 258 }
 259
 260 =head2 AddItem2Serial
 261
 262 $rows = AddItem2Serial($serialid,$itemnumber);
 263 Adds an itemnumber to Serial record
 264 returns the number of rows affected
 265
 266 =cut
 267
 268 sub AddItem2Serial {
 269     my ( $serialid, $itemnumber ) = @_;
 270     my $dbh = C4::Context->dbh;
 271     my $rq  = $dbh->prepare("INSERT INTO `serialitems` SET serialid=? , itemnumber=?");
 272     $rq->execute( $serialid, $itemnumber );
 273     return $rq->rows;
 274 }
 275
 276 =head2 UpdateClaimdateIssues
 277
 278 UpdateClaimdateIssues($serialids,[$date]);
 279
 280 Update Claimdate for issues in @$serialids list with date $date
 281 (Take Today if none)
 282
 283 =cut
 284
 285 sub UpdateClaimdateIssues {
 286     my ( $serialids, $date ) = @_;
 287     my $dbh = C4::Context->dbh;
 288     $date = strftime( "%Y-%m-%d", localtime ) unless ($date);
 289     my $query = "
 290         UPDATE serial SET claimdate = ?, status = 7
 291         WHERE  serialid in (" . join( ",", map { '?' } @$serialids ) . ")";
 292     my $rq = $dbh->prepare($query);
 293     $rq->execute($date, @$serialids);
 294     return $rq->rows;
 295 }
 296
 297 =head2 GetSubscription
 298
 299 $subs = GetSubscription($subscriptionid)
 300 this function returns the subscription which has $subscriptionid as id.
 301 return :
 302 a hashref. This hash containts
 303 subscription, subscriptionhistory, aqbudget.bookfundid, biblio.title
 304
 305 =cut
 306
 307 sub GetSubscription {
 308     my ($subscriptionid) = @_;
 309     my $dbh              = C4::Context->dbh;
 310     my $query            = qq(
 311         SELECT  subscription.*,
 312                 subscriptionhistory.*,
 313                 aqbooksellers.name AS aqbooksellername,
 314                 biblio.title AS bibliotitle,
 315                 subscription.biblionumber as bibnum);
 316     if (   C4::Context->preference('IndependantBranches')
 317         && C4::Context->userenv
 318         && C4::Context->userenv->{'flags'} != 1
 319         && C4::Context->userenv->{'branch'} ) {
 320         $query .= "
 321       , ((subscription.branchcode <>\"" . C4::Context->userenv->{'branch'} . "\") and subscription.branchcode <>\"\" and subscription.branchcode IS NOT NULL) as cannotedit ";
 322     }
 323     $query .= qq(
 324        FROM subscription
 325        LEFT JOIN subscriptionhistory ON subscription.subscriptionid=subscriptionhistory.subscriptionid
 326        LEFT JOIN aqbooksellers ON subscription.aqbooksellerid=aqbooksellers.id
 327        LEFT JOIN biblio ON biblio.biblionumber=subscription.biblionumber
 328        WHERE subscription.subscriptionid = ?
 329     );
 330
 331     #     if (C4::Context->preference('IndependantBranches') &&
 332     #         C4::Context->userenv &&
 333     #         C4::Context->userenv->{'flags'} != 1){
 334     # #       $debug and warn "flags: ".C4::Context->userenv->{'flags'};
 335     #       $query.=" AND subscription.branchcode IN ('".C4::Context->userenv->{'branch'}."',\"\")";
 336     #     }
 337     $debug and warn "query : $query\nsubsid :$subscriptionid";
 338     my $sth = $dbh->prepare($query);
 339     $sth->execute($subscriptionid);
 340     return $sth->fetchrow_hashref;
 341 }
 342
 343 =head2 GetFullSubscription
 344
 345    $array_ref = GetFullSubscription($subscriptionid)
 346    this function reads the serial table.
 347
 348 =cut
 349
 350 sub GetFullSubscription {
 351     my ($subscriptionid) = @_;
 352     my $dbh              = C4::Context->dbh;
 353     my $query            = qq|
 354   SELECT    serial.serialid,
 355             serial.serialseq,
 356             serial.planneddate,
 357             serial.publisheddate,
 358             serial.status,
 359             serial.notes as notes,
 360             year(IF(serial.publisheddate="00-00-0000",serial.planneddate,serial.publisheddate)) as year,
 361             aqbooksellers.name as aqbooksellername,
 362             biblio.title as bibliotitle,
 363             subscription.branchcode AS branchcode,
 364             subscription.subscriptionid AS subscriptionid |;
 365     if (   C4::Context->preference('IndependantBranches')
 366         && C4::Context->userenv
 367         && C4::Context->userenv->{'flags'} != 1
 368         && C4::Context->userenv->{'branch'} ) {
 369         $query .= "
 370       , ((subscription.branchcode <>\"" . C4::Context->userenv->{'branch'} . "\") and subscription.branchcode <>\"\" and subscription.branchcode IS NOT NULL) as cannotedit ";
 371     }
 372     $query .= qq|
 373   FROM      serial
 374   LEFT JOIN subscription ON
 375           (serial.subscriptionid=subscription.subscriptionid )
 376   LEFT JOIN aqbooksellers on subscription.aqbooksellerid=aqbooksellers.id
 377   LEFT JOIN biblio on biblio.biblionumber=subscription.biblionumber
 378   WHERE     serial.subscriptionid = ?
 379   ORDER BY year DESC,
 380           IF(serial.publisheddate="00-00-0000",serial.planneddate,serial.publisheddate) DESC,
 381           serial.subscriptionid
 382           |;
 383     $debug and warn "GetFullSubscription query: $query";
 384     my $sth = $dbh->prepare($query);
 385     $sth->execute($subscriptionid);
 386     return $sth->fetchall_arrayref( {} );
 387 }
 388
 389 =head2 PrepareSerialsData
 390
 391    $array_ref = PrepareSerialsData($serialinfomation)
 392    where serialinformation is a hashref array
 393
 394 =cut
 395
 396 sub PrepareSerialsData {
 397     my ($lines) = @_;
 398     my %tmpresults;
 399     my $year;
 400     my @res;
 401     my $startdate;
 402     my $aqbooksellername;
 403     my $bibliotitle;
 404     my @loopissues;
 405     my $first;
 406     my $previousnote = "";
 407
 408     foreach my $subs (@{$lines}) {
 409         for my $datefield ( qw(publisheddate planneddate) ) {
 410             # handle both undef and undef returned as 0000-00-00
 411             if (!defined $subs->{$datefield} or $subs->{$datefield}=~m/^00/) {
 412                 $subs->{$datefield} = 'XXX';
 413             }
 414             else {
 415                 $subs->{$datefield} = format_date( $subs->{$datefield}  );
 416             }
 417         }
 418         $subs->{'branchname'} = GetBranchName( $subs->{'branchcode'} );
 419         $subs->{ "status" . $subs->{'status'} } = 1;
 420         $subs->{"checked"}                      = $subs->{'status'} =~ /1|3|4|7/;
 421
 422         if ( $subs->{'year'} && $subs->{'year'} ne "" ) {
 423             $year = $subs->{'year'};
 424         } else {
 425             $year = "manage";
 426         }
 427         if ( $tmpresults{$year} ) {
 428             push @{ $tmpresults{$year}->{'serials'} }, $subs;
 429         } else {
 430             $tmpresults{$year} = {
 431                 'year'             => $year,
 432                 'aqbooksellername' => $subs->{'aqbooksellername'},
 433                 'bibliotitle'      => $subs->{'bibliotitle'},
 434                 'serials'          => [$subs],
 435                 'first'            => $first,
 436             };
 437         }
 438     }
 439     foreach my $key ( sort { $b cmp $a } keys %tmpresults ) {
 440         push @res, $tmpresults{$key};
 441     }
 442     $res[0]->{'first'} = 1;
 443     return \@res;
 444 }
 445
 446 =head2 GetSubscriptionsFromBiblionumber
 447
 448 $array_ref = GetSubscriptionsFromBiblionumber($biblionumber)
 449 this function get the subscription list. it reads the subscription table.
 450 return :
 451 reference to an array of subscriptions which have the biblionumber given on input arg.
 452 each element of this array is a hashref containing
 453 startdate, histstartdate,opacnote,missinglist,recievedlist,periodicity,status & enddate
 454
 455 =cut
 456
 457 sub GetSubscriptionsFromBiblionumber {
 458     my ($biblionumber) = @_;
 459     my $dbh            = C4::Context->dbh;
 460     my $query          = qq(
 461         SELECT subscription.*,
 462                branches.branchname,
 463                subscriptionhistory.*,
 464                aqbooksellers.name AS aqbooksellername,
 465                biblio.title AS bibliotitle
 466        FROM subscription
 467        LEFT JOIN subscriptionhistory ON subscription.subscriptionid=subscriptionhistory.subscriptionid
 468        LEFT JOIN aqbooksellers ON subscription.aqbooksellerid=aqbooksellers.id
 469        LEFT JOIN biblio ON biblio.biblionumber=subscription.biblionumber
 470        LEFT JOIN branches ON branches.branchcode=subscription.branchcode
 471        WHERE subscription.biblionumber = ?
 472     );
 473     my $sth = $dbh->prepare($query);
 474     $sth->execute($biblionumber);
 475     my @res;
 476     while ( my $subs = $sth->fetchrow_hashref ) {
 477         $subs->{startdate}     = format_date( $subs->{startdate} );
 478         $subs->{histstartdate} = format_date( $subs->{histstartdate} );
 479         $subs->{histenddate}   = format_date( $subs->{histenddate} );
 480         $subs->{opacnote}     =~ s/\n/\<br\/\>/g;
 481         $subs->{missinglist}  =~ s/\n/\<br\/\>/g;
 482         $subs->{recievedlist} =~ s/\n/\<br\/\>/g;
 483         $subs->{ "periodicity" . $subs->{periodicity} }     = 1;
 484         $subs->{ "numberpattern" . $subs->{numberpattern} } = 1;
 485         $subs->{ "status" . $subs->{'status'} }             = 1;
 486         $subs->{'cannotedit'} =
 487           (      C4::Context->preference('IndependantBranches')
 488               && C4::Context->userenv
 489               && C4::Context->userenv->{flags} % 2 != 1
 490               && C4::Context->userenv->{branch}
 491               && $subs->{branchcode}
 492               && ( C4::Context->userenv->{branch} ne $subs->{branchcode} ) );
 493
 494         if ( $subs->{enddate} eq '0000-00-00' ) {
 495             $subs->{enddate} = '';
 496         } else {
 497             $subs->{enddate} = format_date( $subs->{enddate} );
 498         }
 499         $subs->{'abouttoexpire'}       = abouttoexpire( $subs->{'subscriptionid'} );
 500         $subs->{'subscriptionexpired'} = HasSubscriptionExpired( $subs->{'subscriptionid'} );
 501         push @res, $subs;
 502     }
 503     return \@res;
 504 }
 505
 506 =head2 GetFullSubscriptionsFromBiblionumber
 507
 508    $array_ref = GetFullSubscriptionsFromBiblionumber($biblionumber)
 509    this function reads the serial table.
 510
 511 =cut
 512
 513 sub GetFullSubscriptionsFromBiblionumber {
 514     my ($biblionumber) = @_;
 515     my $dbh            = C4::Context->dbh;
 516     my $query          = qq|
 517   SELECT    serial.serialid,
 518             serial.serialseq,
 519             serial.planneddate,
 520             serial.publisheddate,
 521             serial.status,
 522             serial.notes as notes,
 523             year(IF(serial.publisheddate="00-00-0000",serial.planneddate,serial.publisheddate)) as year,
 524             biblio.title as bibliotitle,
 525             subscription.branchcode AS branchcode,
 526             subscription.subscriptionid AS subscriptionid|;
 527     if (   C4::Context->preference('IndependantBranches')
 528         && C4::Context->userenv
 529         && C4::Context->userenv->{'flags'} != 1
 530         && C4::Context->userenv->{'branch'} ) {
 531         $query .= "
 532       , ((subscription.branchcode <>\"" . C4::Context->userenv->{'branch'} . "\") and subscription.branchcode <>\"\" and subscription.branchcode IS NOT NULL) as cannotedit ";
 533     }
 534
 535     $query .= qq|
 536   FROM      serial
 537   LEFT JOIN subscription ON
 538           (serial.subscriptionid=subscription.subscriptionid)
 539   LEFT JOIN aqbooksellers on subscription.aqbooksellerid=aqbooksellers.id
 540   LEFT JOIN biblio on biblio.biblionumber=subscription.biblionumber
 541   WHERE     subscription.biblionumber = ?
 542   ORDER BY year DESC,
 543           IF(serial.publisheddate="00-00-0000",serial.planneddate,serial.publisheddate) DESC,
 544           serial.subscriptionid
 545           |;
 546     my $sth = $dbh->prepare($query);
 547     $sth->execute($biblionumber);
 548     return $sth->fetchall_arrayref( {} );
 549 }
 550
 551 =head2 GetSubscriptions
 552
 553 @results = GetSubscriptions($title,$ISSN,$biblionumber);
 554 this function gets all subscriptions which have title like $title,ISSN like $ISSN and biblionumber like $biblionumber.
 555 return:
 556 a table of hashref. Each hash containt the subscription.
 557
 558 =cut
 559
 560 sub GetSubscriptions {
 561     my ( $string, $issn, $biblionumber ) = @_;
 562
 563     #return unless $title or $ISSN or $biblionumber;
 564     my $dbh = C4::Context->dbh;
 565     my $sth;
 566     my $sql = qq(
 567             SELECT subscription.*, subscriptionhistory.*, biblio.title,biblioitems.issn,biblio.biblionumber
 568             FROM   subscription
 569             LEFT JOIN subscriptionhistory USING(subscriptionid)
 570             LEFT JOIN biblio ON biblio.biblionumber = subscription.biblionumber
 571             LEFT JOIN biblioitems ON biblio.biblionumber = biblioitems.biblionumber
 572     );
 573     my @bind_params;
 574     my $sqlwhere;
 575     if ($biblionumber) {
 576         $sqlwhere = "   WHERE biblio.biblionumber=?";
 577         push @bind_params, $biblionumber;
 578     }
 579     if ($string) {
 580         my @sqlstrings;
 581         my @strings_to_search;
 582         @strings_to_search = map { "%$_%" } split( / /, $string );
 583         foreach my $index qw(biblio.title subscription.callnumber subscription.location subscription.notes subscription.internalnotes) {
 584             push @bind_params, @strings_to_search;
 585             my $tmpstring = "AND $index LIKE ? " x scalar(@strings_to_search);
 586             $debug && warn "$tmpstring";
 587             $tmpstring =~ s/^AND //;
 588             push @sqlstrings, $tmpstring;
 589         }
 590         $sqlwhere .= ( $sqlwhere ? " AND " : " WHERE " ) . "(" . join( ") OR (", @sqlstrings ) . ")";
 591     }
 592     if ($issn) {
 593         my @sqlstrings;
 594         my @strings_to_search;
 595         @strings_to_search = map { "%$_%" } split( / /, $issn );
 596         foreach my $index qw(biblioitems.issn subscription.callnumber) {
 597             push @bind_params, @strings_to_search;
 598             my $tmpstring = "OR $index LIKE ? " x scalar(@strings_to_search);
 599             $debug && warn "$tmpstring";
 600             $tmpstring =~ s/^OR //;
 601             push @sqlstrings, $tmpstring;
 602         }
 603         $sqlwhere .= ( $sqlwhere ? " AND " : " WHERE " ) . "(" . join( ") OR (", @sqlstrings ) . ")";
 604     }
 605     $sql .= "$sqlwhere ORDER BY title";
 606     $debug and warn "GetSubscriptions query: $sql params : ", join( " ", @bind_params );
 607     $sth = $dbh->prepare($sql);
 608     $sth->execute(@bind_params);
 609     my @results;
 610     my $previousbiblio = "";
 611     my $odd           = 1;
 612
 613     while ( my $line = $sth->fetchrow_hashref ) {
 614         if ( $previousbiblio eq $line->{biblionumber} ) {
 615             $line->{title} = "";
 616             $line->{issn}  = "";
 617         } else {
 618             $previousbiblio = $line->{biblionumber};
 619             $odd           = -$odd;
 620         }
 621         $line->{toggle} = 1 if $odd == 1;
 622         $line->{'cannotedit'} =
 623           (      C4::Context->preference('IndependantBranches')
 624               && C4::Context->userenv
 625               && C4::Context->userenv->{flags} % 2 != 1
 626               && C4::Context->userenv->{branch}
 627               && $line->{branchcode}
 628               && ( C4::Context->userenv->{branch} ne $line->{branchcode} ) );
 629         push @results, $line;
 630     }
 631     return @results;
 632 }
 633
 634 =head2 GetSerials
 635
 636 ($totalissues,@serials) = GetSerials($subscriptionid);
 637 this function gets every serial not arrived for a given subscription
 638 as well as the number of issues registered in the database (all types)
 639 this number is used to see if a subscription can be deleted (=it must have only 1 issue)
 640
 641 FIXME: We should return \@serials.
 642
 643 =cut
 644
 645 sub GetSerials {
 646     my ( $subscriptionid, $count ) = @_;
 647     my $dbh = C4::Context->dbh;
 648
 649     # status = 2 is "arrived"
 650     my $counter = 0;
 651     $count = 5 unless ($count);
 652     my @serials;
 653     my $query = "SELECT serialid,serialseq, status, publisheddate, planneddate,notes, routingnotes
 654                         FROM   serial
 655                         WHERE  subscriptionid = ? AND status NOT IN (2,4,5)
 656                         ORDER BY IF(publisheddate<>'0000-00-00',publisheddate,planneddate) DESC";
 657     my $sth = $dbh->prepare($query);
 658     $sth->execute($subscriptionid);
 659
 660     while ( my $line = $sth->fetchrow_hashref ) {
 661         $line->{ "status" . $line->{status} } = 1;                                         # fills a "statusX" value, used for template status select list
 662         for my $datefield ( qw( planneddate publisheddate) ) {
 663             if ($line->{$datefield} && $line->{$datefield}!~m/^00/) {
 664                 $line->{$datefield} = format_date( $line->{$datefield});
 665             } else {
 666                 $line->{$datefield} = q{};
 667             }
 668         }
 669         push @serials, $line;
 670     }
 671
 672     # OK, now add the last 5 issues arrives/missing
 673     $query = "SELECT   serialid,serialseq, status, planneddate, publisheddate,notes, routingnotes
 674        FROM     serial
 675        WHERE    subscriptionid = ?
 676        AND      (status in (2,4,5))
 677        ORDER BY IF(publisheddate<>'0000-00-00',publisheddate,planneddate) DESC
 678       ";
 679     $sth = $dbh->prepare($query);
 680     $sth->execute($subscriptionid);
 681     while ( ( my $line = $sth->fetchrow_hashref ) && $counter < $count ) {
 682         $counter++;
 683         $line->{ "status" . $line->{status} } = 1;                                         # fills a "statusX" value, used for template status select list
 684         for my $datefield ( qw( planneddate publisheddate) ) {
 685             if ($line->{$datefield} && $line->{$datefield}!~m/^00/) {
 686                 $line->{$datefield} = format_date( $line->{$datefield});
 687             } else {
 688                 $line->{$datefield} = q{};
 689             }
 690         }
 691
 692         push @serials, $line;
 693     }
 694
 695     $query = "SELECT count(*) FROM serial WHERE subscriptionid=?";
 696     $sth   = $dbh->prepare($query);
 697     $sth->execute($subscriptionid);
 698     my ($totalissues) = $sth->fetchrow;
 699     return ( $totalissues, @serials );
 700 }
 701
 702 =head2 GetSerials2
 703
 704 @serials = GetSerials2($subscriptionid,$status);
 705 this function returns every serial waited for a given subscription
 706 as well as the number of issues registered in the database (all types)
 707 this number is used to see if a subscription can be deleted (=it must have only 1 issue)
 708
 709 =cut
 710
 711 sub GetSerials2 {
 712     my ( $subscription, $status ) = @_;
 713     my $dbh   = C4::Context->dbh;
 714     my $query = qq|
 715                  SELECT   serialid,serialseq, status, planneddate, publisheddate,notes, routingnotes
 716                  FROM     serial
 717                  WHERE    subscriptionid=$subscription AND status IN ($status)
 718                  ORDER BY publisheddate,serialid DESC
 719                     |;
 720     $debug and warn "GetSerials2 query: $query";
 721     my $sth = $dbh->prepare($query);
 722     $sth->execute;
 723     my @serials;
 724
 725     while ( my $line = $sth->fetchrow_hashref ) {
 726         $line->{ "status" . $line->{status} } = 1;                                         # fills a "statusX" value, used for template status select list
 727         $line->{"planneddate"}                = format_date( $line->{"planneddate"} );
 728         $line->{"publisheddate"}              = format_date( $line->{"publisheddate"} );
 729         push @serials, $line;
 730     }
 731     return @serials;
 732 }
 733
 734 =head2 GetLatestSerials
 735
 736 \@serials = GetLatestSerials($subscriptionid,$limit)
 737 get the $limit's latest serials arrived or missing for a given subscription
 738 return :
 739 a ref to an array which contains all of the latest serials stored into a hash.
 740
 741 =cut
 742
 743 sub GetLatestSerials {
 744     my ( $subscriptionid, $limit ) = @_;
 745     my $dbh = C4::Context->dbh;
 746
 747     # status = 2 is "arrived"
 748     my $strsth = "SELECT   serialid,serialseq, status, planneddate, notes
 749                         FROM     serial
 750                         WHERE    subscriptionid = ?
 751                         AND      (status =2 or status=4)
 752                         ORDER BY planneddate DESC LIMIT 0,$limit
 753                 ";
 754     my $sth = $dbh->prepare($strsth);
 755     $sth->execute($subscriptionid);
 756     my @serials;
 757     while ( my $line = $sth->fetchrow_hashref ) {
 758         $line->{ "status" . $line->{status} } = 1;                        # fills a "statusX" value, used for template status select list
 759         $line->{"planneddate"} = format_date( $line->{"planneddate"} );
 760         push @serials, $line;
 761     }
 762
 763     return \@serials;
 764 }
 765
 766 =head2 GetDistributedTo
 767
 768 $distributedto=GetDistributedTo($subscriptionid)
 769 This function returns the field distributedto for the subscription matching subscriptionid
 770
 771 =cut
 772
 773 sub GetDistributedTo {
 774     my $dbh = C4::Context->dbh;
 775     my $distributedto;
 776     my $subscriptionid = @_;
 777     my $query          = "SELECT distributedto FROM subscription WHERE subscriptionid=?";
 778     my $sth            = $dbh->prepare($query);
 779     $sth->execute($subscriptionid);
 780     return ($distributedto) = $sth->fetchrow;
 781 }
 782
 783 =head2 GetNextSeq
 784
 785 GetNextSeq($val)
 786 $val is a hashref containing all the attributes of the table 'subscription'
 787 This function get the next issue for the subscription given on input arg
 788 return:
 789 a list containing all the input params updated.
 790
 791 =cut
 792
 793 # sub GetNextSeq {
 794 #     my ($val) =@_;
 795 #     my ($calculated,$newlastvalue1,$newlastvalue2,$newlastvalue3,$newinnerloop1,$newinnerloop2,$newinnerloop3);
 796 #     $calculated = $val->{numberingmethod};
 797 # # calculate the (expected) value of the next issue recieved.
 798 #     $newlastvalue1 = $val->{lastvalue1};
 799 # # check if we have to increase the new value.
 800 #     $newinnerloop1 = $val->{innerloop1}+1;
 801 #     $newinnerloop1=0 if ($newinnerloop1 >= $val->{every1});
 802 #     $newlastvalue1 += $val->{add1} if ($newinnerloop1<1); # <1 to be true when 0 or empty.
 803 #     $newlastvalue1=$val->{setto1} if ($newlastvalue1>$val->{whenmorethan1}); # reset counter if needed.
 804 #     $calculated =~ s/\{X\}/$newlastvalue1/g;
 805 #
 806 #     $newlastvalue2 = $val->{lastvalue2};
 807 # # check if we have to increase the new value.
 808 #     $newinnerloop2 = $val->{innerloop2}+1;
 809 #     $newinnerloop2=0 if ($newinnerloop2 >= $val->{every2});
 810 #     $newlastvalue2 += $val->{add2} if ($newinnerloop2<1); # <1 to be true when 0 or empty.
 811 #     $newlastvalue2=$val->{setto2} if ($newlastvalue2>$val->{whenmorethan2}); # reset counter if needed.
 812 #     $calculated =~ s/\{Y\}/$newlastvalue2/g;
 813 #
 814 #     $newlastvalue3 = $val->{lastvalue3};
 815 # # check if we have to increase the new value.
 816 #     $newinnerloop3 = $val->{innerloop3}+1;
 817 #     $newinnerloop3=0 if ($newinnerloop3 >= $val->{every3});
 818 #     $newlastvalue3 += $val->{add3} if ($newinnerloop3<1); # <1 to be true when 0 or empty.
 819 #     $newlastvalue3=$val->{setto3} if ($newlastvalue3>$val->{whenmorethan3}); # reset counter if needed.
 820 #     $calculated =~ s/\{Z\}/$newlastvalue3/g;
 821 #     return ($calculated,$newlastvalue1,$newlastvalue2,$newlastvalue3,$newinnerloop1,$newinnerloop2,$newinnerloop3);
 822 # }
 823
 824 sub GetNextSeq {
 825     my ($val) = @_;
 826     my ( $calculated, $newlastvalue1, $newlastvalue2, $newlastvalue3, $newinnerloop1, $newinnerloop2, $newinnerloop3 );
 827     my $pattern          = $val->{numberpattern};
 828     my @seasons          = ( 'nothing', 'Winter', 'Spring', 'Summer', 'Autumn' );
 829     my @southern_seasons = ( '', 'Summer', 'Autumn', 'Winter', 'Spring' );
 830     $calculated    = $val->{numberingmethod};
 831     $newlastvalue1 = $val->{lastvalue1};
 832     $newlastvalue2 = $val->{lastvalue2};
 833     $newlastvalue3 = $val->{lastvalue3};
 834     $newlastvalue1 = $val->{lastvalue1};
 835
 836     # check if we have to increase the new value.
 837     $newinnerloop1 = $val->{innerloop1} + 1;
 838     $newinnerloop1 = 0 if ( $newinnerloop1 >= $val->{every1} );
 839     $newlastvalue1 += $val->{add1} if ( $newinnerloop1 < 1 );    # <1 to be true when 0 or empty.
 840     $newlastvalue1 = $val->{setto1} if ( $newlastvalue1 > $val->{whenmorethan1} );    # reset counter if needed.
 841     $calculated =~ s/\{X\}/$newlastvalue1/g;
 842
 843     $newlastvalue2 = $val->{lastvalue2};
 844
 845     # check if we have to increase the new value.
 846     $newinnerloop2 = $val->{innerloop2} + 1;
 847     $newinnerloop2 = 0 if ( $newinnerloop2 >= $val->{every2} );
 848     $newlastvalue2 += $val->{add2} if ( $newinnerloop2 < 1 );                         # <1 to be true when 0 or empty.
 849     $newlastvalue2 = $val->{setto2} if ( $newlastvalue2 > $val->{whenmorethan2} );    # reset counter if needed.
 850     if ( $pattern == 6 ) {
 851         if ( $val->{hemisphere} == 2 ) {
 852             my $newlastvalue2seq = $southern_seasons[$newlastvalue2];
 853             $calculated =~ s/\{Y\}/$newlastvalue2seq/g;
 854         } else {
 855             my $newlastvalue2seq = $seasons[$newlastvalue2];
 856             $calculated =~ s/\{Y\}/$newlastvalue2seq/g;
 857         }
 858     } else {
 859         $calculated =~ s/\{Y\}/$newlastvalue2/g;
 860     }
 861
 862     $newlastvalue3 = $val->{lastvalue3};
 863
 864     # check if we have to increase the new value.
 865     $newinnerloop3 = $val->{innerloop3} + 1;
 866     $newinnerloop3 = 0 if ( $newinnerloop3 >= $val->{every3} );
 867     $newlastvalue3 += $val->{add3} if ( $newinnerloop3 < 1 );    # <1 to be true when 0 or empty.
 868     $newlastvalue3 = $val->{setto3} if ( $newlastvalue3 > $val->{whenmorethan3} );    # reset counter if needed.
 869     $calculated =~ s/\{Z\}/$newlastvalue3/g;
 870
 871     return ( $calculated, $newlastvalue1, $newlastvalue2, $newlastvalue3, $newinnerloop1, $newinnerloop2, $newinnerloop3 );
 872 }
 873
 874 =head2 GetSeq
 875
 876 $calculated = GetSeq($val)
 877 $val is a hashref containing all the attributes of the table 'subscription'
 878 this function transforms {X},{Y},{Z} to 150,0,0 for example.
 879 return:
 880 the sequence in integer format
 881
 882 =cut
 883
 884 sub GetSeq {
 885     my ($val) = @_;
 886     my $pattern = $val->{numberpattern};
 887     my @seasons          = ( 'nothing', 'Winter', 'Spring', 'Summer', 'Autumn' );
 888     my @southern_seasons = ( '',        'Summer', 'Autumn', 'Winter', 'Spring' );
 889     my $calculated       = $val->{numberingmethod};
 890     my $x                = $val->{'lastvalue1'};
 891     $calculated =~ s/\{X\}/$x/g;
 892     my $newlastvalue2 = $val->{'lastvalue2'};
 893
 894     if ( $pattern == 6 ) {
 895         if ( $val->{hemisphere} == 2 ) {
 896             my $newlastvalue2seq = $southern_seasons[$newlastvalue2];
 897             $calculated =~ s/\{Y\}/$newlastvalue2seq/g;
 898         } else {
 899             my $newlastvalue2seq = $seasons[$newlastvalue2];
 900             $calculated =~ s/\{Y\}/$newlastvalue2seq/g;
 901         }
 902     } else {
 903         $calculated =~ s/\{Y\}/$newlastvalue2/g;
 904     }
 905     my $z = $val->{'lastvalue3'};
 906     $calculated =~ s/\{Z\}/$z/g;
 907     return $calculated;
 908 }
 909
 910 =head2 GetExpirationDate
 911
 912 $enddate = GetExpirationDate($subscriptionid, [$startdate])
 913
 914 this function return the next expiration date for a subscription given on input args.
 915
 916 return
 917 the enddate or undef
 918
 919 =cut
 920
 921 sub GetExpirationDate {
 922     my ( $subscriptionid, $startdate ) = @_;
 923     my $dbh          = C4::Context->dbh;
 924     my $subscription = GetSubscription($subscriptionid);
 925     my $enddate;
 926
 927     # we don't do the same test if the subscription is based on X numbers or on X weeks/months
 928     $enddate = $startdate || $subscription->{startdate};
 929     my @date = split( /-/, $enddate );
 930     return if ( scalar(@date) != 3 || not check_date(@date) );
 931     if ( ( $subscription->{periodicity} % 16 ) > 0 ) {
 932
 933         # If Not Irregular
 934         if ( my $length = $subscription->{numberlength} ) {
 935
 936             #calculate the date of the last issue.
 937             for ( my $i = 1 ; $i <= $length ; $i++ ) {
 938                 $enddate = GetNextDate( $enddate, $subscription );
 939             }
 940         } elsif ( $subscription->{monthlength} ) {
 941             if ( $$subscription{startdate} ) {
 942                 my @enddate = Add_Delta_YM( $date[0], $date[1], $date[2], 0, $subscription->{monthlength} );
 943                 $enddate = sprintf( "%04d-%02d-%02d", $enddate[0], $enddate[1], $enddate[2] );
 944             }
 945         } elsif ( $subscription->{weeklength} ) {
 946             if ( $$subscription{startdate} ) {
 947                 my @date = split( /-/, $subscription->{startdate} );
 948                 my @enddate = Add_Delta_Days( $date[0], $date[1], $date[2], $subscription->{weeklength} * 7 );
 949                 $enddate = sprintf( "%04d-%02d-%02d", $enddate[0], $enddate[1], $enddate[2] );
 950             }
 951         }
 952         return $enddate;
 953     } else {
 954         return;
 955     }
 956 }
 957
 958 =head2 CountSubscriptionFromBiblionumber
 959
 960 $subscriptionsnumber = CountSubscriptionFromBiblionumber($biblionumber)
 961 this returns a count of the subscriptions for a given biblionumber
 962 return :
 963 the number of subscriptions
 964
 965 =cut
 966
 967 sub CountSubscriptionFromBiblionumber {
 968     my ($biblionumber) = @_;
 969     my $dbh            = C4::Context->dbh;
 970     my $query          = "SELECT count(*) FROM subscription WHERE biblionumber=?";
 971     my $sth            = $dbh->prepare($query);
 972     $sth->execute($biblionumber);
 973     my $subscriptionsnumber = $sth->fetchrow;
 974     return $subscriptionsnumber;
 975 }
 976
 977 =head2 ModSubscriptionHistory
 978
 979 ModSubscriptionHistory($subscriptionid,$histstartdate,$enddate,$recievedlist,$missinglist,$opacnote,$librariannote);
 980
 981 this function modifies the history of a subscription. Put your new values on input arg.
 982 returns the number of rows affected
 983
 984 =cut
 985
 986 sub ModSubscriptionHistory {
 987     my ( $subscriptionid, $histstartdate, $enddate, $recievedlist, $missinglist, $opacnote, $librariannote ) = @_;
 988     my $dbh   = C4::Context->dbh;
 989     my $query = "UPDATE subscriptionhistory
 990                     SET histstartdate=?,histenddate=?,recievedlist=?,missinglist=?,opacnote=?,librariannote=?
 991                     WHERE subscriptionid=?
 992                 ";
 993     my $sth = $dbh->prepare($query);
 994     $recievedlist =~ s/^; //;
 995     $missinglist  =~ s/^; //;
 996     $opacnote     =~ s/^; //;
 997     $sth->execute( $histstartdate, $enddate, $recievedlist, $missinglist, $opacnote, $librariannote, $subscriptionid );
 998     return $sth->rows;
 999 }
1000
1001 =head2 ModSerialStatus
1002
1003 ModSerialStatus($serialid,$serialseq, $planneddate,$publisheddate,$status,$notes)
1004
1005 This function modify the serial status. Serial status is a number.(eg 2 is "arrived")
1006 Note : if we change from "waited" to something else,then we will have to create a new "waited" entry
1007
1008 =cut
1009
1010 sub ModSerialStatus {
1011     my ( $serialid, $serialseq, $planneddate, $publisheddate, $status, $notes ) = @_;
1012
1013     #It is a usual serial
1014     # 1st, get previous status :
1015     my $dbh   = C4::Context->dbh;
1016     my $query = "SELECT subscriptionid,status FROM serial WHERE  serialid=?";
1017     my $sth   = $dbh->prepare($query);
1018     $sth->execute($serialid);
1019     my ( $subscriptionid, $oldstatus ) = $sth->fetchrow;
1020
1021     # change status & update subscriptionhistory
1022     my $val;
1023     if ( $status == 6 ) {
1024         DelIssue( {'serialid'=>$serialid, 'subscriptionid'=>$subscriptionid,'serialseq'=>$serialseq} );
1025     }
1026     else {
1027         my $query =
1028 'UPDATE serial SET serialseq=?,publisheddate=?,planneddate=?,status=?,notes=? WHERE  serialid = ?';
1029         $sth = $dbh->prepare($query);
1030         $sth->execute( $serialseq, $publisheddate, $planneddate, $status, $notes, $serialid );
1031         $query = "SELECT * FROM   subscription WHERE  subscriptionid = ?";
1032         $sth   = $dbh->prepare($query);
1033         $sth->execute($subscriptionid);
1034         my $val = $sth->fetchrow_hashref;
1035         unless ( $val->{manualhistory} ) {
1036             $query = "SELECT missinglist,recievedlist FROM subscriptionhistory WHERE  subscriptionid=?";
1037             $sth   = $dbh->prepare($query);
1038             $sth->execute($subscriptionid);
1039             my ( $missinglist, $recievedlist ) = $sth->fetchrow;
1040             if ( $status == 2 ) {
1041
1042                 $recievedlist .= "; $serialseq"
1043                   unless ( index( "$recievedlist", "$serialseq" ) >= 0 );
1044             }
1045
1046             #         warn "missinglist : $missinglist serialseq :$serialseq, ".index("$missinglist","$serialseq");
1047             $missinglist .= "; $serialseq"
1048               if ( $status == 4
1049                 and not index( "$missinglist", "$serialseq" ) >= 0 );
1050             $missinglist .= "; not issued $serialseq"
1051               if ( $status == 5
1052                 and index( "$missinglist", "$serialseq" ) >= 0 );
1053             $query = "UPDATE subscriptionhistory SET recievedlist=?, missinglist=? WHERE  subscriptionid=?";
1054             $sth   = $dbh->prepare($query);
1055             $recievedlist =~ s/^; //;
1056             $missinglist  =~ s/^; //;
1057             $sth->execute( $recievedlist, $missinglist, $subscriptionid );
1058         }
1059     }
1060
1061     # create new waited entry if needed (ie : was a "waited" and has changed)
1062     if ( $oldstatus == 1 && $status != 1 ) {
1063         my $query = "SELECT * FROM   subscription WHERE  subscriptionid = ?";
1064         $sth = $dbh->prepare($query);
1065         $sth->execute($subscriptionid);
1066         my $val = $sth->fetchrow_hashref;
1067
1068         # next issue number
1069         my (
1070             $newserialseq,  $newlastvalue1, $newlastvalue2, $newlastvalue3,
1071             $newinnerloop1, $newinnerloop2, $newinnerloop3
1072         ) = GetNextSeq($val);
1073
1074         # next date (calculated from actual date & frequency parameters)
1075         my $nextpublisheddate = GetNextDate( $publisheddate, $val );
1076         NewIssue( $newserialseq, $subscriptionid, $val->{'biblionumber'}, 1, $nextpublisheddate, $nextpublisheddate );
1077         $query = "UPDATE subscription SET lastvalue1=?, lastvalue2=?, lastvalue3=?, innerloop1=?, innerloop2=?, innerloop3=?
1078                     WHERE  subscriptionid = ?";
1079         $sth = $dbh->prepare($query);
1080         $sth->execute( $newlastvalue1, $newlastvalue2, $newlastvalue3, $newinnerloop1, $newinnerloop2, $newinnerloop3, $subscriptionid );
1081
1082 # check if an alert must be sent... (= a letter is defined & status became "arrived"
1083         if ( $val->{letter} && $status == 2 && $oldstatus != 2 ) {
1084             SendAlerts( 'issue', $val->{subscriptionid}, $val->{letter} );
1085         }
1086     }
1087     return;
1088 }
1089
1090 =head2 GetNextExpected
1091
1092 $nextexpected = GetNextExpected($subscriptionid)
1093
1094 Get the planneddate for the current expected issue of the subscription.
1095
1096 returns a hashref:
1097
1098 $nextexepected = {
1099     serialid => int
1100     planneddate => C4::Dates object
1101     }
1102
1103 =cut
1104
1105 sub GetNextExpected($) {
1106     my ($subscriptionid) = @_;
1107     my $dbh              = C4::Context->dbh;
1108     my $sth              = $dbh->prepare('SELECT serialid, planneddate FROM serial WHERE subscriptionid=? AND status=?');
1109
1110     # Each subscription has only one 'expected' issue, with serial.status==1.
1111     $sth->execute( $subscriptionid, 1 );
1112     my ( $nextissue ) = $sth->fetchrow_hashref;
1113     if( !$nextissue){
1114          $sth = $dbh->prepare('SELECT serialid,planneddate FROM serial WHERE subscriptionid  = ? ORDER BY planneddate DESC LIMIT 1');
1115          $sth->execute( $subscriptionid );
1116          $nextissue = $sth->fetchrow_hashref;
1117     }
1118     if (!defined $nextissue->{planneddate}) {
1119         # or should this default to 1st Jan ???
1120         $nextissue->{planneddate} = strftime('%Y-%m-%d',localtime);
1121     }
1122     $nextissue->{planneddate} = C4::Dates->new($nextissue->{planneddate},'iso');
1123     return $nextissue;
1124
1125 }
1126
1127 =head2 ModNextExpected
1128
1129 ModNextExpected($subscriptionid,$date)
1130
1131 Update the planneddate for the current expected issue of the subscription.
1132 This will modify all future prediction results.
1133
1134 C<$date> is a C4::Dates object.
1135
1136 returns 0
1137
1138 =cut
1139
1140 sub ModNextExpected($$) {
1141     my ( $subscriptionid, $date ) = @_;
1142     my $dbh = C4::Context->dbh;
1143
1144     #FIXME: Would expect to only set planneddate, but we set both on new issue creation, so updating it here
1145     my $sth = $dbh->prepare('UPDATE serial SET planneddate=?,publisheddate=? WHERE subscriptionid=? AND status=?');
1146
1147     # Each subscription has only one 'expected' issue, with serial.status==1.
1148     $sth->execute( $date->output('iso'), $date->output('iso'), $subscriptionid, 1 );
1149     return 0;
1150
1151 }
1152
1153 =head2 ModSubscription
1154
1155 this function modifies a subscription. Put all new values on input args.
1156 returns the number of rows affected
1157
1158 =cut
1159
1160 sub ModSubscription {
1161     my ($auser,           $branchcode,      $aqbooksellerid,    $cost,             $aqbudgetid,    $startdate,   $periodicity,   $firstacquidate,
1162         $dow,             $irregularity,    $numberpattern,     $numberlength,     $weeklength,    $monthlength, $add1,          $every1,
1163         $whenmorethan1,   $setto1,          $lastvalue1,        $innerloop1,       $add2,          $every2,      $whenmorethan2, $setto2,
1164         $lastvalue2,      $innerloop2,      $add3,              $every3,           $whenmorethan3, $setto3,      $lastvalue3,    $innerloop3,
1165         $numberingmethod, $status,          $biblionumber,      $callnumber,       $notes,         $letter,      $hemisphere,    $manualhistory,
1166         $internalnotes,   $serialsadditems, $staffdisplaycount, $opacdisplaycount, $graceperiod,   $location,    $enddate,       $subscriptionid
1167     ) = @_;
1168
1169     #     warn $irregularity;
1170     my $dbh   = C4::Context->dbh;
1171     my $query = "UPDATE subscription
1172                     SET librarian=?, branchcode=?,aqbooksellerid=?,cost=?,aqbudgetid=?,startdate=?,
1173                         periodicity=?,firstacquidate=?,dow=?,irregularity=?, numberpattern=?, numberlength=?,weeklength=?,monthlength=?,
1174                         add1=?,every1=?,whenmorethan1=?,setto1=?,lastvalue1=?,innerloop1=?,
1175                         add2=?,every2=?,whenmorethan2=?,setto2=?,lastvalue2=?,innerloop2=?,
1176                         add3=?,every3=?,whenmorethan3=?,setto3=?,lastvalue3=?,innerloop3=?,
1177                         numberingmethod=?, status=?, biblionumber=?, callnumber=?, notes=?,
1178                                                 letter=?, hemisphere=?,manualhistory=?,internalnotes=?,serialsadditems=?,
1179                                                 staffdisplaycount = ?,opacdisplaycount = ?, graceperiod = ?, location = ?
1180                                                 ,enddate=?
1181                     WHERE subscriptionid = ?";
1182
1183     #warn "query :".$query;
1184     my $sth = $dbh->prepare($query);
1185     $sth->execute(
1186         $auser,           $branchcode,     $aqbooksellerid, $cost,
1187         $aqbudgetid,      $startdate,      $periodicity,    $firstacquidate,
1188         $dow,             "$irregularity", $numberpattern,  $numberlength,
1189         $weeklength,      $monthlength,    $add1,           $every1,
1190         $whenmorethan1,   $setto1,         $lastvalue1,     $innerloop1,
1191         $add2,            $every2,         $whenmorethan2,  $setto2,
1192         $lastvalue2,      $innerloop2,     $add3,           $every3,
1193         $whenmorethan3,   $setto3,         $lastvalue3,     $innerloop3,
1194         $numberingmethod, $status,         $biblionumber,   $callnumber,
1195         $notes, $letter, $hemisphere, ( $manualhistory ? $manualhistory : 0 ),
1196         $internalnotes, $serialsadditems, $staffdisplaycount, $opacdisplaycount,
1197         $graceperiod,   $location,        $enddate,           $subscriptionid
1198     );
1199     my $rows = $sth->rows;
1200
1201     logaction( "SERIAL", "MODIFY", $subscriptionid, "" ) if C4::Context->preference("SubscriptionLog");
1202     return $rows;
1203 }
1204
1205 =head2 NewSubscription
1206
1207 $subscriptionid = &NewSubscription($auser,branchcode,$aqbooksellerid,$cost,$aqbudgetid,$biblionumber,
1208     $startdate,$periodicity,$dow,$numberlength,$weeklength,$monthlength,
1209     $add1,$every1,$whenmorethan1,$setto1,$lastvalue1,$innerloop1,
1210     $add2,$every2,$whenmorethan2,$setto2,$lastvalue2,$innerloop2,
1211     $add3,$every3,$whenmorethan3,$setto3,$lastvalue3,$innerloop3,
1212     $numberingmethod, $status, $notes, $serialsadditems,
1213     $staffdisplaycount, $opacdisplaycount, $graceperiod, $location, $enddate);
1214
1215 Create a new subscription with value given on input args.
1216
1217 return :
1218 the id of this new subscription
1219
1220 =cut
1221
1222 sub NewSubscription {
1223     my ($auser,         $branchcode,      $aqbooksellerid,    $cost,             $aqbudgetid,    $biblionumber, $startdate,       $periodicity,
1224         $dow,           $numberlength,    $weeklength,        $monthlength,      $add1,          $every1,       $whenmorethan1,   $setto1,
1225         $lastvalue1,    $innerloop1,      $add2,              $every2,           $whenmorethan2, $setto2,       $lastvalue2,      $innerloop2,
1226         $add3,          $every3,          $whenmorethan3,     $setto3,           $lastvalue3,    $innerloop3,   $numberingmethod, $status,
1227         $notes,         $letter,          $firstacquidate,    $irregularity,     $numberpattern, $callnumber,   $hemisphere,      $manualhistory,
1228         $internalnotes, $serialsadditems, $staffdisplaycount, $opacdisplaycount, $graceperiod,   $location,     $enddate
1229     ) = @_;
1230     my $dbh = C4::Context->dbh;
1231
1232     #save subscription (insert into database)
1233     my $query = qq|
1234         INSERT INTO subscription
1235             (librarian,branchcode,aqbooksellerid,cost,aqbudgetid,biblionumber,
1236             startdate,periodicity,dow,numberlength,weeklength,monthlength,
1237             add1,every1,whenmorethan1,setto1,lastvalue1,innerloop1,
1238             add2,every2,whenmorethan2,setto2,lastvalue2,innerloop2,
1239             add3,every3,whenmorethan3,setto3,lastvalue3,innerloop3,
1240             numberingmethod, status, notes, letter,firstacquidate,irregularity,
1241             numberpattern, callnumber, hemisphere,manualhistory,internalnotes,serialsadditems,
1242             staffdisplaycount,opacdisplaycount,graceperiod,location,enddate)
1243         VALUES (?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?)
1244         |;
1245     my $sth = $dbh->prepare($query);
1246     $sth->execute(
1247         $auser,         $branchcode,      $aqbooksellerid,    $cost,             $aqbudgetid,    $biblionumber, $startdate,       $periodicity,
1248         $dow,           $numberlength,    $weeklength,        $monthlength,      $add1,          $every1,       $whenmorethan1,   $setto1,
1249         $lastvalue1,    $innerloop1,      $add2,              $every2,           $whenmorethan2, $setto2,       $lastvalue2,      $innerloop2,
1250         $add3,          $every3,          $whenmorethan3,     $setto3,           $lastvalue3,    $innerloop3,   $numberingmethod, "$status",
1251         $notes,         $letter,          $firstacquidate,    $irregularity,     $numberpattern, $callnumber,   $hemisphere,      $manualhistory,
1252         $internalnotes, $serialsadditems, $staffdisplaycount, $opacdisplaycount, $graceperiod,   $location,     $enddate
1253     );
1254
1255     my $subscriptionid = $dbh->{'mysql_insertid'};
1256     unless ($enddate){
1257        $enddate = GetExpirationDate($subscriptionid,$startdate);
1258         $query = q|
1259             UPDATE subscription
1260             SET    enddate=?
1261             WHERE  subscriptionid=?
1262         |;
1263         $sth = $dbh->prepare($query);
1264         $sth->execute( $enddate, $subscriptionid );
1265     }
1266     #then create the 1st waited number
1267     $query = qq(
1268         INSERT INTO subscriptionhistory
1269             (biblionumber, subscriptionid, histstartdate,  opacnote, librariannote)
1270         VALUES (?,?,?,?,?)
1271         );
1272     $sth = $dbh->prepare($query);
1273     $sth->execute( $biblionumber, $subscriptionid, $startdate, $notes, $internalnotes );
1274
1275     # reread subscription to get a hash (for calculation of the 1st issue number)
1276     $query = qq(
1277         SELECT *
1278         FROM   subscription
1279         WHERE  subscriptionid = ?
1280     );
1281     $sth = $dbh->prepare($query);
1282     $sth->execute($subscriptionid);
1283     my $val = $sth->fetchrow_hashref;
1284
1285     # calculate issue number
1286     my $serialseq = GetSeq($val);
1287     $query = qq|
1288         INSERT INTO serial
1289             (serialseq,subscriptionid,biblionumber,status, planneddate, publisheddate)
1290         VALUES (?,?,?,?,?,?)
1291     |;
1292     $sth = $dbh->prepare($query);
1293     $sth->execute( "$serialseq", $subscriptionid, $biblionumber, 1, $firstacquidate, $firstacquidate );
1294
1295     logaction( "SERIAL", "ADD", $subscriptionid, "" ) if C4::Context->preference("SubscriptionLog");
1296
1297     #set serial flag on biblio if not already set.
1298     my ( $null, ($bib) ) = GetBiblio($biblionumber);
1299     if ( !$bib->{'serial'} ) {
1300         my $record = GetMarcBiblio($biblionumber);
1301         my ( $tag, $subf ) = GetMarcFromKohaField( 'biblio.serial', $bib->{'frameworkcode'} );
1302         if ($tag) {
1303             eval { $record->field($tag)->update( $subf => 1 ); };
1304         }
1305         ModBiblio( $record, $biblionumber, $bib->{'frameworkcode'} );
1306     }
1307     return $subscriptionid;
1308 }
1309
1310 =head2 ReNewSubscription
1311
1312 ReNewSubscription($subscriptionid,$user,$startdate,$numberlength,$weeklength,$monthlength,$note)
1313
1314 this function renew a subscription with values given on input args.
1315
1316 =cut
1317
1318 sub ReNewSubscription {
1319     my ( $subscriptionid, $user, $startdate, $numberlength, $weeklength, $monthlength, $note ) = @_;
1320     my $dbh          = C4::Context->dbh;
1321     my $subscription = GetSubscription($subscriptionid);
1322     my $query        = qq|
1323          SELECT *
1324          FROM   biblio
1325          LEFT JOIN biblioitems ON biblio.biblionumber=biblioitems.biblionumber
1326          WHERE    biblio.biblionumber=?
1327      |;
1328     my $sth = $dbh->prepare($query);
1329     $sth->execute( $subscription->{biblionumber} );
1330     my $biblio = $sth->fetchrow_hashref;
1331
1332     if ( C4::Context->preference("RenewSerialAddsSuggestion") ) {
1333
1334         NewSuggestion(
1335             {   'suggestedby'   => $user,
1336                 'title'         => $subscription->{bibliotitle},
1337                 'author'        => $biblio->{author},
1338                 'publishercode' => $biblio->{publishercode},
1339                 'note'          => $biblio->{note},
1340                 'biblionumber'  => $subscription->{biblionumber}
1341             }
1342         );
1343     }
1344
1345     # renew subscription
1346     $query = qq|
1347         UPDATE subscription
1348         SET    startdate=?,numberlength=?,weeklength=?,monthlength=?
1349         WHERE  subscriptionid=?
1350     |;
1351     $sth = $dbh->prepare($query);
1352     $sth->execute( $startdate, $numberlength, $weeklength, $monthlength, $subscriptionid );
1353     my $enddate = GetExpirationDate($subscriptionid);
1354         $debug && warn "enddate :$enddate";
1355     $query = qq|
1356         UPDATE subscription
1357         SET    enddate=?
1358         WHERE  subscriptionid=?
1359     |;
1360     $sth = $dbh->prepare($query);
1361     $sth->execute( $enddate, $subscriptionid );
1362     $query = qq|
1363         UPDATE subscriptionhistory
1364         SET    histenddate=?
1365         WHERE  subscriptionid=?
1366     |;
1367     $sth = $dbh->prepare($query);
1368     $sth->execute( $enddate, $subscriptionid );
1369
1370     logaction( "SERIAL", "RENEW", $subscriptionid, "" ) if C4::Context->preference("SubscriptionLog");
1371     return;
1372 }
1373
1374 =head2 NewIssue
1375
1376 NewIssue($serialseq,$subscriptionid,$biblionumber,$status, $planneddate, $publisheddate,  $notes)
1377
1378 Create a new issue stored on the database.
1379 Note : we have to update the recievedlist and missinglist on subscriptionhistory for this subscription.
1380 returns the serial id
1381
1382 =cut
1383
1384 sub NewIssue {
1385     my ( $serialseq, $subscriptionid, $biblionumber, $status, $planneddate, $publisheddate, $notes ) = @_;
1386     ### FIXME biblionumber CAN be provided by subscriptionid. So Do we STILL NEED IT ?
1387
1388     my $dbh   = C4::Context->dbh;
1389     my $query = qq|
1390         INSERT INTO serial
1391             (serialseq,subscriptionid,biblionumber,status,publisheddate,planneddate,notes)
1392         VALUES (?,?,?,?,?,?,?)
1393     |;
1394     my $sth = $dbh->prepare($query);
1395     $sth->execute( $serialseq, $subscriptionid, $biblionumber, $status, $publisheddate, $planneddate, $notes );
1396     my $serialid = $dbh->{'mysql_insertid'};
1397     $query = qq|
1398         SELECT missinglist,recievedlist
1399         FROM   subscriptionhistory
1400         WHERE  subscriptionid=?
1401     |;
1402     $sth = $dbh->prepare($query);
1403     $sth->execute($subscriptionid);
1404     my ( $missinglist, $recievedlist ) = $sth->fetchrow;
1405
1406     if ( $status == 2 ) {
1407       ### TODO Add a feature that improves recognition and description.
1408       ### As such count (serialseq) i.e. : N18,2(N19),N20
1409       ### Would use substr and index But be careful to previous presence of ()
1410         $recievedlist .= "; $serialseq" unless (index($recievedlist,$serialseq)>0);
1411     }
1412     if ( $status == 4 ) {
1413         $missinglist .= "; $serialseq" unless (index($missinglist,$serialseq)>0);
1414     }
1415     $query = qq|
1416         UPDATE subscriptionhistory
1417         SET    recievedlist=?, missinglist=?
1418         WHERE  subscriptionid=?
1419     |;
1420     $sth = $dbh->prepare($query);
1421     $recievedlist =~ s/^; //;
1422     $missinglist  =~ s/^; //;
1423     $sth->execute( $recievedlist, $missinglist, $subscriptionid );
1424     return $serialid;
1425 }
1426
1427 =head2 ItemizeSerials
1428
1429 ItemizeSerials($serialid, $info);
1430 $info is a hashref containing  barcode branch, itemcallnumber, status, location
1431 $serialid the serialid
1432 return :
1433 1 if the itemize is a succes.
1434 0 and @error otherwise. @error containts the list of errors found.
1435
1436 =cut
1437
1438 sub ItemizeSerials {
1439     my ( $serialid, $info ) = @_;
1440     my $now = POSIX::strftime( "%Y-%m-%d", localtime );
1441
1442     my $dbh   = C4::Context->dbh;
1443     my $query = qq|
1444         SELECT *
1445         FROM   serial
1446         WHERE  serialid=?
1447     |;
1448     my $sth = $dbh->prepare($query);
1449     $sth->execute($serialid);
1450     my $data = $sth->fetchrow_hashref;
1451     if ( C4::Context->preference("RoutingSerials") ) {
1452
1453         # check for existing biblioitem relating to serial issue
1454         my ( $count, @results ) = GetBiblioItemByBiblioNumber( $data->{'biblionumber'} );
1455         my $bibitemno = 0;
1456         for ( my $i = 0 ; $i < $count ; $i++ ) {
1457             if ( $results[$i]->{'volumeddesc'} eq $data->{'serialseq'} . ' (' . $data->{'planneddate'} . ')' ) {
1458                 $bibitemno = $results[$i]->{'biblioitemnumber'};
1459                 last;
1460             }
1461         }
1462         if ( $bibitemno == 0 ) {
1463             my $sth = $dbh->prepare( "SELECT * FROM biblioitems WHERE biblionumber = ? ORDER BY biblioitemnumber DESC" );
1464             $sth->execute( $data->{'biblionumber'} );
1465             my $biblioitem = $sth->fetchrow_hashref;
1466             $biblioitem->{'volumedate'}  = $data->{planneddate};
1467             $biblioitem->{'volumeddesc'} = $data->{serialseq} . ' (' . format_date( $data->{'planneddate'} ) . ')';
1468             $biblioitem->{'dewey'}       = $info->{itemcallnumber};
1469         }
1470     }
1471
1472     my $fwk = GetFrameworkCode( $data->{'biblionumber'} );
1473     if ( $info->{barcode} ) {
1474         my @errors;
1475         my $exists = itemdata( $info->{'barcode'} );
1476         push @errors, "barcode_not_unique" if ($exists);
1477         unless ($exists) {
1478             my $marcrecord = MARC::Record->new();
1479             my ( $tag, $subfield ) = GetMarcFromKohaField( "items.barcode", $fwk );
1480             my $newField = MARC::Field->new( "$tag", '', '', "$subfield" => $info->{barcode} );
1481             $marcrecord->insert_fields_ordered($newField);
1482             if ( $info->{branch} ) {
1483                 my ( $tag, $subfield ) = GetMarcFromKohaField( "items.homebranch", $fwk );
1484
1485                 #warn "items.homebranch : $tag , $subfield";
1486                 if ( $marcrecord->field($tag) ) {
1487                     $marcrecord->field($tag)->add_subfields( "$subfield" => $info->{branch} );
1488                 } else {
1489                     my $newField = MARC::Field->new( "$tag", '', '', "$subfield" => $info->{branch} );
1490                     $marcrecord->insert_fields_ordered($newField);
1491                 }
1492                 ( $tag, $subfield ) = GetMarcFromKohaField( "items.holdingbranch", $fwk );
1493
1494                 #warn "items.holdingbranch : $tag , $subfield";
1495                 if ( $marcrecord->field($tag) ) {
1496                     $marcrecord->field($tag)->add_subfields( "$subfield" => $info->{branch} );
1497                 } else {
1498                     my $newField = MARC::Field->new( "$tag", '', '', "$subfield" => $info->{branch} );
1499                     $marcrecord->insert_fields_ordered($newField);
1500                 }
1501             }
1502             if ( $info->{itemcallnumber} ) {
1503                 my ( $tag, $subfield ) = GetMarcFromKohaField( "items.itemcallnumber", $fwk );
1504
1505                 if ( $marcrecord->field($tag) ) {
1506                     $marcrecord->field($tag)->add_subfields( "$subfield" => $info->{itemcallnumber} );
1507                 } else {
1508                     my $newField = MARC::Field->new( "$tag", '', '', "$subfield" => $info->{itemcallnumber} );
1509                     $marcrecord->insert_fields_ordered($newField);
1510                 }
1511             }
1512             if ( $info->{notes} ) {
1513                 my ( $tag, $subfield ) = GetMarcFromKohaField( "items.itemnotes", $fwk );
1514
1515                 if ( $marcrecord->field($tag) ) {
1516                     $marcrecord->field($tag)->add_subfields( "$subfield" => $info->{notes} );
1517                 } else {
1518                     my $newField = MARC::Field->new( "$tag", '', '', "$subfield" => $info->{notes} );
1519                     $marcrecord->insert_fields_ordered($newField);
1520                 }
1521             }
1522             if ( $info->{location} ) {
1523                 my ( $tag, $subfield ) = GetMarcFromKohaField( "items.location", $fwk );
1524
1525                 if ( $marcrecord->field($tag) ) {
1526                     $marcrecord->field($tag)->add_subfields( "$subfield" => $info->{location} );
1527                 } else {
1528                     my $newField = MARC::Field->new( "$tag", '', '', "$subfield" => $info->{location} );
1529                     $marcrecord->insert_fields_ordered($newField);
1530                 }
1531             }
1532             if ( $info->{status} ) {
1533                 my ( $tag, $subfield ) = GetMarcFromKohaField( "items.notforloan", $fwk );
1534
1535                 if ( $marcrecord->field($tag) ) {
1536                     $marcrecord->field($tag)->add_subfields( "$subfield" => $info->{status} );
1537                 } else {
1538                     my $newField = MARC::Field->new( "$tag", '', '', "$subfield" => $info->{status} );
1539                     $marcrecord->insert_fields_ordered($newField);
1540                 }
1541             }
1542             if ( C4::Context->preference("RoutingSerials") ) {
1543                 my ( $tag, $subfield ) = GetMarcFromKohaField( "items.dateaccessioned", $fwk );
1544                 if ( $marcrecord->field($tag) ) {
1545                     $marcrecord->field($tag)->add_subfields( "$subfield" => $now );
1546                 } else {
1547                     my $newField = MARC::Field->new( "$tag", '', '', "$subfield" => $now );
1548                     $marcrecord->insert_fields_ordered($newField);
1549                 }
1550             }
1551             AddItemFromMarc( $marcrecord, $data->{'biblionumber'} );
1552             return 1;
1553         }
1554         return ( 0, @errors );
1555     }
1556 }
1557
1558 =head2 HasSubscriptionStrictlyExpired
1559
1560 1 or 0 = HasSubscriptionStrictlyExpired($subscriptionid)
1561
1562 the subscription has stricly expired when today > the end subscription date
1563
1564 return :
1565 1 if true, 0 if false, -1 if the expiration date is not set.
1566
1567 =cut
1568
1569 sub HasSubscriptionStrictlyExpired {
1570
1571     # Getting end of subscription date
1572     my ($subscriptionid) = @_;
1573     my $dbh              = C4::Context->dbh;
1574     my $subscription     = GetSubscription($subscriptionid);
1575     my $expirationdate = $subscription->{enddate} || GetExpirationDate($subscriptionid);
1576
1577     # If the expiration date is set
1578     if ( $expirationdate != 0 ) {
1579         my ( $endyear, $endmonth, $endday ) = split( '-', $expirationdate );
1580
1581         # Getting today's date
1582         my ( $nowyear, $nowmonth, $nowday ) = Today();
1583
1584         # if today's date > expiration date, then the subscription has stricly expired
1585         if ( Delta_Days( $nowyear, $nowmonth, $nowday, $endyear, $endmonth, $endday ) < 0 ) {
1586             return 1;
1587         } else {
1588             return 0;
1589         }
1590     } else {
1591
1592         # There are some cases where the expiration date is not set
1593         # As we can't determine if the subscription has expired on a date-basis,
1594         # we return -1;
1595         return -1;
1596     }
1597 }
1598
1599 =head2 HasSubscriptionExpired
1600
1601 $has_expired = HasSubscriptionExpired($subscriptionid)
1602
1603 the subscription has expired when the next issue to arrive is out of subscription limit.
1604
1605 return :
1606 0 if the subscription has not expired
1607 1 if the subscription has expired
1608 2 if has subscription does not have a valid expiration date set
1609
1610 =cut
1611
1612 sub HasSubscriptionExpired {
1613     my ($subscriptionid) = @_;
1614     my $dbh              = C4::Context->dbh;
1615     my $subscription     = GetSubscription($subscriptionid);
1616     if ( ( $subscription->{periodicity} % 16 ) > 0 ) {
1617         my $expirationdate = $subscription->{enddate} || GetExpirationDate($subscriptionid);
1618         if (!defined $expirationdate) {
1619             $expirationdate = q{};
1620         }
1621         my $query          = qq|
1622             SELECT max(planneddate)
1623             FROM   serial
1624             WHERE  subscriptionid=?
1625       |;
1626         my $sth = $dbh->prepare($query);
1627         $sth->execute($subscriptionid);
1628         my ($res) = $sth->fetchrow;
1629         return 0 unless $res;
1630         my @res                   = split( /-/, $res );
1631         my @endofsubscriptiondate = split( /-/, $expirationdate );
1632         return 2 if ( scalar(@res) != 3 || scalar(@endofsubscriptiondate) != 3 || not check_date(@res) || not check_date(@endofsubscriptiondate) );
1633         return 1
1634           if ( ( @endofsubscriptiondate && Delta_Days( $res[0], $res[1], $res[2], $endofsubscriptiondate[0], $endofsubscriptiondate[1], $endofsubscriptiondate[2] ) <= 0 )
1635             || ( !$res ) );
1636         return 0;
1637     } else {
1638         if ( $subscription->{'numberlength'} ) {
1639             my $countreceived = countissuesfrom( $subscriptionid, $subscription->{'startdate'} );
1640             return 1 if ( $countreceived > $subscription->{'numberlength'} );
1641             return 0;
1642         } else {
1643             return 0;
1644         }
1645     }
1646     return 0;    # Notice that you'll never get here.
1647 }
1648
1649 =head2 SetDistributedto
1650
1651 SetDistributedto($distributedto,$subscriptionid);
1652 This function update the value of distributedto for a subscription given on input arg.
1653
1654 =cut
1655
1656 sub SetDistributedto {
1657     my ( $distributedto, $subscriptionid ) = @_;
1658     my $dbh   = C4::Context->dbh;
1659     my $query = qq|
1660         UPDATE subscription
1661         SET    distributedto=?
1662         WHERE  subscriptionid=?
1663     |;
1664     my $sth = $dbh->prepare($query);
1665     $sth->execute( $distributedto, $subscriptionid );
1666     return;
1667 }
1668
1669 =head2 DelSubscription
1670
1671 DelSubscription($subscriptionid)
1672 this function deletes subscription which has $subscriptionid as id.
1673
1674 =cut
1675
1676 sub DelSubscription {
1677     my ($subscriptionid) = @_;
1678     my $dbh = C4::Context->dbh;
1679     $subscriptionid = $dbh->quote($subscriptionid);
1680     $dbh->do("DELETE FROM subscription WHERE subscriptionid=$subscriptionid");
1681     $dbh->do("DELETE FROM subscriptionhistory WHERE subscriptionid=$subscriptionid");
1682     $dbh->do("DELETE FROM serial WHERE subscriptionid=$subscriptionid");
1683
1684     logaction( "SERIAL", "DELETE", $subscriptionid, "" ) if C4::Context->preference("SubscriptionLog");
1685 }
1686
1687 =head2 DelIssue
1688
1689 DelIssue($serialseq,$subscriptionid)
1690 this function deletes an issue which has $serialseq and $subscriptionid given on input arg.
1691
1692 returns the number of rows affected
1693
1694 =cut
1695
1696 sub DelIssue {
1697     my ($dataissue) = @_;
1698     my $dbh = C4::Context->dbh;
1699     ### TODO Add itemdeletion. Would need to get itemnumbers. Should be in a pref ?
1700
1701     my $query = qq|
1702         DELETE FROM serial
1703         WHERE       serialid= ?
1704         AND         subscriptionid= ?
1705     |;
1706     my $mainsth = $dbh->prepare($query);
1707     $mainsth->execute( $dataissue->{'serialid'}, $dataissue->{'subscriptionid'} );
1708
1709     #Delete element from subscription history
1710     $query = "SELECT * FROM   subscription WHERE  subscriptionid = ?";
1711     my $sth = $dbh->prepare($query);
1712     $sth->execute( $dataissue->{'subscriptionid'} );
1713     my $val = $sth->fetchrow_hashref;
1714     unless ( $val->{manualhistory} ) {
1715         my $query = qq|
1716           SELECT * FROM subscriptionhistory
1717           WHERE       subscriptionid= ?
1718       |;
1719         my $sth = $dbh->prepare($query);
1720         $sth->execute( $dataissue->{'subscriptionid'} );
1721         my $data      = $sth->fetchrow_hashref;
1722         my $serialseq = $dataissue->{'serialseq'};
1723         $data->{'missinglist'}  =~ s/\b$serialseq\b//;
1724         $data->{'recievedlist'} =~ s/\b$serialseq\b//;
1725         my $strsth = "UPDATE subscriptionhistory SET " . join( ",", map { join( "=", $_, $dbh->quote( $data->{$_} ) ) } keys %$data ) . " WHERE subscriptionid=?";
1726         $sth = $dbh->prepare($strsth);
1727         $sth->execute( $dataissue->{'subscriptionid'} );
1728     }
1729
1730     return $mainsth->rows;
1731 }
1732
1733 =head2 GetLateOrMissingIssues
1734
1735 @issuelist = GetLateMissingIssues($supplierid,$serialid)
1736
1737 this function selects missing issues on database - where serial.status = 4 or serial.status=3 or planneddate<now
1738
1739 return :
1740 the issuelist as an array of hash refs. Each element of this array contains
1741 name,title,planneddate,serialseq,serial.subscriptionid from tables : subscription, serial & biblio
1742
1743 =cut
1744
1745 sub GetLateOrMissingIssues {
1746     my ( $supplierid, $serialid, $order ) = @_;
1747     my $dbh = C4::Context->dbh;
1748     my $sth;
1749     my $byserial = '';
1750     if ($serialid) {
1751         $byserial = "and serialid = " . $serialid;
1752     }
1753     if ($order) {
1754         $order .= ", title";
1755     } else {
1756         $order = "title";
1757     }
1758     if ($supplierid) {
1759         $sth = $dbh->prepare(
1760             "SELECT
1761                 serialid,      aqbooksellerid,        name,
1762                 biblio.title,  planneddate,           serialseq,
1763                 serial.status, serial.subscriptionid, claimdate
1764             FROM      serial
1765                 LEFT JOIN subscription  ON serial.subscriptionid=subscription.subscriptionid
1766                 LEFT JOIN biblio        ON subscription.biblionumber=biblio.biblionumber
1767                 LEFT JOIN aqbooksellers ON subscription.aqbooksellerid = aqbooksellers.id
1768                 WHERE subscription.subscriptionid = serial.subscriptionid
1769                 AND (serial.STATUS = 4 OR ((planneddate < now() AND serial.STATUS =1) OR serial.STATUS = 3 OR serial.STATUS = 7))
1770                 AND subscription.aqbooksellerid=$supplierid
1771                 $byserial
1772                 ORDER BY $order"
1773         );
1774     } else {
1775         $sth = $dbh->prepare(
1776             "SELECT
1777             serialid,      aqbooksellerid,         name,
1778             biblio.title,  planneddate,           serialseq,
1779             serial.status, serial.subscriptionid, claimdate
1780             FROM serial
1781                 LEFT JOIN subscription ON serial.subscriptionid=subscription.subscriptionid
1782                 LEFT JOIN biblio ON subscription.biblionumber=biblio.biblionumber
1783                 LEFT JOIN aqbooksellers ON subscription.aqbooksellerid = aqbooksellers.id
1784                 WHERE subscription.subscriptionid = serial.subscriptionid
1785                         AND (serial.STATUS = 4 OR ((planneddate < now() AND serial.STATUS =1) OR serial.STATUS = 3 OR serial.STATUS = 7))
1786                 $byserial
1787                 ORDER BY $order"
1788         );
1789     }
1790     $sth->execute;
1791     my @issuelist;
1792     while ( my $line = $sth->fetchrow_hashref ) {
1793
1794         if ($line->{planneddate} && $line->{planneddate} !~/^0+\-/) {
1795             $line->{planneddate} = format_date( $line->{planneddate} );
1796         }
1797         if ($line->{claimdate} && $line->{claimdate} !~/^0+\-/) {
1798             $line->{claimdate}   = format_date( $line->{claimdate} );
1799         }
1800         $line->{"status".$line->{status}}   = 1;
1801         push @issuelist, $line;
1802     }
1803     return @issuelist;
1804 }
1805
1806 =head2 removeMissingIssue
1807
1808 removeMissingIssue($subscriptionid)
1809
1810 this function removes an issue from being part of the missing string in
1811 subscriptionlist.missinglist column
1812
1813 called when a missing issue is found from the serials-recieve.pl file
1814
1815 =cut
1816
1817 sub removeMissingIssue {
1818     my ( $sequence, $subscriptionid ) = @_;
1819     my $dbh = C4::Context->dbh;
1820     my $sth = $dbh->prepare("SELECT * FROM subscriptionhistory WHERE subscriptionid = ?");
1821     $sth->execute($subscriptionid);
1822     my $data              = $sth->fetchrow_hashref;
1823     my $missinglist       = $data->{'missinglist'};
1824     my $missinglistbefore = $missinglist;
1825
1826     # warn $missinglist." before";
1827     $missinglist =~ s/($sequence)//;
1828
1829     # warn $missinglist." after";
1830     if ( $missinglist ne $missinglistbefore ) {
1831         $missinglist =~ s/\|\s\|/\|/g;
1832         $missinglist =~ s/^\| //g;
1833         $missinglist =~ s/\|$//g;
1834         my $sth2 = $dbh->prepare(
1835             "UPDATE subscriptionhistory
1836                     SET missinglist = ?
1837                     WHERE subscriptionid = ?"
1838         );
1839         $sth2->execute( $missinglist, $subscriptionid );
1840     }
1841     return;
1842 }
1843
1844 =head2 updateClaim
1845
1846 &updateClaim($serialid)
1847
1848 this function updates the time when a claim is issued for late/missing items
1849
1850 called from claims.pl file
1851
1852 =cut
1853
1854 sub updateClaim {
1855     my ($serialid) = @_;
1856     my $dbh        = C4::Context->dbh;
1857     my $sth        = $dbh->prepare(
1858         "UPDATE serial SET claimdate = now()
1859                 WHERE serialid = ?
1860         "
1861     );
1862     $sth->execute($serialid);
1863     return;
1864 }
1865
1866 =head2 getsupplierbyserialid
1867
1868 $result = getsupplierbyserialid($serialid)
1869
1870 this function is used to find the supplier id given a serial id
1871
1872 return :
1873 hashref containing serialid, subscriptionid, and aqbooksellerid
1874
1875 =cut
1876
1877 sub getsupplierbyserialid {
1878     my ($serialid) = @_;
1879     my $dbh        = C4::Context->dbh;
1880     my $sth        = $dbh->prepare(
1881         "SELECT serialid, serial.subscriptionid, aqbooksellerid
1882          FROM serial
1883             LEFT JOIN subscription ON serial.subscriptionid = subscription.subscriptionid
1884             WHERE serialid = ?
1885         "
1886     );
1887     $sth->execute($serialid);
1888     my $line   = $sth->fetchrow_hashref;
1889     my $result = $line->{'aqbooksellerid'};
1890     return $result;
1891 }
1892
1893 =head2 check_routing
1894
1895 $result = &check_routing($subscriptionid)
1896
1897 this function checks to see if a serial has a routing list and returns the count of routingid
1898 used to show either an 'add' or 'edit' link
1899
1900 =cut
1901
1902 sub check_routing {
1903     my ($subscriptionid) = @_;
1904     my $dbh              = C4::Context->dbh;
1905     my $sth              = $dbh->prepare(
1906         "SELECT count(routingid) routingids FROM subscription LEFT JOIN subscriptionroutinglist
1907                               ON subscription.subscriptionid = subscriptionroutinglist.subscriptionid
1908                               WHERE subscription.subscriptionid = ? ORDER BY ranking ASC
1909                               "
1910     );
1911     $sth->execute($subscriptionid);
1912     my $line   = $sth->fetchrow_hashref;
1913     my $result = $line->{'routingids'};
1914     return $result;
1915 }
1916
1917 =head2 addroutingmember
1918
1919 addroutingmember($borrowernumber,$subscriptionid)
1920
1921 this function takes a borrowernumber and subscriptionid and adds the member to the
1922 routing list for that serial subscription and gives them a rank on the list
1923 of either 1 or highest current rank + 1
1924
1925 =cut
1926
1927 sub addroutingmember {
1928     my ( $borrowernumber, $subscriptionid ) = @_;
1929     my $rank;
1930     my $dbh = C4::Context->dbh;
1931     my $sth = $dbh->prepare( "SELECT max(ranking) rank FROM subscriptionroutinglist WHERE subscriptionid = ?" );
1932     $sth->execute($subscriptionid);
1933     while ( my $line = $sth->fetchrow_hashref ) {
1934         if ( $line->{'rank'} > 0 ) {
1935             $rank = $line->{'rank'} + 1;
1936         } else {
1937             $rank = 1;
1938         }
1939     }
1940     $sth = $dbh->prepare( "INSERT INTO subscriptionroutinglist (subscriptionid,borrowernumber,ranking) VALUES (?,?,?)" );
1941     $sth->execute( $subscriptionid, $borrowernumber, $rank );
1942 }
1943
1944 =head2 reorder_members
1945
1946 reorder_members($subscriptionid,$routingid,$rank)
1947
1948 this function is used to reorder the routing list
1949
1950 it takes the routingid of the member one wants to re-rank and the rank it is to move to
1951 - it gets all members on list puts their routingid's into an array
1952 - removes the one in the array that is $routingid
1953 - then reinjects $routingid at point indicated by $rank
1954 - then update the database with the routingids in the new order
1955
1956 =cut
1957
1958 sub reorder_members {
1959     my ( $subscriptionid, $routingid, $rank ) = @_;
1960     my $dbh = C4::Context->dbh;
1961     my $sth = $dbh->prepare( "SELECT * FROM subscriptionroutinglist WHERE subscriptionid = ? ORDER BY ranking ASC" );
1962     $sth->execute($subscriptionid);
1963     my @result;
1964     while ( my $line = $sth->fetchrow_hashref ) {
1965         push( @result, $line->{'routingid'} );
1966     }
1967
1968     # To find the matching index
1969     my $i;
1970     my $key = -1;    # to allow for 0 being a valid response
1971     for ( $i = 0 ; $i < @result ; $i++ ) {
1972         if ( $routingid == $result[$i] ) {
1973             $key = $i;    # save the index
1974             last;
1975         }
1976     }
1977
1978     # if index exists in array then move it to new position
1979     if ( $key > -1 && $rank > 0 ) {
1980         my $new_rank = $rank - 1;                       # $new_rank is what you want the new index to be in the array
1981         my $moving_item = splice( @result, $key, 1 );
1982         splice( @result, $new_rank, 0, $moving_item );
1983     }
1984     for ( my $j = 0 ; $j < @result ; $j++ ) {
1985         my $sth = $dbh->prepare( "UPDATE subscriptionroutinglist SET ranking = '" . ( $j + 1 ) . "' WHERE routingid = '" . $result[$j] . "'" );
1986         $sth->execute;
1987     }
1988     return;
1989 }
1990
1991 =head2 delroutingmember
1992
1993 delroutingmember($routingid,$subscriptionid)
1994
1995 this function either deletes one member from routing list if $routingid exists otherwise
1996 deletes all members from the routing list
1997
1998 =cut
1999
2000 sub delroutingmember {
2001
2002     # if $routingid exists then deletes that row otherwise deletes all with $subscriptionid
2003     my ( $routingid, $subscriptionid ) = @_;
2004     my $dbh = C4::Context->dbh;
2005     if ($routingid) {
2006         my $sth = $dbh->prepare("DELETE FROM subscriptionroutinglist WHERE routingid = ?");
2007         $sth->execute($routingid);
2008         reorder_members( $subscriptionid, $routingid );
2009     } else {
2010         my $sth = $dbh->prepare("DELETE FROM subscriptionroutinglist WHERE subscriptionid = ?");
2011         $sth->execute($subscriptionid);
2012     }
2013     return;
2014 }
2015
2016 =head2 getroutinglist
2017
2018 ($count,@routinglist) = getroutinglist($subscriptionid)
2019
2020 this gets the info from the subscriptionroutinglist for $subscriptionid
2021
2022 return :
2023 a count of the number of members on routinglist
2024 the routinglist as an array. Each element of the array contains a hash_ref containing
2025 routingid - a unique id, borrowernumber, ranking, and biblionumber of subscription
2026
2027 =cut
2028
2029 sub getroutinglist {
2030     my ($subscriptionid) = @_;
2031     my $dbh              = C4::Context->dbh;
2032     my $sth              = $dbh->prepare(
2033         "SELECT routingid, borrowernumber, ranking, biblionumber
2034             FROM subscription
2035             JOIN subscriptionroutinglist ON subscription.subscriptionid = subscriptionroutinglist.subscriptionid
2036             WHERE subscription.subscriptionid = ? ORDER BY ranking ASC
2037                               "
2038     );
2039     $sth->execute($subscriptionid);
2040     my @routinglist;
2041     my $count = 0;
2042     while ( my $line = $sth->fetchrow_hashref ) {
2043         $count++;
2044         push( @routinglist, $line );
2045     }
2046     return ( $count, @routinglist );
2047 }
2048
2049 =head2 countissuesfrom
2050
2051 $result = countissuesfrom($subscriptionid,$startdate)
2052
2053 Returns a count of serial rows matching the given subsctiptionid
2054 with published date greater than startdate
2055
2056 =cut
2057
2058 sub countissuesfrom {
2059     my ( $subscriptionid, $startdate ) = @_;
2060     my $dbh   = C4::Context->dbh;
2061     my $query = qq|
2062             SELECT count(*)
2063             FROM   serial
2064             WHERE  subscriptionid=?
2065             AND serial.publisheddate>?
2066         |;
2067     my $sth = $dbh->prepare($query);
2068     $sth->execute( $subscriptionid, $startdate );
2069     my ($countreceived) = $sth->fetchrow;
2070     return $countreceived;
2071 }
2072
2073 =head2 CountIssues
2074
2075 $result = CountIssues($subscriptionid)
2076
2077 Returns a count of serial rows matching the given subsctiptionid
2078
2079 =cut
2080
2081 sub CountIssues {
2082     my ($subscriptionid) = @_;
2083     my $dbh              = C4::Context->dbh;
2084     my $query            = qq|
2085             SELECT count(*)
2086             FROM   serial
2087             WHERE  subscriptionid=?
2088         |;
2089     my $sth = $dbh->prepare($query);
2090     $sth->execute($subscriptionid);
2091     my ($countreceived) = $sth->fetchrow;
2092     return $countreceived;
2093 }
2094
2095 =head2 HasItems
2096
2097 $result = HasItems($subscriptionid)
2098
2099 returns a count of items from serial matching the subscriptionid
2100
2101 =cut
2102
2103 sub HasItems {
2104     my ($subscriptionid) = @_;
2105     my $dbh              = C4::Context->dbh;
2106     my $query = q|
2107             SELECT COUNT(serialitems.itemnumber)
2108             FROM   serial
2109                         LEFT JOIN serialitems USING(serialid)
2110             WHERE  subscriptionid=? AND serialitems.serialid IS NOT NULL
2111         |;
2112     my $sth=$dbh->prepare($query);
2113     $sth->execute($subscriptionid);
2114     my ($countitems)=$sth->fetchrow_array();
2115     return $countitems;
2116 }
2117
2118 =head2 abouttoexpire
2119
2120 $result = abouttoexpire($subscriptionid)
2121
2122 this function alerts you to the penultimate issue for a serial subscription
2123
2124 returns 1 - if this is the penultimate issue
2125 returns 0 - if not
2126
2127 =cut
2128
2129 sub abouttoexpire {
2130     my ($subscriptionid) = @_;
2131     my $dbh              = C4::Context->dbh;
2132     my $subscription     = GetSubscription($subscriptionid);
2133     my $per = $subscription->{'periodicity'};
2134     if ($per && $per % 16 > 0){
2135         my $expirationdate   = GetExpirationDate($subscriptionid);
2136         my ($res) = $dbh->selectrow_array('select max(planneddate) from serial where subscriptionid = ?', undef, $subscriptionid);
2137         my @res;
2138         if (defined $res) {
2139             @res=split (/-/,$res);
2140             @res=Date::Calc::Today if ($res[0]*$res[1]==0);
2141         } else { # default an undefined value
2142             @res=Date::Calc::Today;
2143         }
2144         my @endofsubscriptiondate=split(/-/,$expirationdate);
2145         my @per_list = (0, 7, 7, 14, 21, 31, 62, 93, 93, 190, 365, 730, 0, 0, 0, 0);
2146         my @datebeforeend;
2147         @datebeforeend = Add_Delta_Days(  $endofsubscriptiondate[0],$endofsubscriptiondate[1],$endofsubscriptiondate[2],
2148             - (3 * $per_list[$per])) if (@endofsubscriptiondate && $endofsubscriptiondate[0]*$endofsubscriptiondate[1]*$endofsubscriptiondate[2]);
2149         return 1 if ( @res &&
2150             (@datebeforeend &&
2151                 Delta_Days($res[0],$res[1],$res[2],
2152                     $datebeforeend[0],$datebeforeend[1],$datebeforeend[2]) <= 0) &&
2153             (@endofsubscriptiondate &&
2154                 Delta_Days($res[0],$res[1],$res[2],
2155                     $endofsubscriptiondate[0],$endofsubscriptiondate[1],$endofsubscriptiondate[2]) >= 0) );
2156         return 0;
2157     } elsif ($subscription->{numberlength}>0) {
2158         return (countissuesfrom($subscriptionid,$subscription->{'startdate'}) >=$subscription->{numberlength}-1);
2159     }
2160     return 0;
2161 }
2162
2163 sub in_array {    # used in next sub down
2164     my ( $val, @elements ) = @_;
2165     foreach my $elem (@elements) {
2166         if ( $val == $elem ) {
2167             return 1;
2168         }
2169     }
2170     return 0;
2171 }
2172
2173 =head2 GetNextDate
2174
2175 $resultdate = GetNextDate($planneddate,$subscription)
2176
2177 this function it takes the planneddate and will return the next issue's date and will skip dates if there
2178 exists an irregularity
2179 - eg if periodicity is monthly and $planneddate is 2007-02-10 but if March and April is to be
2180 skipped then the returned date will be 2007-05-10
2181
2182 return :
2183 $resultdate - then next date in the sequence
2184
2185 Return 0 if periodicity==0
2186
2187 =cut
2188
2189 sub GetNextDate(@) {
2190     my ( $planneddate, $subscription ) = @_;
2191     my @irreg = split( /\,/, $subscription->{irregularity} );
2192
2193     #date supposed to be in ISO.
2194
2195     my ( $year, $month, $day ) = split( /-/, $planneddate );
2196     $month = 1 unless ($month);
2197     $day   = 1 unless ($day);
2198     my @resultdate;
2199
2200     #       warn "DOW $dayofweek";
2201     if ( $subscription->{periodicity} % 16 == 0 ) {    # 'without regularity' || 'irregular'
2202         return 0;
2203     }
2204
2205     #   daily : n / week
2206     #   Since we're interpreting irregularity here as which days of the week to skip an issue,
2207     #   renaming this pattern from 1/day to " n / week ".
2208     if ( $subscription->{periodicity} == 1 ) {
2209         my $dayofweek = eval { Day_of_Week( $year, $month, $day ) };
2210         if ($@) { warn "year month day : $year $month $day $subscription->{subscriptionid} : $@"; }
2211         else {
2212             for ( my $i = 0 ; $i < @irreg ; $i++ ) {
2213                 $dayofweek = 0 if ( $dayofweek == 7 );
2214                 if ( in_array( ( $dayofweek + 1 ), @irreg ) ) {
2215                     ( $year, $month, $day ) = Add_Delta_Days( $year, $month, $day, 1 );
2216                     $dayofweek++;
2217                 }
2218             }
2219             @resultdate = Add_Delta_Days( $year, $month, $day, 1 );
2220         }
2221     }
2222
2223     #   1  week
2224     if ( $subscription->{periodicity} == 2 ) {
2225         my ( $wkno, $year ) = eval { Week_of_Year( $year, $month, $day ) };
2226         if ($@) { warn "year month day : $year $month $day $subscription->{subscriptionid} : $@"; }
2227         else {
2228             for ( my $i = 0 ; $i < @irreg ; $i++ ) {
2229
2230                 #FIXME: if two consecutive irreg, do we only skip one?
2231                 if ( $irreg[$i] == ( ( $wkno != 51 ) ? ( $wkno + 1 ) % 52 : 52 ) ) {
2232                     ( $year, $month, $day ) = Add_Delta_Days( $year, $month, $day, 7 );
2233                     $wkno = ( ( $wkno != 51 ) ? ( $wkno + 1 ) % 52 : 52 );
2234                 }
2235             }
2236             @resultdate = Add_Delta_Days( $year, $month, $day, 7 );
2237         }
2238     }
2239
2240     #   1 / 2 weeks
2241     if ( $subscription->{periodicity} == 3 ) {
2242         my ( $wkno, $year ) = eval { Week_of_Year( $year, $month, $day ) };
2243         if ($@) { warn "year month day : $year $month $day $subscription->{subscriptionid} : $@"; }
2244         else {
2245             for ( my $i = 0 ; $i < @irreg ; $i++ ) {
2246                 if ( $irreg[$i] == ( ( $wkno != 50 ) ? ( $wkno + 2 ) % 52 : 52 ) ) {
2247                     ### BUGFIX was previously +1 ^
2248                     ( $year, $month, $day ) = Add_Delta_Days( $year, $month, $day, 14 );
2249                     $wkno = ( ( $wkno != 50 ) ? ( $wkno + 2 ) % 52 : 52 );
2250                 }
2251             }
2252             @resultdate = Add_Delta_Days( $year, $month, $day, 14 );
2253         }
2254     }
2255
2256     #   1 / 3 weeks
2257     if ( $subscription->{periodicity} == 4 ) {
2258         my ( $wkno, $year ) = eval { Week_of_Year( $year, $month, $day ) };
2259         if ($@) { warn "année mois jour : $year $month $day $subscription->{subscriptionid} : $@"; }
2260         else {
2261             for ( my $i = 0 ; $i < @irreg ; $i++ ) {
2262                 if ( $irreg[$i] == ( ( $wkno != 49 ) ? ( $wkno + 3 ) % 52 : 52 ) ) {
2263                     ( $year, $month, $day ) = Add_Delta_Days( $year, $month, $day, 21 );
2264                     $wkno = ( ( $wkno != 49 ) ? ( $wkno + 3 ) % 52 : 52 );
2265                 }
2266             }
2267             @resultdate = Add_Delta_Days( $year, $month, $day, 21 );
2268         }
2269     }
2270     my $tmpmonth = $month;
2271     if ( $year && $month && $day ) {
2272         if ( $subscription->{periodicity} == 5 ) {
2273             for ( my $i = 0 ; $i < @irreg ; $i++ ) {
2274                 if ( $irreg[$i] == ( ( $tmpmonth != 11 ) ? ( $tmpmonth + 1 ) % 12 : 12 ) ) {
2275                     ( $year, $month, $day ) = Add_Delta_YMD( $year, $month, $day, 0, 1, 0 );
2276                     $tmpmonth = ( ( $tmpmonth != 11 ) ? ( $tmpmonth + 1 ) % 12 : 12 );
2277                 }
2278             }
2279             @resultdate = Add_Delta_YMD( $year, $month, $day, 0, 1, 0 );
2280         }
2281         if ( $subscription->{periodicity} == 6 ) {
2282             for ( my $i = 0 ; $i < @irreg ; $i++ ) {
2283                 if ( $irreg[$i] == ( ( $tmpmonth != 10 ) ? ( $tmpmonth + 2 ) % 12 : 12 ) ) {
2284                     ( $year, $month, $day ) = Add_Delta_YMD( $year, $month, $day, 0, 2, 0 );
2285                     $tmpmonth = ( ( $tmpmonth != 10 ) ? ( $tmpmonth + 2 ) % 12 : 12 );
2286                 }
2287             }
2288             @resultdate = Add_Delta_YMD( $year, $month, $day, 0, 2, 0 );
2289         }
2290         if ( $subscription->{periodicity} == 7 ) {
2291             for ( my $i = 0 ; $i < @irreg ; $i++ ) {
2292                 if ( $irreg[$i] == ( ( $tmpmonth != 9 ) ? ( $tmpmonth + 3 ) % 12 : 12 ) ) {
2293                     ( $year, $month, $day ) = Add_Delta_YMD( $year, $month, $day, 0, 3, 0 );
2294                     $tmpmonth = ( ( $tmpmonth != 9 ) ? ( $tmpmonth + 3 ) % 12 : 12 );
2295                 }
2296             }
2297             @resultdate = Add_Delta_YMD( $year, $month, $day, 0, 3, 0 );
2298         }
2299         if ( $subscription->{periodicity} == 8 ) {
2300             for ( my $i = 0 ; $i < @irreg ; $i++ ) {
2301                 if ( $irreg[$i] == ( ( $tmpmonth != 9 ) ? ( $tmpmonth + 3 ) % 12 : 12 ) ) {
2302                     ( $year, $month, $day ) = Add_Delta_YMD( $year, $month, $day, 0, 3, 0 );
2303                     $tmpmonth = ( ( $tmpmonth != 9 ) ? ( $tmpmonth + 3 ) % 12 : 12 );
2304                 }
2305             }
2306             @resultdate = Add_Delta_YMD( $year, $month, $day, 0, 3, 0 );
2307         }
2308         if ( $subscription->{periodicity} == 9 ) {
2309             for ( my $i = 0 ; $i < @irreg ; $i++ ) {
2310                 if ( $irreg[$i] == ( ( $tmpmonth != 9 ) ? ( $tmpmonth + 3 ) % 12 : 12 ) ) {
2311                     ### BUFIX Seems to need more Than One ?
2312                     ( $year, $month, $day ) = Add_Delta_YM( $year, $month, $day, 0, 6 );
2313                     $tmpmonth = ( ( $tmpmonth != 6 ) ? ( $tmpmonth + 6 ) % 12 : 12 );
2314                 }
2315             }
2316             @resultdate = Add_Delta_YM( $year, $month, $day, 0, 6 );
2317         }
2318         if ( $subscription->{periodicity} == 10 ) {
2319             @resultdate = Add_Delta_YM( $year, $month, $day, 1, 0 );
2320         }
2321         if ( $subscription->{periodicity} == 11 ) {
2322             @resultdate = Add_Delta_YM( $year, $month, $day, 2, 0 );
2323         }
2324     }
2325     my $resultdate = sprintf( "%04d-%02d-%02d", $resultdate[0], $resultdate[1], $resultdate[2] );
2326
2327     return "$resultdate";
2328 }
2329
2330 =head2 itemdata
2331
2332   $item = itemdata($barcode);
2333
2334 Looks up the item with the given barcode, and returns a
2335 reference-to-hash containing information about that item. The keys of
2336 the hash are the fields from the C<items> and C<biblioitems> tables in
2337 the Koha database.
2338
2339 =cut
2340
2341 #'
2342 sub itemdata {
2343     my ($barcode) = @_;
2344     my $dbh       = C4::Context->dbh;
2345     my $sth       = $dbh->prepare(
2346         "Select * from items LEFT JOIN biblioitems ON items.biblioitemnumber=biblioitems.biblioitemnumber
2347         WHERE barcode=?"
2348     );
2349     $sth->execute($barcode);
2350     my $data = $sth->fetchrow_hashref;
2351     $sth->finish;
2352     return ($data);
2353 }
2354
2355 1;
2356 __END__
2357
2358 =head1 AUTHOR
2359
2360 Koha Development Team <http://koha-community.org/>
2361
2362 =cut