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
26 use vars qw($VERSION @ISA @EXPORT);
28 # set the version for version checking
33 C4::Acquisition - Koha functions for dealing with orders and acquisitions
41 The functions in this module deal with acquisitions, managing book
42 orders, converting money to different currencies, and so forth.
52 &getbasket &getbasketcontent &newbasket &closebasket
54 &getorders &getallorders &getrecorders
55 &getorder &neworder &delorder
56 &ordersearch &histsearch
57 &modorder &getsingleorder &invoice &receiveorder
58 &updaterecorder &newordernum
60 &bookfunds &curconvert &getcurrencies &bookfundbreakdown
61 &updatecurrencies &getcurrency
63 &branches &updatesup &insertsup
64 &bookseller &breakdown
76 $aqbasket = &getbasket($basketnumber);
78 get all basket informations in aqbasket for a given basket
83 my $dbh=C4::Context->dbh;
84 my $sth=$dbh->prepare("select aqbasket.*,borrowers.firstname+' '+borrowers.surname as authorisedbyname, borrowers.branchcode as branch from aqbasket left join borrowers on aqbasket.authorisedby=borrowers.borrowernumber where basketno=?");
85 $sth->execute($basketno);
86 return($sth->fetchrow_hashref);
89 =item getbasketcontent
91 ($count, @orders) = &getbasketcontent($basketnumber, $booksellerID);
93 Looks up the pending (non-cancelled) orders with the given basket
94 number. If C<$booksellerID> is non-empty, only orders from that seller
97 C<&basket> returns a two-element array. C<@orders> is an array of
98 references-to-hash, whose keys are the fields from the aqorders,
99 biblio, and biblioitems tables in the Koha database. C<$count> is the
100 number of elements in C<@orders>.
104 sub getbasketcontent {
105 my ($basketno,$supplier,$orderby)=@_;
106 my $dbh = C4::Context->dbh;
107 my $query="Select biblio.*,biblioitems.*,aqorders.*,aqorderbreakdown.*,biblio.title from aqorders,biblio,biblioitems
108 left join aqorderbreakdown on aqorderbreakdown.ordernumber=aqorders.ordernumber
109 where basketno='$basketno'
110 and biblio.biblionumber=aqorders.biblionumber and biblioitems.biblioitemnumber
111 =aqorders.biblioitemnumber
112 and (datecancellationprinted is NULL or datecancellationprinted =
114 if ($supplier ne ''){
115 $query.=" and aqorders.booksellerid='$supplier'";
118 $orderby="biblioitems.publishercode" unless $orderby;
119 $query.=" order by $orderby";
120 my $sth=$dbh->prepare($query);
125 while (my $data=$sth->fetchrow_hashref){
135 $basket = &newbasket();
137 Create a new basket in aqbasket table
141 my ($booksellerid,$authorisedby) = @_;
142 my $dbh = C4::Context->dbh;
143 my $sth=$dbh->do("insert into aqbasket (creationdate,booksellerid,authorisedby) values(now(),'$booksellerid','$authorisedby')");
144 #find & return basketno MYSQL dependant, but $dbh->last_insert_id always returns null :-(
145 my $basket = $dbh->{'mysql_insertid'};
151 &newbasket($basketno);
153 close a basket (becomes unmodifiable,except for recieves
158 my $dbh = C4::Context->dbh;
159 my $sth=$dbh->prepare("update aqbasket set closedate=now() where basketno=?");
160 $sth->execute($basketno);
165 &neworder($basket, $biblionumber, $title, $quantity, $listprice,
166 $booksellerid, $who, $notes, $bookfund, $biblioitemnumber, $rrp,
167 $ecost, $gst, $budget, $unitprice, $subscription,
168 $booksellerinvoicenumber);
170 Adds a new order to the database. Any argument that isn't described
171 below is the new value of the field with the same name in the aqorders
172 table of the Koha database.
174 C<$ordnum> is a "minimum order number." After adding the new entry to
175 the aqorders table, C<&neworder> finds the first entry in aqorders
176 with order number greater than or equal to C<$ordnum>, and adds an
177 entry to the aqorderbreakdown table, with the order number just found,
178 and the book fund ID of the newly-added order.
180 C<$budget> is effectively ignored.
182 C<$subscription> may be either "yes", or anything else for "no".
187 my ($basketno,$bibnum,$title,$quantity,$listprice,$booksellerid,$authorisedby,$notes,$bookfund,$bibitemnum,$rrp,$ecost,$gst,$budget,$cost,$sub,$invoice,$sort1,$sort2)=@_;
188 if ($budget eq 'now'){
191 $budget="'2001-07-01'";
198 # if $basket empty, it's also a new basket, create it
200 $basketno=newbasket($booksellerid,$authorisedby);
202 my $dbh = C4::Context->dbh;
203 my $sth=$dbh->prepare("insert into aqorders
204 (biblionumber,title,basketno,quantity,listprice,notes,
205 biblioitemnumber,rrp,ecost,gst,unitprice,subscription,sort1,sort2)
206 values (?,?,?,?,?,?,?,?,?,?,?,?,?,?)");
207 $sth->execute($bibnum,$title,$basketno,$quantity,$listprice,$notes,
208 $bibitemnum,$rrp,$ecost,$gst,$cost,$sub,$sort1,$sort2);
210 #get ordnum MYSQL dependant, but $dbh->last_insert_id returns null
211 my $ordnum = $dbh->{'mysql_insertid'};
212 $sth=$dbh->prepare("insert into aqorderbreakdown (ordernumber,bookfundid) values
214 $sth->execute($ordnum,$bookfund);
221 &delorder($biblionumber, $ordernumber);
223 Cancel the order with the given order and biblio numbers. It does not
224 delete any entries in the aqorders table, it merely marks them as
230 my ($bibnum,$ordnum)=@_;
231 my $dbh = C4::Context->dbh;
232 my $sth=$dbh->prepare("update aqorders set datecancellationprinted=now()
233 where biblionumber=? and ordernumber=?");
234 $sth->execute($bibnum,$ordnum);
240 &modorder($title, $ordernumber, $quantity, $listprice,
241 $biblionumber, $basketno, $supplier, $who, $notes,
242 $bookfundid, $bibitemnum, $rrp, $ecost, $gst, $budget,
243 $unitprice, $booksellerinvoicenumber);
245 Modifies an existing order. Updates the order with order number
246 C<$ordernumber> and biblionumber C<$biblionumber>. All other arguments
247 update the fields with the same name in the aqorders table of the Koha
250 Entries with order number C<$ordernumber> in the aqorderbreakdown
251 table are also updated to the new book fund ID.
256 my ($title,$ordnum,$quantity,$listprice,$bibnum,$basketno,$supplier,$who,$notes,$bookfund,$bibitemnum,$rrp,$ecost,$gst,$budget,$cost,$invoice,$sort1,$sort2)=@_;
257 my $dbh = C4::Context->dbh;
258 my $sth=$dbh->prepare("update aqorders set title=?,
259 quantity=?,listprice=?,basketno=?,
260 rrp=?,ecost=?,unitprice=?,booksellerinvoicenumber=?,
261 notes=?,sort1=?, sort2=?
263 ordernumber=? and biblionumber=?");
264 $sth->execute($title,$quantity,$listprice,$basketno,$rrp,$ecost,$cost,$invoice,$notes,$sort1,$sort2,$ordnum,$bibnum);
266 $sth=$dbh->prepare("update aqorderbreakdown set bookfundid=? where
268 unless ($sth->execute($bookfund,$ordnum)) { # zero rows affected [Bug 734]
269 my $query="insert into aqorderbreakdown (ordernumber,bookfundid) values (?,?)";
270 $sth=$dbh->prepare($query);
271 $sth->execute($ordnum,$bookfund);
278 $order = &newordernum();
280 Finds the next unused order number in the aqorders table of the Koha
281 database, and returns it.
285 # FIXME - Race condition
287 my $dbh = C4::Context->dbh;
288 my $sth=$dbh->prepare("Select max(ordernumber) from aqorders");
290 my $data=$sth->fetchrow_arrayref;
291 my $ordnum=$$data[0];
299 &receiveorder($biblionumber, $ordernumber, $quantityreceived, $user,
300 $unitprice, $booksellerinvoicenumber, $biblioitemnumber,
301 $freight, $bookfund, $rrp);
303 Updates an order, to reflect the fact that it was received, at least
304 in part. All arguments not mentioned below update the fields with the
305 same name in the aqorders table of the Koha database.
307 Updates the order with bibilionumber C<$biblionumber> and ordernumber
310 Also updates the book fund ID in the aqorderbreakdown table.
315 my ($biblio,$ordnum,$quantrec,$user,$cost,$invoiceno,$freight,$rrp)=@_;
316 my $dbh = C4::Context->dbh;
317 my $sth=$dbh->prepare("update aqorders set quantityreceived=?,datereceived=now(),booksellerinvoicenumber=?,
318 unitprice=?,freight=?,rrp=?
319 where biblionumber=? and ordernumber=?");
320 $sth->execute($quantrec,$invoiceno,$cost,$freight,$rrp,$biblio,$ordnum);
326 &updaterecorder($biblionumber, $ordernumber, $user, $unitprice,
329 Updates the order with biblionumber C<$biblionumber> and order number
330 C<$ordernumber>. C<$bookfundid> is the new value for the book fund ID
331 in the aqorderbreakdown table of the Koha database. All other
332 arguments update the fields with the same name in the aqorders table.
339 my($biblio,$ordnum,$user,$cost,$bookfund,$rrp)=@_;
340 my $dbh = C4::Context->dbh;
341 my $sth=$dbh->prepare("update aqorders set
343 where biblionumber=? and ordernumber=?
345 $sth->execute($cost,$rrp,$biblio,$ordnum);
347 $sth=$dbh->prepare("update aqorderbreakdown set bookfundid=? where ordernumber=?");
348 $sth->execute($bookfund,$ordnum);
360 ($count, $orders) = &getorders($booksellerid);
362 Finds pending orders from the bookseller with the given ID. Ignores
363 completed and cancelled orders.
365 C<$count> is the number of elements in C<@{$orders}>.
367 C<$orders> is a reference-to-array; each element is a
368 reference-to-hash with the following fields:
374 Gives the number of orders in with this basket number.
376 =item C<authorizedby>
382 These give the value of the corresponding field in the aqorders table
383 of the Koha database.
387 Results are ordered from most to least recent.
393 my $dbh = C4::Context->dbh;
395 my $strsth ="Select count(*),authorisedby,creationdate,aqbasket.basketno,
396 closedate,surname,firstname
398 left join aqbasket on aqbasket.basketno=aqorders.basketno
399 left join borrowers on aqbasket.authorisedby=borrowers.borrowernumber
400 where booksellerid=? and (quantity > quantityreceived or
401 quantityreceived is NULL) and datecancellationprinted is NULL ";
403 if (C4::Context->preference("IndependantBranches")) {
404 my $userenv = C4::Context->userenv;
405 unless ($userenv->{flags} == 1){
406 $strsth .= " and (borrowers.branchcode = '".$userenv->{branch}."' or borrowers.branchcode ='')";
409 $strsth.=" group by basketno order by aqbasket.basketno";
410 warn "getorders :".$strsth;
411 my $sth=$dbh->prepare($strsth);
412 $sth->execute($supplierid);
414 while (my $data=$sth->fetchrow_hashref){
415 push(@results,$data);
418 return (scalar(@results),\@results);
423 ($order, $ordernumber) = &getorder($biblioitemnumber, $biblionumber);
425 Looks up the order with the given biblionumber and biblioitemnumber.
427 Returns a two-element array. C<$ordernumber> is the order number.
428 C<$order> is a reference-to-hash describing the order; its keys are
429 fields from the biblio, biblioitems, aqorders, and aqorderbreakdown
430 tables of the Koha database.
436 my $dbh = C4::Context->dbh;
437 my $sth=$dbh->prepare("Select ordernumber from aqorders where biblionumber=? and biblioitemnumber=?");
438 $sth->execute($bib,$bi);
439 # FIXME - Use fetchrow_array(), since we're only interested in the one
441 my $ordnum=$sth->fetchrow_hashref;
443 my $order=getsingleorder($ordnum->{'ordernumber'});
444 return ($order,$ordnum->{'ordernumber'});
449 $order = &getsingleorder($ordernumber);
451 Looks up an order by order number.
453 Returns a reference-to-hash describing the order. The keys of
454 C<$order> are fields from the biblio, biblioitems, aqorders, and
455 aqorderbreakdown tables of the Koha database.
461 my $dbh = C4::Context->dbh;
462 my $sth=$dbh->prepare("Select * from biblio,biblioitems,aqorders left join aqorderbreakdown
463 on aqorders.ordernumber=aqorderbreakdown.ordernumber
464 where aqorders.ordernumber=?
465 and biblio.biblionumber=aqorders.biblionumber and
466 biblioitems.biblioitemnumber=aqorders.biblioitemnumber");
467 $sth->execute($ordnum);
468 my $data=$sth->fetchrow_hashref;
475 ($count, @results) = &getallorders($booksellerid);
477 Looks up all of the pending orders from the supplier with the given
478 bookseller ID. Ignores cancelled and completed orders.
480 C<$count> is the number of elements in C<@results>. C<@results> is an
481 array of references-to-hash. The keys of each element are fields from
482 the aqorders, biblio, and biblioitems tables of the Koha database.
484 C<@results> is sorted alphabetically by book title.
489 #gets all orders from a certain supplier, orders them alphabetically
491 my $dbh = C4::Context->dbh;
493 my $strsth="Select * from aqorders,biblio,biblioitems,aqbasket ";
494 $strsth .= ",borrowers " if (C4::Context->preference("IndependantBranches"));
495 $strsth .=" where aqorders.basketno=aqbasket.basketno and aqbasket.booksellerid=aqbooksellers.id and biblio.biblionumber=aqorders.biblionumber ";
496 $strsth .= " and aqbasket.authorisedby=borrowers.borrowernumber" if (C4::Context->preference("IndependantBranches"));
497 $strsth.=" and booksellerid=? and (cancelledby is NULL or cancelledby = '')
498 and (quantityreceived < quantity or quantityreceived is NULL)
499 and biblio.biblionumber=aqorders.biblionumber and biblioitems.biblioitemnumber=
500 aqorders.biblioitemnumber";
501 if (C4::Context->preference("IndependantBranches")) {
502 my $userenv = C4::Context->userenv;
503 unless ($userenv->{flags} == 1){
504 $strsth .= " and (borrowers.branchcode = '".$userenv->{branch}."' or borrowers.branchcode ='')";
507 $strsth .= "group by aqorders.biblioitemnumber
510 my $sth=$dbh->prepare($strsth);
511 $sth->execute($supid);
512 while (my $data=$sth->fetchrow_hashref){
513 push(@results,$data);
516 return(scalar(@results),@results);
521 #gets all orders from a certain supplier, orders them alphabetically
523 my $dbh = C4::Context->dbh;
525 my $sth=$dbh->prepare("Select * from aqorders,biblio,biblioitems where booksellerid=?
526 and (cancelledby is NULL or cancelledby = '')
527 and biblio.biblionumber=aqorders.biblionumber and biblioitems.biblioitemnumber=
528 aqorders.biblioitemnumber and
529 aqorders.quantityreceived>0
530 and aqorders.datereceived >=now()
531 group by aqorders.biblioitemnumber
534 $sth->execute($supid);
535 while (my $data=$sth->fetchrow_hashref){
536 push(@results,$data);
539 return(scalar(@results),@results);
544 ($count, @results) = &ordersearch($search, $biblionumber, $complete);
548 C<$search> may take one of several forms: if it is an ISBN,
549 C<&ordersearch> returns orders with that ISBN. If C<$search> is an
550 order number, C<&ordersearch> returns orders with that order number
551 and biblionumber C<$biblionumber>. Otherwise, C<$search> is considered
552 to be a space-separated list of search terms; in this case, all of the
553 terms must appear in the title (matching the beginning of title
556 If C<$complete> is C<yes>, the results will include only completed
557 orders. In any case, C<&ordersearch> ignores cancelled orders.
559 C<&ordersearch> returns an array. C<$count> is the number of elements
560 in C<@results>. C<@results> is an array of references-to-hash with the
578 my ($search,$id,$biblio,$catview) = @_;
579 my $dbh = C4::Context->dbh;
580 my @data = split(' ',$search);
581 my @searchterms = ($id);
582 map { push(@searchterms,"$_%","% $_%") } @data;
583 push(@searchterms,$search,$search,$biblio);
584 my $sth=$dbh->prepare("Select biblio.*,biblioitems.*,aqorders.*,aqbasket.*,biblio.title from aqorders,biblioitems,biblio,aqbasket
585 where aqorders.biblioitemnumber = biblioitems.biblioitemnumber and
586 aqorders.basketno = aqbasket.basketno
587 and aqbasket.booksellerid = ?
588 and biblio.biblionumber=aqorders.biblionumber
589 and ((datecancellationprinted is NULL)
590 or (datecancellationprinted = '0000-00-00'))
592 .(join(" and ",map { "(biblio.title like ? or biblio.title like ?)" } @data))
593 .") or biblioitems.isbn=? or (aqorders.ordernumber=? and aqorders.biblionumber=?)) "
594 .(($catview ne 'yes')?" and (quantityreceived < quantity or quantityreceived is NULL)":"")
595 ." group by aqorders.ordernumber");
596 $sth->execute(@searchterms);
598 my $sth2=$dbh->prepare("Select * from biblio where biblionumber=?");
599 my $sth3=$dbh->prepare("Select * from aqorderbreakdown where ordernumber=?");
600 while (my $data=$sth->fetchrow_hashref){
601 $sth2->execute($data->{'biblionumber'});
602 my $data2=$sth2->fetchrow_hashref;
603 $data->{'author'}=$data2->{'author'};
604 $data->{'seriestitle'}=$data2->{'seriestitle'};
605 $sth3->execute($data->{'ordernumber'});
606 my $data3=$sth3->fetchrow_hashref;
607 $data->{'branchcode'}=$data3->{'branchcode'};
608 $data->{'bookfundid'}=$data3->{'bookfundid'};
609 push(@results,$data);
614 return(scalar(@results),@results);
619 my ($title,$author,$name,$from_placed_on,$to_placed_on)=@_;
620 my $dbh= C4::Context->dbh;
621 my $query = "select biblio.title,aqorders.basketno,name,aqbasket.creationdate,aqorders.datereceived, aqorders.quantity, aqorders.ecost from aqorders,aqbasket,aqbooksellers,biblio";
623 $query .= ",borrowers " if (C4::Context->preference("IndependantBranches"));
624 $query .=" where aqorders.basketno=aqbasket.basketno and aqbasket.booksellerid=aqbooksellers.id and biblio.biblionumber=aqorders.biblionumber ";
625 $query .= " and aqbasket.authorisedby=borrowers.borrowernumber" if (C4::Context->preference("IndependantBranches"));
626 $query .= " and biblio.title like ".$dbh->quote("%".$title."%") if $title;
627 $query .= " and biblio.author like ".$dbh->quote("%".$author."%") if $author;
628 $query .= " and name like ".$dbh->quote("%".$name."%") if $name;
629 $query .= " and creationdate >" .$dbh->quote($from_placed_on) if $from_placed_on;
630 $query .= " and creationdate<".$dbh->quote($to_placed_on) if $to_placed_on;
631 if (C4::Context->preference("IndependantBranches")) {
632 my $userenv = C4::Context->userenv;
633 unless ($userenv->{flags} == 1){
634 $query .= " and (borrowers.branchcode = '".$userenv->{branch}."' or borrowers.branchcode ='')";
637 # warn "C4:Acquisition : ".$query;
638 my $sth = $dbh->prepare($query);
641 while (my $line = $sth->fetchrow_hashref) {
642 push @order_loop, $line;
654 ($count, @results) = &invoice($booksellerinvoicenumber);
656 Looks up orders by invoice number.
658 Returns an array. C<$count> is the number of elements in C<@results>.
659 C<@results> is an array of references-to-hash; the keys of each
660 elements are fields from the aqorders, biblio, and biblioitems tables
661 of the Koha database.
667 my $dbh = C4::Context->dbh;
669 my $sth=$dbh->prepare("Select * from aqorders,biblio,biblioitems where
670 booksellerinvoicenumber=?
671 and biblio.biblionumber=aqorders.biblionumber and biblioitems.biblioitemnumber=
672 aqorders.biblioitemnumber group by aqorders.ordernumber,aqorders.biblioitemnumber");
673 $sth->execute($invoice);
674 while (my $data=$sth->fetchrow_hashref){
675 push(@results,$data);
678 return(scalar(@results),@results);
683 ($count, @results) = &bookfunds();
685 Returns a list of all book funds.
687 C<$count> is the number of elements in C<@results>. C<@results> is an
688 array of references-to-hash, whose keys are fields from the aqbookfund
689 and aqbudget tables of the Koha database. Results are ordered
690 alphabetically by book fund name.
696 my $dbh = C4::Context->dbh;
700 $strsth="Select * from aqbookfund,aqbudget where aqbookfund.bookfundid
702 group by aqbookfund.bookfundid order by bookfundname";
704 $strsth="Select * from aqbookfund,aqbudget where aqbookfund.bookfundid
705 =aqbudget.bookfundid and (aqbookfund.branchcode is null or aqbookfund.branchcode='' or aqbookfund.branchcode= ? )
706 group by aqbookfund.bookfundid order by bookfundname";
708 my $sth=$dbh->prepare($strsth);
710 $sth->execute($branch);
715 while (my $data=$sth->fetchrow_hashref){
716 push(@results,$data);
719 return(scalar(@results),@results);
722 =item bookfundbreakdown
724 returns the total comtd & spent for a given bookfund
725 used in acqui-home.pl
729 sub bookfundbreakdown {
731 my $dbh = C4::Context->dbh;
732 my $sth=$dbh->prepare("Select quantity,datereceived,freight,unitprice,listprice,ecost,quantityreceived,subscription
733 from aqorders,aqorderbreakdown where bookfundid=? and
734 aqorders.ordernumber=aqorderbreakdown.ordernumber
735 and (datecancellationprinted is NULL or
736 datecancellationprinted='0000-00-00')");
740 while (my $data=$sth->fetchrow_hashref){
741 if ($data->{'subscription'} == 1){
742 $spent+=$data->{'quantity'}*$data->{'unitprice'};
744 my $leftover=$data->{'quantity'}-$data->{'quantityreceived'};
745 $comtd+=($data->{'ecost'})*$leftover;
746 $spent+=($data->{'unitprice'})*$data->{'quantityreceived'};
750 return($spent,$comtd);
757 $foreignprice = &curconvert($currency, $localprice);
759 Converts the price C<$localprice> to foreign currency C<$currency> by
760 dividing by the exchange rate, and returns the result.
762 If no exchange rate is found, C<&curconvert> assumes the rate is one
768 my ($currency,$price)=@_;
769 my $dbh = C4::Context->dbh;
770 my $sth=$dbh->prepare("Select rate from currency where currency=?");
771 $sth->execute($currency);
772 my $cur=($sth->fetchrow_array())[0];
777 return($price / $cur);
782 ($count, $currencies) = &getcurrencies();
784 Returns the list of all known currencies.
786 C<$count> is the number of elements in C<$currencies>. C<$currencies>
787 is a reference-to-array; its elements are references-to-hash, whose
788 keys are the fields from the currency table in the Koha database.
793 my $dbh = C4::Context->dbh;
794 my $sth=$dbh->prepare("Select * from currency");
797 while (my $data=$sth->fetchrow_hashref){
798 push(@results,$data);
801 return(scalar(@results),\@results);
804 =item updatecurrencies
806 &updatecurrencies($currency, $newrate);
808 Sets the exchange rate for C<$currency> to be C<$newrate>.
812 sub updatecurrencies {
813 my ($currency,$rate)=@_;
814 my $dbh = C4::Context->dbh;
815 my $sth=$dbh->prepare("update currency set rate=? where currency=?");
816 $sth->execute($rate,$currency);
828 ($count, @results) = &bookseller($searchstring);
830 Looks up a book seller. C<$searchstring> may be either a book seller
831 ID, or a string to look for in the book seller's name.
833 C<$count> is the number of elements in C<@results>. C<@results> is an
834 array of references-to-hash, whose keys are the fields of of the
835 aqbooksellers table in the Koha database.
840 my ($searchstring)=@_;
841 my $dbh = C4::Context->dbh;
842 my $sth=$dbh->prepare("Select * from aqbooksellers where name like ? or id = ?");
843 $sth->execute("$searchstring%",$searchstring);
845 while (my $data=$sth->fetchrow_hashref){
846 push(@results,$data);
849 return(scalar(@results),@results);
854 ($count, $results) = &breakdown($ordernumber);
856 Looks up an order by order ID, and returns its breakdown.
858 C<$count> is the number of elements in C<$results>. C<$results> is a
859 reference-to-array; its elements are references-to-hash, whose keys
860 are the fields of the aqorderbreakdown table in the Koha database.
866 my $dbh = C4::Context->dbh;
867 my $sth=$dbh->prepare("Select * from aqorderbreakdown where ordernumber=?");
870 while (my $data=$sth->fetchrow_hashref){
871 push(@results,$data);
874 return(scalar(@results),\@results);
879 ($count, @results) = &branches();
881 Returns a list of all library branches.
883 C<$count> is the number of elements in C<@results>. C<@results> is an
884 array of references-to-hash, whose keys are the fields of the branches
885 table of the Koha database.
890 my $dbh = C4::Context->dbh;
891 my $sth = $dbh->prepare("Select * from branches order by branchname");
895 while (my $data = $sth->fetchrow_hashref) {
896 push(@results,$data);
900 return(scalar(@results), @results);
905 &updatesup($bookseller);
907 Updates the information for a given bookseller. C<$bookseller> is a
908 reference-to-hash whose keys are the fields of the aqbooksellers table
909 in the Koha database. It must contain entries for all of the fields.
910 The entry to modify is determined by C<$bookseller-E<gt>{id}>.
912 The easiest way to get all of the necessary fields is to look up a
913 book seller with C<&booksellers>, modify what's necessary, then call
914 C<&updatesup> with the result.
920 my $dbh = C4::Context->dbh;
921 my $sth=$dbh->prepare("Update aqbooksellers set
922 name=?,address1=?,address2=?,address3=?,address4=?,postal=?,
923 phone=?,fax=?,url=?,contact=?,contpos=?,contphone=?,contfax=?,contaltphone=?,
924 contemail=?,contnotes=?,active=?,
925 listprice=?, invoiceprice=?,gstreg=?, listincgst=?,
926 invoiceincgst=?, specialty=?,discount=?,invoicedisc=?,
929 $sth->execute($data->{'name'},$data->{'address1'},$data->{'address2'},
930 $data->{'address3'},$data->{'address4'},$data->{'postal'},$data->{'phone'},
931 $data->{'fax'},$data->{'url'},$data->{'contact'},$data->{'contpos'},
932 $data->{'contphone'},$data->{'contfax'},$data->{'contaltphone'},
933 $data->{'contemail'},
934 $data->{'contnote'},$data->{'active'},$data->{'listprice'},
935 $data->{'invoiceprice'},$data->{'gstreg'},$data->{'listincgst'},
936 $data->{'invoiceincgst'},$data->{'specialty'},$data->{'discount'},
937 $data->{'invoicedisc'},$data->{'nocalc'},$data->{'id'});
943 $id = &insertsup($bookseller);
945 Creates a new bookseller. C<$bookseller> is a reference-to-hash whose
946 keys are the fields of the aqbooksellers table in the Koha database.
947 All fields must be present.
949 Returns the ID of the newly-created bookseller.
955 my $dbh = C4::Context->dbh;
956 my $sth=$dbh->prepare("Select max(id) from aqbooksellers");
958 my $data2=$sth->fetchrow_hashref;
960 $data2->{'max(id)'}++;
961 $sth=$dbh->prepare("Insert into aqbooksellers (id) values (?)");
962 $sth->execute($data2->{'max(id)'});
964 $data->{'id'}=$data2->{'max(id)'};
966 return($data->{'id'});
969 END { } # module clean-up code here (global destructor)
978 Koha Developement team <info@koha.org>