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