Koha/misc/cronjobs/serialsUpdate.pl
Fridolyn SOMERS 3a1a94d4ef Bug 9739: more options for serialsUpdate.pl
Script serialsUpdate.pl must be set in crontab to run daily.
It checks serials that are late, modifies status and adds a note.

This patch adds some options :
--note : defined note, a defaut one is used if not defined
--no-note : disable automatic note
--verbose : used to control output
This patch also implements confirmation option "-c" who whas present but not used.

Test plan :
Run script on a database with late serials :
- serialsUpdate.pl -h
=> you get help text in output
- serialsUpdate.pl --man
=> you get full help
- serialsUpdate.pl -v
=> you get output of changed serials but database has not changed
- serialsUpdate.pl -c -v
=> you get output of changed serials and database has changed, with note "Automatically set to late"
- serialsUpdate.pl -c
=> database has changed without anything in output
- serialsUpdate.pl -c --note "LATE"
=> database has changed, with note "LATE"
- serialsUpdate.pl -c --no-note
=> database has changed with no note

Signed-off-by: Bernardo Gonzalez Kriegel <bgkriegel@gmail.com>
Works as described. No koha-qa errors.

Signed-off-by: Katrin Fischer <Katrin.Fischer.83@web.de>
Passes all tests and QA script.
New options behave as described.
There are some existing problems with this script that I have noted
directly on the bug report.

Signed-off-by: Galen Charlton <gmc@esilibrary.com>
2013-10-20 18:56:09 +00:00

132 lines
4 KiB
Perl
Executable file

#!/usr/bin/perl
# Copyright 2008 SARL Biblibre
#
# 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.,
# 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
use strict;
use warnings;
BEGIN {
# find Koha's Perl modules
# test carefully before changing this
use FindBin;
eval { require "$FindBin::Bin/../kohalib.pl" };
}
use C4::Context;
use C4::Dates qw/format_date format_date_in_iso/;
use C4::Debug;
use C4::Serials;
use Date::Calc qw/Date_to_Days check_date/;
use Getopt::Long;
use Pod::Usage;
=head1 NAME
serialsUpdate.pl - change status of serials that are late
=head1 SYNOPSIS
serialsUpdate.pl [ -h | -m ][ -v ] -c ][ --note "you are late" ][ --no-note ]
Options:
--h --help -? Brief help message
--man Full documentation
--verbose -v Verbose mode
-c Confirm : without this option, the script will report the concerned serials
without modifying database
--note Note set to concerned serials, by default "Automatically set to late"
--no-note Do not set a note one concerned serials
=cut
my $dbh = C4::Context->dbh;
my $man = 0;
my $help = 0;
my $confirm = 0;
my $verbose = 0;
my $note = '';
my $nonote = 0;
GetOptions(
'help|h|?' => \$help,
'man' => \$man,
'v|verbose' => \$verbose,
'c' => \$confirm,
'note:s' => \$note,
'no-note' => \$nonote,
) or pod2usage(2);
pod2usage(1) if $help;
pod2usage( -verbose => 2 ) if $man;
$verbose and !$confirm and print "### Database will not be modified ###\n";
if ($note && $nonote) {
$note = '';
}
if (!$note && !$nonote) {
$note = 'Automatically set to late';
}
$verbose and print $note ? "Note : $note\n" : "No note\n";
# select all serials with not "irregular" periodicity that are late
my $sth = $dbh->prepare("
SELECT *
FROM serial
LEFT JOIN subscription
ON (subscription.subscriptionid=serial.subscriptionid)
WHERE serial.status = 1
AND periodicity <> 32
AND DATE_ADD(planneddate, INTERVAL CAST(graceperiod AS SIGNED) DAY) < NOW()
AND subscription.closed = 0
");
$sth->execute();
while ( my $issue = $sth->fetchrow_hashref ) {
my $subscription = &GetSubscription( $issue->{subscriptionid} );
my $planneddate = $issue->{planneddate};
if( $subscription && $planneddate && $planneddate ne "0000-00-00" ){
my $nextpublisheddate = GetNextDate( $planneddate, $subscription );
my $today = format_date_in_iso( C4::Dates->new()->output() );
if ($nextpublisheddate && $today){
my ( $year, $month, $day ) = split( /-/, $nextpublisheddate );
my ( $tyear, $tmonth, $tday ) = split( /-/, $today );
if ( check_date( $year, $month, $day )
&& check_date( $tyear, $tmonth, $tday )
&& Date_to_Days( $year, $month, $day ) <
Date_to_Days( $tyear, $tmonth, $tday ) )
{
$confirm and
ModSerialStatus( $issue->{serialid}, $issue->{serialseq},
$issue->{planneddate}, $issue->{publisheddate},
3, $note );
$verbose and print "Serial id=" . $issue->{serialid}." update\n";
}
}else{
$verbose and print "Error with serial(".$issue->{serialid}.") has no existent
subscription(".$issue->{subscriptionid}.") attached
or planneddate is wrong\n";
}
}
}