Main Koha release repository
https://koha-community.org
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
153 lines
3.2 KiB
153 lines
3.2 KiB
package Koha::Item::Transfer;
|
|
|
|
# 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 3 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, see <http://www.gnu.org/licenses>.
|
|
|
|
use Modern::Perl;
|
|
|
|
use Carp;
|
|
|
|
use C4::Items;
|
|
|
|
use Koha::Database;
|
|
use Koha::DateUtils;
|
|
use Koha::Exceptions::Item::Transfer;
|
|
|
|
use base qw(Koha::Object);
|
|
|
|
=head1 NAME
|
|
|
|
Koha::Item::Transfer - Koha Item Transfer Object class
|
|
|
|
=head1 API
|
|
|
|
=head2 Class Methods
|
|
|
|
=cut
|
|
|
|
=head3 item
|
|
|
|
my $item = $transfer->item;
|
|
|
|
Returns the associated item for this transfer.
|
|
|
|
=cut
|
|
|
|
sub item {
|
|
my ($self) = @_;
|
|
my $item_rs = $self->_result->itemnumber;
|
|
return Koha::Item->_new_from_dbic($item_rs);
|
|
}
|
|
|
|
=head3 transit
|
|
|
|
Set the transfer as in transit by updating the datesent time.
|
|
|
|
Also, update date last seen and ensure item holdingbranch is correctly set.
|
|
|
|
=cut
|
|
|
|
sub transit {
|
|
my ($self) = @_;
|
|
|
|
# Throw exception if item is still checked out
|
|
Koha::Exceptions::Item::Transfer::Out->throw() if ( $self->item->checkout );
|
|
|
|
# Remove the 'shelving cart' location status if it is being used (Bug 3701)
|
|
CartToShelf( $self->item->itemnumber )
|
|
if $self->item->location
|
|
&& $self->item->location eq 'CART'
|
|
&& (!$self->item->permanent_location
|
|
|| $self->item->permanent_location ne 'CART' );
|
|
|
|
# Update the transit state
|
|
$self->set(
|
|
{
|
|
frombranch => $self->item->holdingbranch,
|
|
datesent => dt_from_string,
|
|
}
|
|
)->store;
|
|
|
|
ModDateLastSeen( $self->item->itemnumber );
|
|
return $self;
|
|
|
|
}
|
|
|
|
=head3 in_transit
|
|
|
|
Boolean returning whether the transfer is in transit or waiting
|
|
|
|
=cut
|
|
|
|
sub in_transit {
|
|
my ($self) = @_;
|
|
|
|
return ( defined( $self->datesent ) && !defined( $self->datearrived ) );
|
|
}
|
|
|
|
=head3 receive
|
|
|
|
Receive the transfer by setting the datearrived time.
|
|
|
|
=cut
|
|
|
|
sub receive {
|
|
my ($self) = @_;
|
|
|
|
# Throw exception if item is checked out
|
|
Koha::Exceptions::Item::Transfer::Out->throw() if ($self->item->checkout);
|
|
|
|
# Update the arrived date
|
|
$self->set({ datearrived => dt_from_string })->store;
|
|
|
|
ModDateLastSeen( $self->item->itemnumber );
|
|
return $self;
|
|
}
|
|
|
|
=head3 cancel
|
|
|
|
$transfer->cancel($reason);
|
|
|
|
Cancel the transfer by setting the datecancelled time and recording the reason.
|
|
|
|
=cut
|
|
|
|
sub cancel {
|
|
my ( $self, $reason ) = @_;
|
|
|
|
Koha::Exceptions::MissingParameter->throw(
|
|
error => "The 'reason' parameter is mandatory" )
|
|
unless defined($reason);
|
|
|
|
# Throw exception if item is in transit already
|
|
Koha::Exceptions::Item::Transfer::Transit->throw() if ( $self->in_transit );
|
|
|
|
# Update the cancelled date
|
|
$self->set(
|
|
{ datecancelled => dt_from_string, cancellation_reason => $reason } )
|
|
->store;
|
|
|
|
return $self;
|
|
}
|
|
|
|
=head3 type
|
|
|
|
=cut
|
|
|
|
sub _type {
|
|
return 'Branchtransfer';
|
|
}
|
|
|
|
1;
|
|
|