API for circulation modules
This commit is contained in:
tonnesen
parent
40397605a1
commit
e16ba0cb0a
1 changed files with 467 additions and 0 deletions
467
C4/Circulation/Circ2.pm
Executable file
467
C4/Circulation/Circ2.pm
Executable file
|
|
@ -0,0 +1,467 @@
|
|||
package C4::Circulation::Circ2; #assumes C4/Circulation/Returns
|
||||
|
||||
#package to deal with Returns
|
||||
#written 3/11/99 by olwen@katipo.co.nz
|
||||
|
||||
use strict;
|
||||
require Exporter;
|
||||
use DBI;
|
||||
use C4::Database;
|
||||
use C4::Accounts;
|
||||
use C4::InterfaceCDK;
|
||||
use C4::Circulation::Main;
|
||||
use C4::Format;
|
||||
use C4::Circulation::Renewals;
|
||||
use C4::Scan;
|
||||
use C4::Stats;
|
||||
use C4::Search;
|
||||
use C4::Print;
|
||||
|
||||
use vars qw($VERSION @ISA @EXPORT @EXPORT_OK %EXPORT_TAGS);
|
||||
|
||||
# set the version for version checking
|
||||
$VERSION = 0.01;
|
||||
|
||||
@ISA = qw(Exporter);
|
||||
@EXPORT = qw(&getpatroninformation ¤tissues &getiteminformation &findborrower &issuebook &returnbook);
|
||||
%EXPORT_TAGS = ( ); # eg: TAG => [ qw!name1 name2! ],
|
||||
|
||||
# your exported package globals go here,
|
||||
# as well as any optionally exported functions
|
||||
|
||||
@EXPORT_OK = qw($Var1 %Hashit);
|
||||
|
||||
|
||||
# non-exported package globals go here
|
||||
#use vars qw(@more $stuff);
|
||||
|
||||
# initalize package globals, first exported ones
|
||||
|
||||
my $Var1 = '';
|
||||
my %Hashit = ();
|
||||
|
||||
# then the others (which are still accessible as $Some::Module::stuff)
|
||||
my $stuff = '';
|
||||
my @more = ();
|
||||
|
||||
# all file-scoped lexicals must be created before
|
||||
# the functions below that use them.
|
||||
|
||||
# file-private lexicals go here
|
||||
my $priv_var = '';
|
||||
my %secret_hash = ();
|
||||
|
||||
# here's a file-private function as a closure,
|
||||
# callable as &$priv_func; it cannot be prototyped.
|
||||
my $priv_func = sub {
|
||||
# stuff goes here.
|
||||
};
|
||||
|
||||
# make all your functions, whether exported or not;
|
||||
|
||||
sub getpatroninformation {
|
||||
my ($env, $borrowernumber,$cardnumber) = @_;
|
||||
my $dbh=&C4Connect;
|
||||
my $sth;
|
||||
if ($borrowernumber) {
|
||||
$sth=$dbh->prepare("select * from borrowers where borrowernumber=$borrowernumber");
|
||||
} elsif ($cardnumber) {
|
||||
$sth=$dbh->prepare("select * from borrowers where cardnumber=$cardnumber");
|
||||
} else {
|
||||
# error condition. This subroutine must be called with either a
|
||||
# borrowernumber or a card number.
|
||||
$env->{'apierror'}="invalid borrower information passed to getpatroninformation subroutine";
|
||||
return();
|
||||
}
|
||||
$sth->execute;
|
||||
my $borrower=$sth->fetchrow_hashref;
|
||||
my $flags=patronflags($env, $borrower, $dbh);
|
||||
$sth->finish;
|
||||
$dbh->disconnect;
|
||||
return($borrower, $flags);
|
||||
}
|
||||
|
||||
sub patronflags {
|
||||
my %flags;
|
||||
my ($env,$patroninformation,$dbh) = @_;
|
||||
my $amount = checkaccount($env,$patroninformation->{'borrowernumber'}, $dbh);
|
||||
if ($amount>0) {
|
||||
my %flaginfo;
|
||||
$flaginfo{'message'}='Patron owes $amount';
|
||||
if ($amount>5) {
|
||||
$flaginfo{'noissues'}=1;
|
||||
}
|
||||
$flags{'CHARGES'}=\%flaginfo;
|
||||
}
|
||||
if ($patroninformation->{'gonenoaddress'} == 1) {
|
||||
my %flaginfo;
|
||||
$flaginfo{'message'}='Borrower has no valid address.';
|
||||
$flaginfo{'noissues'}=1;
|
||||
$flags{'GNA'}=\%flaginfo;
|
||||
}
|
||||
if ($patroninformation->{'lost'} == 1) {
|
||||
my %flaginfo;
|
||||
$flaginfo{'message'}='Borrower\'s card reported lost.';
|
||||
$flaginfo{'noissues'}=1;
|
||||
$flags{'LOST'}=\%flaginfo;
|
||||
}
|
||||
if ($patroninformation->{'borrowernotes'}) {
|
||||
my %flaginfo;
|
||||
$flaginfo{'message'}="Note: $patroninformation->{'borrowernotes'}";
|
||||
$flags{'NOTES'}=\%flaginfo;
|
||||
}
|
||||
my ($odues) = checkoverdues($env,$patroninformation->{'borrowernumber'},$dbh);
|
||||
if ($odues > 0) {
|
||||
my %flaginfo;
|
||||
$flaginfo{'message'}="Overdue Items";
|
||||
$flags{'ODUES'}=\%flaginfo;
|
||||
}
|
||||
my ($nowaiting,$itemswaiting) = checkwaiting($env,$dbh,$patroninformation->{'borrowernumber'});
|
||||
if ($nowaiting>0) {
|
||||
my %flaginfo;
|
||||
$flaginfo{'message'}="Reserved items available";
|
||||
$flaginfo{'itemlist'}=$itemswaiting;
|
||||
$flaginfo{'itemfields'}=['barcode', 'title', 'author', 'dewey', 'subclass', 'holdingbranch'];
|
||||
$flags{'WAITING'}=\%flaginfo;
|
||||
}
|
||||
|
||||
my $flag;
|
||||
my $key;
|
||||
return(\%flags);
|
||||
}
|
||||
|
||||
|
||||
|
||||
sub currentissues {
|
||||
my ($env, $borrower) = @_;
|
||||
my $dbh=&C4Connect;
|
||||
my %currentissues;
|
||||
my $counter=1;
|
||||
my $borrowernumber=$borrower->{'borrowernumber'};
|
||||
my $sth=$dbh->prepare("select * from issues,items,biblio where borrowernumber=$borrowernumber and issues.itemnumber=items.itemnumber and items.biblionumber=biblio.biblionumber and returndate is null order by date_due");
|
||||
$sth->execute;
|
||||
while (my $data = $sth->fetchrow_hashref) {
|
||||
my $datedue=$data->{'date_due'};
|
||||
my $itemnumber=$data->{'itemnumber'};
|
||||
my ($iteminformation) = getiteminformation($env, $itemnumber,0);
|
||||
open O, ">>/root/tkcirc.out";
|
||||
print O "Getting item info for $itemnumber $iteminformation->{'barcode'}.\n";
|
||||
close O;
|
||||
$iteminformation->{'datedue'}=$datedue;
|
||||
$currentissues{$counter}=$iteminformation;
|
||||
$counter++;
|
||||
}
|
||||
$sth->finish;
|
||||
$dbh->disconnect;
|
||||
return(\%currentissues);
|
||||
}
|
||||
|
||||
sub getiteminformation {
|
||||
my ($env, $itemnumber, $barcode) = @_;
|
||||
my $dbh=&C4Connect;
|
||||
my $sth;
|
||||
if ($itemnumber) {
|
||||
$sth=$dbh->prepare("select * from biblio,items,biblioitems where items.itemnumber=$itemnumber and biblio.biblionumber=items.biblionumber and biblioitems.biblioitemnumber = items.biblioitemnumber");
|
||||
} elsif ($barcode) {
|
||||
my $q_barcode=$dbh->quote($barcode);
|
||||
$sth=$dbh->prepare("select * from biblio,items,biblioitems where items.barcode=$q_barcode and biblio.biblionumber=items.biblionumber and biblioitems.biblioitemnumber = items.biblioitemnumber");
|
||||
} else {
|
||||
$env->{'apierror'}="getiteminformation() subroutine must be called with either an itemnumber or a barcode";
|
||||
# Error condition.
|
||||
return();
|
||||
}
|
||||
$sth->execute;
|
||||
my $iteminformation=$sth->fetchrow_hashref;
|
||||
$sth->finish;
|
||||
$dbh->disconnect;
|
||||
$iteminformation->{'dewey'}=~s/0*$//;
|
||||
return($iteminformation);
|
||||
}
|
||||
|
||||
sub findborrower {
|
||||
my ($env, $key) = @_;
|
||||
my $dbh=&C4Connect;
|
||||
my @borrowers;
|
||||
my $q_key=$dbh->quote($key);
|
||||
my $sth=$dbh->prepare("select * from borrowers where cardnumber=$q_key");
|
||||
$sth->execute;
|
||||
if ($sth->rows) {
|
||||
my ($borrower)=$sth->fetchrow_hashref;
|
||||
push (@borrowers, $borrower);
|
||||
} else {
|
||||
$q_key=$dbh->quote("$key%");
|
||||
$sth->finish;
|
||||
$sth=$dbh->prepare("select * from borrowers where surname like $q_key");
|
||||
$sth->execute;
|
||||
while (my $borrower = $sth->fetchrow_hashref) {
|
||||
push (@borrowers, $borrower);
|
||||
}
|
||||
}
|
||||
$sth->finish;
|
||||
$dbh->disconnect;
|
||||
return(\@borrowers);
|
||||
}
|
||||
|
||||
sub currentborrower {
|
||||
my ($env, $itemnumber, $dbh) = @_;
|
||||
my $q_itemnumber=$dbh->quote($itemnumber);
|
||||
my $sth=$dbh->prepare("select borrowers.borrowernumber from
|
||||
issues,borrowers where issues.itemnumber=$q_itemnumber and
|
||||
issues.borrowernumber=borrowers.borrowernumber and issues.returndate is
|
||||
NULL");
|
||||
$sth->execute;
|
||||
my ($previousborrower)=$sth->fetchrow;
|
||||
return($previousborrower);
|
||||
}
|
||||
|
||||
|
||||
sub checkreserve {
|
||||
# Check for reserves for biblio
|
||||
my ($env,$dbh,$itemnum)=@_;
|
||||
my $resbor = "";
|
||||
my $query = "select * from reserves,items
|
||||
where (items.itemnumber = '$itemnum')
|
||||
and (reserves.cancellationdate is NULL)
|
||||
and (items.biblionumber = reserves.biblionumber)
|
||||
and ((reserves.found = 'W')
|
||||
or (reserves.found is null))
|
||||
order by priority";
|
||||
my $sth = $dbh->prepare($query);
|
||||
$sth->execute();
|
||||
my $resrec;
|
||||
if (my $data=$sth->fetchrow_hashref) {
|
||||
$resrec=$data;
|
||||
my $const = $data->{'constrainttype'};
|
||||
if ($const eq "a") {
|
||||
$resbor = $data->{'borrowernumber'};
|
||||
} else {
|
||||
my $found = 0;
|
||||
my $cquery = "select * from reserveconstraints,items
|
||||
where (borrowernumber='$data->{'borrowernumber'}')
|
||||
and reservedate='$data->{'reservedate'}'
|
||||
and reserveconstraints.biblionumber='$data->{'biblionumber'}'
|
||||
and (items.itemnumber=$itemnum and
|
||||
items.biblioitemnumber = reserveconstraints.biblioitemnumber)";
|
||||
my $csth = $dbh->prepare($cquery);
|
||||
$csth->execute;
|
||||
if (my $cdata=$csth->fetchrow_hashref) {$found = 1;}
|
||||
if ($const eq 'o') {
|
||||
if ($found eq 1) {$resbor = $data->{'borrowernumber'};}
|
||||
} else {
|
||||
if ($found eq 0) {$resbor = $data->{'borrowernumber'};}
|
||||
}
|
||||
$csth->finish();
|
||||
}
|
||||
}
|
||||
$sth->finish;
|
||||
return ($resbor,$resrec);
|
||||
}
|
||||
|
||||
|
||||
sub issuebook {
|
||||
my ($env, $patroninformation, $barcode, $responses) = @_;
|
||||
my $dbh=&C4Connect;
|
||||
my $iteminformation=getiteminformation($env, 0, $barcode);
|
||||
my ($datedue);
|
||||
my ($rejected,$question,$defaultanswer,$questionnumber, $noissue);
|
||||
SWITCH: {
|
||||
if ($iteminformation->{'notforloan'} == 1) {
|
||||
$rejected="Item not for loan.";
|
||||
last SWITCH;
|
||||
}
|
||||
if ($iteminformation->{'wthdrawn'} == 1) {
|
||||
$rejected="Item withdrawn.";
|
||||
last SWITCH;
|
||||
}
|
||||
if ($iteminformation->{'restricted'} == 1) {
|
||||
$rejected="Restricted item.";
|
||||
last SWITCH;
|
||||
}
|
||||
if ($iteminformation->{'itemtype'} eq 'REF') {
|
||||
$rejected="Reference item: Not for loan.";
|
||||
last SWITCH;
|
||||
}
|
||||
my ($currentborrower) = currentborrower($env, $iteminformation->{'itemnumber'}, $dbh);
|
||||
if ($currentborrower eq $patroninformation->{'borrowernumber'}) {
|
||||
# Already issued to current borrower
|
||||
my ($renewstatus) = renewstatus($env,$dbh,$patroninformation->{'borrowernumber'}, $iteminformation->{'itemnumber'});
|
||||
if ($renewstatus == 0) {
|
||||
$rejected="No more renewals allowed for this item.";
|
||||
last SWITCH;
|
||||
} else {
|
||||
if ($responses->{4} eq '') {
|
||||
$questionnumber=4;
|
||||
$question="Book is issued to this borrower.\nRenew?";
|
||||
$defaultanswer='Y';
|
||||
last SWITCH;
|
||||
} elsif ($responses->{4} eq 'Y') {
|
||||
renewbook($env,$dbh, $patroninformation->{'borrowernumber'}, $iteminformation->{'itemnumber'});
|
||||
$noissue=1;
|
||||
} else {
|
||||
$rejected=-1;
|
||||
last SWITCH;
|
||||
}
|
||||
}
|
||||
} elsif ($currentborrower ne '') {
|
||||
my ($currborrower, $cbflags)=getpatroninformation($env,$currentborrower,0);
|
||||
if ($responses->{1} eq '') {
|
||||
$questionnumber=1;
|
||||
$question="Issued to $currborrower->{'firstname'} $currborrower->{'surname'} ($currborrower->{'cardnumber'}).\nMark as returned?";
|
||||
$defaultanswer='Y';
|
||||
last SWITCH;
|
||||
} elsif ($responses->{1} eq 'Y') {
|
||||
returnbook($env,$iteminformation->{'barcode'});
|
||||
} else {
|
||||
$rejected=-1;
|
||||
last SWITCH;
|
||||
}
|
||||
}
|
||||
|
||||
my ($resbor, $resrec) = checkreserve($env, $dbh, $iteminformation->{'itemnumber'});
|
||||
|
||||
if ($resbor eq $patroninformation->{'borrowernumber'}) {
|
||||
my $rquery = "update reserves set found = 'F' where reservedate = '$resrec->{'reservedate'}' and borrowernumber = '$resrec->{'borrowernumber'}' and biblionumber = '$resrec->{'biblionumber'}'";
|
||||
my $rsth = $dbh->prepare($rquery);
|
||||
$rsth->execute;
|
||||
$rsth->finish;
|
||||
} elsif ($resbor ne "") {
|
||||
my $resborrower=getpatroninformation($env, $resbor,0);
|
||||
if ($responses->{2} eq '') {
|
||||
$questionnumber=2;
|
||||
$question="Reserved for $resborrower->{'firstname'} $resborrower->{'surname'} ($resborrower->{'cardnumber'}\nAllow issue?";
|
||||
$defaultanswer='N';
|
||||
last SWITCH;
|
||||
} elsif ($responses->{2} eq 'N') {
|
||||
printreserve($env, $resrec, $resborrower, $iteminformation);
|
||||
$rejected=-1;
|
||||
last SWITCH;
|
||||
} else {
|
||||
if ($responses->{3} eq '') {
|
||||
$questionnumber=3;
|
||||
$question="Cancel reserve for $resborrower->{'firstname'} $resborrower->{'surname'} ($resborrower->{'cardnumber'}?";
|
||||
$defaultanswer='N';
|
||||
last SWITCH;
|
||||
} elsif ($responses->{3} eq 'Y') {
|
||||
my $rquery = "update reserves set found = 'F' where reservedate = '$resrec->{'reservedate'}' and borrowernumber = '$resrec->{'borrowernumber'}' and biblionumber = '$resrec->{'biblionumber'}'";
|
||||
my $rsth = $dbh->prepare($rquery);
|
||||
$rsth->execute;
|
||||
$rsth->finish;
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
my $dateduef;
|
||||
unless (($question) || ($rejected) || ($noissue)) {
|
||||
my $loanlength=21;
|
||||
if ($iteminformation->{'loanlength'}) {
|
||||
$loanlength=$iteminformation->{'loanlength'};
|
||||
}
|
||||
my $ti=time;
|
||||
my $datedue=time+($loanlength)*86400;
|
||||
my @datearr = localtime($datedue);
|
||||
$dateduef = (1900+$datearr[5])."-".($datearr[4]+1)."-".$datearr[3];
|
||||
my $sth=$dbh->prepare("insert into issues (borrowernumber, itemnumber, date_due, branchcode) values ($patroninformation->{'borrowernumber'}, $iteminformation->{'itemnumber'}, '$dateduef', '$env->{'branchcode'}')");
|
||||
$sth->execute;
|
||||
$sth->finish;
|
||||
$iteminformation->{'issues'}++;
|
||||
$sth=$dbh->prepare("update items set issues=$iteminformation->{'issues'} where itemnumber=$iteminformation->{'itemnumber'}");
|
||||
$sth->execute;
|
||||
$sth->finish;
|
||||
}
|
||||
$dbh->disconnect;
|
||||
return ($iteminformation, $dateduef, $rejected, $question, $questionnumber, $defaultanswer);
|
||||
}
|
||||
|
||||
|
||||
sub updatelastseen {
|
||||
my ($env,$dbh,$itemnumber)= @_;
|
||||
my $br = $env->{'branchcode'};
|
||||
my $query = "update items
|
||||
set datelastseen = now(), holdingbranch = '$br'
|
||||
where (itemnumber = '$itemnumber')";
|
||||
my $sth = $dbh->prepare($query);
|
||||
$sth->execute;
|
||||
$sth->finish;
|
||||
}
|
||||
|
||||
sub returnbook {
|
||||
my ($env, $barcode) = @_;
|
||||
my ($messages, $overduecharge);
|
||||
my $dbh=&C4Connect;
|
||||
my ($iteminformation) = getiteminformation($env, 0, $barcode);
|
||||
my $borrower;
|
||||
if ($iteminformation) {
|
||||
my $sth=$dbh->prepare("select * from issues where (itemnumber='$iteminformation->{'itemnumber'}') and (returndate is null)");
|
||||
$sth->execute;
|
||||
my ($currentborrower) = currentborrower($env, $iteminformation->{'itemnumber'}, $dbh);
|
||||
($borrower)=getpatroninformation($env,$currentborrower,0);
|
||||
|
||||
my @datearr = localtime(time);
|
||||
my $dateret = (1900+$datearr[5])."-".$datearr[4]."-".$datearr[3];
|
||||
my $query = "update issues set returndate = now(), branchcode ='$env->{'branchcode'}' where (borrowernumber = $borrower->{'borrowernumber'}) and (itemnumber = $iteminformation->{'itemnumber'}) and (returndate is null)";
|
||||
my $sth = $dbh->prepare($query);
|
||||
$sth->execute;
|
||||
$sth->finish;
|
||||
updatelastseen($env,$dbh,$iteminformation->{'itemnumber'});
|
||||
|
||||
|
||||
# check for overdue fine
|
||||
|
||||
$overduecharge;
|
||||
$sth=$dbh->prepare("select * from accountlines where (borrowernumber=$borrower->{'borrowernumber'}) and (itemnumber = $iteminformation->{'itemnumber'}) and (accounttype='FU' or accounttype='O')");
|
||||
$sth->execute;
|
||||
# alter fine to show that the book has been returned
|
||||
if (my $data = $sth->fetchrow_hashref) {
|
||||
my $usth=$dbh->prepare("update accountlines set accounttype='F' where (borrowernumber=$borrower->{'borrowernumber'}) and (itemnumber=$iteminformation->{'itemnumber'}) and (acccountno='$data->{'accountno'}')");
|
||||
$usth->execute();
|
||||
$usth->finish();
|
||||
$overduecharge=$data->{'amountoutstanding'};
|
||||
}
|
||||
$sth->finish;
|
||||
# check for charge made for lost book
|
||||
$sth=$dbh->prepare("select * from accountlines where (borrowernumber=$borrower->{'borrowernumber'}) and (itemnumber = $iteminformation->{'itemnumber'}) and (accounttype='L')");
|
||||
$sth->execute;
|
||||
if (my $data = $sth->fetchrow_hashref) {
|
||||
# writeoff this amount
|
||||
my $offset;
|
||||
my $amount = $data->{'amount'};
|
||||
my $acctno = $data->{'accountno'};
|
||||
my $amountleft;
|
||||
if ($data->{'amountoutstanding'} == $amount) {
|
||||
$offset = $data->{'amount'};
|
||||
$amountleft = 0;
|
||||
} else {
|
||||
$offset = $amount - $data->{'amountoutstanding'};
|
||||
$amountleft = $data->{'amountoutstanding'} - $amount;
|
||||
}
|
||||
my $uquery = "update accountlines
|
||||
set accounttype = 'LR',amountoutstanding='0'
|
||||
where (borrowernumber = $borrower->{'borrowernumber'})
|
||||
and (itemnumber = $iteminformation->{'itemnumber'})
|
||||
and (accountno = '$acctno') ";
|
||||
my $usth = $dbh->prepare($uquery);
|
||||
$usth->execute();
|
||||
$usth->finish;
|
||||
my $nextaccntno = C4::Accounts::getnextacctno($env,$borrower->{'borrowernumber'},$dbh);
|
||||
$uquery = "insert into accountlines
|
||||
(borrowernumber,accountno,date,amount,description,accounttype,amountoutstanding)
|
||||
values ($borrower->{'borrowernumber'},$nextaccntno,now(),0-$amount,'Book Returned',
|
||||
'CR',$amountleft)";
|
||||
$usth = $dbh->prepare($uquery);
|
||||
$usth->execute;
|
||||
$usth->finish;
|
||||
$uquery = "insert into accountoffsets
|
||||
(borrowernumber, accountno, offsetaccount, offsetamount)
|
||||
values ($borrower->{'borrowernumber'},$data->{'accountno'},$nextaccntno,$offset)";
|
||||
$usth = $dbh->prepare($uquery);
|
||||
$usth->execute;
|
||||
$usth->finish;
|
||||
}
|
||||
$sth->finish;
|
||||
}
|
||||
$dbh->disconnect;
|
||||
UpdateStats($env,'branch','return','0','',$iteminformation->{'itemnumber'});
|
||||
return ($iteminformation, $borrower, $messages, $overduecharge);
|
||||
}
|
||||
|
||||
END { } # module clean-up code here (global destructor)
|
||||
Loading…
Reference in a new issue