3 # This file is part of Koha.
5 # Koha is free software; you can redistribute it and/or modify it
6 # under the terms of the GNU General Public License as published by
7 # the Free Software Foundation; either version 3 of the License, or
8 # (at your option) any later version.
10 # Koha is distributed in the hope that it will be useful, but
11 # WITHOUT ANY WARRANTY; without even the implied warranty of
12 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 # GNU General Public License for more details.
15 # You should have received a copy of the GNU General Public License
16 # along with Koha; if not, see <http://www.gnu.org/licenses>.
20 use Getopt::Long qw( GetOptions );
21 use Pod::Usage qw( pod2usage );
23 use Koha::Script -cron;
28 my $dbh = C4::Context->dbh();
31 target_items => q|SELECT itemnumber, biblionumber from items|
51 'where=s' => $OPTIONS->{where}
52 , 'v|verbose' => sub { $OPTIONS->{flags}->{verbose} = 1 }
53 , 'V|version' => sub { $OPTIONS->{flags}->{version} = 1 }
54 , 'h|help' => sub { $OPTIONS->{flags}->{help} = 1 }
55 , 'm|manual' => sub { $OPTIONS->{flags}->{manual} = 1 }
56 , 'c|commit' => sub { $OPTIONS->{flags}->{commit} = 1 } # aka DO-EET!
59 my @where = @{ $OPTIONS->{where} };
61 pod2usage( -verbose => 2 ) if $OPTIONS->{flags}->{manual};
62 pod2usage( -verbose => 1 ) if $OPTIONS->{flags}->{help};
63 pod2usage( -verbose => 1 -msg => 'You must supply at least one --where option' ) if scalar @where == 0;
66 say @_ if $OPTIONS->{flags}->{verbose};
69 my $where_clause = ' where ' . join ( " and ", @where );
71 verbose "Where statement: $where_clause";
73 # FIXME Use Koha::Items instead
74 $GLOBAL->{sth}->{target_items} = $dbh->prepare( $query->{target_items} . $where_clause );
75 $GLOBAL->{sth}->{target_items}->execute();
77 DELITEM: while ( my $item = $GLOBAL->{sth}->{target_items}->fetchrow_hashref() ) {
79 my $item_object = Koha::Items->find($item->{itemnumber});
80 my $safe_to_delete = $item_object->safe_to_delete;
81 if( $safe_to_delete ) {
82 $item_object->safe_delete
83 if $OPTIONS->{flags}->{commit};
84 verbose "Deleting '$item->{itemnumber}'";
86 verbose sprintf "Item '%s' (Barcode: '%s', Title: '%s') not deleted: %s",
88 $item_object->barcode,
89 $item_object->biblio->title,
90 @{$safe_to_delete->messages}[0]->message;
96 delete_items.pl - A batch item deletion tool, which generates a query against the items database and deletes the items matching the criteria specified in the command line arguments.
100 delete_items.pl [--help|--manual]
102 delete_items.pl [--verbose] --where "I<SQL CONDITIONAL EXPRESSION>" ... [--commit]
112 Show the brief help information.
116 Read the manual, with examples.
120 Send the "WHERE" clause generated by the collected C<--where>
121 arguments, as well as items affected to Standard Out.
125 The C<--where> option may called multiple times. The following argument
126 must be a syntactically valid SQL statement which is part of the C<WHERE>
127 clause querying the items table. These are joined by C<AND>.
131 No items will be deleted unless the C<--commit> flag is present.
140 The following is an example of this script:
142 delete_items.pl --where "items.withdrawn ! 0" --where "items.withdrawn_on < $(date --date="13 month ago" --rfc-3339=date)" --commit
144 delete_items.pl --where "itemlost >= '1'" --where "itemlost <='4'" --where "itemlost_on < '2014-04-28'" --commit
151 This is a lightweight batch deletion tool for items, suitable for running in a cron job.
158 Barton Chittenden <barton@bywatersolutions.com>