Attachment 142915 Details for Bug 30403 – Bug 30403: Add syspref UpdateNotForLoanStatusOnCheckout

[patch] Bug 30403: Add syspref UpdateNotForLoanStatusOnCheckout

0001-Bug-30403-Add-syspref-UpdateNotForLoanStatusOnChecko.patch (text/plain), 9.85 KB, created by Emmi Takkinen on 2022-11-02 08:29:39 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Emmi Takkinen

Created: 2022-11-02 08:29:39 UTC

Size: 9.85 KB

patch

obsolete

>From 8dc325d3f56d9ca568e66aa56d3fbc90a9f08185 Mon Sep 17 00:00:00 2001
>From: Emmi Takkinen <emmi.takkinen@koha-suomi.fi>
>Date: Tue, 29 Mar 2022 12:51:01 +0300
>Subject: [PATCH] Bug 30403: Add syspref UpdateNotForLoanStatusOnCheckout
>
>We currently have syspref UpdateNotForLoanStatusOnCheckin which updates
>notforloan status when item is checked in. We should also have
>same kind of syspref for check outs. This would be usefull if for
>example library has item in exhibition with status
>"In exhibition, available for loan". When patron check outs the
>item notforloan status can be reseted back to 0, informing staff
>that the item is back on circulation.
>
>This patch adds new syspref Add syspref UpdateNotForLoanStatusOnCheckout.
>
>To test:
>1. Set items notforloan status as e.g -1.
>2. Check out item for a patron.
>=> Note that items status doesn't change.
>3. Apply patch and update database if needed.
>4. Add "-1: 0" to syspref UpdateNotForLoanStatusOnCheckout.
>5. Check item in and out again for a patron.
>=> Note that items status is changed as 0.
>
>Also prove t/db_dependent/Circulation/issue.t
>
>Sponsored-by: Koha-Suomi Oy
>---
> C4/Circulation.pm | 19 ++++++++++++
> .../data/mysql/atomicupdate/bug_30403.pl | 14 +++++++++
> installer/data/mysql/mandatory/sysprefs.sql | 1 +
> .../admin/preferences/circulation.pref | 8 +++++
> t/db_dependent/Circulation/issue.t | 31 ++++++++++++++++++-
> 5 files changed, 72 insertions(+), 1 deletion(-)
> create mode 100755 installer/data/mysql/atomicupdate/bug_30403.pl
>
>diff --git a/C4/Circulation.pm b/C4/Circulation.pm
>index d74305aebc..892f29d87f 100644
>--- a/C4/Circulation.pm
>+++ b/C4/Circulation.pm
>@@ -1731,6 +1731,25 @@ sub AddIssue {
> }
> }
> 
>+ my $yaml = C4::Context->preference('UpdateNotForLoanStatusOnCheckout');
>+ if ($yaml) {
>+ $yaml = "$yaml\n\n";
>+
>+ my $rules;
>+ eval { $rules = YAML::XS::Load(Encode::encode_utf8($yaml)); };
>+ if ($@) {
>+ warn "Unable to parse UpdateNotForLoanStatusOnCheckout syspref : $@";
>+ }
>+ else {
>+ foreach my $key ( keys %$rules ) {
>+ if ( $item_object->notforloan eq $key ) {
>+ $item_object->notforloan($rules->{$key})->store({ log_action => 0, skip_record_index => 1 });
>+ last;
>+ }
>+ }
>+ }
>+ }
>+
> # Record the fact that this book was issued.
> C4::Stats::UpdateStats(
> {
>diff --git a/installer/data/mysql/atomicupdate/bug_30403.pl b/installer/data/mysql/atomicupdate/bug_30403.pl
>new file mode 100755
>index 0000000000..2dd37a58cd
>--- /dev/null
>+++ b/installer/data/mysql/atomicupdate/bug_30403.pl
>@@ -0,0 +1,14 @@
>+use Modern::Perl;
>+
>+return {
>+ bug_number => "30403",
>+ description => "A single line description",
>+ up => sub {
>+ my ($args) = @_;
>+ my ($dbh, $out) = @$args{qw(dbh out)};
>+ # Do you stuffs here
>+ $dbh->do(q{INSERT IGNORE INTO systempreferences ( variable, value, options, explanation, type ) VALUES ('UpdateNotForLoanStatusOnCheckin', '', 'NULL', 'This is a list of value pairs. When an item is checked in, if the not for loan value on the left matches the items not for loan value it will be updated to the right-hand value. E.g. ''-1: 0'' will cause an item that was set to ''Ordered'' to now be available for loan. Each pair of values should be on a separate line.', 'Free')});
>+ # Print useful stuff here
>+ say $out "Update is going well so far";
>+ },
>+};
>diff --git a/installer/data/mysql/mandatory/sysprefs.sql b/installer/data/mysql/mandatory/sysprefs.sql
>index c1ff4a2f38..8dad934821 100644
>--- a/installer/data/mysql/mandatory/sysprefs.sql
>+++ b/installer/data/mysql/mandatory/sysprefs.sql
>@@ -741,6 +741,7 @@ INSERT INTO systempreferences ( `variable`, `value`, `options`, `explanation`, `
> ('UnsubscribeReflectionDelay','',NULL,'Delay for locking unsubscribers', 'Integer'),
> ('UpdateItemLocationOnCheckin', '', 'NULL', 'This is a list of value pairs.\n Examples:\n\nPROC: FIC - causes an item in the Processing Center location to be updated into the Fiction location on check in.\nFIC: GEN - causes an item in the Fiction location to be updated into the General stacks location on check in.\n_BLANK_:FIC - causes an item that has no location to be updated into the Fiction location on check in.\nFIC: _BLANK_ - causes an item in location FIC to be updated to a blank location on check in.\n_ALL_:FIC - causes all items to be updated into the Fiction location on check in.\nPROC: _PERM_ - causes an item that is in the Processing Center to be updated to it''s permanent location.\n\nGeneral rule: if the location value on the left matches the item''s current location, it will be updated to match the location value on the right.\nNote: PROC and CART are special values, for these locations only can location and permanent_location differ, in all other cases an update will affect both. Items in the CART location will be returned to their permanent location on checkout.\n\nThe special term _BLANK_ may be used on either side of a value pair to update or remove the location from items with no location assigned.\nThe special term _ALL_ is used on the left side of the colon (:) to affect all items.\nThe special term _PERM_ is used on the right side of the colon (:) to return items to their permanent location.', 'Free'),
> ('UpdateNotForLoanStatusOnCheckin', '', 'NULL', "This is a list of value pairs. When an item is checked in, if the not for loan value on the left matches the items not for loan value it will be updated to the right-hand value. E.g. '-1: 0' will cause an item that was set to 'Ordered' to now be available for loan. Can be used for showing only the not for loan description. E.g. '-1: ONLYMESSAGE'. Each pair of values should be on a separate line.", 'Free'),
>+('UpdateNotForLoanStatusOnCheckout', '', 'NULL', 'This is a list of value pairs. When an item is checked out, if the not for loan value on the left matches the items not for loan value it will be updated to the right-hand value. E.g. ''-1: 0'' will cause an item that was set to ''Ordered'' to now be available for loan. Each pair of values should be on a separate line.', 'Free'),
> ('UpdateTotalIssuesOnCirc','0',NULL,'Whether to update the totalissues field in the biblio on each circ.','YesNo'),
> ('UploadPurgeTemporaryFilesDays','',NULL,'If not empty, number of days used when automatically deleting temporary uploads','integer'),
> ('uppercasesurnames','0',NULL,'If ON, surnames are converted to upper case in patron entry form','YesNo'),
>diff --git a/koha-tmpl/intranet-tmpl/prog/en/modules/admin/preferences/circulation.pref b/koha-tmpl/intranet-tmpl/prog/en/modules/admin/preferences/circulation.pref
>index 6aea72198b..4584ee2b78 100644
>--- a/koha-tmpl/intranet-tmpl/prog/en/modules/admin/preferences/circulation.pref
>+++ b/koha-tmpl/intranet-tmpl/prog/en/modules/admin/preferences/circulation.pref
>@@ -561,6 +561,14 @@ Circulation:
> - " ccode: [NEWFIC,NULL,DVD]"
> - " itype: [NEWBK,\"\"]"
> - " NOTE: The word 'NULL' can be used to block renewal on undefined fields, while an empty string \"\" will block on an empty (but defined) field."
>+ -
>+ - pref: UpdateNotForLoanStatusOnCheckout
>+ type: textarea
>+ syntax: text/x-yaml
>+ class: code
>+ - This is a list of value pairs. When an item is checked out, if the not for loan value on the left matches the items not for loan value
>+ - "it will be updated to the right-hand value. For example, '-1: 0' will cause an item that was set to 'Ordered' to now be available for loan."
>+ - Each pair of values should be on a separate line.
> Checkin policy:
> -
> - pref: TrapHoldsOnOrder
>diff --git a/t/db_dependent/Circulation/issue.t b/t/db_dependent/Circulation/issue.t
>index f388dab007..6b9abc78c2 100755
>--- a/t/db_dependent/Circulation/issue.t
>+++ b/t/db_dependent/Circulation/issue.t
>@@ -17,7 +17,7 @@
> 
> use Modern::Perl;
> 
>-use Test::More tests => 49;
>+use Test::More tests => 52;
> use DateTime::Duration;
> 
> use t::lib::Mocks;
>@@ -543,5 +543,34 @@ AddRenewal( $unseen_patron->borrowernumber, $unseen_item->itemnumber, $branchcod
> my ( $unseen_reset ) = ( C4::Circulation::GetRenewCount( $unseen_patron->borrowernumber, $unseen_item->itemnumber ) )[3];
> is( $unseen_reset, 0, 'seen renewal resets the unseen count' );
> 
>+my $itemnumber4 = Koha::Item->new(
>+ {
>+ biblionumber => $biblionumber,
>+ barcode => 'barcode_6',
>+ itemcallnumber => 'callnumber6',
>+ homebranch => $branchcode_1,
>+ holdingbranch => $branchcode_1,
>+ notforloan => -1,
>+ itype => $itemtype,
>+ location => 'loc1'
>+ },
>+)->store->itemnumber;
>+
>+t::lib::Mocks::mock_preference( 'UpdateNotForLoanStatusOnCheckout', q{} );
>+AddIssue( $borrower_2, 'barcode_6', dt_from_string );
>+my $item = Koha::Items->find( $itemnumber4 );
>+ok( $item->notforloan eq -1, 'UpdateNotForLoanStatusOnCheckout does not modify value when not enabled' );
>+
>+t::lib::Mocks::mock_preference( 'UpdateNotForLoanStatusOnCheckout', '-1: 0' );
>+AddReturn( 'barcode_6', $branchcode_1 );
>+my $test = AddIssue( $borrower_2, 'barcode_6', dt_from_string );
>+$item = Koha::Items->find( $itemnumber4 );
>+ok( $item->notforloan eq 0, q{UpdateNotForLoanStatusOnCheckout updates notforloan value from -1 to 0 with setting "-1: 0"} );
>+
>+AddIssue( $borrower_2, 'barcode_6', dt_from_string );
>+AddReturn( 'barcode_6', $branchcode_1 );
>+$item = Koha::Items->find( $itemnumber4 );
>+ok( $item->notforloan eq 0, q{UpdateNotForLoanStatusOnCheckout does not update notforloan value from 0 with setting "-1: 0"} );
>+
> #End transaction
> $schema->storage->txn_rollback;
>-- 
>2.34.1
>

Actions: View | Diff | Splinter Review

Attachments on bug 30403: 132534 | 132535 | 132536 | 139675 | 142915 | 143883 | 144681 | 144682 | 144683 | 144684 | 149234