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