misc/maintenance/touch_all_items.pl

   1 #!/usr/bin/perl
   2 #
   3 # Copyright (C) 2011 ByWater Solutions
   4 #
   5 # This file is part of Koha.
   6 #
   7 # Koha is free software; you can redistribute it and/or modify it
   8 # under the terms of the GNU General Public License as published by
   9 # the Free Software Foundation; either version 3 of the License, or
  10 # (at your option) any later version.
  11 #
  12 # Koha is distributed in the hope that it will be useful, but
  13 # WITHOUT ANY WARRANTY; without even the implied warranty of
  14 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  15 # GNU General Public License for more details.
  16 #
  17 # You should have received a copy of the GNU General Public License
  18 # along with Koha; if not, see <http://www.gnu.org/licenses>.
  19
  20 use strict;
  21 use warnings;
  22
  23 # possible modules to use
  24 use Getopt::Long qw( GetOptions );
  25
  26 use Koha::Script;
  27 use C4::Context;
  28 use Koha::Items;
  29 use Pod::Usage qw( pod2usage );
  30
  31
  32 sub usage {
  33     pod2usage( -verbose => 2 );
  34     exit;
  35 }
  36
  37 # Database handle
  38 my $dbh = C4::Context->dbh;
  39
  40 # Benchmarking variables
  41 my $startime = time();
  42 my $goodcount = 0;
  43 my $badcount = 0;
  44 my $totalcount = 0;
  45
  46 # Options
  47 my $verbose;
  48 my $whereclause = '';
  49 my $help;
  50 my $outfile;
  51
  52 GetOptions(
  53   'o|output:s' => \$outfile,
  54   'v' => \$verbose,
  55   'where:s' => \$whereclause,
  56   'help|h'   => \$help,
  57 );
  58
  59 usage() if $help;
  60
  61 if ($whereclause) {
  62    $whereclause = "WHERE $whereclause";
  63 }
  64
  65 # output log or STDOUT
  66 my $fh;
  67 if (defined $outfile) {
  68    open ($fh, '>', $outfile) || die ("Cannot open output file");
  69 } else {
  70    open($fh, '>&', \*STDOUT) || die ("Couldn't duplicate STDOUT: $!");
  71 }
  72
  73 # FIXME Would be better to call Koha::Items->search here
  74 my $sth_fetch = $dbh->prepare("SELECT biblionumber, itemnumber, itemcallnumber FROM items $whereclause");
  75 $sth_fetch->execute();
  76
  77 # fetch info from the search
  78 while (my ($biblionumber, $itemnumber, $itemcallnumber) = $sth_fetch->fetchrow_array){
  79
  80   my $item = Koha::Items->find($itemnumber);
  81   next unless $item;
  82
  83   for my $c (qw( itemcallnumber cn_source ) ){
  84       $item->make_column_dirty($c);
  85   }
  86
  87   eval { $item->store };
  88   my $modok = $@ ? 0 : 1;
  89
  90   if ($modok) {
  91      $goodcount++;
  92      print $fh "Touched item $itemnumber\n" if (defined $verbose);
  93   } else {
  94      $badcount++;
  95      print $fh "ERROR WITH ITEM $itemnumber !!!!\n";
  96   }
  97
  98   $totalcount++;
  99
 100 }
 101 close($fh);
 102
 103 # Benchmarking
 104 my $endtime = time();
 105 my $time = $endtime-$startime;
 106 my $accuracy = $totalcount ? ($goodcount / $totalcount) * 100 : 0; # this is a percentage
 107 my $averagetime = 0;
 108 $averagetime = $time / $totalcount if $totalcount;
 109 print "Good: $goodcount, Bad: $badcount (of $totalcount) in $time seconds\n";
 110 printf "Accuracy: %.2f%%\nAverage time per record: %.6f seconds\n", $accuracy, $averagetime if (defined $verbose);
 111
 112 =head1 NAME
 113
 114 touch_all_items.pl
 115
 116 =head1 SYNOPSIS
 117
 118   touch_all_items.pl
 119   touch_all_items.pl -v
 120   touch_all_items.pl --where=STRING
 121
 122 =head1 DESCRIPTION
 123
 124 When changes are made to ModItem (or the routines that are called by it), it is
 125 sometimes necessary to run ModItem on all or some records in the catalog when
 126 upgrading. This script does that.
 127
 128 =over 8
 129
 130 =item B<--help>
 131
 132 Prints this help
 133
 134 =item B<-v>
 135
 136 Provide verbose log information.
 137
 138 =item B<--where>
 139
 140 Limits the search with a user-specified WHERE clause.
 141
 142 =back
 143
 144 =cut
 145