|
Lines 39-44
use C4::Circulation qw/LostItem/;
Link Here
|
| 39 |
use Getopt::Long; |
39 |
use Getopt::Long; |
| 40 |
use C4::Log; |
40 |
use C4::Log; |
| 41 |
use Pod::Usage; |
41 |
use Pod::Usage; |
|
|
42 |
use Koha::Borrowers; |
| 42 |
|
43 |
|
| 43 |
my $lost; # key=lost value, value=num days. |
44 |
my $lost; # key=lost value, value=num days. |
| 44 |
my ($charge, $verbose, $confirm, $quiet); |
45 |
my ($charge, $verbose, $confirm, $quiet); |
|
Lines 48-84
my $borrower_category = [];
Link Here
|
| 48 |
my $skip_borrower_category = []; |
49 |
my $skip_borrower_category = []; |
| 49 |
my $help=0; |
50 |
my $help=0; |
| 50 |
my $man=0; |
51 |
my $man=0; |
|
|
52 |
my $list_categories = 0; |
| 51 |
|
53 |
|
| 52 |
GetOptions( |
54 |
GetOptions( |
| 53 |
'lost=s%' => \$lost, |
55 |
'lost=s%' => \$lost, |
| 54 |
'c|charge=s' => \$charge, |
56 |
'c|charge=s' => \$charge, |
| 55 |
'confirm' => \$confirm, |
57 |
'confirm' => \$confirm, |
| 56 |
'verbose' => \$verbose, |
58 |
'v|verbose' => \$verbose, |
| 57 |
'quiet' => \$quiet, |
59 |
'quiet' => \$quiet, |
| 58 |
'maxdays=s' => \$endrange, |
60 |
'maxdays=s' => \$endrange, |
| 59 |
'mark-returned' => \$mark_returned, |
61 |
'mark-returned' => \$mark_returned, |
| 60 |
'help' => \$help, |
62 |
'h|help' => \$help, |
| 61 |
'man|manual' => \$man, |
63 |
'man|manual' => \$man, |
| 62 |
'category=s' => $borrower_category, |
64 |
'category=s' => $borrower_category, |
| 63 |
'skip-category=s' => $skip_borrower_category |
65 |
'skip-category=s' => $skip_borrower_category, |
|
|
66 |
'list-categories' => \$list_categories, |
| 64 |
); |
67 |
); |
| 65 |
|
68 |
|
| 66 |
if ( $man ) { |
69 |
if ( $man ) { |
| 67 |
pod2usage( -verbose => 2 ); |
70 |
pod2usage( -verbose => 2 |
| 68 |
exit; |
71 |
-exitval => 0 |
|
|
72 |
); |
| 69 |
} |
73 |
} |
| 70 |
|
74 |
|
| 71 |
if ( $help ) { |
75 |
if ( $help ) { |
| 72 |
pod2usage(1); |
76 |
pod2usage( -verbose => 1, |
| 73 |
exit; |
77 |
-exitval => 0 |
|
|
78 |
); |
| 79 |
} |
| 80 |
|
| 81 |
if ( scalar @$borrower_category && scalar @$skip_borrower_category) { |
| 82 |
pod2usage( -verbose => 1, |
| 83 |
-message => "The options --category and --skip-category are muually exclusive.\n" |
| 84 |
. "Use one or the other.", |
| 85 |
-exitval => 1 |
| 86 |
); |
| 87 |
} |
| 88 |
|
| 89 |
if ( $list_categories ) { |
| 90 |
my @categories = sort map { uc $_->[0] } @{ C4::Context->dbh->selectall_arrayref(q|SELECT categorycode FROM categories|) }; |
| 91 |
print "\nBorrowrer Categories: " . join( " ", @categories ) . "\n\n"; |
| 92 |
exit 0; |
| 74 |
} |
93 |
} |
| 75 |
|
94 |
|
| 76 |
=head1 SYNOPSIS |
95 |
=head1 SYNOPSIS |
| 77 |
|
96 |
|
| 78 |
longoverdue.pl [ --help | -h | --man ] |
97 |
longoverdue.pl [ --help | -h | --man | --list-categories ] |
| 79 |
longoverdue.pl --lost | -l DAYS=LOST_CODE [ --charge | -c CHARGE_CODE ] [ --verbose | -v ] [ --quiet ] |
98 |
longoverdue.pl --lost | -l DAYS=LOST_CODE [ --charge | -c CHARGE_CODE ] [ --verbose | -v ] [ --quiet ] |
| 80 |
[ --maxdays MAX_DAYS ] [ --mark-returned ] [ --category BORROWER_CATEGOERY ] ... |
99 |
[ --maxdays MAX_DAYS ] [ --mark-returned ] [ --category BORROWER_CATEGORY ] ... |
| 81 |
[ --skip-category BORROWER_CATEGOERY ] ... [ --commit ] |
100 |
[ --skip-category BORROWER_CATEGOERY ] ... |
|
|
101 |
[ --commit ] |
| 82 |
|
102 |
|
| 83 |
|
103 |
|
| 84 |
WARNING: Flippant use of this script could set all or most of the items in your catalog to Lost and charge your |
104 |
WARNING: Flippant use of this script could set all or most of the items in your catalog to Lost and charge your |
|
Lines 125-135
When an item is marked lost, remove it from the borrowers issued items.
Link Here
|
| 125 |
|
145 |
|
| 126 |
=item B<--category> |
146 |
=item B<--category> |
| 127 |
|
147 |
|
| 128 |
Act on the listed borrower category code (borrowers.categorycode). Exclude all others. This may be specified multiple times to include multiple categories. |
148 |
Act on the listed borrower category code (borrowers.categorycode). |
|
|
149 |
Exclude all others. This may be specified multiple times to include multiple categories. |
| 150 |
May not be used with B<--skip-category> |
| 129 |
|
151 |
|
| 130 |
=item B<--skip-category> |
152 |
=item B<--skip-category> |
| 131 |
|
153 |
|
| 132 |
Act on all available borrower category codes, except those listed. This may be specified multiple times, to exclude multiple categories. |
154 |
Act on all available borrower category codes, except those listed. |
|
|
155 |
This may be specified multiple times, to exclude multiple categories. |
| 156 |
May not be used with B<--category> |
| 157 |
|
| 158 |
=item B<--list-categories> |
| 159 |
|
| 160 |
List borrower categories available for use by B<--category> or |
| 161 |
B<--skip-category>, and exit. |
| 133 |
|
162 |
|
| 134 |
=item B<--help | -h> |
163 |
=item B<--help | -h> |
| 135 |
|
164 |
|
|
Lines 141-149
Display entire manual and exit.
Link Here
|
| 141 |
|
170 |
|
| 142 |
=back |
171 |
=back |
| 143 |
|
172 |
|
| 144 |
All 'category' options will be applied before any 'skip-category' options, meaning that the only categories available to skip |
|
|
| 145 |
are those which have already been specified on the command line. |
| 146 |
|
| 147 |
=cut |
173 |
=cut |
| 148 |
|
174 |
|
| 149 |
=head1 Description |
175 |
=head1 Description |
|
Lines 184-191
if ( ! defined($lost) ) {
Link Here
|
| 184 |
$lost->{$longoverdue_days} = $longoverdue_value; |
210 |
$lost->{$longoverdue_days} = $longoverdue_value; |
| 185 |
} |
211 |
} |
| 186 |
else { |
212 |
else { |
| 187 |
pod2usage(1); |
213 |
pod2usage( { |
| 188 |
die "ERROR: No --lost (-l) option defined"; |
214 |
-exitval => 1, |
|
|
215 |
-msg => q|ERROR: No --lost (-l) option defined|, |
| 216 |
} ); |
| 189 |
} |
217 |
} |
| 190 |
} |
218 |
} |
| 191 |
if ( ! defined($charge) ) { |
219 |
if ( ! defined($charge) ) { |
|
Lines 223-243
sub longoverdue_sth {
Link Here
|
| 223 |
return C4::Context->dbh->prepare($query); |
251 |
return C4::Context->dbh->prepare($query); |
| 224 |
} |
252 |
} |
| 225 |
|
253 |
|
| 226 |
# The following two functions can and should replaced by a call to |
254 |
sub check_user_categories { |
| 227 |
# Koha::Database. |
255 |
|
| 228 |
sub borrower_categories_sth { |
256 |
my $categories = shift; |
| 229 |
my $query = "select distinct categorycode from categories"; |
257 |
my $test_categories = shift; |
| 230 |
return C4::Context->dbh->prepare($query); |
258 |
my $category_label = shift; |
| 231 |
} |
259 |
my %good = map { $_ => 1 } @$categories; |
| 232 |
|
260 |
my @bad_categories = grep { ! $good{ uc $_ } } @$test_categories; |
| 233 |
sub defined_borrower_categories { |
261 |
|
| 234 |
my $sth = borrower_categories_sth(); |
262 |
if ( scalar @bad_categories ) { |
| 235 |
my @categories = (); |
263 |
my $error = "$category_label: category/categories '" |
| 236 |
$sth->execute(); |
264 |
. join( ' ', @bad_categories ) |
| 237 |
CATEGORY: while ( my $row = $sth->fetchrow_hashref ) { |
265 |
. "' not in the available borrower cateogories: [ " |
| 238 |
push @categories, uc( $row->{categorycode} ); |
266 |
. join( ' ', @$categories ) |
|
|
267 |
. " ]"; |
| 268 |
pod2usage( '-verbose' => 1 |
| 269 |
, '-exitval' => 1 |
| 270 |
, '-message' => $error |
| 271 |
); |
| 239 |
} |
272 |
} |
| 240 |
return @categories; |
|
|
| 241 |
} |
273 |
} |
| 242 |
|
274 |
|
| 243 |
# returns a hash of borrower category codes to test for long-overdue-ness. |
275 |
# returns a hash of borrower category codes to test for long-overdue-ness. |
|
Lines 248-279
sub get_borrower_categories {
Link Here
|
| 248 |
|
280 |
|
| 249 |
return () unless ( scalar @$borrower_category || scalar @$skip_borrower_category ); |
281 |
return () unless ( scalar @$borrower_category || scalar @$skip_borrower_category ); |
| 250 |
|
282 |
|
| 251 |
my @categories = defined_borrower_categories(); |
283 |
my $dbh = C4::Context->dbh; |
|
|
284 |
my @categories = map { uc $_->[0] } @{ $dbh->selectall_arrayref(q|SELECT categorycode FROM categories|) }; |
| 252 |
if( @$borrower_category ) { |
285 |
if( @$borrower_category ) { |
|
|
286 |
check_user_categories( \@categories, $borrower_category, "--category" ); |
| 253 |
my %borcat = map { ( uc($_) => 1 ) } @$borrower_category; |
287 |
my %borcat = map { ( uc($_) => 1 ) } @$borrower_category; |
| 254 |
@categories = grep { $borcat{$_} } @categories; |
288 |
@categories = grep { $borcat{$_} } @categories; |
| 255 |
} |
289 |
} |
| 256 |
if( @$skip_borrower_category ) { |
290 |
if( @$skip_borrower_category ) { |
|
|
291 |
check_user_categories( \@categories, $skip_borrower_category, "--skip-category" ); |
| 257 |
my %skip_borcat = map { ( uc($_) => 1 ) } @$skip_borrower_category; |
292 |
my %skip_borcat = map { ( uc($_) => 1 ) } @$skip_borrower_category; |
| 258 |
@categories = grep { ! $skip_borcat{$_} } @categories; |
293 |
@categories = grep { ! $skip_borcat{$_} } @categories; |
| 259 |
} |
294 |
} |
| 260 |
return map { $_ => 1 } @categories; |
295 |
return map { $_ => 1 } @categories; |
| 261 |
} |
296 |
} |
| 262 |
|
297 |
|
| 263 |
# TODO: category handling should be more user friendly: |
|
|
| 264 |
# * Warn if a category specified using --category or |
| 265 |
# --skip-category is not in the categories table |
| 266 |
# * Add --list-categories argument so that you don't |
| 267 |
# need to bring up the staff client or koha-mysql to |
| 268 |
# find the valid borrower categories. |
| 269 |
|
| 270 |
my %category_to_process = get_borrower_categories( $borrower_category, $skip_borrower_category ); |
298 |
my %category_to_process = get_borrower_categories( $borrower_category, $skip_borrower_category ); |
| 271 |
my $filter_borrower_categories = ( scalar @$borrower_category || scalar @$skip_borrower_category ); |
299 |
my $filter_borrower_categories = ( scalar @$borrower_category || scalar @$skip_borrower_category ); |
| 272 |
|
300 |
|
| 273 |
#FIXME - Should add a 'system' user and get suitable userenv for it for logging, etc. |
|
|
| 274 |
|
| 275 |
my $count; |
301 |
my $count; |
| 276 |
# my @ranges = map { |
|
|
| 277 |
my @report; |
302 |
my @report; |
| 278 |
my $total = 0; |
303 |
my $total = 0; |
| 279 |
my $i = 0; |
304 |
my $i = 0; |
|
Lines 295-301
foreach my $startrange (sort keys %$lost) {
Link Here
|
| 295 |
$count=0; |
320 |
$count=0; |
| 296 |
ITEM: while (my $row=$sth_items->fetchrow_hashref) { |
321 |
ITEM: while (my $row=$sth_items->fetchrow_hashref) { |
| 297 |
if( $filter_borrower_categories ) { |
322 |
if( $filter_borrower_categories ) { |
| 298 |
my $category = uc Koha::Database->new()->schema->resultset('Borrower')->find( $row->{borrowernumber} )->get_column('categorycode'); |
323 |
my $category = uc Koha::Borrowers->find( $row->{borrowernumber} )->categorycode(); |
| 299 |
next ITEM unless ( $category_to_process{ $category } ); |
324 |
next ITEM unless ( $category_to_process{ $category } ); |
| 300 |
} |
325 |
} |
| 301 |
printf ("Due %s: item %5s from borrower %5s to lost: %s\n", $row->{date_due}, $row->{itemnumber}, $row->{borrowernumber}, $lostvalue) if($verbose); |
326 |
printf ("Due %s: item %5s from borrower %5s to lost: %s\n", $row->{date_due}, $row->{itemnumber}, $row->{borrowernumber}, $lostvalue) if($verbose); |
| 302 |
- |
|
|