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,
  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.cant_be_pickup = function (id) { return !egCore.org.CanHaveUsers(id); };
 202                     $scope.args = {};
 203                     $scope.ok = function() {
 204                         var vals = hold_ids.map(function(hold_id) {
 205                             return {
 206                                 id : hold_id,
 207                                 pickup_lib : $scope.args.org_unit.id()
 208                             }
 209                         });
 210                         service.update_holds(vals).finally(function() {
 211                             $modalInstance.close();
 212                         });
 213                     }
 214                     $scope.cancel = function() { $modalInstance.dismiss() }
 215                 }
 216             ]
 217         }).result;
 218     }
 219
 220     service.get_sms_carriers = function() {
 221         if (egCore.env.csc) return $q.when(egCore.env.csc.list);
 222         return egCore.pcrud.retrieveAll('csc', {}, {atomic : true})
 223         .then(function(list) { return egCore.env.absorbList(list, 'csc').list });
 224     }
 225
 226     service.edit_notify_prefs = function(hold_ids) {
 227         if (!hold_ids.length) return $q.when();
 228         return $modal.open({
 229             templateUrl : './circ/share/t_hold_notification_prefs',
 230             controller :
 231                 ['$scope', '$modalInstance', 'sms_carriers',
 232                 function($scope, $modalInstance, sms_carriers) {
 233                     $scope.args = {}
 234                     $scope.sms_carriers = sms_carriers;
 235                     $scope.num_holds = hold_ids.length;
 236                     $scope.ok = function() {
 237
 238                         var vals = hold_ids.map(function(hold_id) {
 239                             var val = {id : hold_id};
 240                             angular.forEach(
 241                                 ['email', 'phone', 'sms'],
 242                                 function(type) {
 243                                     var key = type + '_notify';
 244                                     if ($scope.args['update_' + key])
 245                                         val[key] = $scope.args[key];
 246                                 }
 247                             );
 248                             if ($scope.args.update_sms_carrier)
 249                                 val.sms_carrier = $scope.args.sms_carrier.id();
 250                             return val;
 251                         });
 252
 253                         service.update_holds(vals).finally(function() {
 254                             $modalInstance.close();
 255                         });
 256                     }
 257                     $scope.cancel = function() { $modalInstance.dismiss() }
 258                 }
 259             ],
 260             resolve : {
 261                 sms_carriers : service.get_sms_carriers
 262             }
 263         }).result;
 264     }
 265
 266     service.edit_dates = function(hold_ids) {
 267         if (!hold_ids.length) return $q.when();
 268
 269         // collects the fields from the dialog the user wishes to modify
 270         function relay_to_update(modal_scope) {
 271             var vals = hold_ids.map(function(hold_id) {
 272                 var val = {id : hold_id};
 273                 angular.forEach(
 274                     ['thaw_date', 'request_time', 'expire_time', 'shelf_expire_time'],
 275                     function(field) {
 276                         if (modal_scope.args['modify_' + field])
 277                             val[field] = modal_scope.args[field].toISOString();
 278                     }
 279                 );
 280
 281                 return val;
 282             });
 283
 284             console.log(JSON.stringify(vals,null,2));
 285             return service.update_holds(vals);
 286         }
 287
 288         return $modal.open({
 289             templateUrl : './circ/share/t_hold_dates',
 290             controller :
 291                 ['$scope', '$modalInstance',
 292                 function($scope, $modalInstance) {
 293                     var today = new Date();
 294                     $scope.args = {
 295                         thaw_date : today,
 296                         request_time : today,
 297                         expire_time : today,
 298                         shelf_expire_time : today
 299                     }
 300                     $scope.num_holds = hold_ids.length;
 301                     $scope.ok = function() {
 302                         relay_to_update($scope).then($modalInstance.close);
 303                     }
 304                     $scope.cancel = function() { $modalInstance.dismiss() }
 305                 }
 306             ],
 307         }).result;
 308     }
 309
 310     service.update_field_with_confirm = function(hold_ids, msg_key, field, value) {
 311         if (!hold_ids.length) return $q.when();
 312
 313         return egConfirmDialog.open(
 314             egCore.strings[msg_key], '', {num_holds : hold_ids.length})
 315         .result.then(function() {
 316
 317             var vals = hold_ids.map(function(hold_id) {
 318                 val = {id : hold_id};
 319                 val[field] = value;
 320                 return val;
 321             });
 322             return service.update_holds(vals);
 323         });
 324     }
 325
 326     service.suspend_holds = function(hold_ids) {
 327         return service.update_field_with_confirm(
 328             hold_ids, 'SUSPEND_HOLDS', 'frozen', true);
 329     }
 330
 331     service.activate_holds = function(hold_ids) {
 332         return service.update_field_with_confirm(
 333             hold_ids, 'ACTIVATE_HOLDS', 'frozen', false);
 334     }
 335
 336     service.set_top_of_queue = function(hold_ids) {
 337         return service.update_field_with_confirm(
 338             hold_ids, 'SET_TOP_OF_QUEUE', 'cut_in_line', true);
 339     }
 340
 341     service.clear_top_of_queue = function(hold_ids) {
 342         return service.update_field_with_confirm(
 343             hold_ids, 'CLEAR_TOP_OF_QUEUE', 'cut_in_line', null);
 344     }
 345
 346     service.transfer_to_marked_title = function(hold_ids) {
 347         if (!hold_ids.length) return $q.when();
 348
 349         var bib_id = egCore.hatch.getLocalItem(
 350             'eg.circ.hold.title_transfer_target');
 351
 352         if (!bib_id) {
 353             // no target marked
 354             return egAlertDialog.open(
 355                 egCore.strings.NO_HOLD_TRANSFER_TITLE_MARKED).result;
 356         }
 357
 358         return egConfirmDialog.open(
 359             egCore.strings.TRANSFER_HOLD_TO_TITLE, '', {
 360                 num_holds : hold_ids.length,
 361                 bib_id : bib_id
 362             }
 363         ).result.then(function() {
 364             return egCore.net.request(
 365                 'open-ils.circ',
 366                 'open-ils.circ.hold.change_title.specific_holds',
 367                 egCore.auth.token(), bib_id, hold_ids);
 368         });
 369     }
 370
 371     // serially retargets each hold
 372     service.retarget = function(hold_ids) {
 373         if (!hold_ids.length) return $q.when();
 374         var deferred = $q.defer();
 375
 376         egConfirmDialog.open(
 377             egCore.strings.RETARGET_HOLDS, '',
 378             {hold_ids : hold_ids.join(',')}
 379
 380         ).result.then(function() {
 381
 382             function do_one() {
 383                 var hold_id = hold_ids.pop();
 384                 if (!hold_id) {
 385                     deferred.resolve();
 386                     return;
 387                 }
 388
 389                 egCore.net.request(
 390                     'open-ils.circ',
 391                     'open-ils.circ.hold.reset',
 392                     egCore.auth.token(), hold_id).finally(do_one);
 393             }
 394
 395             do_one(); // kick it off
 396         });
 397
 398         return deferred.promise;
 399     }
 400
 401     // fleshes orgs, etc. for hold data blobs retrieved from
 402     // open-ils.circ.hold.details[.batch].retrieve
 403     service.local_flesh = function(hold_data) {
 404
 405         hold_data.status_string =
 406             egCore.strings['HOLD_STATUS_' + hold_data.status]
 407             || hold_data.status;
 408
 409         var hold = hold_data.hold;
 410         hold.pickup_lib(egCore.org.get(hold.pickup_lib()));
 411         hold.current_shelf_lib(egCore.org.get(hold.current_shelf_lib()));
 412         hold_data.id = hold.id();
 413
 414         if (hold.requestor() && typeof hold.requestor() != 'object')
 415             egCore.pcrud.retrieve('au',hold.requestor()).then(function(u) { hold.requestor(u) });
 416
 417         if (hold.cancel_cause() && typeof hold.cancel_cause() != 'object')
 418             egCore.pcrud.retrieve('ahrcc',hold.cancel_cause()).then(function(c) { hold.cancel_cause(c) });
 419
 420         if (hold.usr() && typeof hold.usr() != 'object')
 421             egCore.pcrud.retrieve('au',hold.usr()).then(function(u) { hold.usr(u) });
 422
 423         // current_copy is not always fleshed in the API
 424         if (hold.current_copy() && typeof hold.current_copy() != 'object')
 425             hold.current_copy(hold_data.copy);
 426     }
 427
 428     return service;
 429 }])
 430
 431 /**
 432  * Action handlers for the common Hold grid UI.
 433  * These generally scrub the data for valid input then pass the
 434  * holds / copies / etc. off to the relevant action in egHolds or egCirc.
 435  *
 436  * Caller must apply a reset_page function, which is called after
 437  * most actionis are performed.
 438  */
 439 .factory('egHoldGridActions',
 440        ['$window','$location','$timeout','egCore','egHolds','egCirc',
 441 function($window , $location , $timeout , egCore , egHolds , egCirc) {
 442
 443     var service = {};
 444
 445     service.refresh = function() {
 446         console.error('egHoldGridActions.refresh not defined!');
 447     }
 448
 449     service.cancel_hold = function(items) {
 450         var hold_ids = items.filter(function(item) {
 451             return !item.hold.cancel_time();
 452         }).map(function(item) {return item.hold.id()});
 453
 454         return egHolds.cancel_holds(hold_ids).then(service.refresh);
 455     }
 456
 457     service.uncancel_hold = function(items) {
 458         var hold_ids = items.filter(function(item) {
 459             return item.hold.cancel_time();
 460         }).map(function(item) {return item.hold.id()});
 461
 462         return egHolds.uncancel_holds(hold_ids).then(service.refresh);
 463     }
 464
 465     // jump to circ list for either 1) the targeted copy or
 466     // 2) the hold target copy for copy-level holds
 467     service.show_recent_circs = function(items) {
 468         var focus = items.length == 1;
 469         angular.forEach(items, function(item) {
 470             if (item.copy) {
 471                 var url = egCore.env.basePath +
 472                           '/cat/item/' +
 473                           item.copy.id() +
 474                           '/circ_list';
 475                 $timeout(function() { var x = $window.open(url, '_blank'); if (focus) x.focus() });
 476             }
 477         });
 478     }
 479
 480     service.show_patrons = function(items) {
 481         var focus = items.length == 1;
 482         angular.forEach(items, function(item) {
 483             var url = egCore.env.basePath +
 484                       'circ/patron/' +
 485                       item.hold.usr().id() +
 486                       '/holds';
 487             $timeout(function() { var x = $window.open(url, '_blank'); if (focus) x.focus() });
 488         });
 489     }
 490
 491     service.show_holds_for_title = function(items) {
 492         var focus = items.length == 1;
 493         angular.forEach(items, function(item) {
 494             var url = egCore.env.basePath +
 495                       'cat/catalog/record/' +
 496                       item.mvr.doc_id() +
 497                       '/holds';
 498             $timeout(function() { var x = $window.open(url, '_blank'); if (focus) x.focus() });
 499         });
 500     }
 501
 502
 503     function generic_update(items, action) {
 504         if (!items.length) return $q.when();
 505         var hold_ids = items.map(function(item) {return item.hold.id()});
 506         return egHolds[action](hold_ids).then(service.refresh);
 507     }
 508
 509     service.set_copy_quality = function(items) {
 510         generic_update(items, 'set_copy_quality'); }
 511     service.edit_pickup_lib = function(items) {
 512         generic_update(items, 'edit_pickup_lib'); }
 513     service.edit_notify_prefs = function(items) {
 514         generic_update(items, 'edit_notify_prefs'); }
 515     service.edit_dates = function(items) {
 516         generic_update(items, 'edit_dates'); }
 517     service.suspend = function(items) {
 518         generic_update(items, 'suspend_holds'); }
 519     service.activate = function(items) {
 520         generic_update(items, 'activate_holds'); }
 521     service.set_top_of_queue = function(items) {
 522         generic_update(items, 'set_top_of_queue'); }
 523     service.clear_top_of_queue = function(items) {
 524         generic_update(items, 'clear_top_of_queue'); }
 525     service.transfer_to_marked_title = function(items) {
 526         generic_update(items, 'transfer_to_marked_title'); }
 527
 528     service.mark_damaged = function(items) {
 529         var copy_ids = items
 530             .filter(function(item) { return Boolean(item.copy) })
 531             .map(function(item) { return item.copy.id() });
 532         if (copy_ids.length)
 533             egCirc.mark_damaged(copy_ids).then(service.refresh);
 534     }
 535
 536     service.mark_missing = function(items) {
 537         var copy_ids = items
 538             .filter(function(item) { return Boolean(item.copy) })
 539             .map(function(item) { return item.copy.id() });
 540         if (copy_ids.length)
 541             egCirc.mark_missing(copy_ids).then(service.refresh);
 542     }
 543
 544     service.retarget = function(items) {
 545         var hold_ids = items.map(function(item) { return item.hold.id() });
 546         egHolds.retarget(hold_ids).then(service.refresh);
 547     }
 548
 549     return service;
 550 }])
 551
 552 /**
 553  * Hold details interface
 554  */
 555 .directive('egHoldDetails', function() {
 556     return {
 557         restrict : 'AE',
 558         templateUrl : './circ/share/t_hold_details',
 559         scope : {
 560             holdId : '=',
 561             // if set, called whenever hold details are retrieved.  The
 562             // argument is the hold blob returned from hold.details.retrieve
 563             holdRetrieved : '=',
 564             showPatron : '='
 565         },
 566         controller : [
 567                     '$scope','$modal','egCore','egHolds','egCirc',
 568             function($scope , $modal , egCore , egHolds , egCirc) {
 569
 570                 function draw() {
 571                     if (!$scope.holdId) return;
 572
 573                     egCore.net.request(
 574                         'open-ils.circ',
 575                         'open-ils.circ.hold.details.retrieve.authoritative',
 576                         egCore.auth.token(), $scope.holdId
 577
 578                     ).then(function(hold_data) {
 579                         egHolds.local_flesh(hold_data);
 580
 581                         angular.forEach(hold_data,
 582                             function(val, key) { $scope[key] = val });
 583
 584                         // fetch + flesh the cancel_cause if needed
 585                         if ($scope.hold.cancel_time()) {
 586                             egHolds.get_cancel_reasons().then(function() {
 587                                 // egHolds caches the causes in egEnv
 588                                 $scope.hold.cancel_cause(
 589                                     egCore.env.ahrcc.map[$scope.hold.cancel_cause()]);
 590                             })
 591                         }
 592
 593                         if ($scope.hold.current_copy()) {
 594                             egCirc.flesh_copy_location($scope.hold.current_copy());
 595                         }
 596
 597                         if ($scope.holdRetrieved)
 598                             $scope.holdRetrieved(hold_data);
 599
 600                     });
 601                 }
 602
 603                 $scope.show_notify_tab = function() {
 604                     $scope.detail_tab = 'notify';
 605                     egCore.pcrud.search('ahn',
 606                         {hold : $scope.hold.id()},
 607                         {flesh : 1, flesh_fields : {ahn : ['notify_staff']}},
 608                         {atomic : true}
 609                     ).then(function(nots) {
 610                         $scope.hold.notifications(nots);
 611                     });
 612                 }
 613
 614                 $scope.delete_note = function(note) {
 615                     egCore.pcrud.remove(note).then(function() {
 616                         // remove the deleted note from the locally fleshed notes
 617                         $scope.hold.notes(
 618                             $scope.hold.notes().filter(function(n) {
 619                                 return n.id() != note.id()
 620                             })
 621                         );
 622                     });
 623                 }
 624
 625                 $scope.new_note = function() {
 626                     return $modal.open({
 627                         templateUrl : './circ/share/t_hold_note_dialog',
 628                         controller :
 629                             ['$scope', '$modalInstance',
 630                             function($scope, $modalInstance) {
 631                                 $scope.args = {};
 632                                 $scope.ok = function() {
 633                                     $modalInstance.close($scope.args)
 634                                 },
 635                                 $scope.cancel = function($event) {
 636                                     $modalInstance.dismiss();
 637                                     $event.preventDefault();
 638                                 }
 639                             }
 640                         ]
 641                     }).result.then(function(args) {
 642                         var note = new egCore.idl.ahrn();
 643                         note.hold($scope.hold.id());
 644                         note.staff(true);
 645                         note.slip(args.slip);
 646                         note.pub(args.pub);
 647                         note.title(args.title);
 648                         note.body(args.body);
 649                         return egCore.pcrud.create(note).then(function(n) {
 650                             $scope.hold.notes().push(n);
 651                         });
 652                     });
 653                 }
 654
 655                 $scope.new_notification = function() {
 656                     return $modal.open({
 657                         templateUrl : './circ/share/t_hold_notification_dialog',
 658                         controller :
 659                             ['$scope', '$modalInstance',
 660                             function($scope, $modalInstance) {
 661                                 $scope.args = {};
 662                                 $scope.ok = function() {
 663                                     $modalInstance.close($scope.args)
 664                                 },
 665                                 $scope.cancel = function($event) {
 666                                     $modalInstance.dismiss();
 667                                     $event.preventDefault();
 668                                 }
 669                             }
 670                         ]
 671                     }).result.then(function(args) {
 672                         var note = new egCore.idl.ahn();
 673                         note.hold($scope.hold.id());
 674                         note.method(args.method);
 675                         note.note(args.note);
 676                         note.notify_staff(egCore.auth.user().id());
 677                         note.notify_time('now');
 678                         return egCore.pcrud.create(note).then(function(n) {
 679                             n.notify_staff(egCore.auth.user());
 680                             $scope.hold.notifications().push(n);
 681                         });
 682                     });
 683                 }
 684
 685                 $scope.$watch('holdId', function(newVal, oldVal) {
 686                     if (newVal != oldVal) draw();
 687                 });
 688
 689                 draw();
 690             }
 691         ]
 692     }
 693 })
 694
 695