a4c279ac4e
*Bookseller.pm* : contains all functions dealing with bookseller. *Bookfund.pm* : contains all functions dealing with bookfund, currency & budget. *Acquisition.pm* contains all functions dealing with orders, basket & parcels.
1153 lines
34 KiB
Perl
1153 lines
34 KiB
Perl
package C4::Acquisition;
|
|
|
|
# Copyright 2000-2002 Katipo Communications
|
|
#
|
|
# This file is part of Koha.
|
|
#
|
|
# Koha is free software; you can redistribute it and/or modify it under the
|
|
# terms of the GNU General Public License as published by the Free Software
|
|
# Foundation; either version 2 of the License, or (at your option) any later
|
|
# version.
|
|
#
|
|
# Koha is distributed in the hope that it will be useful, but WITHOUT ANY
|
|
# WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
|
|
# A PARTICULAR PURPOSE. See the GNU General Public License for more details.
|
|
#
|
|
# You should have received a copy of the GNU General Public License along with
|
|
# Koha; if not, write to the Free Software Foundation, Inc., 59 Temple Place,
|
|
# Suite 330, Boston, MA 02111-1307 USA
|
|
|
|
# $Id$
|
|
|
|
use strict;
|
|
require Exporter;
|
|
use C4::Context;
|
|
use C4::Date;
|
|
use MARC::Record;
|
|
use C4::Suggestions;
|
|
use Time::localtime;
|
|
|
|
use vars qw($VERSION @ISA @EXPORT);
|
|
|
|
# set the version for version checking
|
|
$VERSION = do { my @v = '$Revision$' =~ /\d+/g; shift(@v) . "." . join( "_", map { sprintf "%03d", $_ } @v ); };
|
|
|
|
# used in receiveorder subroutine
|
|
# to provide library specific handling
|
|
my $library_name = C4::Context->preference("LibraryName");
|
|
|
|
=head1 NAME
|
|
|
|
C4::Acquisition - Koha functions for dealing with orders and acquisitions
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
use C4::Acquisition;
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
The functions in this module deal with acquisitions, managing book
|
|
orders, basket and parcels.
|
|
|
|
=head1 FUNCTIONS
|
|
|
|
=over 2
|
|
|
|
=cut
|
|
|
|
@ISA = qw(Exporter);
|
|
@EXPORT = qw(
|
|
&GetBasket &GetBasketContent &NewBasket &CloseBasket
|
|
&GetPendingOrders &GetAllOrders
|
|
&GetOrder &GetLateOrders &NewOrder &DelOrder
|
|
&SearchOrder &GetHistory
|
|
&ModOrder &GetSingleOrder &ModReceiveOrder
|
|
&GetParcels &GetParcel
|
|
);
|
|
|
|
=head2 FUNCTIONS ABOUT BASKETS
|
|
|
|
=over 2
|
|
|
|
=cut
|
|
|
|
#------------------------------------------------------------#
|
|
|
|
=head3 GetBasket
|
|
|
|
=over 4
|
|
|
|
$aqbasket = &GetBasket($basketnumber);
|
|
|
|
get all basket informations in aqbasket for a given basket
|
|
|
|
return :
|
|
informations for a given basket returned as a hashref.
|
|
|
|
=back
|
|
|
|
=back
|
|
|
|
=cut
|
|
|
|
sub GetBasket {
|
|
my ($basketno) = @_;
|
|
my $dbh = C4::Context->dbh;
|
|
my $query = "
|
|
SELECT aqbasket.*,
|
|
borrowers.firstname+' '+borrowers.surname AS authorisedbyname,
|
|
borrowers.branchcode AS branch
|
|
FROM aqbasket
|
|
LEFT JOIN borrowers ON aqbasket.authorisedby=borrowers.borrowernumber
|
|
WHERE basketno=?
|
|
";
|
|
my $sth=$dbh->prepare($query);
|
|
$sth->execute($basketno);
|
|
return ( $sth->fetchrow_hashref );
|
|
}
|
|
|
|
#------------------------------------------------------------#
|
|
|
|
=head3 GetBasketContent
|
|
|
|
=over 4
|
|
|
|
@orders = &GetBasketContent($basketnumber, $orderby);
|
|
|
|
Looks up the pending (non-cancelled) orders with the given basket
|
|
number. If C<$booksellerID> is non-empty, only orders from that seller
|
|
are returned.
|
|
|
|
return :
|
|
C<&basket> returns a two-element array. C<@orders> is an array of
|
|
references-to-hash, whose keys are the fields from the aqorders,
|
|
biblio, and biblioitems tables in the Koha database.
|
|
|
|
=back
|
|
|
|
=cut
|
|
|
|
sub GetBasketContent {
|
|
my ( $basketno, $orderby ) = @_;
|
|
my $dbh = C4::Context->dbh;
|
|
my $query ="
|
|
SELECT aqorderbreakdown.*,
|
|
biblio.*,biblioitems.*,
|
|
aqorders.*,
|
|
biblio.title
|
|
FROM aqorders,biblio,biblioitems
|
|
LEFT JOIN aqorderbreakdown ON
|
|
aqorders.ordernumber=aqorderbreakdown.ordernumber
|
|
WHERE basketno=?
|
|
AND biblio.biblionumber=aqorders.biblionumber
|
|
AND biblioitems.biblioitemnumber=aqorders.biblioitemnumber
|
|
AND (datecancellationprinted IS NULL OR datecancellationprinted='0000-00-00')
|
|
";
|
|
|
|
$orderby = "biblioitems.publishercode" unless $orderby;
|
|
$query .= " ORDER BY $orderby";
|
|
my $sth = $dbh->prepare($query);
|
|
$sth->execute($basketno);
|
|
my @results;
|
|
|
|
my $i=0;
|
|
# print $query;
|
|
while ( my $data = $sth->fetchrow_hashref ) {
|
|
$results[$i++] = $data;
|
|
}
|
|
$sth->finish;
|
|
return @results;
|
|
}
|
|
|
|
#------------------------------------------------------------#
|
|
|
|
=head3 NewBasket
|
|
|
|
=over 4
|
|
|
|
$basket = &NewBasket();
|
|
|
|
Create a new basket in aqbasket table
|
|
|
|
=back
|
|
|
|
=cut
|
|
|
|
# FIXME : this function seems to be unused.
|
|
|
|
sub NewBasket {
|
|
my ( $booksellerid, $authorisedby ) = @_;
|
|
my $dbh = C4::Context->dbh;
|
|
my $query = "
|
|
INSERT INTO aqbasket
|
|
(creationdate,booksellerid,authorisedby)
|
|
VALUES (now(),'$booksellerid','$authorisedby')
|
|
";
|
|
my $sth =
|
|
$dbh->do($query);
|
|
|
|
#find & return basketno MYSQL dependant, but $dbh->last_insert_id always returns null :-(
|
|
my $basket = $dbh->{'mysql_insertid'};
|
|
return $basket;
|
|
}
|
|
|
|
#------------------------------------------------------------#
|
|
|
|
=head3 CloseBasket
|
|
|
|
=over 4
|
|
|
|
&CloseBasket($basketno);
|
|
|
|
close a basket (becomes unmodifiable,except for recieves)
|
|
|
|
=back
|
|
|
|
=cut
|
|
|
|
sub CloseBasket {
|
|
my ($basketno) = @_;
|
|
my $dbh = C4::Context->dbh;
|
|
my $query = "
|
|
UPDATE aqbasket
|
|
SET closedate=now()
|
|
WHERE basketno=?
|
|
";
|
|
my $sth = $dbh->prepare($query);
|
|
$sth->execute($basketno);
|
|
}
|
|
|
|
#------------------------------------------------------------#
|
|
|
|
=back
|
|
|
|
=head2 FUNCTIONS ABOUT ORDERS
|
|
|
|
=over 2
|
|
|
|
=cut
|
|
|
|
#------------------------------------------------------------#
|
|
|
|
=head3 GetPendingOrders
|
|
|
|
=over 4
|
|
|
|
$orders = &GetPendingOrders($booksellerid);
|
|
|
|
Finds pending orders from the bookseller with the given ID. Ignores
|
|
completed and cancelled orders.
|
|
|
|
C<$orders> is a reference-to-array; each element is a
|
|
reference-to-hash with the following fields:
|
|
|
|
=over 2
|
|
|
|
=item C<authorizedby>
|
|
|
|
=item C<entrydate>
|
|
|
|
=item C<basketno>
|
|
|
|
These give the value of the corresponding field in the aqorders table
|
|
of the Koha database.
|
|
|
|
=back
|
|
|
|
=back
|
|
|
|
Results are ordered from most to least recent.
|
|
|
|
=cut
|
|
|
|
sub GetPendingOrders {
|
|
my $supplierid = @_;
|
|
my $dbh = C4::Context->dbh;
|
|
my $strsth = "
|
|
SELECT count(*),authorisedby,creationdate,aqbasket.basketno,
|
|
closedate,surname,firstname,aqorders.title
|
|
FROM aqorders
|
|
LEFT JOIN aqbasket ON aqbasket.basketno=aqorders.basketno
|
|
LEFT JOIN borrowers ON aqbasket.authorisedby=borrowers.borrowernumber
|
|
WHERE booksellerid=?
|
|
AND (quantity > quantityreceived OR quantityreceived is NULL)
|
|
AND datecancellationprinted IS NULL
|
|
AND (to_days(now())-to_days(closedate) < 180 OR closedate IS NULL)
|
|
";
|
|
if ( C4::Context->preference("IndependantBranches") ) {
|
|
my $userenv = C4::Context->userenv;
|
|
if ( ($userenv) && ( $userenv->{flags} != 1 ) ) {
|
|
$strsth .=
|
|
" and (borrowers.branchcode = '"
|
|
. $userenv->{branch}
|
|
. "' or borrowers.branchcode ='')";
|
|
}
|
|
}
|
|
$strsth .= " group by basketno order by aqbasket.basketno";
|
|
my $sth = $dbh->prepare($strsth);
|
|
$sth->execute($supplierid);
|
|
my @results = ();
|
|
while ( my $data = $sth->fetchrow_hashref ) {
|
|
push( @results, $data );
|
|
}
|
|
$sth->finish;
|
|
return \@results;
|
|
}
|
|
|
|
#------------------------------------------------------------#
|
|
|
|
=head3 GetOrder
|
|
|
|
=over 4
|
|
|
|
($order, $ordernumber) = &GetOrder($biblioitemnumber, $biblionumber);
|
|
|
|
Looks up the order with the given biblionumber and biblioitemnumber.
|
|
|
|
Returns a two-element array. C<$ordernumber> is the order number.
|
|
C<$order> is a reference-to-hash describing the order; its keys are
|
|
fields from the biblio, biblioitems, aqorders, and aqorderbreakdown
|
|
tables of the Koha database.
|
|
|
|
=back
|
|
|
|
=cut
|
|
# @_ = biblioitemnumber, biblionumber.
|
|
sub GetOrder {
|
|
my ( $bi, $bib ) = @_;
|
|
my $dbh = C4::Context->dbh;
|
|
my $query = "
|
|
SELECT ordernumber
|
|
FROM aqorders
|
|
WHERE biblionumber=?
|
|
AND biblioitemnumber=?
|
|
";
|
|
my $sth = $dbh->prepare($query);
|
|
$sth->execute( $bib, $bi );
|
|
|
|
# FIXME - Use fetchrow_array(), since we're only interested in the one
|
|
# value.
|
|
my $ordnum = $sth->fetchrow_hashref;
|
|
$sth->finish;
|
|
my $order = GetSingleOrder( $ordnum->{'ordernumber'} );
|
|
return ( $order, $ordnum->{'ordernumber'} );
|
|
}
|
|
|
|
#------------------------------------------------------------#
|
|
|
|
=head3 GetSingleOrder
|
|
|
|
=over 4
|
|
|
|
$order = &GetSingleOrder($ordernumber);
|
|
|
|
Looks up an order by order number.
|
|
|
|
Returns a reference-to-hash describing the order. The keys of
|
|
C<$order> are fields from the biblio, biblioitems, aqorders, and
|
|
aqorderbreakdown tables of the Koha database.
|
|
|
|
=back
|
|
|
|
=cut
|
|
|
|
sub GetSingleOrder {
|
|
my ($ordnum) = @_;
|
|
my $dbh = C4::Context->dbh;
|
|
my $query = "
|
|
SELECT *
|
|
FROM biblio,biblioitems,aqorders
|
|
LEFT JOIN aqorderbreakdown ON aqorders.ordernumber=aqorderbreakdown.ordernumber
|
|
WHERE aqorders.ordernumber=?
|
|
AND biblio.biblionumber=aqorders.biblionumber
|
|
AND biblioitems.biblioitemnumber=aqorders.biblioitemnumber
|
|
";
|
|
my $sth= $dbh->prepare($query);
|
|
$sth->execute($ordnum);
|
|
my $data = $sth->fetchrow_hashref;
|
|
$sth->finish;
|
|
return $data;
|
|
}
|
|
|
|
#------------------------------------------------------------#
|
|
|
|
=head3 GetAllOrders
|
|
|
|
=over 4
|
|
|
|
@results = &GetAllOrders($booksellerid);
|
|
|
|
Looks up all of the pending orders from the supplier with the given
|
|
bookseller ID. Ignores cancelled and completed orders.
|
|
|
|
C<@results> is an array of references-to-hash. The keys of each element are fields from
|
|
the aqorders, biblio, and biblioitems tables of the Koha database.
|
|
|
|
C<@results> is sorted alphabetically by book title.
|
|
|
|
=back
|
|
|
|
=cut
|
|
|
|
sub GetAllOrders {
|
|
|
|
#gets all orders from a certain supplier, orders them alphabetically
|
|
my ($supplierid) = @_;
|
|
my $dbh = C4::Context->dbh;
|
|
my @results = ();
|
|
my $strsth = "
|
|
SELECT count(*),authorisedby,creationdate,aqbasket.basketno,
|
|
closedate,surname,firstname,aqorders.biblionumber,aqorders.title, aqorders.ordernumber
|
|
FROM aqorders
|
|
LEFT JOIN aqbasket ON aqbasket.basketno=aqorders.basketno
|
|
LEFT JOIN borrowers ON aqbasket.authorisedby=borrowers.borrowernumber
|
|
WHERE booksellerid=?
|
|
AND (quantity > quantityreceived OR quantityreceived IS NULL)
|
|
AND datecancellationprinted IS NULL
|
|
";
|
|
|
|
if ( C4::Context->preference("IndependantBranches") ) {
|
|
my $userenv = C4::Context->userenv;
|
|
if ( ($userenv) && ( $userenv->{flags} != 1 ) ) {
|
|
$strsth .=
|
|
" and (borrowers.branchcode = '"
|
|
. $userenv->{branch}
|
|
. "' or borrowers.branchcode ='')";
|
|
}
|
|
}
|
|
$strsth .= " group by basketno order by aqbasket.basketno";
|
|
my $sth = $dbh->prepare($strsth);
|
|
$sth->execute($supplierid);
|
|
while ( my $data = $sth->fetchrow_hashref ) {
|
|
push( @results, $data );
|
|
}
|
|
$sth->finish;
|
|
return @results;
|
|
}
|
|
|
|
#------------------------------------------------------------#
|
|
|
|
=head3 NewOrder
|
|
|
|
=over 4
|
|
|
|
&NewOrder($basket, $biblionumber, $title, $quantity, $listprice,
|
|
$booksellerid, $who, $notes, $bookfund, $biblioitemnumber, $rrp,
|
|
$ecost, $gst, $budget, $unitprice, $subscription,
|
|
$booksellerinvoicenumber);
|
|
|
|
Adds a new order to the database. Any argument that isn't described
|
|
below is the new value of the field with the same name in the aqorders
|
|
table of the Koha database.
|
|
|
|
C<$ordnum> is a "minimum order number." After adding the new entry to
|
|
the aqorders table, C<&neworder> finds the first entry in aqorders
|
|
with order number greater than or equal to C<$ordnum>, and adds an
|
|
entry to the aqorderbreakdown table, with the order number just found,
|
|
and the book fund ID of the newly-added order.
|
|
|
|
C<$budget> is effectively ignored.
|
|
|
|
C<$subscription> may be either "yes", or anything else for "no".
|
|
|
|
=back
|
|
|
|
=cut
|
|
|
|
sub NewOrder {
|
|
my (
|
|
$basketno, $bibnum, $title, $quantity,
|
|
$listprice, $booksellerid, $authorisedby, $notes,
|
|
$bookfund, $bibitemnum, $rrp, $ecost,
|
|
$gst, $budget, $cost, $sub,
|
|
$invoice, $sort1, $sort2
|
|
)
|
|
= @_;
|
|
|
|
my $year = localtime->year() + 1900;
|
|
my $month = localtime->mon() + 1; # months starts at 0, add 1
|
|
|
|
if ( !$budget || $budget eq 'now' ) {
|
|
$budget = "now()";
|
|
}
|
|
|
|
# if month is july or more, budget start is 1 jul, next year.
|
|
elsif ( $month >= '7' ) {
|
|
++$year; # add 1 to year , coz its next year
|
|
$budget = "'$year-07-01'";
|
|
}
|
|
else {
|
|
|
|
# START OF NEW BUDGET, 1ST OF JULY, THIS YEAR
|
|
$budget = "'$year-07-01'";
|
|
}
|
|
|
|
if ( $sub eq 'yes' ) {
|
|
$sub = 1;
|
|
}
|
|
else {
|
|
$sub = 0;
|
|
}
|
|
|
|
# if $basket empty, it's also a new basket, create it
|
|
unless ($basketno) {
|
|
$basketno = NewBasket( $booksellerid, $authorisedby );
|
|
}
|
|
|
|
my $dbh = C4::Context->dbh;
|
|
my $query = "
|
|
INSERT INTO aqorders
|
|
( biblionumber,title,basketno,quantity,listprice,notes,
|
|
biblioitemnumber,rrp,ecost,gst,unitprice,subscription,sort1,sort2,budgetdate,entrydate)
|
|
VALUES (?,?,?,?,?,?,?,?,?,?,?,?,?,?,$budget,now() )
|
|
";
|
|
my $sth = $dbh->prepare($query);
|
|
|
|
$sth->execute(
|
|
$bibnum, $title, $basketno, $quantity, $listprice,
|
|
$notes, $bibitemnum, $rrp, $ecost, $gst,
|
|
$cost, $sub, $sort1, $sort2
|
|
);
|
|
$sth->finish;
|
|
|
|
#get ordnum MYSQL dependant, but $dbh->last_insert_id returns null
|
|
my $ordnum = $dbh->{'mysql_insertid'};
|
|
my $query = "
|
|
INSERT INTO aqorderbreakdown (ordernumber,bookfundid)
|
|
VALUES (?,?)
|
|
";
|
|
$sth = $dbh->prepare($query);
|
|
$sth->execute( $ordnum, $bookfund );
|
|
$sth->finish;
|
|
return ( $basketno, $ordnum );
|
|
}
|
|
|
|
#------------------------------------------------------------#
|
|
|
|
=head3 ModOrder
|
|
|
|
=over 4
|
|
|
|
&ModOrder($title, $ordernumber, $quantity, $listprice,
|
|
$biblionumber, $basketno, $supplier, $who, $notes,
|
|
$bookfundid, $bibitemnum, $rrp, $ecost, $gst, $budget,
|
|
$unitprice, $booksellerinvoicenumber);
|
|
|
|
Modifies an existing order. Updates the order with order number
|
|
C<$ordernumber> and biblionumber C<$biblionumber>. All other arguments
|
|
update the fields with the same name in the aqorders table of the Koha
|
|
database.
|
|
|
|
Entries with order number C<$ordernumber> in the aqorderbreakdown
|
|
table are also updated to the new book fund ID.
|
|
|
|
=back
|
|
|
|
=cut
|
|
|
|
sub ModOrder {
|
|
my (
|
|
$title, $ordnum, $quantity, $listprice, $bibnum,
|
|
$basketno, $supplier, $who, $notes, $bookfund,
|
|
$bibitemnum, $rrp, $ecost, $gst, $budget,
|
|
$cost, $invoice, $sort1, $sort2
|
|
)
|
|
= @_;
|
|
my $dbh = C4::Context->dbh;
|
|
my $query = "
|
|
UPDATE aqorders
|
|
SET title=?,
|
|
quantity=?,listprice=?,basketno=?,
|
|
rrp=?,ecost=?,unitprice=?,booksellerinvoicenumber=?,
|
|
notes=?,sort1=?, sort2=?
|
|
WHERE ordernumber=? AND biblionumber=?
|
|
";
|
|
my $sth = $dbh->prepare($query);
|
|
$sth->execute(
|
|
$title, $quantity, $listprice, $basketno, $rrp,
|
|
$ecost, $cost, $invoice, $notes, $sort1,
|
|
$sort2, $ordnum, $bibnum
|
|
);
|
|
$sth->finish;
|
|
my $query = "
|
|
UPDATE aqorderbreakdown
|
|
SET bookfundid=?
|
|
WHERE ordernumber=?
|
|
";
|
|
$sth = $dbh->prepare($query);
|
|
|
|
unless ( $sth->execute( $bookfund, $ordnum ) )
|
|
{ # zero rows affected [Bug 734]
|
|
my $query ="
|
|
INSERT INTO aqorderbreakdown
|
|
(ordernumber,bookfundid)
|
|
VALUES (?,?)
|
|
";
|
|
$sth = $dbh->prepare($query);
|
|
$sth->execute( $ordnum, $bookfund );
|
|
}
|
|
$sth->finish;
|
|
}
|
|
|
|
#------------------------------------------------------------#
|
|
|
|
=head3 ModReceiveOrder
|
|
|
|
=over 4
|
|
|
|
&ModReceiveOrder($biblionumber, $ordernumber, $quantityreceived, $user,
|
|
$unitprice, $booksellerinvoicenumber, $biblioitemnumber,
|
|
$freight, $bookfund, $rrp);
|
|
|
|
Updates an order, to reflect the fact that it was received, at least
|
|
in part. All arguments not mentioned below update the fields with the
|
|
same name in the aqorders table of the Koha database.
|
|
|
|
Updates the order with bibilionumber C<$biblionumber> and ordernumber
|
|
C<$ordernumber>.
|
|
|
|
Also updates the book fund ID in the aqorderbreakdown table.
|
|
|
|
=back
|
|
|
|
=cut
|
|
|
|
|
|
sub ModReceiveOrder {
|
|
my (
|
|
$biblio, $ordnum, $quantrec, $user, $cost,
|
|
$invoiceno, $freight, $rrp, $bookfund
|
|
)
|
|
= @_;
|
|
my $dbh = C4::Context->dbh;
|
|
my $query = "
|
|
UPDATE aqorders
|
|
SET quantityreceived=?,datereceived=now(),booksellerinvoicenumber=?,
|
|
unitprice=?,freight=?,rrp=?
|
|
WHERE biblionumber=? AND ordernumber=?
|
|
";
|
|
my $sth = $dbh->prepare($query);
|
|
my $suggestionid = GetSuggestionFromBiblionumber( $dbh, $biblio );
|
|
if ($suggestionid) {
|
|
ModStatus( $suggestionid, 'AVAILABLE', '', $biblio );
|
|
}
|
|
$sth->execute( $quantrec, $invoiceno, $cost, $freight, $rrp, $biblio,
|
|
$ordnum );
|
|
$sth->finish;
|
|
|
|
# Allows libraries to change their bookfund during receiving orders
|
|
# allows them to adjust budgets
|
|
if ( C4::Context->preferene("LooseBudgets") ) {
|
|
my $query = "
|
|
UPDATE aqorderbreakdown
|
|
SET bookfundid=?
|
|
WHERE ordernumber=?
|
|
";
|
|
my $sth = $dbh->prepare($query);
|
|
$sth->execute( $bookfund, $ordnum );
|
|
$sth->finish;
|
|
}
|
|
}
|
|
|
|
#------------------------------------------------------------#
|
|
|
|
=head3 SearchOrder
|
|
|
|
@results = &SearchOrder($search, $biblionumber, $complete);
|
|
|
|
Searches for orders.
|
|
|
|
C<$search> may take one of several forms: if it is an ISBN,
|
|
C<&ordersearch> returns orders with that ISBN. If C<$search> is an
|
|
order number, C<&ordersearch> returns orders with that order number
|
|
and biblionumber C<$biblionumber>. Otherwise, C<$search> is considered
|
|
to be a space-separated list of search terms; in this case, all of the
|
|
terms must appear in the title (matching the beginning of title
|
|
words).
|
|
|
|
If C<$complete> is C<yes>, the results will include only completed
|
|
orders. In any case, C<&ordersearch> ignores cancelled orders.
|
|
|
|
C<&ordersearch> returns an array. C<@results> is an array of references-to-hash with the
|
|
following keys:
|
|
|
|
=over 4
|
|
|
|
=item C<author>
|
|
|
|
=item C<seriestitle>
|
|
|
|
=item C<branchcode>
|
|
|
|
=item C<bookfundid>
|
|
|
|
=back
|
|
|
|
=cut
|
|
|
|
sub SearchOrder {
|
|
my ( $search, $id, $biblio, $catview ) = @_;
|
|
my $dbh = C4::Context->dbh;
|
|
my @data = split( ' ', $search );
|
|
my @searchterms;
|
|
if ($id) {
|
|
@searchterms = ($id);
|
|
}
|
|
map { push( @searchterms, "$_%", "% $_%" ) } @data;
|
|
push( @searchterms, $search, $search, $biblio );
|
|
my $query;
|
|
if ($id) {
|
|
$query =
|
|
"SELECT *,biblio.title FROM aqorders,biblioitems,biblio,aqbasket
|
|
WHERE aqorders.biblioitemnumber = biblioitems.biblioitemnumber AND
|
|
aqorders.basketno = aqbasket.basketno
|
|
AND aqbasket.booksellerid = ?
|
|
AND biblio.biblionumber=aqorders.biblionumber
|
|
AND ((datecancellationprinted is NULL)
|
|
OR (datecancellationprinted = '0000-00-00'))
|
|
AND (("
|
|
. (
|
|
join( " AND ",
|
|
map { "(biblio.title like ? or biblio.title like ?)" } @data )
|
|
)
|
|
. ") OR biblioitems.isbn=? OR (aqorders.ordernumber=? AND aqorders.biblionumber=?)) ";
|
|
|
|
}
|
|
else {
|
|
$query =
|
|
" SELECT *,biblio.title
|
|
FROM aqorders,biblioitems,biblio,aqbasket
|
|
WHERE aqorders.biblioitemnumber = biblioitems.biblioitemnumber
|
|
AND aqorders.basketno = aqbasket.basketno
|
|
AND biblio.biblionumber=aqorders.biblionumber
|
|
AND ((datecancellationprinted is NULL)
|
|
OR (datecancellationprinted = '0000-00-00'))
|
|
AND (aqorders.quantityreceived < aqorders.quantity OR aqorders.quantityreceived is NULL)
|
|
AND (("
|
|
. (
|
|
join( " AND ",
|
|
map { "(biblio.title like ? OR biblio.title like ?)" } @data )
|
|
)
|
|
. ") or biblioitems.isbn=? OR (aqorders.ordernumber=? AND aqorders.biblionumber=?)) ";
|
|
}
|
|
$query .= " GROUP BY aqorders.ordernumber";
|
|
my $sth = $dbh->prepare($query);
|
|
$sth->execute(@searchterms);
|
|
my @results = ();
|
|
my $query2 = "
|
|
SELECT *
|
|
FROM biblio
|
|
WHERE biblionumber=?
|
|
";
|
|
my $sth2 = $dbh->prepare($query2);
|
|
my $query3 = "
|
|
SELECT *
|
|
FROM aqorderbreakdown
|
|
WHERE ordernumber=?
|
|
";
|
|
my $sth3 = $dbh->prepare($query3);
|
|
|
|
while ( my $data = $sth->fetchrow_hashref ) {
|
|
$sth2->execute( $data->{'biblionumber'} );
|
|
my $data2 = $sth2->fetchrow_hashref;
|
|
$data->{'author'} = $data2->{'author'};
|
|
$data->{'seriestitle'} = $data2->{'seriestitle'};
|
|
$sth3->execute( $data->{'ordernumber'} );
|
|
my $data3 = $sth3->fetchrow_hashref;
|
|
$data->{'branchcode'} = $data3->{'branchcode'};
|
|
$data->{'bookfundid'} = $data3->{'bookfundid'};
|
|
push( @results, $data );
|
|
}
|
|
$sth->finish;
|
|
$sth2->finish;
|
|
$sth3->finish;
|
|
return @results;
|
|
}
|
|
|
|
#------------------------------------------------------------#
|
|
|
|
=head3 DelOrder
|
|
|
|
=over 4
|
|
|
|
&DelOrder($biblionumber, $ordernumber);
|
|
|
|
Cancel the order with the given order and biblio numbers. It does not
|
|
delete any entries in the aqorders table, it merely marks them as
|
|
cancelled.
|
|
|
|
=back
|
|
|
|
=cut
|
|
|
|
sub DelOrder {
|
|
my ( $bibnum, $ordnum ) = @_;
|
|
my $dbh = C4::Context->dbh;
|
|
my $query = "
|
|
UPDATE aqorders
|
|
SET datecancellationprinted=now()
|
|
WHERE biblionumber=? AND ordernumber=?
|
|
";
|
|
my $sth = $dbh->prepare($query);
|
|
$sth->execute( $bibnum, $ordnum );
|
|
$sth->finish;
|
|
}
|
|
|
|
|
|
=back
|
|
|
|
=back
|
|
|
|
=head2 FUNCTIONS ABOUT PARCELS
|
|
|
|
=over 2
|
|
|
|
=cut
|
|
|
|
#------------------------------------------------------------#
|
|
|
|
=head3 GetParcel
|
|
|
|
=over 4
|
|
|
|
@results = &GetParcel($booksellerid, $code, $date);
|
|
|
|
Looks up all of the received items from the supplier with the given
|
|
bookseller ID at the given date, for the given code. Ignores cancelled and completed orders.
|
|
|
|
C<@results> is an array of references-to-hash. The keys of each element are fields from
|
|
the aqorders, biblio, and biblioitems tables of the Koha database.
|
|
|
|
C<@results> is sorted alphabetically by book title.
|
|
|
|
=back
|
|
|
|
=cut
|
|
|
|
sub GetParcel {
|
|
|
|
#gets all orders from a certain supplier, orders them alphabetically
|
|
my ( $supplierid, $code, $datereceived ) = @_;
|
|
my $dbh = C4::Context->dbh;
|
|
my @results = ();
|
|
$code .= '%'
|
|
if $code; # add % if we search on a given code (otherwise, let him empty)
|
|
my $strsth ="
|
|
SELECT authorisedby,
|
|
creationdate,
|
|
aqbasket.basketno,
|
|
closedate,surname,
|
|
firstname,
|
|
aqorders.biblionumber,
|
|
aqorders.title,
|
|
aqorders.ordernumber,
|
|
aqorders.quantity,
|
|
aqorders.quantityreceived,
|
|
aqorders.unitprice,
|
|
aqorders.listprice,
|
|
aqorders.rrp,
|
|
aqorders.ecost
|
|
FROM aqorders,aqbasket
|
|
LEFT JOIN borrowers ON aqbasket.authorisedby=borrowers.borrowernumber
|
|
WHERE aqbasket.basketno=aqorders.basketno
|
|
AND aqbasket.booksellerid=?
|
|
AND aqorders.booksellerinvoicenumber LIKE \"$code\"
|
|
AND aqorders.datereceived= \'$datereceived\'";
|
|
|
|
if ( C4::Context->preference("IndependantBranches") ) {
|
|
my $userenv = C4::Context->userenv;
|
|
if ( ($userenv) && ( $userenv->{flags} != 1 ) ) {
|
|
$strsth .=
|
|
" and (borrowers.branchcode = '"
|
|
. $userenv->{branch}
|
|
. "' or borrowers.branchcode ='')";
|
|
}
|
|
}
|
|
$strsth .= " order by aqbasket.basketno";
|
|
### parcelinformation : $strsth
|
|
my $sth = $dbh->prepare($strsth);
|
|
$sth->execute($supplierid);
|
|
while ( my $data = $sth->fetchrow_hashref ) {
|
|
push( @results, $data );
|
|
}
|
|
### countparcelbiblio: $count
|
|
$sth->finish;
|
|
|
|
return @results;
|
|
}
|
|
|
|
#------------------------------------------------------------#
|
|
|
|
=head3 GetParcels
|
|
|
|
=over 4
|
|
|
|
$results = &GetParcels($bookseller, $order, $code, $datefrom, $dateto, $limit);
|
|
|
|
get a lists of parcels
|
|
Returns a pointer on a hash list containing parcel informations as such :
|
|
Creation date
|
|
Last operation
|
|
Number of biblio
|
|
Number of items
|
|
|
|
=back
|
|
|
|
=cut
|
|
|
|
sub GetParcels {
|
|
my ($bookseller,$order, $code, $datefrom, $dateto) = @_;
|
|
my $dbh = C4::Context->dbh;
|
|
my $strsth ="
|
|
SELECT aqorders.booksellerinvoicenumber,
|
|
datereceived,
|
|
count(DISTINCT biblionumber) AS biblio,
|
|
sum(quantity) AS itemsexpected,
|
|
sum(quantityreceived) AS itemsreceived
|
|
FROM aqorders, aqbasket
|
|
WHERE aqbasket.basketno = aqorders.basketno
|
|
AND aqbasket.booksellerid = $bookseller and datereceived IS NOT NULL
|
|
";
|
|
|
|
$strsth .= "and aqorders.booksellerinvoicenumber like \"$code%\" " if ($code);
|
|
|
|
$strsth .= "and datereceived >=" . $dbh->quote($datefrom) . " " if ($datefrom);
|
|
|
|
$strsth .= "and datereceived <=" . $dbh->quote($dateto) . " " if ($dateto);
|
|
|
|
$strsth .= "group by aqorders.booksellerinvoicenumber,datereceived ";
|
|
$strsth .= "order by $order " if ($order);
|
|
my $sth = $dbh->prepare($strsth);
|
|
|
|
$sth->execute;
|
|
my @results;
|
|
|
|
while ( my $data2 = $sth->fetchrow_hashref ) {
|
|
push @results, $data2;
|
|
}
|
|
|
|
$sth->finish;
|
|
return @results;
|
|
}
|
|
|
|
#------------------------------------------------------------#
|
|
|
|
=head3 GetLateOrders
|
|
|
|
=over 4
|
|
|
|
@results = &GetLateOrders;
|
|
|
|
Searches for suppliers with late orders.
|
|
|
|
return:
|
|
the table of supplier with late issues. This table is full of hashref.
|
|
|
|
=back
|
|
|
|
=cut
|
|
|
|
sub GetLateOrders {
|
|
my $delay = shift;
|
|
my $supplierid = shift;
|
|
my $branch = shift;
|
|
|
|
my $dbh = C4::Context->dbh;
|
|
|
|
#BEWARE, order of parenthesis and LEFT JOIN is important for speed
|
|
my $strsth;
|
|
my $dbdriver = C4::Context->config("db_scheme") || "mysql";
|
|
|
|
# warn " $dbdriver";
|
|
if ( $dbdriver eq "mysql" ) {
|
|
$strsth = "
|
|
SELECT aqbasket.basketno,
|
|
DATE(aqbasket.closedate) AS orderdate,
|
|
aqorders.quantity - IFNULL(aqorders.quantityreceived,0) AS quantity,
|
|
aqorders.rrp AS unitpricesupplier,
|
|
aqorders.ecost AS unitpricelib,
|
|
(aqorders.quantity - IFNULL(aqorders.quantityreceived,0)) * aqorders.rrp AS subtotal,
|
|
aqbookfund.bookfundname AS budget,
|
|
borrowers.branchcode AS branch,
|
|
aqbooksellers.name AS supplier,
|
|
aqorders.title,
|
|
biblio.author,
|
|
biblioitems.publishercode AS publisher,
|
|
biblioitems.publicationyear,
|
|
DATEDIFF(CURDATE( ),closedate) AS latesince
|
|
FROM (((
|
|
(aqorders LEFT JOIN biblio ON biblio.biblionumber = aqorders.biblionumber)
|
|
LEFT JOIN biblioitems ON biblioitems.biblionumber=biblio.biblionumber)
|
|
LEFT JOIN aqorderbreakdown ON aqorders.ordernumber = aqorderbreakdown.ordernumber)
|
|
LEFT JOIN aqbookfund ON aqorderbreakdown.bookfundid = aqbookfund.bookfundid),
|
|
(aqbasket LEFT JOIN borrowers ON aqbasket.authorisedby = borrowers.borrowernumber)
|
|
LEFT JOIN aqbooksellers ON aqbasket.booksellerid = aqbooksellers.id
|
|
WHERE aqorders.basketno = aqbasket.basketno
|
|
AND (closedate < DATE_SUB(CURDATE( ),INTERVAL $delay DAY))
|
|
AND ((datereceived = '' OR datereceived is null)
|
|
OR (aqorders.quantityreceived < aqorders.quantity) )
|
|
";
|
|
$strsth .= " AND aqbasket.booksellerid = $supplierid " if ($supplierid);
|
|
$strsth .= " AND borrowers.branchcode like \'" . $branch . "\'"
|
|
if ($branch);
|
|
$strsth .=
|
|
" AND borrowers.branchcode like \'"
|
|
. C4::Context->userenv->{branch} . "\'"
|
|
if ( C4::Context->preference("IndependantBranches")
|
|
&& C4::Context->userenv
|
|
&& C4::Context->userenv->{flags} != 1 );
|
|
$strsth .=" HAVING quantity<>0
|
|
AND unitpricesupplier<>0
|
|
AND unitpricelib<>0
|
|
ORDER BY latesince,basketno,borrowers.branchcode, supplier
|
|
";
|
|
}
|
|
else {
|
|
$strsth = "
|
|
SELECT aqbasket.basketno,
|
|
DATE(aqbasket.closedate) AS orderdate,
|
|
aqorders.quantity, aqorders.rrp AS unitpricesupplier,
|
|
aqorders.ecost as unitpricelib,
|
|
aqorders.quantity * aqorders.rrp AS subtotal
|
|
aqbookfund.bookfundname AS budget,
|
|
borrowers.branchcode AS branch,
|
|
aqbooksellers.name AS supplier,
|
|
biblio.title,
|
|
biblio.author,
|
|
biblioitems.publishercode AS publisher,
|
|
biblioitems.publicationyear,
|
|
(CURDATE - closedate) AS latesince
|
|
FROM(( (
|
|
(aqorders LEFT JOIN biblio on biblio.biblionumber = aqorders.biblionumber)
|
|
LEFT JOIN biblioitems on biblioitems.biblionumber=biblio.biblionumber)
|
|
LEFT JOIN aqorderbreakdown on aqorders.ordernumber = aqorderbreakdown.ordernumber)
|
|
LEFT JOIN aqbookfund ON aqorderbreakdown.bookfundid = aqbookfund.bookfundid),
|
|
(aqbasket LEFT JOIN borrowers on aqbasket.authorisedby = borrowers.borrowernumber) LEFT JOIN aqbooksellers ON aqbasket.booksellerid = aqbooksellers.id
|
|
WHERE aqorders.basketno = aqbasket.basketno
|
|
AND (closedate < (CURDATE -(INTERVAL $delay DAY))
|
|
AND ((datereceived = '' OR datereceived is null)
|
|
OR (aqorders.quantityreceived < aqorders.quantity) ) ";
|
|
$strsth .= " AND aqbasket.booksellerid = $supplierid " if ($supplierid);
|
|
|
|
$strsth .= " AND borrowers.branchcode like \'" . $branch . "\'" if ($branch);
|
|
$strsth .=" AND borrowers.branchcode like \'". C4::Context->userenv->{branch} . "\'"
|
|
if (C4::Context->preference("IndependantBranches") && C4::Context->userenv->{flags} != 1 );
|
|
$strsth .=" ORDER BY latesince,basketno,borrowers.branchcode, supplier";
|
|
}
|
|
my $sth = $dbh->prepare($strsth);
|
|
$sth->execute;
|
|
my @results;
|
|
my $hilighted = 1;
|
|
while ( my $data = $sth->fetchrow_hashref ) {
|
|
$data->{hilighted} = $hilighted if ( $hilighted > 0 );
|
|
$data->{orderdate} = format_date( $data->{orderdate} );
|
|
push @results, $data;
|
|
$hilighted = -$hilighted;
|
|
}
|
|
$sth->finish;
|
|
return @results;
|
|
}
|
|
|
|
#------------------------------------------------------------#
|
|
|
|
=head3 GetHistory
|
|
|
|
=over 4
|
|
|
|
(\@order_loop, $total_qty, $total_price, $total_qtyreceived)=&GetHistory( $title, $author, $name, $from_placed_on, $to_placed_on )
|
|
|
|
this function get the search history.
|
|
|
|
=back
|
|
|
|
=cut
|
|
|
|
sub GetHistory {
|
|
my ( $title, $author, $name, $from_placed_on, $to_placed_on ) = @_;
|
|
my @order_loop;
|
|
my $total_qty = 0;
|
|
my $total_qtyreceived = 0;
|
|
my $total_price = 0;
|
|
|
|
# don't run the query if there are no parameters (list would be too long for sure !)
|
|
if ( $title || $author || $name || $from_placed_on || $to_placed_on ) {
|
|
my $dbh = C4::Context->dbh;
|
|
my $query ="
|
|
SELECT
|
|
biblio.title,
|
|
biblio.author,
|
|
aqorders.basketno,
|
|
name,aqbasket.creationdate,
|
|
aqorders.datereceived,
|
|
aqorders.quantity,
|
|
aqorders.quantityreceived,
|
|
aqorders.ecost,
|
|
aqorders.ordernumber
|
|
FROM aqorders,aqbasket,aqbooksellers,biblio";
|
|
|
|
$query .= ",borrowers "
|
|
if ( C4::Context->preference("IndependantBranches") );
|
|
|
|
$query .="
|
|
WHERE aqorders.basketno=aqbasket.basketno
|
|
AND aqbasket.booksellerid=aqbooksellers.id
|
|
AND biblio.biblionumber=aqorders.biblionumber ";
|
|
|
|
$query .= " AND aqbasket.authorisedby=borrowers.borrowernumber"
|
|
if ( C4::Context->preference("IndependantBranches") );
|
|
|
|
$query .= " AND biblio.title LIKE " . $dbh->quote( "%" . $title . "%" )
|
|
if $title;
|
|
|
|
$query .=
|
|
" AND biblio.author LIKE " . $dbh->quote( "%" . $author . "%" )
|
|
if $author;
|
|
|
|
$query .= " AND name LIKE " . $dbh->quote( "%" . $name . "%" ) if $name;
|
|
|
|
$query .= " AND creationdate >" . $dbh->quote($from_placed_on)
|
|
if $from_placed_on;
|
|
|
|
$query .= " AND creationdate<" . $dbh->quote($to_placed_on)
|
|
if $to_placed_on;
|
|
|
|
if ( C4::Context->preference("IndependantBranches") ) {
|
|
my $userenv = C4::Context->userenv;
|
|
if ( ($userenv) && ( $userenv->{flags} != 1 ) ) {
|
|
$query .=
|
|
" AND (borrowers.branchcode = '"
|
|
. $userenv->{branch}
|
|
. "' OR borrowers.branchcode ='')";
|
|
}
|
|
}
|
|
$query .= " ORDER BY booksellerid";
|
|
my $sth = $dbh->prepare($query);
|
|
$sth->execute;
|
|
my $cnt = 1;
|
|
while ( my $line = $sth->fetchrow_hashref ) {
|
|
$line->{count} = $cnt++;
|
|
$line->{toggle} = 1 if $cnt % 2;
|
|
push @order_loop, $line;
|
|
$line->{creationdate} = format_date( $line->{creationdate} );
|
|
$line->{datereceived} = format_date( $line->{datereceived} );
|
|
$total_qty += $line->{'quantity'};
|
|
$total_qtyreceived += $line->{'quantityreceived'};
|
|
$total_price += $line->{'quantity'} * $line->{'ecost'};
|
|
}
|
|
}
|
|
return \@order_loop, $total_qty, $total_price, $total_qtyreceived;
|
|
}
|
|
|
|
END { } # module clean-up code here (global destructor)
|
|
|
|
1;
|
|
|
|
__END__
|
|
|
|
=back
|
|
|
|
=head1 AUTHOR
|
|
|
|
Koha Developement team <info@koha.org>
|
|
|
|
=cut
|