4 #written 2/1/00 by chris@katipo.oc.nz
5 # Copyright 2000-2002 Katipo Communications
6 # Parts Copyright 2011 Catalyst IT
8 # This file is part of Koha.
10 # Koha is free software; you can redistribute it and/or modify it
11 # under the terms of the GNU General Public License as published by
12 # the Free Software Foundation; either version 3 of the License, or
13 # (at your option) any later version.
15 # Koha is distributed in the hope that it will be useful, but
16 # WITHOUT ANY WARRANTY; without even the implied warranty of
17 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 # GNU General Public License for more details.
20 # You should have received a copy of the GNU General Public License
21 # along with Koha; if not, see <http://www.gnu.org/licenses>.
25 script to place reserves/requests
32 use List::MoreUtils qw/uniq/;
33 use Date::Calc qw/Date_to_Days/;
43 use C4::Utils::DataTables::Members;
45 use C4::Search; # enabled_staff_search_views
51 use Koha::CirculationRules;
58 my $dbh = C4::Context->dbh;
60 my ( $template, $borrowernumber, $cookie, $flags ) = get_template_and_user(
62 template_name => "reserve/request.tt",
65 flagsrequired => { reserveforothers => 'place_holds' },
69 my $showallitems = $input->param('showallitems');
70 my $pickup = $input->param('pickup');
72 my $itemtypes = { map { $_->{itemtype} => $_ } @{ Koha::ItemTypes->search_with_localization->unblessed } };
74 # Select borrowers infos
75 my $findborrower = $input->param('findborrower');
76 $findborrower = '' unless defined $findborrower;
77 $findborrower =~ s|,| |g;
78 my $findclub = $input->param('findclub');
79 $findclub = '' unless defined $findclub && !$findborrower;
80 my $borrowernumber_hold = $input->param('borrowernumber') || '';
81 my $club_hold = $input->param('club')||'';
86 my $exceeded_maxreserves;
87 my $exceeded_holds_per_record;
89 my $date = output_pref({ dt => dt_from_string, dateformat => 'iso', dateonly => 1 });
90 my $action = $input->param('action');
93 if ( $action eq 'move' ) {
94 my $where = $input->param('where');
95 my $reserve_id = $input->param('reserve_id');
96 my $prev_priority = $input->param('prev_priority');
97 my $next_priority = $input->param('next_priority');
98 my $first_priority = $input->param('first_priority');
99 my $last_priority = $input->param('last_priority');
100 my $hold_itemnumber = $input->param('itemnumber');
101 if ( $prev_priority == 0 && $next_priority == 1 ){
102 C4::Reserves::RevertWaitingStatus({ itemnumber => $hold_itemnumber });
104 AlterPriority( $where, $reserve_id, $prev_priority, $next_priority, $first_priority, $last_priority );
106 } elsif ( $action eq 'cancel' ) {
107 my $reserve_id = $input->param('reserve_id');
108 my $hold = Koha::Holds->find( $reserve_id );
109 $hold->cancel if $hold;
110 } elsif ( $action eq 'setLowestPriority' ) {
111 my $reserve_id = $input->param('reserve_id');
112 ToggleLowestPriority( $reserve_id );
113 } elsif ( $action eq 'toggleSuspend' ) {
114 my $reserve_id = $input->param('reserve_id');
115 my $suspend_until = $input->param('suspend_until');
116 ToggleSuspend( $reserve_id, $suspend_until );
120 my $patron = Koha::Patrons->find( { cardnumber => $findborrower } );
122 $borrowernumber_hold = $patron->borrowernumber;
124 my $dt_params = { iDisplayLength => -1 };
125 my $results = C4::Utils::DataTables::Members::search(
127 searchmember => $findborrower,
128 dt_params => $dt_params,
131 my $borrowers = $results->{patrons};
132 if ( scalar @$borrowers == 1 ) {
133 $borrowernumber_hold = $borrowers->[0]->{borrowernumber};
134 } elsif ( @$borrowers ) {
135 $template->param( borrowers => $borrowers );
137 $messageborrower = "'$findborrower'";
143 my $club = Koha::Clubs->find( { name => $findclub } );
145 $club_hold = $club->id;
147 my @clubs = Koha::Clubs->search( [
148 { name => { like => '%'.$findclub.'%' } },
149 { description => { like => '%'.$findclub.'%' } }
151 if( scalar @clubs == 1 ) {
152 $club_hold = $clubs[0]->id;
154 $template->param( clubs => \@clubs );
156 $messageclub = "'$findclub'";
161 my @biblionumbers = ();
162 my $biblionumber = $input->param('biblionumber');
163 my $biblionumbers = $input->param('biblionumbers');
164 if ( $biblionumbers ) {
165 @biblionumbers = split '/', $biblionumbers;
167 push @biblionumbers, $input->multi_param('biblionumber');
170 my $multi_hold = @biblionumbers > 1;
171 $template->param(multi_hold => $multi_hold);
173 # If we have the borrowernumber because we've performed an action, then we
174 # don't want to try to place another reserve.
175 if ($borrowernumber_hold && !$action) {
176 my $patron = Koha::Patrons->find( $borrowernumber_hold );
179 # we check the reserves of the user, and if they can reserve a document
180 # FIXME At this time we have a simple count of reservs, but, later, we could improve the infos "title" ...
182 my $reserves_count = $patron->holds->count;
184 my $new_reserves_count = scalar( @biblionumbers );
186 my $maxreserves = C4::Context->preference('maxreserves');
188 && ( $reserves_count + $new_reserves_count > $maxreserves ) )
190 my $new_reserves_allowed =
191 $maxreserves - $reserves_count > 0
192 ? $maxreserves - $reserves_count
195 $exceeded_maxreserves = 1;
197 new_reserves_allowed => $new_reserves_allowed,
198 new_reserves_count => $new_reserves_count,
199 reserves_count => $reserves_count,
200 maxreserves => $maxreserves,
204 # we check the date expiry of the borrower (only if there is an expiry date, otherwise, set to 1 (warn)
205 my $expiry_date = $patron->dateexpiry;
206 my $expiry = 0; # flag set if patron account has expired
208 Date_to_Days(split /-/,$date) > Date_to_Days(split /-/,$expiry_date)) {
212 # check if the borrower make the reserv in a different branch
213 if ( $patron->branchcode ne C4::Context->userenv->{'branch'} ) {
217 my $amount_outstanding = $patron->account->balance;
221 diffbranch => $diffbranch,
222 messages => $messages,
223 warnings => $warnings,
224 amount_outstanding => $amount_outstanding,
228 if ($club_hold && !$borrowernumber_hold && !$action) {
229 my $club = Koha::Clubs->find($club_hold);
231 my $enrollments = $club->club_enrollments;
233 my $maxreserves = C4::Context->preference('maxreserves');
234 my $new_reserves_count = scalar( @biblionumbers );
238 while(my $enrollment = $enrollments->next) {
239 next if $enrollment->is_canceled;
240 my $member = { patron => $enrollment->patron->unblessed };
241 my $reserves_count = $enrollment->patron->holds->count;
243 && ( $reserves_count + $new_reserves_count > $maxreserves ) )
245 $member->{new_reserves_allowed} = $maxreserves - $reserves_count > 0
246 ? $maxreserves - $reserves_count
248 $member->{exceeded_maxreserves} = 1;
250 my $expiry_date = $enrollment->patron->dateexpiry;
251 $member->{expiry} = 0; # flag set if patron account has expired
253 Date_to_Days(split /-/,$date) > Date_to_Days(split /-/,$expiry_date)) {
254 $member->{expiry} = 1;
256 $member->{amount_outstanding} = $enrollment->patron->account->balance;
257 if ( $enrollment->patron->branchcode ne C4::Context->userenv->{'branch'} ) {
258 $member->{diffbranch} = 1;
261 push @members, $member;
266 members => \@members,
267 maxreserves => $maxreserves,
268 new_reserves_count => $new_reserves_count
273 messageborrower => $messageborrower,
274 messageclub => $messageclub
277 # FIXME launch another time GetMember perhaps until (Joubu: Why?)
278 my $patron = Koha::Patrons->find( $borrowernumber_hold );
280 my $logged_in_patron = Koha::Patrons->find( $borrowernumber );
284 $wants_check = $patron->wants_check_for_previous_checkout;
286 my $itemdata_enumchron = 0;
287 my $itemdata_ccode = 0;
289 foreach my $biblionumber (@biblionumbers) {
290 next unless $biblionumber =~ m|^\d+$|;
292 my %biblioloopiter = ();
294 my $biblio = Koha::Biblios->find( $biblionumber );
296 my $force_hold_level;
298 { # CanBookBeReserved
299 my $canReserve = CanBookBeReserved( $patron->borrowernumber, $biblionumber );
300 if ( $canReserve->{status} eq 'OK' ) {
302 #All is OK and we can continue
304 elsif ( $canReserve->{status} eq 'tooManyReserves' ) {
305 $exceeded_maxreserves = 1;
306 $template->param( maxreserves => $canReserve->{limit} );
308 elsif ( $canReserve->{status} eq 'tooManyHoldsForThisRecord' ) {
309 $exceeded_holds_per_record = 1;
310 $biblioloopiter{ $canReserve->{status} } = 1;
312 elsif ( $canReserve->{status} eq 'ageRestricted' ) {
313 $template->param( $canReserve->{status} => 1 );
314 $biblioloopiter{ $canReserve->{status} } = 1;
317 $biblioloopiter{ $canReserve->{status} } = 1;
321 # For multiple holds per record, if a patron has previously placed a hold,
322 # the patron can only place more holds of the same type. That is, if the
323 # patron placed a record level hold, all the holds the patron places must
324 # be record level. If the patron placed an item level hold, all holds
325 # the patron places must be item level
326 my $holds = Koha::Holds->search(
328 borrowernumber => $patron->borrowernumber,
329 biblionumber => $biblionumber,
333 $force_hold_level = $holds->forced_hold_level();
334 $biblioloopiter{force_hold_level} = $force_hold_level;
335 $template->param( force_hold_level => $force_hold_level );
337 # For a librarian to be able to place multiple record holds for a patron for a record,
338 # we must find out what the maximum number of holds they can place for the patron is
339 my $max_holds_for_record = GetMaxPatronHoldsForRecord( $patron->borrowernumber, $biblionumber );
340 my $remaining_holds_for_record = $max_holds_for_record - $holds->count();
341 $biblioloopiter{remaining_holds_for_record} = $max_holds_for_record;
342 $template->param( max_holds_for_record => $max_holds_for_record );
343 $template->param( remaining_holds_for_record => $remaining_holds_for_record );
345 { # alreadypossession
346 # Check to see if patron is allowed to place holds on records where the
347 # patron already has an item from that record checked out
348 if ( !C4::Context->preference('AllowHoldsOnPatronsPossessions')
349 && CheckIfIssuedToPatron( $patron->borrowernumber, $biblionumber ) )
351 $template->param( alreadypossession => 1, );
357 my $count = Koha::Holds->search( { biblionumber => $biblionumber } )->count();
358 my $totalcount = $count;
360 # FIXME think @optionloop, is maybe obsolete, or must be switchable by a systeme preference fixed rank or not
361 # make priorities options
364 for ( 1 .. $count + 1 ) {
369 selected => ( $_ == $count + 1 ),
373 # adding a fixed value for priority options
374 my $fixedRank = $count+1;
376 my %itemnumbers_of_biblioitem;
378 my @hostitems = get_hostitemnumbers_of($biblionumber);
381 $template->param('hostitemsflag' => 1);
382 push(@itemnumbers, @hostitems);
385 my $items = Koha::Items->search({ -or => { biblionumber => $biblionumber, itemnumber => { in => \@itemnumbers } } });
387 unless ( $items->count ) {
388 # FIXME Then why do we continue?
389 $template->param('noitems' => 1);
390 $biblioloopiter{noitems} = 1;
393 ## Here we go backwards again to create hash of biblioitemnumber to itemnumbers,
394 ## when by definition all of the itemnumber have the same biblioitemnumber
395 my ( $iteminfos_of );
396 while ( my $item = $items->next ) {
397 $item = $item->unblessed;
398 my $biblioitemnumber = $item->{biblioitemnumber};
399 my $itemnumber = $item->{itemnumber};
400 push( @{ $itemnumbers_of_biblioitem{$biblioitemnumber} }, $itemnumber );
401 $iteminfos_of->{$itemnumber} = $item;
404 ## Should be same as biblionumber
405 my @biblioitemnumbers = keys %itemnumbers_of_biblioitem;
407 my $biblioiteminfos_of = {
410 ( $biblioitem->{biblioitemnumber} => $biblioitem )
411 } @{ Koha::Biblioitems->search(
412 { biblioitemnumber => { -in => \@biblioitemnumbers } },
413 { select => ['biblioitemnumber', 'publicationyear', 'itemtype']}
420 my @available_itemtypes;
421 foreach my $biblioitemnumber (@biblioitemnumbers) {
422 my $biblioitem = $biblioiteminfos_of->{$biblioitemnumber};
423 my $num_available = 0;
424 my $num_override = 0;
426 my $num_alreadyheld = 0;
428 $biblioitem->{force_hold_level} = $force_hold_level;
430 if ( $biblioitem->{biblioitemnumber} ne $biblionumber ) {
431 $biblioitem->{hostitemsflag} = 1;
434 $biblioloopiter{description} = $biblioitem->{description};
435 $biblioloopiter{itypename} = $biblioitem->{description};
436 if ( $biblioitem->{itemtype} ) {
438 $biblioitem->{description} =
439 $itemtypes->{ $biblioitem->{itemtype} }{description};
441 $biblioloopiter{imageurl} =
442 getitemtypeimagelocation( 'intranet',
443 $itemtypes->{ $biblioitem->{itemtype} }{imageurl} );
446 # iterating through all items first to check if any of them available
447 # to pass this value further inside down to IsAvailableForItemLevelRequest to
448 # it's complicated logic to analyse.
449 # (before this loop was inside that sub loop so it was O(n^2) )
450 my $items_any_available;
452 $items_any_available = ItemsAnyAvailableAndNotRestricted( { biblionumber => $biblioitemnumber, patron => $patron })
455 foreach my $itemnumber ( @{ $itemnumbers_of_biblioitem{$biblioitemnumber} } ) {
456 my $item = $iteminfos_of->{$itemnumber};
459 $do_check = $patron->do_check_for_previous_checkout($item) if $wants_check;
460 if ( $do_check && $wants_check ) {
461 $item->{checked_previously} = $do_check;
463 $biblioloopiter{checked_previously} = $do_check;
465 $template->param( checked_previously => $do_check );
469 $item->{force_hold_level} = $force_hold_level;
471 unless (C4::Context->preference('item-level_itypes')) {
472 $item->{itype} = $biblioitem->{itemtype};
475 $item->{itypename} = $itemtypes->{ $item->{itype} }{description};
476 $item->{imageurl} = getitemtypeimagelocation( 'intranet', $itemtypes->{ $item->{itype} }{imageurl} );
477 $item->{homebranch} = $item->{homebranch};
479 # if the holdingbranch is different than the homebranch, we show the
480 # holdingbranch of the document too
481 if ( $item->{homebranch} ne $item->{holdingbranch} ) {
482 $item->{holdingbranch} = $item->{holdingbranch};
485 if($item->{biblionumber} ne $biblionumber){
486 $item->{hostitemsflag} = 1;
487 $item->{hosttitle} = Koha::Biblios->find( $item->{biblionumber} )->title;
490 # if the item is currently on loan, we display its return date and
491 # change the background color
492 my $issue = Koha::Checkouts->find( { itemnumber => $itemnumber } );
494 $item->{date_due} = $issue->date_due;
495 $item->{backgroundcolor} = 'onloan';
499 my $item_object = Koha::Items->find( $itemnumber );
500 my $holds = $item_object->current_holds;
501 if ( my $first_hold = $holds->next ) {
502 my $p = Koha::Patrons->find( $first_hold->borrowernumber );
504 $item->{backgroundcolor} = 'reserved';
505 $item->{reservedate} = output_pref({ dt => dt_from_string( $first_hold->reservedate ), dateonly => 1 }); # FIXME Should be formatted in the template
506 $item->{ReservedFor} = $p;
507 $item->{ExpectedAtLibrary} = $first_hold->branchcode;
508 $item->{waitingdate} = $first_hold->waitingdate;
511 # Management of the notforloan document
512 if ( $item->{notforloan} ) {
513 $item->{backgroundcolor} = 'other';
516 # Management of lost or long overdue items
517 if ( $item->{itemlost} ) {
518 $item->{backgroundcolor} = 'other';
519 if ($logged_in_patron->category->hidelostitems && !$showallitems) {
525 # Check the transit status
526 my ( $transfertwhen, $transfertfrom, $transfertto ) =
527 GetTransfers($itemnumber);
529 if ( defined $transfertwhen && $transfertwhen ne '' ) {
530 $item->{transfertwhen} = output_pref({ dt => dt_from_string( $transfertwhen ), dateonly => 1 });
531 $item->{transfertfrom} = $transfertfrom;
532 $item->{transfertto} = $transfertto;
533 $item->{nocancel} = 1;
536 # If there is no loan, return and transfer, we show a checkbox.
537 $item->{notforloan} ||= 0;
539 # if independent branches is on we need to check if the person can reserve
540 # for branches they arent logged in to
541 if ( C4::Context->preference("IndependentBranches") ) {
542 if (! C4::Context->preference("canreservefromotherbranches")){
543 # can't reserve items so need to check if item homebranch and userenv branch match if not we can't reserve
544 my $userenv = C4::Context->userenv;
545 unless ( C4::Context->IsSuperLibrarian ) {
546 $item->{cantreserve} = 1 if ( $item->{homebranch} ne $userenv->{branch} );
552 my $patron_unblessed = $patron->unblessed;
553 my $branch = C4::Circulation::_GetCircControlBranch($item, $patron_unblessed);
555 my $branchitemrule = GetBranchItemRule( $branch, $item->{'itype'} );
557 $item->{'holdallowed'} = $branchitemrule->{'holdallowed'};
559 my $reserves_control_branch = $pickup || C4::Reserves::GetReservesControlBranch( $item, $patron_unblessed );
560 my $can_item_be_reserved = CanItemBeReserved( $patron->borrowernumber, $itemnumber, $reserves_control_branch )->{status};
561 $item->{not_holdable} = $can_item_be_reserved unless ( $can_item_be_reserved eq 'OK' );
563 $item->{item_level_holds} = Koha::CirculationRules->get_opacitemholds_policy( { item => $item_object, patron => $patron } );
566 !$item->{cantreserve}
567 && !$exceeded_maxreserves
568 && $can_item_be_reserved eq 'OK'
569 # items_any_available defined outside of the current loop,
570 # so we avoiding loop inside IsAvailableForItemLevelRequest:
571 && IsAvailableForItemLevelRequest($item_object, $patron, undef, $items_any_available)
574 $item->{available} = 1;
577 if ( $branchitemrule->{'hold_fulfillment_policy'} eq 'any' )
579 $item->{any_pickup_location} = 1;
582 my @pickup_locations = $item_object->pickup_locations({ patron => $patron });
584 $item->{pickup_locations} = join( ', ', map { $_->branchname } @pickup_locations );
587 push( @available_itemtypes, $item->{itype} );
589 elsif ( C4::Context->preference('AllowHoldPolicyOverride') ) {
590 # If AllowHoldPolicyOverride is set, it should override EVERY restriction, not just branch item rules
591 # with the exception of itemAlreadyOnHold because, you know, the item is already on hold
592 if ( $can_item_be_reserved ne 'itemAlreadyOnHold' ) {
593 $item->{override} = 1;
595 } else { $num_alreadyheld++ }
597 push( @available_itemtypes, $item->{itype} );
600 # If none of the conditions hold true, then neither override nor available is set and the item cannot be checked
602 # Show serial enumeration when needed
603 if ($item->{enumchron}) {
604 $itemdata_enumchron = 1;
606 # Show collection when needed
607 if ($item->{ccode}) {
612 push @{ $biblioitem->{itemloop} }, $item;
615 # While we can't override an alreay held item, we should be able to override the others
616 # Unless all items are already held
617 if ( $num_override > 0 && ($num_override + $num_alreadyheld) == scalar( @{ $biblioitem->{itemloop} } ) ) {
618 # That is, if all items require an override
619 $template->param( override_required => 1 );
620 } elsif ( $num_available == 0 ) {
621 $template->param( none_available => 1 );
622 $biblioloopiter{warn} = 1;
623 $biblioloopiter{none_avail} = 1;
625 $template->param( hiddencount => $hiddencount);
627 push @bibitemloop, $biblioitem;
630 @available_itemtypes = uniq( @available_itemtypes );
631 $template->param( available_itemtypes => \@available_itemtypes );
633 # existingreserves building
635 my @reserves = Koha::Holds->search( { biblionumber => $biblionumber }, { order_by => 'priority' } );
638 my $a_found = $a->found() || '';
639 my $b_found = $a->found() || '';
640 $a_found cmp $b_found;
644 my $priority = $res->priority();
647 for ( my $i = 1 ; $i <= $totalcount ; $i++ ) {
652 selected => ( $i == $priority ),
657 if ( $res->is_found() ) {
658 $reserve{'holdingbranch'} = $res->item()->holdingbranch();
659 $reserve{'biblionumber'} = $res->item()->biblionumber();
660 $reserve{'barcodenumber'} = $res->item()->barcode();
661 $reserve{'wbrcode'} = $res->branchcode();
662 $reserve{'itemnumber'} = $res->itemnumber();
663 $reserve{'wbrname'} = $res->branch()->branchname();
664 $reserve{'atdestination'} = $res->is_at_destination();
666 # set found to 1 if reserve is waiting for patron pickup
667 $reserve{'found'} = $res->is_found();
668 $reserve{'intransit'} = $res->is_in_transit();
670 elsif ( $res->priority() > 0 ) {
671 if ( my $item = $res->item() ) {
672 $reserve{'itemnumber'} = $item->id();
673 $reserve{'barcodenumber'} = $item->barcode();
674 $reserve{'item_level_hold'} = 1;
678 $reserve{'expirationdate'} = $res->expirationdate;
679 $reserve{'date'} = $res->reservedate;
680 $reserve{'borrowernumber'} = $res->borrowernumber();
681 $reserve{'biblionumber'} = $res->biblionumber();
682 $reserve{'patron'} = $res->borrower;
683 $reserve{'notes'} = $res->reservenotes();
684 $reserve{'waiting_date'} = $res->waitingdate();
685 $reserve{'ccode'} = $res->item() ? $res->item()->ccode() : undef;
686 $reserve{'barcode'} = $res->item() ? $res->item()->barcode() : undef;
687 $reserve{'priority'} = $res->priority();
688 $reserve{'lowestPriority'} = $res->lowestPriority();
689 $reserve{'optionloop'} = \@optionloop;
690 $reserve{'suspend'} = $res->suspend();
691 $reserve{'suspend_until'} = $res->suspend_until();
692 $reserve{'reserve_id'} = $res->reserve_id();
693 $reserve{itemtype} = $res->itemtype();
694 $reserve{branchcode} = $res->branchcode();
695 $reserve{object} = $res;
697 push( @reserveloop, \%reserve );
700 # get the time for the form name...
705 fixedRank => $fixedRank,
710 optionloop => \@optionloop,
711 bibitemloop => \@bibitemloop,
712 itemdata_enumchron => $itemdata_enumchron,
713 itemdata_ccode => $itemdata_ccode,
715 biblionumber => $biblionumber,
716 findborrower => $findborrower,
719 C4::Search::enabled_staff_search_views,
722 $biblioloopiter{biblionumber} = $biblionumber;
723 $biblioloopiter{title} = $biblio->title;
724 $biblioloopiter{rank} = $fixedRank;
725 $biblioloopiter{reserveloop} = \@reserveloop;
728 $template->param( reserveloop => \@reserveloop );
731 push @biblioloop, \%biblioloopiter;
734 $template->param( biblioloop => \@biblioloop );
735 $template->param( biblionumbers => $biblionumbers );
736 $template->param( exceeded_maxreserves => $exceeded_maxreserves );
737 $template->param( exceeded_holds_per_record => $exceeded_holds_per_record );
738 $template->param( subscriptionsnumber => CountSubscriptionFromBiblionumber($biblionumber));
740 # pass the userenv branch if no pickup location selected
741 $template->param( pickup => $pickup || C4::Context->userenv->{branch} );
743 if ( C4::Context->preference( 'AllowHoldDateInFuture' ) ) {
744 $template->param( reserve_in_future => 1 );
748 SuspendHoldsIntranet => C4::Context->preference('SuspendHoldsIntranet'),
749 AutoResumeSuspendedHolds => C4::Context->preference('AutoResumeSuspendedHolds'),
753 output_html_with_http_headers $input, $cookie, $template->output;
755 sub sort_borrowerlist {
756 my $borrowerslist = shift;
759 uc( $a->{surname} . $a->{firstname} ) cmp
760 uc( $b->{surname} . $b->{firstname} )