1 package C4::Maintainance; #assumes C4/Maintainance
3 #package to deal with marking up output
6 # Copyright 2000-2002 Katipo Communications
8 # This file is part of Koha.
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
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.
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
28 use vars qw($VERSION @ISA @EXPORT);
30 # set the version for version checking
35 C4::Maintenance - Koha catalog maintenance functions
43 The functions in this module perform various catalog-maintenance
44 functions, including deleting and undeleting books, fixing
45 miscategorized items, etc.
54 @EXPORT = qw(&listsubjects &updatesub &shiftgroup &deletedbib &undeletebib
59 ($count, $results) = &listsubjects($subject, $n, $offset);
61 Finds the subjects that begin with C<$subject> in the bibliosubject
62 table of the Koha database.
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}>.
69 Probably the only interesting field in C<$results->[$i]> is
70 C<subject>, the subject in question.
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.
77 # FIXME - This API is bogus. The way it's currently used, it should
78 # just return a list of strings.
80 my ($sub,$num,$offset)=@_;
81 my $dbh = C4::Context->dbh;
82 my $query="Select * from bibliosubject where subject like ? group by subject";
84 # FIXME - Make $num and $offset optional.
85 # If $num was given, make sure $offset was, too.
88 push(@bind,$offset,$num);
90 my $sth=$dbh->prepare($query);
95 while (my $data=$sth->fetchrow_hashref){
100 return($i,\@results);
105 &updatesub($newsubject, $oldsubject);
107 Renames a subject from C<$oldsubject> to C<$newsubject> in the
108 bibliosubject table of the Koha database.
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);
122 &shiftgroup($biblionumber, $biblioitemnumber);
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.
132 my $dbh = C4::Context->dbh;
133 my $sth=$dbh->prepare("update biblioitems set biblionumber=? where biblioitemnumber=?");
134 $sth->execute($bib,$bi);
136 $sth=$dbh->prepare("update items set biblionumber=? where biblioitemnumber=?");
137 $sth->execute($bib,$bi);
143 ($count, $results) = &deletedbib($title);
145 Looks up deleted books whose title begins with C<$title>.
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>.
156 my $dbh = C4::Context->dbh;
157 my $sth=$dbh->prepare("Select * from deletedbiblio where title like ? order by title");
158 $sth->execute("$title%");
161 while (my $data=$sth->fetchrow_hashref){
166 return($i,\@results);
171 &undeletebib($biblionumber);
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.
181 my $dbh = C4::Context->dbh;
182 my $sth=$dbh->prepare("select * from deletedbiblio where biblionumber=?");
184 if (my @data=$sth->fetchrow_array){
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 $query .= ("?," x $#data);
192 $sth=$dbh->prepare($query);
193 $sth->execute(@data);
196 $sth=$dbh->prepare("Delete from deletedbiblio where biblionumber=?");
203 &updatetype($biblioitemnumber, $itemtype);
205 Changes the type of the item with the given biblioitemnumber to be
212 my $dbh = C4::Context->dbh;
213 my $sth=$dbh->prepare("Update biblioitems set itemtype=? where biblioitemnumber=?");
214 $sth->execute($type,$bi);
218 END { } # module clean-up code here (global destructor)
227 Koha Developement team <info@koha.org>