Open-ILS/web/js/ui/default/staff/circ/services/holds.js

   1 /**
   2  * Holds, yo
   3  */
   4
   5 angular.module('egCoreMod')
   6
   7 .factory('egHolds',
   8
   9        ['$modal','$q','egCore','egConfirmDialog','egAlertDialog',
  10 function($modal , $q , egCore , egConfirmDialog , egAlertDialog) {
  11
  12     var service = {};
  13
  14     service.fetch_holds = function(hold_ids) {
  15         var deferred = $q.defer();
  16
  17         // FIXME: large batches using .authoritative result in many
  18         // stranded cstore backends on the server.  Needs investigation.
  19         // For now, collect holds in a series of small batches.
  20         // Fetch them serially both to avoid the above problem and
  21         // to maintain order.
  22         var batch_size = 5;
  23         var index = 0;
  24
  25         function one_batch() {
  26             var ids = hold_ids.slice(index, index + batch_size)
  27                 .filter(function(id) {return Boolean(id)}) // avoid nulls
  28
  29             console.debug('egHolds.fetch_holds => ' + ids);
  30             index += batch_size;
  31
  32             if (!ids.length) {
  33                 deferred.resolve();
  34                 return;
  35             }
  36
  37             egCore.net.request(
  38                 'open-ils.circ',
  39                 'open-ils.circ.hold.details.batch.retrieve.authoritative',
  40                 egCore.auth.token(), ids
  41
  42             ).then(
  43                 one_batch,  // kick off the next batch
  44                 null,
  45                 function(hold_data) {
  46                     var hold = hold_data.hold;
  47                     hold_data.id = hold.id();
  48                     service.local_flesh(hold_data);
  49                     deferred.notify(hold_data);
  50                 }
  51             );
  52         }
  53
  54         one_batch(); // kick it off
  55         return deferred.promise;
  56     }
  57
  58
  59     service.cancel_holds = function(hold_ids) {
  60
  61         return $modal.open({
  62             templateUrl : './circ/share/t_cancel_hold_dialog',
  63             controller :
  64                 ['$scope', '$modalInstance', 'cancel_reasons',
  65                 function($scope, $modalInstance, cancel_reasons) {
  66                     $scope.args = {
  67                         cancel_reason : 5,
  68                         cancel_reasons : cancel_reasons,
  69                         num_holds : hold_ids.length
  70                     };
  71
  72                     $scope.cancel = function($event) {
  73                         $modalInstance.dismiss();
  74                         $event.preventDefault();
  75                     }
  76
  77                     $scope.ok = function() {
  78
  79                         function cancel_one() {
  80                             var hold_id = hold_ids.pop();
  81                             if (!hold_id) {
  82                                 $modalInstance.close();
  83                                 return;
  84                             }
  85                             egCore.net.request(
  86                                 'open-ils.circ', 'open-ils.circ.hold.cancel',
  87                                 egCore.auth.token(), hold_id,
  88                                 $scope.args.cancel_reason.id(),
  89                                 $scope.args.note
  90                             ).then(function(resp) {
  91                                 if (evt = egCore.evt.parse(resp)) {
  92                                     console.error('unable to cancel hold: '
  93                                         + evt.toString());
  94                                 }
  95                                 cancel_one();
  96                             });
  97                         }
  98
  99                         cancel_one();
 100                     }
 101                 }
 102             ],
 103             resolve : {
 104                 cancel_reasons : function() {
 105                     return service.get_cancel_reasons();
 106                 }
 107             }
 108         }).result;
 109     }
 110
 111     service.uncancel_holds = function(hold_ids) {
 112
 113         return $modal.open({
 114             templateUrl : './circ/share/t_uncancel_hold_dialog',
 115             controller :
 116                 ['$scope', '$modalInstance',
 117                 function($scope, $modalInstance) {
 118                     $scope.args = {
 119                         num_holds : hold_ids.length
 120                     };
 121
 122                     $scope.cancel = function($event) {
 123                         $modalInstance.dismiss();
 124                         $event.preventDefault();
 125                     }
 126
 127                     $scope.ok = function() {
 128
 129                         function uncancel_one() {
 130                             var hold_id = hold_ids.pop();
 131                             if (!hold_id) {
 132                                 $modalInstance.close();
 133                                 return;
 134                             }
 135                             egCore.net.request(
 136                                 'open-ils.circ', 'open-ils.circ.hold.uncancel',
 137                                 egCore.auth.token(), hold_id
 138                             ).then(function(resp) {
 139                                 if (evt = egCore.evt.parse(resp)) {
 140                                     console.error('unable to uncancel hold: '
 141                                         + evt.toString());
 142                                 }
 143                                 uncancel_one();
 144                             });
 145                         }
 146
 147                         uncancel_one();
 148                     }
 149                 }
 150             ]
 151         }).result;
 152     }
 153
 154     service.get_cancel_reasons = function() {
 155         if (egCore.env.ahrcc) return $q.when(egCore.env.ahrcc.list);
 156         return egCore.pcrud.retrieveAll('ahrcc', {}, {atomic : true})
 157         .then(function(list) { return egCore.env.absorbList(list, 'ahrcc').list });
 158     }
 159
 160     // Updates a batch of holds, notifies on each response.
 161     // new_values = array of hashes describing values to change,
 162     // including the id of the hold to change.
 163     // e.g. {id : 1, mint_condition : true}
 164     service.update_holds = function(new_values) {
 165         return egCore.net.request(
 166             'open-ils.circ',
 167             'open-ils.circ.hold.update.batch',
 168             egCore.auth.token(), null, new_values);
 169     }
 170
 171     service.set_copy_quality = function(hold_ids) {
 172         if (!hold_ids.length) return $q.when();
 173         return $modal.open({
 174             templateUrl : './circ/share/t_hold_copy_quality_dialog',
 175             controller :
 176                 ['$scope', '$modalInstance',
 177                 function($scope, $modalInstance) {
 178
 179                     function update(val) {
 180                         var vals = hold_ids.map(function(hold_id) {
 181                             return {id : hold_id, mint_condition : val}})
 182                         service.update_holds(vals).finally(function() {
 183                             $modalInstance.close();
 184                         });
 185                     }
 186                     $scope.good = function() { update(true) }
 187                     $scope.any = function() { update(false) }
 188                     $scope.cancel = function() { $modalInstance.dismiss() }
 189                 }
 190             ]
 191         }).result;
 192     }
 193
 194     service.edit_pickup_lib = function(hold_ids) {
 195         if (!hold_ids.length) return $q.when();
 196         return $modal.open({
 197             templateUrl : './circ/share/t_hold_edit_pickup_lib',
 198             controller :
 199                 ['$scope', '$modalInstance',
 200                 function($scope, $modalInstance) {
 201                     $scope.args = {}
 202                     $scope.ok = function() {
 203                         var vals = hold_ids.map(function(hold_id) {
 204                             return {
 205                                 id : hold_id,
 206                                 pickup_lib : $scope.args.org_unit.id()
 207                             }
 208                         });
 209                         service.update_holds(vals).finally(function() {
 210                             $modalInstance.close();
 211                         });
 212                     }
 213                     $scope.cancel = function() { $modalInstance.dismiss() }
 214                 }
 215             ]
 216         }).result;
 217     }
 218
 219     service.get_sms_carriers = function() {
 220         if (egCore.env.csc) return $q.when(egCore.env.csc.list);
 221         return egCore.pcrud.retrieveAll('csc', {}, {atomic : true})
 222         .then(function(list) { return egCore.env.absorbList(list, 'csc').list });
 223     }
 224
 225     service.edit_notify_prefs = function(hold_ids) {
 226         if (!hold_ids.length) return $q.when();
 227         return $modal.open({
 228             templateUrl : './circ/share/t_hold_notification_prefs',
 229             controller :
 230                 ['$scope', '$modalInstance', 'sms_carriers',
 231                 function($scope, $modalInstance, sms_carriers) {
 232                     $scope.args = {}
 233                     $scope.sms_carriers = sms_carriers;
 234                     $scope.num_holds = hold_ids.length;
 235                     $scope.ok = function() {
 236
 237                         var vals = hold_ids.map(function(hold_id) {
 238                             var val = {id : hold_id};
 239                             angular.forEach(
 240                                 ['email', 'phone', 'sms'],
 241                                 function(type) {
 242                                     var key = type + '_notify';
 243                                     if ($scope.args['update_' + key])
 244                                         val[key] = $scope.args[key];
 245                                 }
 246                             );
 247                             if ($scope.args.update_sms_carrier)
 248                                 val.sms_carrier = $scope.args.sms_carrier.id();
 249                             return val;
 250                         });
 251
 252                         service.update_holds(vals).finally(function() {
 253                             $modalInstance.close();
 254                         });
 255                     }
 256                     $scope.cancel = function() { $modalInstance.dismiss() }
 257                 }
 258             ],
 259             resolve : {
 260                 sms_carriers : service.get_sms_carriers
 261             }
 262         }).result;
 263     }
 264
 265     service.edit_dates = function(hold_ids) {
 266         if (!hold_ids.length) return $q.when();
 267
 268         // collects the fields from the dialog the user wishes to modify
 269         function relay_to_update(modal_scope) {
 270             var vals = hold_ids.map(function(hold_id) {
 271                 var val = {id : hold_id};
 272                 angular.forEach(
 273                     ['thaw_date', 'request_time', 'expire_time', 'shelf_expire_time'],
 274                     function(field) {
 275                         if (modal_scope.args['modify_' + field])
 276                             val[field] = modal_scope.args[field].toISOString();
 277                     }
 278                 );
 279
 280                 return val;
 281             });
 282
 283             console.log(JSON.stringify(vals,null,2));
 284             return service.update_holds(vals);
 285         }
 286
 287         return $modal.open({
 288             templateUrl : './circ/share/t_hold_dates',
 289             controller :
 290                 ['$scope', '$modalInstance',
 291                 function($scope, $modalInstance) {
 292                     var today = new Date();
 293                     $scope.args = {
 294                         thaw_date : today,
 295                         request_time : today,
 296                         expire_time : today,
 297                         shelf_expire_time : today
 298                     }
 299                     $scope.num_holds = hold_ids.length;
 300                     $scope.ok = function() {
 301                         relay_to_update($scope).then($modalInstance.close);
 302                     }
 303                     $scope.cancel = function() { $modalInstance.dismiss() }
 304                 }
 305             ],
 306         }).result;
 307     }
 308
 309     service.update_field_with_confirm = function(hold_ids, msg_key, field, value) {
 310         if (!hold_ids.length) return $q.when();
 311
 312         return egConfirmDialog.open(
 313             egCore.strings[msg_key], '', {num_holds : hold_ids.length})
 314         .result.then(function() {
 315
 316             var vals = hold_ids.map(function(hold_id) {
 317                 val = {id : hold_id};
 318                 val[field] = value;
 319                 return val;
 320             });
 321             return service.update_holds(vals);
 322         });
 323     }
 324
 325     service.suspend_holds = function(hold_ids) {
 326         return service.update_field_with_confirm(
 327             hold_ids, 'SUSPEND_HOLDS', 'frozen', true);
 328     }
 329
 330     service.activate_holds = function(hold_ids) {
 331         return service.update_field_with_confirm(
 332             hold_ids, 'ACTIVATE_HOLDS', 'frozen', false);
 333     }
 334
 335     service.set_top_of_queue = function(hold_ids) {
 336         return service.update_field_with_confirm(
 337             hold_ids, 'SET_TOP_OF_QUEUE', 'cut_in_line', true);
 338     }
 339
 340     service.clear_top_of_queue = function(hold_ids) {
 341         return service.update_field_with_confirm(
 342             hold_ids, 'CLEAR_TOP_OF_QUEUE', 'cut_in_line', null);
 343     }
 344
 345     service.transfer_to_marked_title = function(hold_ids) {
 346         if (!hold_ids.length) return $q.when();
 347
 348         var bib_id = egCore.hatch.getLocalItem(
 349             'eg.circ.hold.title_transfer_target');
 350
 351         if (!bib_id) {
 352             // no target marked
 353             return egAlertDialog.open(
 354                 egCore.strings.NO_HOLD_TRANSFER_TITLE_MARKED).result;
 355         }
 356
 357         return egConfirmDialog.open(
 358             egCore.strings.TRANSFER_HOLD_TO_TITLE, '', {
 359                 num_holds : hold_ids.length,
 360                 bib_id : bib_id
 361             }
 362         ).result.then(function() {
 363             return egCore.net.request(
 364                 'open-ils.circ',
 365                 'open-ils.circ.hold.change_title.specific_holds',
 366                 egCore.auth.token(), bib_id, hold_ids);
 367         });
 368     }
 369
 370     // serially retargets each hold
 371     service.retarget = function(hold_ids) {
 372         if (!hold_ids.length) return $q.when();
 373         var deferred = $q.defer();
 374
 375         egConfirmDialog.open(
 376             egCore.strings.RETARGET_HOLDS, '',
 377             {hold_ids : hold_ids.join(',')}
 378
 379         ).result.then(function() {
 380
 381             function do_one() {
 382                 var hold_id = hold_ids.pop();
 383                 if (!hold_id) {
 384                     deferred.resolve();
 385                     return;
 386                 }
 387
 388                 egCore.net.request(
 389                     'open-ils.circ',
 390                     'open-ils.circ.hold.reset',
 391                     egCore.auth.token(), hold_id).finally(do_one);
 392             }
 393
 394             do_one(); // kick it off
 395         });
 396
 397         return deferred.promise;
 398     }
 399
 400     // fleshes orgs, etc. for hold data blobs retrieved from
 401     // open-ils.circ.hold.details[.batch].retrieve
 402     service.local_flesh = function(hold_data) {
 403
 404         hold_data.status_string =
 405             egCore.strings['HOLD_STATUS_' + hold_data.status]
 406             || hold_data.status;
 407
 408         var hold = hold_data.hold;
 409         hold.pickup_lib(egCore.org.get(hold.pickup_lib()));
 410         hold.current_shelf_lib(egCore.org.get(hold.current_shelf_lib()));
 411         hold_data.id = hold.id();
 412
 413         if (hold.requestor() && typeof hold.requestor() != 'object')
 414             egCore.pcrud.retrieve('au',hold.requestor()).then(function(u) { hold.requestor(u) });
 415
 416         if (hold.usr() && typeof hold.usr() != 'object')
 417             egCore.pcrud.retrieve('au',hold.usr()).then(function(u) { hold.usr(u) });
 418
 419         // current_copy is not always fleshed in the API
 420         if (hold.current_copy() && typeof hold.current_copy() != 'object')
 421             hold.current_copy(hold_data.copy);
 422     }
 423
 424     return service;
 425 }])
 426
 427 /**
 428  * Action handlers for the common Hold grid UI.
 429  * These generally scrub the data for valid input then pass the
 430  * holds / copies / etc. off to the relevant action in egHolds or egCirc.
 431  *
 432  * Caller must apply a reset_page function, which is called after
 433  * most actionis are performed.
 434  */
 435 .factory('egHoldGridActions',
 436        ['$window','$location','egCore','egHolds','egCirc',
 437 function($window , $location , egCore , egHolds , egCirc) {
 438
 439     var service = {};
 440
 441     service.refresh = function() {
 442         console.error('egHoldGridActions.refresh not defined!');
 443     }
 444
 445     service.cancel_hold = function(items) {
 446         var hold_ids = items.filter(function(item) {
 447             return !item.hold.cancel_time();
 448         }).map(function(item) {return item.hold.id()});
 449
 450         return egHolds.cancel_holds(hold_ids).then(service.refresh);
 451     }
 452
 453     service.uncancel_hold = function(items) {
 454         var hold_ids = items.filter(function(item) {
 455             return item.hold.cancel_time();
 456         }).map(function(item) {return item.hold.id()});
 457
 458         return egHolds.uncancel_holds(hold_ids).then(service.refresh);
 459     }
 460
 461     // jump to circ list for either 1) the targeted copy or
 462     // 2) the hold target copy for copy-level holds
 463     service.show_recent_circs = function(items) {
 464         if (items.length && (copy = items[0].copy)) {
 465             var url = $location.path(
 466                 '/cat/item/' + copy.id() + '/circ_list').absUrl();
 467             $window.open(url, '_blank').focus();
 468         }
 469     }
 470
 471     function generic_update(items, action) {
 472         if (!items.length) return $q.when();
 473         var hold_ids = items.map(function(item) {return item.hold.id()});
 474         return egHolds[action](hold_ids).then(service.refresh);
 475     }
 476
 477     service.set_copy_quality = function(items) {
 478         generic_update(items, 'set_copy_quality'); }
 479     service.edit_pickup_lib = function(items) {
 480         generic_update(items, 'edit_pickup_lib'); }
 481     service.edit_notify_prefs = function(items) {
 482         generic_update(items, 'edit_notify_prefs'); }
 483     service.edit_dates = function(items) {
 484         generic_update(items, 'edit_dates'); }
 485     service.suspend = function(items) {
 486         generic_update(items, 'suspend_holds'); }
 487     service.activate = function(items) {
 488         generic_update(items, 'activate_holds'); }
 489     service.set_top_of_queue = function(items) {
 490         generic_update(items, 'set_top_of_queue'); }
 491     service.clear_top_of_queue = function(items) {
 492         generic_update(items, 'clear_top_of_queue'); }
 493     service.transfer_to_marked_title = function(items) {
 494         generic_update(items, 'transfer_to_marked_title'); }
 495
 496     service.mark_damaged = function(items) {
 497         var copy_ids = items
 498             .filter(function(item) { return Boolean(item.copy) })
 499             .map(function(item) { return item.copy.id() });
 500         if (copy_ids.length)
 501             egCirc.mark_damaged(copy_ids).then(service.refresh);
 502     }
 503
 504     service.mark_missing = function(items) {
 505         var copy_ids = items
 506             .filter(function(item) { return Boolean(item.copy) })
 507             .map(function(item) { return item.copy.id() });
 508         if (copy_ids.length)
 509             egCirc.mark_missing(copy_ids).then(service.refresh);
 510     }
 511
 512     service.retarget = function(items) {
 513         var hold_ids = items.map(function(item) { return item.hold.id() });
 514         egHolds.retarget(hold_ids).then(service.refresh);
 515     }
 516
 517     return service;
 518 }])
 519
 520 /**
 521  * Hold details interface
 522  */
 523 .directive('egHoldDetails', function() {
 524     return {
 525         restrict : 'AE',
 526         templateUrl : './circ/share/t_hold_details',
 527         scope : {
 528             holdId : '=',
 529             // if set, called whenever hold details are retrieved.  The
 530             // argument is the hold blob returned from hold.details.retrieve
 531             holdRetrieved : '=',
 532             showPatron : '='
 533         },
 534         controller : [
 535                     '$scope','$modal','egCore','egHolds','egCirc',
 536             function($scope , $modal , egCore , egHolds , egCirc) {
 537
 538                 function draw() {
 539                     if (!$scope.holdId) return;
 540
 541                     egCore.net.request(
 542                         'open-ils.circ',
 543                         'open-ils.circ.hold.details.retrieve.authoritative',
 544                         egCore.auth.token(), $scope.holdId
 545
 546                     ).then(function(hold_data) {
 547                         egHolds.local_flesh(hold_data);
 548
 549                         angular.forEach(hold_data,
 550                             function(val, key) { $scope[key] = val });
 551
 552                         // fetch + flesh the cancel_cause if needed
 553                         if ($scope.hold.cancel_time()) {
 554                             egHolds.get_cancel_reasons().then(function() {
 555                                 // egHolds caches the causes in egEnv
 556                                 $scope.hold.cancel_cause(
 557                                     egCore.env.ahrcc.map[$scope.hold.cancel_cause()]);
 558                             })
 559                         }
 560
 561                         if ($scope.hold.current_copy()) {
 562                             egCirc.flesh_copy_location($scope.hold.current_copy());
 563                         }
 564
 565                         if ($scope.holdRetrieved)
 566                             $scope.holdRetrieved(hold_data);
 567
 568                     });
 569                 }
 570
 571                 $scope.show_notify_tab = function() {
 572                     $scope.detail_tab = 'notify';
 573                     egCore.pcrud.search('ahn',
 574                         {hold : $scope.hold.id()},
 575                         {flesh : 1, flesh_fields : {ahn : ['notify_staff']}},
 576                         {atomic : true}
 577                     ).then(function(nots) {
 578                         $scope.hold.notifications(nots);
 579                     });
 580                 }
 581
 582                 $scope.delete_note = function(note) {
 583                     egCore.pcrud.remove(note).then(function() {
 584                         // remove the deleted note from the locally fleshed notes
 585                         $scope.hold.notes(
 586                             $scope.hold.notes().filter(function(n) {
 587                                 return n.id() != note.id()
 588                             })
 589                         );
 590                     });
 591                 }
 592
 593                 $scope.new_note = function() {
 594                     return $modal.open({
 595                         templateUrl : './circ/share/t_hold_note_dialog',
 596                         controller :
 597                             ['$scope', '$modalInstance',
 598                             function($scope, $modalInstance) {
 599                                 $scope.args = {};
 600                                 $scope.ok = function() {
 601                                     $modalInstance.close($scope.args)
 602                                 },
 603                                 $scope.cancel = function($event) {
 604                                     $modalInstance.dismiss();
 605                                     $event.preventDefault();
 606                                 }
 607                             }
 608                         ]
 609                     }).result.then(function(args) {
 610                         var note = new egCore.idl.ahrn();
 611                         note.hold($scope.hold.id());
 612                         note.staff(true);
 613                         note.slip(args.slip);
 614                         note.pub(args.pub);
 615                         note.title(args.title);
 616                         note.body(args.body);
 617                         return egCore.pcrud.create(note).then(function(n) {
 618                             $scope.hold.notes().push(n);
 619                         });
 620                     });
 621                 }
 622
 623                 $scope.new_notification = function() {
 624                     return $modal.open({
 625                         templateUrl : './circ/share/t_hold_notification_dialog',
 626                         controller :
 627                             ['$scope', '$modalInstance',
 628                             function($scope, $modalInstance) {
 629                                 $scope.args = {};
 630                                 $scope.ok = function() {
 631                                     $modalInstance.close($scope.args)
 632                                 },
 633                                 $scope.cancel = function($event) {
 634                                     $modalInstance.dismiss();
 635                                     $event.preventDefault();
 636                                 }
 637                             }
 638                         ]
 639                     }).result.then(function(args) {
 640                         var note = new egCore.idl.ahn();
 641                         note.hold($scope.hold.id());
 642                         note.method(args.method);
 643                         note.note(args.note);
 644                         note.notify_staff(egCore.auth.user().id());
 645                         note.notify_time('now');
 646                         return egCore.pcrud.create(note).then(function(n) {
 647                             n.notify_staff(egCore.auth.user());
 648                             $scope.hold.notifications().push(n);
 649                         });
 650                     });
 651                 }
 652
 653                 $scope.$watch('holdId', function(newVal, oldVal) {
 654                     if (newVal != oldVal) draw();
 655                 });
 656
 657                 draw();
 658             }
 659         ]
 660     }
 661 })
 662
 663