t/db_dependent/HoldsQueue.t

   1 #!/usr/bin/perl
   2
   3 # Test C4::HoldsQueue::CreateQueue() for both transport cost matrix
   4 # and StaticHoldsQueueWeight array (no RandomizeHoldsQueueWeight, no point)
   5 # Wraps tests in transaction that's rolled back, so no data is destroyed
   6 # MySQL WARNING: This makes sense only if your tables are InnoDB, otherwise
   7 # transactions are not supported and mess is left behind
   8
   9 use Modern::Perl;
  10
  11 use C4::Context;
  12
  13 use Data::Dumper;
  14
  15 use Test::More tests => 21;
  16
  17
  18 use C4::Branch;
  19 use C4::ItemType;
  20 use C4::Members;
  21
  22 BEGIN {
  23     use FindBin;
  24     use lib $FindBin::Bin;
  25     use_ok('C4::Reserves');
  26     use_ok('C4::HoldsQueue');
  27 }
  28
  29 # Start transaction
  30 my $dbh = C4::Context->dbh;
  31 $dbh->{AutoCommit} = 0;
  32 $dbh->{RaiseError} = 1;
  33
  34 my $TITLE = "Test Holds Queue XXX";
  35
  36 my %data = (
  37     cardnumber => 'CARDNUMBER42',
  38     firstname =>  'my firstname',
  39     surname => 'my surname',
  40     categorycode => 'S',
  41     branchcode => 'CPL',
  42 );
  43
  44 my $borrowernumber = AddMember(%data);
  45 my $borrower = GetMember( borrowernumber => $borrowernumber );
  46 # Set special (for this test) branches
  47 my $borrower_branchcode = $borrower->{branchcode};
  48 my $branches = C4::Branch::GetBranches;
  49 my @other_branches = grep { $_ ne $borrower_branchcode } keys %$branches;
  50 my $least_cost_branch_code = pop @other_branches
  51   or BAIL_OUT("No point testing only one branch...");
  52 my @item_types = C4::ItemType->all;
  53 my $itemtype = grep { $_->{notforloan} == 1 } @item_types
  54   or BAIL_OUT("No adequate itemtype");
  55
  56 #Set up the stage
  57 # Sysprefs and cost matrix
  58 $dbh->do("UPDATE systempreferences SET value = ? WHERE variable = 'StaticHoldsQueueWeight'", undef,
  59          join( ',', @other_branches, $borrower_branchcode, $least_cost_branch_code));
  60 $dbh->do("UPDATE systempreferences SET value = '0' WHERE variable = 'RandomizeHoldsQueueWeight'");
  61
  62 $dbh->do("DELETE FROM transport_cost");
  63 my $transport_cost_insert_sth = $dbh->prepare("insert into transport_cost (frombranch, tobranch, cost) values (?, ?, ?)");
  64 # Favour $least_cost_branch_code
  65 $transport_cost_insert_sth->execute($borrower_branchcode, $least_cost_branch_code, 0.2);
  66 $transport_cost_insert_sth->execute($least_cost_branch_code, $borrower_branchcode, 0.2);
  67 my @b = @other_branches;
  68 while ( my $b1 = shift @b ) {
  69     foreach my $b2 ($borrower_branchcode, $least_cost_branch_code, @b) {
  70         $transport_cost_insert_sth->execute($b1, $b2, 0.5);
  71         $transport_cost_insert_sth->execute($b2, $b1, 0.5);
  72     }
  73 }
  74
  75
  76 # Loanable items - all possible combinations of homebranch and holdingbranch
  77 $dbh->do("INSERT INTO biblio (frameworkcode, author, title, datecreated)
  78           VALUES             ('SER', 'Koha test', '$TITLE', '2011-02-01')");
  79 my $biblionumber = $dbh->selectrow_array("SELECT biblionumber FROM biblio WHERE title = '$TITLE'")
  80   or BAIL_OUT("Cannot find newly created biblio record");
  81 $dbh->do("INSERT INTO biblioitems (biblionumber, marcxml, itemtype)
  82           VALUES                  ($biblionumber, '', '$itemtype')");
  83 my $biblioitemnumber = $dbh->selectrow_array("SELECT biblioitemnumber FROM biblioitems WHERE biblionumber = $biblionumber")
  84   or BAIL_OUT("Cannot find newly created biblioitems record");
  85
  86 my $items_insert_sth = $dbh->prepare("INSERT INTO items (biblionumber, biblioitemnumber, barcode, homebranch, holdingbranch, notforloan, damaged, itemlost, withdrawn, onloan, itype)
  87                                       VALUES            ($biblionumber, $biblioitemnumber, ?, ?, ?, 0, 0, 0, 0, NULL, '$itemtype')"); # CURRENT_DATE - 3)");
  88 my $first_barcode = int(rand(1000000000000)); # XXX
  89 my $barcode = $first_barcode;
  90 foreach ( $borrower_branchcode, $least_cost_branch_code, @other_branches ) {
  91     $items_insert_sth->execute($barcode++, $borrower_branchcode, $_);
  92     $items_insert_sth->execute($barcode++, $_, $_);
  93     $items_insert_sth->execute($barcode++, $_, $borrower_branchcode);
  94 }
  95
  96 # Remove existing reserves, makes debugging easier
  97 $dbh->do("DELETE FROM reserves");
  98 my $constraint = undef;
  99 my $bibitems = undef;
 100 my $priority = 1;
 101 # Make a reserve
 102 AddReserve ( $borrower_branchcode, $borrowernumber, $biblionumber, $constraint, $bibitems,  $priority );
 103 #                           $resdate, $expdate, $notes, $title, $checkitem, $found
 104 $dbh->do("UPDATE reserves SET reservedate = DATE_SUB( reservedate, INTERVAL 1 DAY )");
 105
 106 # Tests
 107 my $use_cost_matrix_sth = $dbh->prepare("UPDATE systempreferences SET value = ? WHERE variable = 'UseTransportCostMatrix'");
 108 my $test_sth = $dbh->prepare("SELECT * FROM hold_fill_targets
 109                               JOIN tmp_holdsqueue USING (borrowernumber, biblionumber, itemnumber)
 110                               JOIN items USING (itemnumber)
 111                               WHERE borrowernumber = $borrowernumber");
 112
 113 # We have a book available homed in borrower branch, no point fiddling with AutomaticItemReturn
 114 C4::Context->set_preference('AutomaticItemReturn', 0);
 115 test_queue ('take from homebranch',  0, $borrower_branchcode, $borrower_branchcode);
 116 test_queue ('take from homebranch',  1, $borrower_branchcode, $borrower_branchcode);
 117
 118 $dbh->do("DELETE FROM tmp_holdsqueue");
 119 $dbh->do("DELETE FROM hold_fill_targets");
 120 $dbh->do("DELETE FROM issues WHERE itemnumber IN (SELECT itemnumber FROM items WHERE homebranch = '$borrower_branchcode' AND holdingbranch = '$borrower_branchcode')");
 121 $dbh->do("DELETE FROM items WHERE homebranch = '$borrower_branchcode' AND holdingbranch = '$borrower_branchcode'");
 122 # test_queue will flush
 123 C4::Context->set_preference('AutomaticItemReturn', 1);
 124 # Not sure how to make this test more difficult - holding branch does not matter
 125
 126 $dbh->do("DELETE FROM tmp_holdsqueue");
 127 $dbh->do("DELETE FROM hold_fill_targets");
 128 $dbh->do("DELETE FROM issues WHERE itemnumber IN (SELECT itemnumber FROM items WHERE homebranch = '$borrower_branchcode')");
 129 $dbh->do("DELETE FROM items WHERE homebranch = '$borrower_branchcode'");
 130 C4::Context->set_preference('AutomaticItemReturn', 0);
 131 # We have a book available held in borrower branch
 132 test_queue ('take from holdingbranch', 0, $borrower_branchcode, $borrower_branchcode);
 133 test_queue ('take from holdingbranch', 1, $borrower_branchcode, $borrower_branchcode);
 134
 135 $dbh->do("DELETE FROM tmp_holdsqueue");
 136 $dbh->do("DELETE FROM hold_fill_targets");
 137 $dbh->do("DELETE FROM issues WHERE itemnumber IN (SELECT itemnumber FROM items WHERE holdingbranch = '$borrower_branchcode')");
 138 $dbh->do("DELETE FROM items WHERE holdingbranch = '$borrower_branchcode'");
 139 # No book available in borrower branch, pick according to the rules
 140 # Frst branch from StaticHoldsQueueWeight
 141 test_queue ('take from lowest cost branch', 0, $borrower_branchcode, $other_branches[0]);
 142 test_queue ('take from lowest cost branch', 1, $borrower_branchcode, $least_cost_branch_code);
 143 my $queue = C4::HoldsQueue::GetHoldsQueueItems($least_cost_branch_code) || [];
 144 my $queue_item = $queue->[0];
 145 ok( $queue_item
 146  && $queue_item->{pickbranch} eq $borrower_branchcode
 147  && $queue_item->{holdingbranch} eq $least_cost_branch_code, "GetHoldsQueueItems" )
 148   or diag( "Expected item for pick $borrower_branchcode, hold $least_cost_branch_code, got ".Dumper($queue_item) );
 149 ok( exists($queue_item->{itype}), 'item type included in queued items list (bug 5825)' );
 150
 151 ok(
 152     C4::HoldsQueue::least_cost_branch( 'B', [ 'A', 'B', 'C' ] ) eq 'B',
 153     'C4::HoldsQueue::least_cost_branch returns the local branch if it is in the list of branches to pull from'
 154 );
 155
 156 # XXX All this tests are for borrower branch pick-up.
 157 # Maybe needs expanding to homebranch or holdingbranch pick-up.
 158
 159 # Cleanup
 160 $dbh->rollback;
 161
 162 ### Test holds queue builder does not violate holds policy ###
 163
 164 # Clear out existing rules relating to holdallowed
 165 $dbh->do("DELETE FROM default_branch_circ_rules");
 166 $dbh->do("DELETE FROM default_branch_item_rules");
 167 $dbh->do("DELETE FROM default_circ_rules");
 168
 169 C4::Context->set_preference('UseTransportCostMatrix', 0);
 170
 171 my @branchcodes = keys %$branches;
 172 ( $itemtype ) = @{ $dbh->selectrow_arrayref("SELECT itemtype FROM itemtypes LIMIT 1") };
 173
 174 my $borrowernumber1 = AddMember(
 175     (
 176         cardnumber   => 'CARDNUMBER1',
 177         firstname    => 'Firstname',
 178         surname      => 'Surname',
 179         categorycode => 'S',
 180         branchcode   => $branchcodes[0],
 181     )
 182 );
 183 my $borrowernumber2 = AddMember(
 184     (
 185         cardnumber   => 'CARDNUMBER2',
 186         firstname    => 'Firstname',
 187         surname      => 'Surname',
 188         categorycode => 'S',
 189         branchcode   => $branchcodes[1],
 190     )
 191 );
 192 my $borrowernumber3 = AddMember(
 193     (
 194         cardnumber   => 'CARDNUMBER3',
 195         firstname    => 'Firstname',
 196         surname      => 'Surname',
 197         categorycode => 'S',
 198         branchcode   => $branchcodes[2],
 199     )
 200 );
 201 my $borrower1 = GetMember( borrowernumber => $borrowernumber1 );
 202 my $borrower2 = GetMember( borrowernumber => $borrowernumber2 );
 203 my $borrower3 = GetMember( borrowernumber => $borrowernumber3 );
 204
 205 $dbh->do(qq{
 206     INSERT INTO biblio (
 207         frameworkcode,
 208         author,
 209         title,
 210         datecreated
 211     ) VALUES (
 212         'SER',
 213         'Koha test',
 214         '$TITLE',
 215         '2011-02-01'
 216     )
 217 });
 218 $biblionumber = $dbh->selectrow_array("SELECT biblionumber FROM biblio WHERE title = '$TITLE'")
 219   or BAIL_OUT("Cannot find newly created biblio record");
 220
 221 $dbh->do(qq{
 222     INSERT INTO biblioitems (
 223         biblionumber,
 224         marcxml,
 225         itemtype
 226     ) VALUES (
 227         $biblionumber,
 228         '',
 229         '$itemtype'
 230     )
 231 });
 232 $biblioitemnumber = $dbh->selectrow_array("SELECT biblioitemnumber FROM biblioitems WHERE biblionumber = $biblionumber")
 233   or BAIL_OUT("Cannot find newly created biblioitems record");
 234
 235 $items_insert_sth = $dbh->prepare(qq{
 236     INSERT INTO items (
 237         biblionumber,
 238         biblioitemnumber,
 239         barcode,
 240         homebranch,
 241         holdingbranch,
 242         notforloan,
 243         damaged,
 244         itemlost,
 245         withdrawn,
 246         onloan,
 247         itype
 248     ) VALUES (
 249         $biblionumber,
 250         $biblioitemnumber,
 251         ?,
 252         ?,
 253         ?,
 254         0,
 255         0,
 256         0,
 257         0,
 258         NULL,
 259         '$itemtype'
 260     )
 261 });
 262 # Create 3 items from 2 branches ( branches are for borrowers 1 and 2 respectively )
 263 $barcode = int( rand(1000000000000) );
 264 $items_insert_sth->execute( $barcode + 0, $branchcodes[0], $branchcodes[0] );
 265 $items_insert_sth->execute( $barcode + 1, $branchcodes[1], $branchcodes[1] );
 266 $items_insert_sth->execute( $barcode + 2, $branchcodes[1], $branchcodes[1] );
 267
 268 $dbh->do("DELETE FROM reserves");
 269 my $sth = $dbh->prepare(q{
 270     INSERT INTO reserves (
 271         borrowernumber,
 272         biblionumber,
 273         branchcode,
 274         priority,
 275         reservedate
 276     ) VALUES ( ?,?,?,?, CURRENT_DATE() )
 277 });
 278 $sth->execute( $borrower1->{borrowernumber}, $biblionumber, $branchcodes[0], 1 );
 279 $sth->execute( $borrower2->{borrowernumber}, $biblionumber, $branchcodes[0], 2 );
 280 $sth->execute( $borrower3->{borrowernumber}, $biblionumber, $branchcodes[0], 3 );
 281 #warn "RESERVES" . Data::Dumper::Dumper( $dbh->selectall_arrayref("SELECT * FROM reserves", { Slice => {} }) );
 282 #warn "ITEMS: " . Data::Dumper::Dumper( $dbh->selectall_arrayref("SELECT * FROM items WHERE biblionumber = $biblionumber", { Slice => {} }) );
 283
 284 my $holds_queue;
 285
 286 $dbh->do("DELETE FROM default_circ_rules");
 287 $dbh->do("INSERT INTO default_circ_rules ( holdallowed ) VALUES ( 1 )");
 288 C4::HoldsQueue::CreateQueue();
 289 $holds_queue = $dbh->selectall_arrayref("SELECT * FROM tmp_holdsqueue", { Slice => {} });
 290 ok( @$holds_queue == 2, "Holds queue filling correct number for default holds policy 'from home library'" );
 291 ok( $holds_queue->[0]->{cardnumber} eq 'CARDNUMBER1', "Holds queue filling 1st correct hold for default holds policy 'from home library'");
 292 ok( $holds_queue->[1]->{cardnumber} eq 'CARDNUMBER2', "Holds queue filling 2nd correct hold for default holds policy 'from home library'");
 293
 294 $dbh->do("DELETE FROM default_circ_rules");
 295 $dbh->do("INSERT INTO default_circ_rules ( holdallowed ) VALUES ( 2 )");
 296 C4::HoldsQueue::CreateQueue();
 297 $holds_queue = $dbh->selectall_arrayref("SELECT * FROM tmp_holdsqueue", { Slice => {} });
 298 ok( @$holds_queue == 3, "Holds queue filling correct number for holds for default holds policy 'from any library'" );
 299 #warn "HOLDS QUEUE: " . Data::Dumper::Dumper( $holds_queue );
 300
 301 # Cleanup
 302 $dbh->rollback;
 303
 304 ### END Test holds queue builder does not violate holds policy ###
 305
 306 sub test_queue {
 307     my ($test_name, $use_cost_matrix, $pick_branch, $hold_branch) = @_;
 308
 309     $test_name = "$test_name (".($use_cost_matrix ? "" : "don't ")."use cost matrix)";
 310
 311     $use_cost_matrix_sth->execute($use_cost_matrix);
 312     C4::Context->clear_syspref_cache();
 313     C4::HoldsQueue::CreateQueue();
 314
 315     my $results = $dbh->selectall_arrayref($test_sth, { Slice => {} }); # should be only one
 316     my $r = $results->[0];
 317
 318     my $ok = is( $r->{pickbranch}, $pick_branch, "$test_name pick up branch");
 319     $ok &&=  is( $r->{holdingbranch}, $hold_branch, "$test_name holding branch")
 320       if $hold_branch;
 321
 322     diag( "Wrong pick-up/hold for first target (pick_branch, hold_branch, reserves, hold_fill_targets, tmp_holdsqueue): "
 323         . Dumper ($pick_branch, $hold_branch, map dump_records($_), qw(reserves hold_fill_targets tmp_holdsqueue)) )
 324       unless $ok;
 325 }
 326
 327 sub dump_records {
 328     my ($tablename) = @_;
 329     return $dbh->selectall_arrayref("SELECT * from $tablename where borrowernumber = ?", { Slice => {} }, $borrowernumber);
 330 }