Koha/C4/Maintainance.pm
2004-03-15 20:24:13 +00:00

231 lines
5.7 KiB
Perl

package C4::Maintainance; #assumes C4/Maintainance
#package to deal with marking up output
# Copyright 2000-2002 Katipo Communications
#
# This file is part of Koha.
#
# Koha is free software; you can redistribute it and/or modify it under the
# terms of the GNU General Public License as published by the Free Software
# Foundation; either version 2 of the License, or (at your option) any later
# version.
#
# Koha is distributed in the hope that it will be useful, but WITHOUT ANY
# WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
# A PARTICULAR PURPOSE. See the GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License along with
# Koha; if not, write to the Free Software Foundation, Inc., 59 Temple Place,
# Suite 330, Boston, MA 02111-1307 USA
use strict;
use C4::Context;
require Exporter;
use vars qw($VERSION @ISA @EXPORT);
# set the version for version checking
$VERSION = 0.01;
=head1 NAME
C4::Maintenance - Koha catalog maintenance functions
=head1 SYNOPSIS
use C4::Maintenance;
=head1 DESCRIPTION
The functions in this module perform various catalog-maintenance
functions, including deleting and undeleting books, fixing
miscategorized items, etc.
=head1 FUNCTIONS
=over 2
=cut
@ISA = qw(Exporter);
@EXPORT = qw(&listsubjects &updatesub &shiftgroup &deletedbib &undeletebib
&updatetype);
=item listsubjects
($count, $results) = &listsubjects($subject, $n, $offset);
Finds the subjects that begin with C<$subject> in the bibliosubject
table of the Koha database.
C<&listsubjects> returns a two-element array. C<$results> is a
reference-to-array, in which each element is a reference-to-hash
giving information about the given subject. C<$count> is the number of
elements in C<@{$results}>.
Probably the only interesting field in C<$results->[$i]> is
C<subject>, the subject in question.
C<&listsubject> returns up to C<$n> items, starting at C<$offset>. If
C<$n> is 0, it will return all matching subjects.
=cut
#'
# FIXME - This API is bogus. The way it's currently used, it should
# just return a list of strings.
sub listsubjects {
my ($sub,$num,$offset)=@_;
my $dbh = C4::Context->dbh;
my $query="Select * from bibliosubject where subject like ? group by subject";
my @bind = ("$sub%");
# FIXME - Make $num and $offset optional.
# If $num was given, make sure $offset was, too.
if ($num != 0){
$query.=" limit ?,?";
push(@bind,$offset,$num);
}
my $sth=$dbh->prepare($query);
# print $query;
$sth->execute(@bind);
my @results;
my $i=0;
while (my $data=$sth->fetchrow_hashref){
$results[$i]=$data;
$i++;
}
$sth->finish;
return($i,\@results);
}
=item updatesub
&updatesub($newsubject, $oldsubject);
Renames a subject from C<$oldsubject> to C<$newsubject> in the
bibliosubject table of the Koha database.
=cut
#'
sub updatesub{
my ($sub,$oldsub)=@_;
my $dbh = C4::Context->dbh;
$sub=$dbh->quote($sub);
$oldsub=$dbh->quote($oldsub);
my $sth=$dbh->prepare("update bibliosubject set subject=? where subject=?");
$sth->execute($sub,$oldsub);
$sth->finish;
}
=item shiftgroup
&shiftgroup($biblionumber, $biblioitemnumber);
Changes the biblionumber associated with a given biblioitem.
C<$biblioitemnumber> is the number of the biblioitem to change.
C<$biblionumber> is the biblionumber to associate it with.
=cut
#'
sub shiftgroup{
my ($bib,$bi)=@_;
my $dbh = C4::Context->dbh;
my $sth=$dbh->prepare("update biblioitems set biblionumber=? where biblioitemnumber=?");
$sth->execute($bib,$bi);
$sth->finish;
$sth=$dbh->prepare("update items set biblionumber=? where biblioitemnumber=?");
$sth->execute($bib,$bi);
$sth->finish;
}
=item deletedbib
($count, $results) = &deletedbib($title);
Looks up deleted books whose title begins with C<$title>.
C<&deletedbib> returns a two-element list. C<$results> is a
reference-to-array; each element is a reference-to-hash whose keys are
the fields of the deletedbiblio table in the Koha database. C<$count>
is the number of elements in C<$results>.
=cut
#'
sub deletedbib{
my ($title)=@_;
my $dbh = C4::Context->dbh;
my $sth=$dbh->prepare("Select * from deletedbiblio where title like ? order by title");
$sth->execute("$title%");
my @results;
my $i=0;
while (my $data=$sth->fetchrow_hashref){
$results[$i]=$data;
$i++;
}
$sth->finish;
return($i,\@results);
}
=item undeletebib
&undeletebib($biblionumber);
Undeletes a book. C<&undeletebib> looks up the book with the given
biblionumber in the deletedbiblio table of the Koha database, and
moves its entry to the biblio table.
=cut
#'
sub undeletebib{
my ($bib)=@_;
my $dbh = C4::Context->dbh;
my $sth=$dbh->prepare("select * from deletedbiblio where biblionumber=?");
$sth->execute($bib);
if (my @data=$sth->fetchrow_array){
$sth->finish;
# FIXME - Doesn't this keep the same biblionumber? Isn't this
# forbidden by the definition of 'biblio'? Or doesn't it matter?
my $query="Insert into biblio values (";
$query .= ("?," x $#data);
$query=~ s/\,$/\)/;
# print $query;
$sth=$dbh->prepare($query);
$sth->execute(@data);
$sth->finish;
}
$sth=$dbh->prepare("Delete from deletedbiblio where biblionumber=?");
$sth->execute($bib);
$sth->finish;
}
=item updatetype
&updatetype($biblioitemnumber, $itemtype);
Changes the type of the item with the given biblioitemnumber to be
C<$itemtype>.
=cut
#'
sub updatetype{
my ($bi,$type)=@_;
my $dbh = C4::Context->dbh;
my $sth=$dbh->prepare("Update biblioitems set itemtype=? where biblioitemnumber=?");
$sth->execute($type,$bi);
$sth->finish;
}
END { } # module clean-up code here (global destructor)
1;
__END__
=back
=head1 AUTHOR
Koha Developement team <info@koha.org>
=cut