C4/Maintainance.pm

   1 package C4::Maintainance; #assumes C4/Maintainance
   2
   3 #package to deal with marking up output
   4
   5
   6 # Copyright 2000-2002 Katipo Communications
   7 #
   8 # This file is part of Koha.
   9 #
  10 # Koha is free software; you can redistribute it and/or modify it under the
  11 # terms of the GNU General Public License as published by the Free Software
  12 # Foundation; either version 2 of the License, or (at your option) any later
  13 # version.
  14 #
  15 # Koha is distributed in the hope that it will be useful, but WITHOUT ANY
  16 # WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
  17 # A PARTICULAR PURPOSE.  See the GNU General Public License for more details.
  18 #
  19 # You should have received a copy of the GNU General Public License along with
  20 # Koha; if not, write to the Free Software Foundation, Inc., 59 Temple Place,
  21 # Suite 330, Boston, MA  02111-1307 USA
  22
  23 use strict;
  24 use C4::Context;
  25
  26 require Exporter;
  27
  28 use vars qw($VERSION @ISA @EXPORT);
  29
  30 # set the version for version checking
  31 $VERSION = 0.01;
  32
  33 =head1 NAME
  34
  35 C4::Maintenance - Koha catalog maintenance functions
  36
  37 =head1 SYNOPSIS
  38
  39   use C4::Maintenance;
  40
  41 =head1 DESCRIPTION
  42
  43 The functions in this module perform various catalog-maintenance
  44 functions, including deleting and undeleting books, fixing
  45 miscategorized items, etc.
  46
  47 =head1 FUNCTIONS
  48
  49 =over 2
  50
  51 =cut
  52
  53 @ISA = qw(Exporter);
  54 @EXPORT = qw(&listsubjects &updatesub &shiftgroup &deletedbib &undeletebib
  55 &updatetype &logaction);
  56
  57 =item listsubjects
  58
  59   ($count, $results) = &listsubjects($subject, $n, $offset);
  60
  61 Finds the subjects that begin with C<$subject> in the bibliosubject
  62 table of the Koha database.
  63
  64 C<&listsubjects> returns a two-element array. C<$results> is a
  65 reference-to-array, in which each element is a reference-to-hash
  66 giving information about the given subject. C<$count> is the number of
  67 elements in C<@{$results}>.
  68
  69 Probably the only interesting field in C<$results->[$i]> is
  70 C<subject>, the subject in question.
  71
  72 C<&listsubject> returns up to C<$n> items, starting at C<$offset>. If
  73 C<$n> is 0, it will return all matching subjects.
  74
  75 =cut
  76 #'
  77 # FIXME - This API is bogus. The way it's currently used, it should
  78 # just return a list of strings.
  79 sub listsubjects {
  80   my ($sub,$num,$offset)=@_;
  81   my $dbh = C4::Context->dbh;
  82   my $query="Select * from bibliosubject where subject like ? group by subject";
  83   my @bind = ("$sub%");
  84   # FIXME - Make $num and $offset optional.
  85   # If $num was given, make sure $offset was, too.
  86   if ($num != 0){
  87     $query.=" limit ?,?";
  88     push(@bind,$offset,$num);
  89   }
  90   my $sth=$dbh->prepare($query);
  91 #  print $query;
  92   $sth->execute(@bind);
  93   my @results;
  94   my $i=0;
  95   while (my $data=$sth->fetchrow_hashref){
  96     $results[$i]=$data;
  97     $i++;
  98   }
  99   $sth->finish;
 100   return($i,\@results);
 101 }
 102
 103 =item updatesub
 104
 105   &updatesub($newsubject, $oldsubject);
 106
 107 Renames a subject from C<$oldsubject> to C<$newsubject> in the
 108 bibliosubject table of the Koha database.
 109
 110 =cut
 111 #'
 112 sub updatesub{
 113   my ($sub,$oldsub)=@_;
 114   my $dbh = C4::Context->dbh;
 115   my $sth=$dbh->prepare("update bibliosubject set subject=? where subject=?");
 116   $sth->execute($sub,$oldsub);
 117   $sth->finish;
 118 }
 119
 120 =item shiftgroup
 121
 122   &shiftgroup($biblionumber, $biblioitemnumber);
 123
 124 Changes the biblionumber associated with a given biblioitem.
 125 C<$biblioitemnumber> is the number of the biblioitem to change.
 126 C<$biblionumber> is the biblionumber to associate it with.
 127
 128 =cut
 129 #'
 130 sub shiftgroup{
 131   my ($bib,$bi)=@_;
 132   my $dbh = C4::Context->dbh;
 133   my $sth=$dbh->prepare("update biblioitems set biblionumber=? where biblioitemnumber=?");
 134   $sth->execute($bib,$bi);
 135   $sth->finish;
 136   $sth=$dbh->prepare("update items set biblionumber=? where biblioitemnumber=?");
 137   $sth->execute($bib,$bi);
 138   $sth->finish;
 139 }
 140
 141 =item deletedbib
 142
 143   ($count, $results) = &deletedbib($title);
 144
 145 Looks up deleted books whose title begins with C<$title>.
 146
 147 C<&deletedbib> returns a two-element list. C<$results> is a
 148 reference-to-array; each element is a reference-to-hash whose keys are
 149 the fields of the deletedbiblio table in the Koha database. C<$count>
 150 is the number of elements in C<$results>.
 151
 152 =cut
 153 #'
 154 sub deletedbib{
 155   my ($title)=@_;
 156   my $dbh = C4::Context->dbh;
 157   my $sth=$dbh->prepare("Select * from deletedbiblio where title like ? order by title");
 158   $sth->execute("$title%");
 159   my @results;
 160   my $i=0;
 161   while (my $data=$sth->fetchrow_hashref){
 162     $results[$i]=$data;
 163     $i++;
 164   }
 165   $sth->finish;
 166   return($i,\@results);
 167 }
 168
 169 =item undeletebib
 170
 171   &undeletebib($biblionumber);
 172
 173 Undeletes a book. C<&undeletebib> looks up the book with the given
 174 biblionumber in the deletedbiblio table of the Koha database, and
 175 moves its entry to the biblio table.
 176
 177 =cut
 178 #'
 179 sub undeletebib{
 180   my ($bib)=@_;
 181   my $dbh = C4::Context->dbh;
 182   my $sth=$dbh->prepare("select * from deletedbiblio where biblionumber=?");
 183   $sth->execute($bib);
 184   if (my @data=$sth->fetchrow_array){
 185     $sth->finish;
 186     # FIXME - Doesn't this keep the same biblionumber? Isn't this
 187     # forbidden by the definition of 'biblio'? Or doesn't it matter?
 188     my $query="INSERT INTO biblio VALUES (";
 189    my $count = @data;
 190     $query .= ("?," x $count);
 191     $query=~ s/\,$/\)/;
 192     #   print $query;
 193     $sth=$dbh->prepare($query);
 194     $sth->execute(@data);
 195     $sth->finish;
 196   }
 197   $sth=$dbh->prepare("DELETE FROM deletedbiblio WHERE biblionumber=?");
 198   $sth->execute($bib);
 199   $sth->finish;
 200 }
 201
 202 =item updatetype
 203
 204   &updatetype($biblioitemnumber, $itemtype);
 205
 206 Changes the type of the item with the given biblioitemnumber to be
 207 C<$itemtype>.
 208
 209 =cut
 210 #'
 211 sub updatetype{
 212   my ($bi,$type)=@_;
 213   my $dbh = C4::Context->dbh;
 214   my $sth=$dbh->prepare("Update biblioitems set itemtype=? where biblioitemnumber=?");
 215   $sth->execute($type,$bi);
 216   $sth->finish;
 217 }
 218
 219 END { }       # module clean-up code here (global destructor)
 220
 221 1;
 222 __END__
 223
 224 =back
 225
 226 =head1 AUTHOR
 227
 228 Koha Developement team <info@koha.org>
 229
 230 =cut