1 package C4::Acquisition;
3 # Copyright 2000-2002 Katipo Communications
5 # This file is part of Koha.
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
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.
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
24 use C4::Dates qw(format_date);
29 use vars qw($VERSION @ISA @EXPORT);
32 # set the version for version checking
37 &GetBasket &NewBasket &CloseBasket
38 &GetPendingOrders &GetOrder &GetOrders
39 &GetOrderNumber &GetLateOrders &NewOrder &DelOrder
40 &SearchOrder &GetHistory &GetRecentAcqui
41 &ModOrder &ModReceiveOrder &ModOrderBiblioNumber
42 &GetParcels &GetParcel
46 # used in receiveorder subroutine
47 # to provide library specific handling
48 my $library_name = C4::Context->preference("LibraryName");
52 C4::Acquisition - Koha functions for dealing with orders and acquisitions
60 The functions in this module deal with acquisitions, managing book
61 orders, basket and parcels.
65 =head2 FUNCTIONS ABOUT BASKETS
71 $aqbasket = &GetBasket($basketnumber);
73 get all basket informations in aqbasket for a given basket
76 informations for a given basket returned as a hashref.
84 my $dbh = C4::Context->dbh;
87 concat( b.firstname,' ',b.surname) AS authorisedbyname,
88 b.branchcode AS branch
90 LEFT JOIN borrowers b ON aqbasket.authorisedby=b.borrowernumber
93 my $sth=$dbh->prepare($query);
94 $sth->execute($basketno);
95 my $basket = $sth->fetchrow_hashref;
99 #------------------------------------------------------------#
105 $basket = &NewBasket();
107 Create a new basket in aqbasket table
113 # FIXME : this function seems to be unused.
116 my ( $booksellerid, $authorisedby ) = @_;
117 my $dbh = C4::Context->dbh;
120 (creationdate,booksellerid,authorisedby)
121 VALUES (now(),'$booksellerid','$authorisedby')
126 #find & return basketno MYSQL dependant, but $dbh->last_insert_id always returns null :-(
127 my $basket = $dbh->{'mysql_insertid'};
131 #------------------------------------------------------------#
137 &CloseBasket($basketno);
139 close a basket (becomes unmodifiable,except for recieves)
147 my $dbh = C4::Context->dbh;
153 my $sth = $dbh->prepare($query);
154 $sth->execute($basketno);
157 #------------------------------------------------------------#
159 =head2 FUNCTIONS ABOUT ORDERS
163 #------------------------------------------------------------#
165 =head3 GetPendingOrders
169 $orders = &GetPendingOrders($booksellerid, $grouped);
171 Finds pending orders from the bookseller with the given ID. Ignores
172 completed and cancelled orders.
174 C<$orders> is a reference-to-array; each element is a
175 reference-to-hash with the following fields:
176 C<$grouped> is a boolean that, if set to 1 will group all order lines of the same basket
177 in a single result line
181 =item C<authorizedby>
187 These give the value of the corresponding field in the aqorders table
188 of the Koha database.
194 Results are ordered from most to least recent.
198 sub GetPendingOrders {
199 my ($supplierid,$grouped) = @_;
200 my $dbh = C4::Context->dbh;
202 SELECT ".($grouped?"count(*),":"")."aqbasket.basketno,
203 surname,firstname,aqorders.*,
204 aqbasket.closedate, aqbasket.creationdate
206 LEFT JOIN aqbasket ON aqbasket.basketno=aqorders.basketno
207 LEFT JOIN borrowers ON aqbasket.authorisedby=borrowers.borrowernumber
209 AND (quantity > quantityreceived OR quantityreceived is NULL)
210 AND datecancellationprinted IS NULL
211 AND (to_days(now())-to_days(closedate) < 180 OR closedate IS NULL)
213 ## FIXME Why 180 days ???
214 my @query_params = ( $supplierid );
215 if ( C4::Context->preference("IndependantBranches") ) {
216 my $userenv = C4::Context->userenv;
217 if ( ($userenv) && ( $userenv->{flags} != 1 ) ) {
218 $strsth .= " and (borrowers.branchcode = ?
219 or borrowers.branchcode = '')";
220 push @query_params, $userenv->{branch};
223 $strsth .= " group by aqbasket.basketno" if $grouped;
224 $strsth .= " order by aqbasket.basketno";
226 my $sth = $dbh->prepare($strsth);
227 $sth->execute( @query_params );
228 my $results = $sth->fetchall_arrayref({});
233 #------------------------------------------------------------#
239 @orders = &GetOrders($basketnumber, $orderby);
241 Looks up the pending (non-cancelled) orders with the given basket
242 number. If C<$booksellerID> is non-empty, only orders from that seller
246 C<&basket> returns a two-element array. C<@orders> is an array of
247 references-to-hash, whose keys are the fields from the aqorders,
248 biblio, and biblioitems tables in the Koha database.
255 my ( $basketno, $orderby ) = @_;
256 my $dbh = C4::Context->dbh;
258 SELECT aqorderbreakdown.*,
259 biblio.*,biblioitems.*,
261 aqbookfund.bookfundname,
264 LEFT JOIN aqorderbreakdown ON aqorders.ordernumber=aqorderbreakdown.ordernumber
265 LEFT JOIN aqbookfund ON aqbookfund.bookfundid=aqorderbreakdown.bookfundid
266 LEFT JOIN biblio ON biblio.biblionumber=aqorders.biblionumber
267 LEFT JOIN biblioitems ON biblioitems.biblionumber=biblio.biblionumber
269 AND (datecancellationprinted IS NULL OR datecancellationprinted='0000-00-00')
272 $orderby = "biblioitems.publishercode,biblio.title" unless $orderby;
273 $query .= " ORDER BY $orderby";
274 my $sth = $dbh->prepare($query);
275 $sth->execute($basketno);
278 while ( my $data = $sth->fetchrow_hashref ) {
279 push @results, $data;
285 #------------------------------------------------------------#
287 =head3 GetOrderNumber
291 $ordernumber = &GetOrderNumber($biblioitemnumber, $biblionumber);
295 Looks up the ordernumber with the given biblionumber and biblioitemnumber.
297 Returns the number of this order.
301 =item C<$ordernumber> is the order number.
307 my ( $biblionumber,$biblioitemnumber ) = @_;
308 my $dbh = C4::Context->dbh;
313 AND biblioitemnumber=?
315 my $sth = $dbh->prepare($query);
316 $sth->execute( $biblionumber, $biblioitemnumber );
318 return $sth->fetchrow;
321 #------------------------------------------------------------#
327 $order = &GetOrder($ordernumber);
329 Looks up an order by order number.
331 Returns a reference-to-hash describing the order. The keys of
332 C<$order> are fields from the biblio, biblioitems, aqorders, and
333 aqorderbreakdown tables of the Koha database.
341 my $dbh = C4::Context->dbh;
343 SELECT biblioitems.*, biblio.*, aqorderbreakdown.*, aqorders.*
345 LEFT JOIN aqorderbreakdown ON aqorders.ordernumber=aqorderbreakdown.ordernumber
346 LEFT JOIN biblio on biblio.biblionumber=aqorders.biblionumber
347 LEFT JOIN biblioitems on biblioitems.biblionumber=aqorders.biblionumber
348 WHERE aqorders.ordernumber=?
351 my $sth= $dbh->prepare($query);
352 $sth->execute($ordnum);
353 my $data = $sth->fetchrow_hashref;
358 #------------------------------------------------------------#
364 &NewOrder($basket, $biblionumber, $title, $quantity, $listprice,
365 $booksellerid, $who, $notes, $bookfund, $biblioitemnumber, $rrp,
366 $ecost, $gst, $budget, $unitprice, $subscription,
367 $booksellerinvoicenumber, $purchaseorder, $branchcode);
369 Adds a new order to the database. Any argument that isn't described
370 below is the new value of the field with the same name in the aqorders
371 table of the Koha database.
373 C<$ordnum> is a "minimum order number." After adding the new entry to
374 the aqorders table, C<&neworder> finds the first entry in aqorders
375 with order number greater than or equal to C<$ordnum>, and adds an
376 entry to the aqorderbreakdown table, with the order number just found,
377 and the book fund ID of the newly-added order.
379 C<$budget> is effectively ignored.
380 If it's undef (anything false) or the string 'now', the current day is used.
381 Else, the upcoming July 1st is used.
383 C<$subscription> may be either "yes", or anything else for "no".
391 $basketno, $bibnum, $title, $quantity,
392 $listprice, $booksellerid, $authorisedby, $notes,
393 $bookfund, $bibitemnum, $rrp, $ecost,
394 $gst, $budget, $cost, $sub,
395 $invoice, $sort1, $sort2, $purchaseorder,
400 my $year = localtime->year() + 1900;
401 my $month = localtime->mon() + 1; # months starts at 0, add 1
403 if ( !$budget || $budget eq 'now' ) {
407 # if month is july or more, budget start is 1 jul, next year.
408 elsif ( $month >= '7' ) {
409 ++$year; # add 1 to year , coz its next year
410 $budget = "$year-07-01";
414 # START OF NEW BUDGET, 1ST OF JULY, THIS YEAR
415 $budget = "$year-07-01";
418 if ( $sub eq 'yes' ) {
425 # if $basket empty, it's also a new basket, create it
427 $basketno = NewBasket( $booksellerid, $authorisedby );
430 my $dbh = C4::Context->dbh;
433 ( biblionumber, title, basketno, quantity, listprice,
434 notes, biblioitemnumber, rrp, ecost, gst,
435 unitprice, subscription, sort1, sort2, budgetdate,
436 entrydate, purchaseordernumber)
437 VALUES ( ?,?,?,?,?,?,?,?,?,?,?,?,?,?,COALESCE(?,NOW()),NOW(),? )
439 my $sth = $dbh->prepare($query);
442 $bibnum, $title, $basketno, $quantity, $listprice,
443 $notes, $bibitemnum, $rrp, $ecost, $gst,
444 $cost, $sub, $sort1, $sort2, $budget,
449 #get ordnum MYSQL dependant, but $dbh->last_insert_id returns null
450 my $ordnum = $dbh->{'mysql_insertid'};
452 INSERT INTO aqorderbreakdown (ordernumber,bookfundid, branchcode)
455 $sth = $dbh->prepare($query);
456 $sth->execute( $ordnum, $bookfund, $branchcode );
458 return ( $basketno, $ordnum );
461 #------------------------------------------------------------#
467 &ModOrder($title, $ordernumber, $quantity, $listprice,
468 $biblionumber, $basketno, $supplier, $who, $notes,
469 $bookfundid, $bibitemnum, $rrp, $ecost, $gst, $budget,
470 $unitprice, $booksellerinvoicenumber, $branchcode);
472 Modifies an existing order. Updates the order with order number
473 C<$ordernumber> and biblionumber C<$biblionumber>. All other arguments
474 update the fields with the same name in the aqorders table of the Koha
477 Entries with order number C<$ordernumber> in the aqorderbreakdown
478 table are also updated to the new book fund ID or branchcode.
486 $title, $ordnum, $quantity, $listprice, $bibnum,
487 $basketno, $supplier, $who, $notes, $bookfund,
488 $bibitemnum, $rrp, $ecost, $gst, $budget,
489 $cost, $invoice, $sort1, $sort2, $purchaseorder, $branchcode
492 # FIXME : Refactor to pass a hashref instead of fifty params.
493 my $dbh = C4::Context->dbh;
497 quantity=?,listprice=?,basketno=?,
498 rrp=?,ecost=?,unitprice=?,booksellerinvoicenumber=?,
499 notes=?,sort1=?, sort2=?, purchaseordernumber=?
500 WHERE ordernumber=? AND biblionumber=?
502 my $sth = $dbh->prepare($query);
504 $title, $quantity, $listprice, $basketno, $rrp,
505 $ecost, $cost, $invoice, $notes, $sort1,
506 $sort2, $purchaseorder,
511 UPDATE aqorderbreakdown
512 SET bookfundid=?,branchcode=?
515 $sth = $dbh->prepare($query);
517 my $rv = $sth->execute( $bookfund,$branchcode, $ordnum );
518 unless($rv && ( $rv ne '0E0' )) { # zero rows affected [Bug 734]
520 INSERT INTO aqorderbreakdown
521 (ordernumber,branchcode,bookfundid)
524 $sth = $dbh->prepare($query);
525 $sth->execute( $ordnum,$branchcode, $bookfund );
530 #------------------------------------------------------------#
532 =head3 ModOrderBiblioNumber
536 &ModOrderBiblioNumber($biblioitemnumber,$ordnum, $biblionumber);
538 Modifies the biblioitemnumber for an existing order.
539 Updates the order with order number C<$ordernum> and biblionumber C<$biblionumber>.
545 sub ModOrderBiblioNumber {
546 my ($biblioitemnumber,$ordnum, $biblionumber) = @_;
547 my $dbh = C4::Context->dbh;
550 SET biblioitemnumber = ?
551 WHERE ordernumber = ?
552 AND biblionumber = ?";
553 my $sth = $dbh->prepare($query);
554 $sth->execute( $biblioitemnumber, $ordnum, $biblionumber );
557 #------------------------------------------------------------#
559 =head3 ModReceiveOrder
563 &ModReceiveOrder($biblionumber, $ordernumber, $quantityreceived, $user,
564 $unitprice, $booksellerinvoicenumber, $biblioitemnumber,
565 $freight, $bookfund, $rrp);
567 Updates an order, to reflect the fact that it was received, at least
568 in part. All arguments not mentioned below update the fields with the
569 same name in the aqorders table of the Koha database.
571 If a partial order is received, splits the order into two. The received
572 portion must have a booksellerinvoicenumber.
574 Updates the order with bibilionumber C<$biblionumber> and ordernumber
577 Also updates the book fund ID in the aqorderbreakdown table.
584 sub ModReceiveOrder {
586 $biblionumber, $ordnum, $quantrec, $user, $cost,
587 $invoiceno, $freight, $rrp, $bookfund, $datereceived
590 my $dbh = C4::Context->dbh;
591 # warn "DATE BEFORE : $daterecieved";
592 # $daterecieved=POSIX::strftime("%Y-%m-%d",CORE::localtime) unless $daterecieved;
593 # warn "DATE REC : $daterecieved";
594 $datereceived = C4::Dates->output('iso') unless $datereceived;
595 my $suggestionid = GetSuggestionFromBiblionumber( $dbh, $biblionumber );
597 ModStatus( $suggestionid, 'AVAILABLE', '', $biblionumber );
599 # Allows libraries to change their bookfund during receiving orders
600 # allows them to adjust budgets
601 if ( C4::Context->preference("LooseBudgets") && $bookfund ) {
603 UPDATE aqorderbreakdown
607 my $sth = $dbh->prepare($query);
608 $sth->execute( $bookfund, $ordnum );
612 my $sth=$dbh->prepare("SELECT * FROM aqorders LEFT JOIN aqorderbreakdown ON aqorders.ordernumber=aqorderbreakdown.ordernumber
613 WHERE biblionumber=? AND aqorders.ordernumber=?");
614 $sth->execute($biblionumber,$ordnum);
615 my $order = $sth->fetchrow_hashref();
618 if ( $order->{quantity} > $quantrec ) {
619 $sth=$dbh->prepare("update aqorders
620 set quantityreceived=?,datereceived=?,booksellerinvoicenumber=?,
621 unitprice=?,freight=?,rrp=?,quantity=?
622 where biblionumber=? and ordernumber=?");
623 $sth->execute($quantrec,$datereceived,$invoiceno,$cost,$freight,$rrp,$quantrec,$biblionumber,$ordnum);
625 # create a new order for the remaining items, and set its bookfund.
626 my $newOrder = NewOrder($order->{'basketno'},$order->{'biblionumber'},$order->{'title'}, $order->{'quantity'} - $quantrec,
627 $order->{'listprice'},$order->{'booksellerid'},$order->{'authorisedby'},$order->{'notes'},
628 $order->{'bookfundid'},$order->{'biblioitemnumber'},$order->{'rrp'},$order->{'ecost'},$order->{'gst'},
629 $order->{'budget'},$order->{'unitcost'},$order->{'sub'},'',$order->{'sort1'},$order->{'sort2'},$order->{'purchaseordernumber'});
631 $sth=$dbh->prepare("update aqorders
632 set quantityreceived=?,datereceived=?,booksellerinvoicenumber=?,
633 unitprice=?,freight=?,rrp=?
634 where biblionumber=? and ordernumber=?");
635 $sth->execute($quantrec,$datereceived,$invoiceno,$cost,$freight,$rrp,$biblionumber,$ordnum);
638 return $datereceived;
640 #------------------------------------------------------------#
644 @results = &SearchOrder($search, $biblionumber, $complete);
648 C<$search> may take one of several forms: if it is an ISBN,
649 C<&ordersearch> returns orders with that ISBN. If C<$search> is an
650 order number, C<&ordersearch> returns orders with that order number
651 and biblionumber C<$biblionumber>. Otherwise, C<$search> is considered
652 to be a space-separated list of search terms; in this case, all of the
653 terms must appear in the title (matching the beginning of title
656 If C<$complete> is C<yes>, the results will include only completed
657 orders. In any case, C<&ordersearch> ignores cancelled orders.
659 C<&ordersearch> returns an array.
660 C<@results> is an array of references-to-hash with the following keys:
677 my ( $search, $id, $biblionumber, $catview ) = @_;
678 my $dbh = C4::Context->dbh;
679 my @data = split( ' ', $search );
682 @searchterms = ($id);
684 map { push( @searchterms, "$_%", "%$_%" ) } @data;
685 push( @searchterms, $search, $search, $biblionumber );
687 ### FIXME THIS CAN raise a problem if more THAN ONE biblioitem is linked to one biblio
690 "SELECT *,biblio.title
692 LEFT JOIN biblio ON aqorders.biblionumber=biblio.biblionumber
693 LEFT JOIN biblioitems ON biblioitems.biblionumber=biblio.biblionumber
694 LEFT JOIN aqbasket ON aqorders.basketno = aqbasket.basketno
695 WHERE aqbasket.booksellerid = ?
696 AND ((datecancellationprinted is NULL)
697 OR (datecancellationprinted = '0000-00-00'))
701 map { "(biblio.title like ? or biblio.title like ?)" } @data )
703 . ") OR biblioitems.isbn=? OR (aqorders.ordernumber=? AND aqorders.biblionumber=?)) ";
708 " SELECT *,biblio.title
710 LEFT JOIN biblio ON biblio.biblionumber=aqorders.biblionumber
711 LEFT JOIN aqbasket on aqorders.basketno=aqbasket.basketno
712 LEFT JOIN biblioitems ON biblioitems.biblionumber=biblio.biblionumber
713 WHERE ((datecancellationprinted is NULL)
714 OR (datecancellationprinted = '0000-00-00'))
715 AND (aqorders.quantityreceived < aqorders.quantity OR aqorders.quantityreceived is NULL)
719 map { "(biblio.title like ? OR biblio.title like ?)" } @data )
721 . ") or biblioitems.isbn=? OR (aqorders.ordernumber=? AND aqorders.biblionumber=?)) ";
723 $query .= " GROUP BY aqorders.ordernumber";
725 my $sth = $dbh->prepare($query);
726 $sth->execute(@searchterms);
733 my $sth2 = $dbh->prepare($query2);
736 FROM aqorderbreakdown
739 my $sth3 = $dbh->prepare($query3);
741 while ( my $data = $sth->fetchrow_hashref ) {
742 $sth2->execute( $data->{'biblionumber'} );
743 my $data2 = $sth2->fetchrow_hashref;
744 $data->{'author'} = $data2->{'author'};
745 $data->{'seriestitle'} = $data2->{'seriestitle'};
746 $sth3->execute( $data->{'ordernumber'} );
747 my $data3 = $sth3->fetchrow_hashref;
748 $data->{'branchcode'} = $data3->{'branchcode'};
749 $data->{'bookfundid'} = $data3->{'bookfundid'};
750 push( @results, $data );
759 #------------------------------------------------------------#
765 &DelOrder($biblionumber, $ordernumber);
767 Cancel the order with the given order and biblio numbers. It does not
768 delete any entries in the aqorders table, it merely marks them as
776 my ( $bibnum, $ordnum ) = @_;
777 my $dbh = C4::Context->dbh;
780 SET datecancellationprinted=now()
781 WHERE biblionumber=? AND ordernumber=?
783 my $sth = $dbh->prepare($query);
784 $sth->execute( $bibnum, $ordnum );
788 =head2 FUNCTIONS ABOUT PARCELS
792 #------------------------------------------------------------#
798 @results = &GetParcel($booksellerid, $code, $date);
800 Looks up all of the received items from the supplier with the given
801 bookseller ID at the given date, for the given code (bookseller Invoice number). Ignores cancelled and completed orders.
803 C<@results> is an array of references-to-hash. The keys of each element are fields from
804 the aqorders, biblio, and biblioitems tables of the Koha database.
806 C<@results> is sorted alphabetically by book title.
813 #gets all orders from a certain supplier, orders them alphabetically
814 my ( $supplierid, $code, $datereceived ) = @_;
815 my $dbh = C4::Context->dbh;
818 if $code; # add % if we search on a given code (otherwise, let him empty)
825 aqorders.biblionumber,
827 aqorders.ordernumber,
829 aqorders.quantityreceived,
835 LEFT JOIN aqbasket ON aqbasket.basketno=aqorders.basketno
836 LEFT JOIN borrowers ON aqbasket.authorisedby=borrowers.borrowernumber
838 aqbasket.booksellerid = ?
839 AND aqorders.booksellerinvoicenumber LIKE ?
840 AND aqorders.datereceived = ? ";
842 my @query_params = ( $supplierid, $code, $datereceived );
843 if ( C4::Context->preference("IndependantBranches") ) {
844 my $userenv = C4::Context->userenv;
845 if ( ($userenv) && ( $userenv->{flags} != 1 ) ) {
846 $strsth .= " and (borrowers.branchcode = ?
847 or borrowers.branchcode = '')";
848 push @query_params, $userenv->{branch};
851 $strsth .= " ORDER BY aqbasket.basketno";
852 ### parcelinformation : $strsth
853 my $sth = $dbh->prepare($strsth);
854 $sth->execute( @query_params );
855 while ( my $data = $sth->fetchrow_hashref ) {
856 push( @results, $data );
858 ### countparcelbiblio: scalar(@results)
864 #------------------------------------------------------------#
870 $results = &GetParcels($bookseller, $order, $code, $datefrom, $dateto);
871 get a lists of parcels.
880 is the bookseller this function has to get parcels.
883 To know on what criteria the results list has to be ordered.
886 is the booksellerinvoicenumber.
888 =item $datefrom & $dateto
889 to know on what date this function has to filter its search.
892 a pointer on a hash list containing parcel informations as such :
898 =item Number of biblio
900 =item Number of items
907 my ($bookseller,$order, $code, $datefrom, $dateto) = @_;
908 my $dbh = C4::Context->dbh;
909 my @query_params = ();
911 SELECT aqorders.booksellerinvoicenumber,
912 datereceived,purchaseordernumber,
913 count(DISTINCT biblionumber) AS biblio,
914 sum(quantity) AS itemsexpected,
915 sum(quantityreceived) AS itemsreceived
916 FROM aqorders LEFT JOIN aqbasket ON aqbasket.basketno = aqorders.basketno
917 WHERE aqbasket.booksellerid = $bookseller and datereceived IS NOT NULL
920 if ( defined $code ) {
921 $strsth .= ' and aqorders.booksellerinvoicenumber like ? ';
922 # add a % to the end of the code to allow stemming.
923 push @query_params, "$code%";
926 if ( defined $datefrom ) {
927 $strsth .= ' and datereceived >= ? ';
928 push @query_params, $datefrom;
931 if ( defined $dateto ) {
932 $strsth .= 'and datereceived <= ? ';
933 push @query_params, $dateto;
936 $strsth .= "group by aqorders.booksellerinvoicenumber,datereceived ";
938 # can't use a placeholder to place this column name.
939 # but, we could probably be checking to make sure it is a column that will be fetched.
940 $strsth .= "order by $order " if ($order);
942 my $sth = $dbh->prepare($strsth);
944 $sth->execute( @query_params );
945 my $results = $sth->fetchall_arrayref({});
950 #------------------------------------------------------------#
956 @results = &GetLateOrders;
958 Searches for bookseller with late orders.
961 the table of supplier with late issues. This table is full of hashref.
969 my $supplierid = shift;
972 my $dbh = C4::Context->dbh;
974 #BEWARE, order of parenthesis and LEFT JOIN is important for speed
975 my $dbdriver = C4::Context->config("db_scheme") || "mysql";
977 my @query_params = ($delay); # delay is the first argument regardless
979 SELECT aqbasket.basketno,
980 aqorders.ordernumber,
981 DATE(aqbasket.closedate) AS orderdate,
982 aqorders.rrp AS unitpricesupplier,
983 aqorders.ecost AS unitpricelib,
984 aqbookfund.bookfundname AS budget,
985 borrowers.branchcode AS branch,
986 aqbooksellers.name AS supplier,
989 biblioitems.publishercode AS publisher,
990 biblioitems.publicationyear,
994 (aqorders LEFT JOIN biblio ON biblio.biblionumber = aqorders.biblionumber)
995 LEFT JOIN biblioitems ON biblioitems.biblionumber = biblio.biblionumber)
996 LEFT JOIN aqorderbreakdown ON aqorders.ordernumber = aqorderbreakdown.ordernumber)
997 LEFT JOIN aqbookfund ON aqorderbreakdown.bookfundid = aqbookfund.bookfundid),
998 (aqbasket LEFT JOIN borrowers ON aqbasket.authorisedby = borrowers.borrowernumber)
999 LEFT JOIN aqbooksellers ON aqbasket.booksellerid = aqbooksellers.id
1000 WHERE aqorders.basketno = aqbasket.basketno
1001 AND ( (datereceived = '' OR datereceived IS NULL)
1002 OR (aqorders.quantityreceived < aqorders.quantity)
1006 if ($dbdriver eq "mysql") {
1008 aqorders.quantity - IFNULL(aqorders.quantityreceived,0) AS quantity,
1009 (aqorders.quantity - IFNULL(aqorders.quantityreceived,0)) * aqorders.rrp AS subtotal,
1010 DATEDIFF(CURDATE( ),closedate) AS latesince
1012 $from .= " AND (closedate <= DATE_SUB(CURDATE( ),INTERVAL ? DAY)) ";
1014 HAVING quantity <> 0
1015 AND unitpricesupplier <> 0
1016 AND unitpricelib <> 0
1019 # FIXME: account for IFNULL as above
1021 aqorders.quantity AS quantity,
1022 aqorders.quantity * aqorders.rrp AS subtotal,
1023 (CURDATE - closedate) AS latesince
1025 $from .= " AND (closedate <= (CURDATE -(INTERVAL ? DAY)) ";
1027 if (defined $supplierid) {
1028 $from .= ' AND aqbasket.booksellerid = ? ';
1029 push @query_params, $supplierid;
1031 if (defined $branch) {
1032 $from .= ' AND borrowers.branchcode LIKE ? ';
1033 push @query_params, $branch;
1035 if (C4::Context->preference("IndependantBranches")
1036 && C4::Context->userenv
1037 && C4::Context->userenv->{flags} != 1 ) {
1038 $from .= ' AND borrowers.branchcode LIKE ? ';
1039 push @query_params, C4::Context->userenv->{branch};
1041 my $query = "$select $from $having\nORDER BY latesince, basketno, borrowers.branchcode, supplier";
1042 $debug and print STDERR "GetLateOrders query: $query\nGetLateOrders args: " . join(" ",@query_params);
1043 my $sth = $dbh->prepare($query);
1044 $sth->execute(@query_params);
1046 while (my $data = $sth->fetchrow_hashref) {
1047 $data->{orderdate} = format_date($data->{orderdate});
1048 push @results, $data;
1053 #------------------------------------------------------------#
1059 (\@order_loop, $total_qty, $total_price, $total_qtyreceived) = GetHistory( $title, $author, $name, $from_placed_on, $to_placed_on );
1061 Retreives some acquisition history information
1064 $order_loop is a list of hashrefs that each look like this:
1066 'author' => 'Twain, Mark',
1068 'biblionumber' => '215',
1070 'creationdate' => 'MM/DD/YYYY',
1071 'datereceived' => undef,
1074 'invoicenumber' => undef,
1076 'ordernumber' => '1',
1078 'quantityreceived' => undef,
1079 'title' => 'The Adventures of Huckleberry Finn'
1081 $total_qty is the sum of all of the quantities in $order_loop
1082 $total_price is the cost of each in $order_loop times the quantity
1083 $total_qtyreceived is the sum of all of the quantityreceived entries in $order_loop
1090 my ( $title, $author, $name, $from_placed_on, $to_placed_on ) = @_;
1093 my $total_qtyreceived = 0;
1094 my $total_price = 0;
1096 # don't run the query if there are no parameters (list would be too long for sure !)
1097 if ( $title || $author || $name || $from_placed_on || $to_placed_on ) {
1098 my $dbh = C4::Context->dbh;
1104 name,aqbasket.creationdate,
1105 aqorders.datereceived,
1107 aqorders.quantityreceived,
1109 aqorders.ordernumber,
1110 aqorders.booksellerinvoicenumber as invoicenumber,
1111 aqbooksellers.id as id,
1112 aqorders.biblionumber
1114 LEFT JOIN aqbasket ON aqorders.basketno=aqbasket.basketno
1115 LEFT JOIN aqbooksellers ON aqbasket.booksellerid=aqbooksellers.id
1116 LEFT JOIN biblio ON biblio.biblionumber=aqorders.biblionumber";
1118 $query .= " LEFT JOIN borrowers ON aqbasket.authorisedby=borrowers.borrowernumber"
1119 if ( C4::Context->preference("IndependantBranches") );
1121 $query .= " WHERE (datecancellationprinted is NULL or datecancellationprinted='0000-00-00') ";
1123 my @query_params = ();
1125 if ( defined $title ) {
1126 $query .= " AND biblio.title LIKE ? ";
1127 push @query_params, "%$title%";
1130 if ( defined $author ) {
1131 $query .= " AND biblio.author LIKE ? ";
1132 push @query_params, "%$author%";
1135 if ( defined $name ) {
1136 $query .= " AND name LIKE ? ";
1137 push @query_params, "%$name%";
1140 if ( defined $from_placed_on ) {
1141 $query .= " AND creationdate >= ? ";
1142 push @query_params, $from_placed_on;
1145 if ( defined $to_placed_on ) {
1146 $query .= " AND creationdate <= ? ";
1147 push @query_params, $to_placed_on;
1150 if ( C4::Context->preference("IndependantBranches") ) {
1151 my $userenv = C4::Context->userenv;
1152 if ( ($userenv) && ( $userenv->{flags} != 1 ) ) {
1153 $query .= " AND (borrowers.branchcode = ? OR borrowers.branchcode ='' ) ";
1154 push @query_params, $userenv->{branch};
1157 $query .= " ORDER BY booksellerid";
1158 my $sth = $dbh->prepare($query);
1159 $sth->execute( @query_params );
1161 while ( my $line = $sth->fetchrow_hashref ) {
1162 $line->{count} = $cnt++;
1163 $line->{toggle} = 1 if $cnt % 2;
1164 push @order_loop, $line;
1165 $line->{creationdate} = format_date( $line->{creationdate} );
1166 $line->{datereceived} = format_date( $line->{datereceived} );
1167 $total_qty += $line->{'quantity'};
1168 $total_qtyreceived += $line->{'quantityreceived'};
1169 $total_price += $line->{'quantity'} * $line->{'ecost'};
1172 return \@order_loop, $total_qty, $total_price, $total_qtyreceived;
1175 =head2 GetRecentAcqui
1177 $results = GetRecentAcqui($days);
1179 C<$results> is a ref to a table which containts hashref
1183 sub GetRecentAcqui {
1185 my $dbh = C4::Context->dbh;
1189 ORDER BY timestamp DESC
1192 my $sth = $dbh->prepare($query);
1195 while(my $data = $sth->fetchrow_hashref){
1196 push @results,$data;
1206 Koha Developement team <info@koha.org>