2 #-----------------------------------
3 # Script Name: circstats.pl
6 # Author: Stephen Hedges (shedges@skemotah.com)
8 # This script creates a comma-separated value file of
9 # circulation statistics for any given month and year.
10 # The statistics are grouped by itemtype, then by branch,
11 # then by issues and renewals.
13 # 1.0 2006/02/07: original version
14 #-----------------------------------
15 # Contributed 2003-6 by Skemotah Solutions
17 # This file is part of Koha.
19 # Koha is free software; you can redistribute it and/or modify it under the
20 # terms of the GNU General Public License as published by the Free Software
21 # Foundation; either version 2 of the License, or (at your option) any later
24 # Koha is distributed in the hope that it will be useful, but WITHOUT ANY
25 # WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
26 # A PARTICULAR PURPOSE. See the GNU General Public License for more details.
28 # You should have received a copy of the GNU General Public License along with
29 # Koha; if not, write to the Free Software Foundation, Inc., 59 Temple Place,
30 # Suite 330, Boston, MA 02111-1307 USA
35 # UNCOMMENT the following lines if running from a command line
36 # print "THIS SCRIPT produces a comma-separated values file of circulation statistics for a given month and year.\n\nDo you wish to continue? (y/n) ";
37 # chomp($_ = <STDIN>);
40 # UNCOMMENT the following lines if getting old stats (but be aware that renewal numbers are affected by deletes)
41 # YOU WILL also need to modify the SQLs to use these dates
43 # print "Get statistics for which month (1 to 12)? ";
44 # chomp($month = <STDIN>);
45 # die if ($month < 1 || $month > 12);
46 # print "Get statistics for which year (2000 to 2050)? ";
47 # chomp($year = <STDIN>);
48 # die if ($year < 2000 || $year > 2050);
50 open OUTFILE, ">circstats.csv" or die "Cannot open file circstats.csv: $!";
51 print OUTFILE "\"ccode\",\"branch\",\"issues\",\"renewals\"\n";
55 use Mail::Sendmail; # comment out 3 lines if not doing e-mail sending of file
56 use MIME::QuotedPrint;
58 # set the e-mail server -- comment out if not doing e-mail notices
59 unshift @{$Mail::Sendmail::mailcfg{'smtp'}} , 'localhost';
60 # set your own mail server name here
62 my $dbh = C4::Context->dbh;
63 #my $sth1 = $dbh->prepare ("SELECT itemtype FROM itemtypes ORDER BY itemtype");
64 my $sth2 = $dbh->prepare ("SELECT branchcode, branchname FROM branches ORDER BY branchcode");
66 # number of checkouts for this library
67 my $sth3 = $dbh->prepare ("SELECT COUNT(*) FROM biblioitems,items,statistics WHERE biblioitems.biblioitemnumber=items.biblioitemnumber AND statistics.itemnumber=items.itemnumber AND items.ccode=? AND YEAR(statistics.datetime)=YEAR(SUBDATE(CURDATE(),INTERVAL 1 MONTH)) AND MONTH(statistics.datetime)=MONTH(SUBDATE(CURDATE(),INTERVAL 1 MONTH)) AND statistics.branch=? AND statistics.type='issue' GROUP BY ccode");
69 # number of renewals for this library
70 my $sth4 = $dbh->prepare ("SELECT COUNT(statistics.itemnumber) FROM statistics,items,biblioitems
71 WHERE YEAR(statistics.datetime)=YEAR(SUBDATE(CURDATE(),INTERVAL 1 MONTH))
72 AND MONTH(statistics.datetime)=MONTH(SUBDATE(CURDATE(),INTERVAL 1 MONTH))
73 AND statistics.itemnumber=items.itemnumber
74 AND biblioitems.ccode=?
76 AND biblioitems.biblioitemnumber=items.biblioitemnumber
77 AND statistics.type='renew'
78 GROUP BY statistics.type");
80 # find the itemnumbers
81 my ($rowt,$rowb,$rowi,$rowr,$itemtype,$branchcode,$branchname,$issues,$renews,$line);
84 my ($ccode_count,@ccode_results) = GetCcodes;
86 #for my $ccode (@ccode_results);
87 # loop through every itemtype
88 #while ($rowt = $sth1->fetchrow_arrayref) {
89 for (my $i=0;$i<scalar(@ccode_results);$i++) {
90 #for my $ccode (@ccode_results) {
91 unless (!$ccode_results[$i]) {
93 # warn Dumper($ccode_results[$i]);
94 $itemtype = $ccode_results[$i]{'authorised_value'}; #$ccode->{authorised_value}; #rowt->[0];
95 $line = "\"$itemtype\"";
100 # find the number of issues per itemtype in this branch
101 while ($rowb = $sth2->fetchrow_arrayref) {
102 $branchcode = $rowb->[0];
103 $branchname = $rowb->[1];
104 $sth3->execute($itemtype,$branchcode); # find issues by itemtype per branch
105 $rowi = $sth3->fetchrow_arrayref;
106 $issues = $rowi->[0]; # count
107 unless ($issues) {$issues=""}
110 $sth4->execute($itemtype,$branchcode); # find reserves by itemtype per branch
111 $rowr = $sth4->fetchrow_arrayref; # count
112 $renews = $rowr->[0];
113 unless ($renews) {$renews=""}
116 # put the data in this line
117 $line = $line . ",\"$branchname\",\"$issues\",\"$renews\"";
118 # warn "LINE: $branchname $issues $renews\n";
122 $line = $line . "\n";
123 print OUTFILE "$line";
130 # send the outfile as an attachment to the library e-mail
133 from => $from_address,
135 subject => 'Circulation Statistics',
139 my $boundary = "====" . time() . "====";
140 $attachmail{'content-type'} = "multipart/mixed; boundary=\"$boundary\"";
142 my $attachmessage = "Attached is the file of circulation statistics for the previous month. Please open the statistics spreadsheet template for Page 1, open this file in a new spreadsheet, and paste the numbers from this file into the template.\n";
144 my $attachfile = "circstats.csv";
146 open (F, $attachfile) or die "Cannot read $attachfile: $!";
148 $attachmail{body} = encode_base64(<F>);
151 $boundary = '--'.$boundary;
152 $attachmail{body} = <<END_OF_BODY;
154 Content-Type: text/plain; charset="iso-8859-1"
155 Content-Transfer-Encoding: quoted-printable
159 Content-Type: application/octet-stream; name="circstats.csv"
160 Content-Transfer-Encoding: base64
161 Content-Disposition: attachment; filename="circstats.csv"
167 sendmail(%attachmail) || print "Error: $Mail::Sendmail::error\n";