Open-ILS/web/js/ui/default/staff/circ/patron/checkout.js

   1 /**
   2  * Checkout items to patrons
   3  */
   4
   5 angular.module('egPatronApp').controller('PatronCheckoutCtrl',
   6
   7        ['$scope','$q','$routeParams','egCore','egUser','patronSvc',
   8         'egGridDataProvider','$location','$timeout','egCirc','ngToast',
   9
  10 function($scope , $q , $routeParams , egCore , egUser , patronSvc ,
  11          egGridDataProvider , $location , $timeout , egCirc , ngToast) {
  12
  13     $scope.initTab('checkout', $routeParams.id).finally(function(){
  14         $scope.focusMe = true;
  15     });
  16     $scope.checkouts = patronSvc.checkouts;
  17     $scope.checkoutArgs = {
  18         noncat_type : 'barcode',
  19         due_date : new Date()
  20     };
  21
  22     $scope.minDate = new Date();
  23     $scope.outOfRange = false;
  24     $scope.gridDataProvider = egGridDataProvider.instance({
  25         get : function(offset, count) {
  26             return this.arrayNotifier($scope.checkouts, offset, count);
  27         }
  28     });
  29
  30     $scope.disable_checkout = function() {
  31         return (
  32             !patronSvc.current ||
  33             patronSvc.current.active() == 'f' ||
  34             patronSvc.current.deleted() == 't' ||
  35             patronSvc.current.card().active() == 'f' ||
  36             patronSvc.fetchedWithInactiveCard() ||
  37             $scope.outOfRange == true
  38         );
  39     }
  40
  41     function setting_value (user, setting) {
  42         if (user) {
  43             var list = user.settings().filter(function(s){
  44                 return s.name() == setting;
  45             });
  46
  47             if (list.length) return list[0].value();
  48         }
  49     }
  50
  51     $scope.date_options = {
  52         due_date : egCore.hatch.getSessionItem('eg.circ.checkout.due_date'),
  53         has_sticky_date : egCore.hatch.getSessionItem('eg.circ.checkout.is_until_logout'),
  54         is_until_logout : egCore.hatch.getSessionItem('eg.circ.checkout.is_until_logout')
  55     };
  56
  57     if ($scope.date_options.is_until_logout) { // If until_logout is set there should also be a date set.
  58         $scope.checkoutArgs.due_date = new Date($scope.date_options.due_date);
  59         $scope.checkoutArgs.sticky_date = true;
  60     }
  61
  62     $scope.toggle_opt = function(opt) {
  63         if ($scope.date_options[opt]) {
  64             $scope.date_options[opt] = false;
  65         } else {
  66             $scope.date_options[opt] = true;
  67         }
  68     };
  69
  70     // The interactions between these options are complicated enough that $watch'ing them all is the only safe way to keep things sane.
  71     $scope.$watch('date_options.has_sticky_date', function(newval) {
  72         if ( newval ) { // was false, is true
  73             // $scope.date_options.due_date = checkoutArgs.due_date;
  74         } else {
  75             $scope.date_options.is_until_logout = false;
  76         }
  77         $scope.checkoutArgs.sticky_date = newval;
  78     });
  79
  80     $scope.$watch('date_options.is_until_logout', function(newval) {
  81         if ( newval ) { // was false, is true
  82             $scope.date_options.has_sticky_date = true;
  83             $scope.date_options.due_date = $scope.checkoutArgs.due_date;
  84             egCore.hatch.setSessionItem('eg.circ.checkout.is_until_logout', true);
  85             egCore.hatch.setSessionItem('eg.circ.checkout.due_date', $scope.checkoutArgs.due_date);
  86         } else {
  87             egCore.hatch.removeSessionItem('eg.circ.checkout.is_until_logout');
  88             egCore.hatch.removeSessionItem('eg.circ.checkout.due_date');
  89         }
  90     });
  91
  92     $scope.$watch('checkoutArgs.due_date', function(newval) {
  93         if ( $scope.date_options.is_until_logout && !isNaN(newval)) {
  94             if (!$scope.outOfRange) {
  95                 egCore.hatch.setSessionItem('eg.circ.checkout.due_date', newval);
  96             } else {
  97                 egCore.hatch.setSessionItem('eg.circ.checkout.due_date', $scope.checkoutArgs.due_date);
  98             }
  99         }
 100     });
 101
 102     $scope.has_email_address = function() {
 103         return (
 104             patronSvc.current &&
 105             patronSvc.current.email() &&
 106             patronSvc.current.email().match(/.*@.*/)
 107         );
 108     }
 109
 110     $scope.may_email_receipt = function() {
 111         return (
 112             $scope.has_email_address() &&
 113             setting_value(
 114                 patronSvc.current,
 115                 'circ.send_email_checkout_receipts'
 116             ) == 'true'
 117         );
 118     }
 119
 120     egCore.hatch.usePrinting().then(function(useHatch) {
 121         $scope.using_hatch_printer = useHatch;
 122     });
 123
 124     egCore.hatch.getItem('circ.checkout.strict_barcode')
 125         .then(function(sb){ $scope.strict_barcode = sb });
 126
 127     // avoid multiple, in-flight attempts on the same barcode
 128     var pending_barcodes = {};
 129
 130     var printOnComplete = true;
 131     egCore.org.settings([
 132         'circ.staff_client.do_not_auto_attempt_print'
 133     ]).then(function(settings) {
 134         printOnComplete = !Boolean(
 135             angular.isArray(settings['circ.staff_client.do_not_auto_attempt_print']) &&
 136             (settings['circ.staff_client.do_not_auto_attempt_print'].indexOf('Checkout') > -1)
 137         );
 138     });
 139
 140     egCirc.get_noncat_types().then(function(list) {
 141         $scope.nonCatTypes = list;
 142     });
 143
 144     $scope.selectedNcType = function() {
 145         if (!egCore.env.cnct) return null; // too soon
 146         var type = egCore.env.cnct.map[$scope.checkoutArgs.noncat_type];
 147         return type ? type.name() : null;
 148     }
 149
 150     $scope.checkout = function(args) {
 151         var params = angular.copy(args);
 152         params.patron_id = patronSvc.current.id();
 153
 154         if (args.sticky_date) {
 155             params.due_date = args.due_date.toISOString();
 156         } else {
 157             delete params.due_date;
 158         }
 159         delete params.sticky_date;
 160
 161         if (params.noncat_type == 'barcode') {
 162             if (!args.copy_barcode) return;
 163
 164             args.copy_barcode = ''; // reset UI input
 165             params.noncat_type = ''; // "barcode"
 166
 167             if (pending_barcodes[params.copy_barcode]) {
 168                 console.log(
 169                     "Skipping checkout of redundant barcode "
 170                     + params.copy_barcode
 171                 );
 172                 return;
 173             }
 174
 175             pending_barcodes[params.copy_barcode] = true;
 176             send_checkout(params);
 177
 178         } else {
 179             egCirc.noncat_dialog(params).then(function() {
 180                 send_checkout(params)
 181             });
 182         }
 183
 184         $scope.focusMe = true; // return focus to barcode input
 185     }
 186
 187     function send_checkout(params) {
 188
 189         params.noncat_type = params.noncat ? params.noncat_type : '';
 190
 191         // populate the grid row before we send the request so that the
 192         // order of actions is maintained and so the user gets an
 193         // immediate reaction to their barcode input action.
 194         var row_item = {
 195             index : $scope.checkouts.length,
 196             input_barcode : params.copy_barcode,
 197             noncat_type : params.noncat_type
 198         };
 199
 200         $scope.checkouts.unshift(row_item);
 201         $scope.gridDataProvider.prepend();
 202
 203         egCore.hatch.setItem('circ.checkout.strict_barcode', $scope.strict_barcode);
 204         var options = {check_barcode : $scope.strict_barcode};
 205
 206         egCirc.checkout(params, options).then(
 207             function(co_resp) {
 208                 // update stats locally so we don't have to fetch them w/
 209                 // each checkout.
 210
 211                 // Avoid updating checkout counts when a checkout turns
 212                 // into a renewal via auto_renew.
 213                 if (!co_resp.auto_renew && !params.noncat && !options.sameCopyCheckout) {
 214                     patronSvc.patron_stats.checkouts.out++;
 215                     patronSvc.patron_stats.checkouts.total_out++;
 216                 }
 217
 218                 // copy the response event into the original grid row item
 219                 // note: angular.copy clobbers the destination
 220                 row_item.evt = co_resp.evt;
 221                 angular.forEach(co_resp.data, function(val, key) {
 222                     row_item[key] = val;
 223                 });
 224
 225                 if (row_item.acp) { // unset for non-cat items.
 226                     row_item['copy_barcode'] = row_item.acp.barcode();
 227                 }
 228
 229                 munge_checkout_resp(co_resp, row_item);
 230             },
 231             function() {
 232                 // Circ was rejected somewhere along the way.
 233                 // Remove the copy from the grid since there was no action.
 234                 // note: since checkouts are unshifted onto the array, the
 235                 // index value does not (generally) match the array position.
 236                 var pos = -1;
 237                 angular.forEach($scope.checkouts, function(co, idx) {
 238                     if (co.index == row_item.index) pos = idx;
 239                 });
 240                 $scope.checkouts.splice(pos, 1);
 241                 $scope.gridDataProvider.refresh();
 242             }
 243
 244         ).finally(function() {
 245
 246             // regardless of the outcome of the circ, remove the
 247             // barcode from the pending list.
 248             if (params.copy_barcode)
 249                 delete pending_barcodes[params.copy_barcode];
 250
 251             $scope.focusMe = true; // return focus to barcode input
 252         });
 253     }
 254
 255     // add some checkout-specific additions for display
 256     function munge_checkout_resp(co_resp, row_item) {
 257         var params = co_resp.params;
 258         if (params.noncat) {
 259             row_item.title = egCore.env.cnct.map[params.noncat_type].name();
 260             row_item.noncat_count = params.noncat_count;
 261             row_item.circ = new egCore.idl.circ();
 262             row_item.circ.due_date(co_resp.evt[0].payload.noncat_circ.duedate());
 263             // Non-cat circs don't return the full list of circs.
 264             // Refresh the list of non-cat circs from the server.
 265             patronSvc.getUserNonCats(patronSvc.current.id());
 266             row_item.copy_alert_count = 0;
 267         } else {
 268             row_item.copy_alert_count = 0;
 269             egCore.pcrud.search(
 270                 'aca',
 271                 { copy : co_resp.data.acp.id(), ack_time : null },
 272                 null,
 273                 { atomic : true }
 274             ).then(function(list) {
 275                 row_item.copy_alert_count = list.length;
 276             });
 277         }
 278     }
 279
 280     $scope.addCopyAlerts = function(items) {
 281         var copy_ids = [];
 282         angular.forEach(items, function(item) {
 283             if (item.acp) copy_ids.push(item.acp.id());
 284         });
 285         egCirc.add_copy_alerts(copy_ids).then(function() {
 286             // update grid items?
 287         });
 288     }
 289
 290     $scope.manageCopyAlerts = function(items) {
 291         var copy_ids = [];
 292         angular.forEach(items, function(item) {
 293             if (item.acp) copy_ids.push(item.acp.id());
 294         });
 295         egCirc.manage_copy_alerts(copy_ids).then(function() {
 296             // update grid items?
 297         });
 298     }
 299
 300     $scope.gridCellHandlers = {};
 301     $scope.gridCellHandlers.copyAlertsEdit = function(id) {
 302         egCirc.manage_copy_alerts([id]).then(function() {
 303             // update grid items?
 304         });
 305     };
 306
 307     $scope.print_receipt = function() {
 308         var print_data = {circulations : []};
 309         var cusr = patronSvc.current;
 310
 311         if ($scope.checkouts.length == 0) return $q.when();
 312
 313         angular.forEach($scope.checkouts, function(co) {
 314             if (co.circ) {
 315                 print_data.circulations.push({
 316                     circ : egCore.idl.toHash(co.circ),
 317                     copy : egCore.idl.toHash(co.acp),
 318                     title : co.title,
 319                     author : co.author
 320                 });
 321                 // Flesh selected fields of this circulation
 322                 print_data.circulations[0].copy.call_number =
 323                     egCore.idl.toHash(co.acn);
 324                 print_data.circulations[0].copy.owning_lib =
 325                     egCore.ils.toHash(co.aou);
 326             };
 327         });
 328
 329         // This is repeated in patron.* so everything is in one place but left here so existing templates don't break.
 330         print_data.patron_money = patronSvc.patron_stats.fines;
 331         print_data.patron = {
 332             prefix : cusr.prefix(),
 333             first_given_name : cusr.first_given_name(),
 334             second_given_name : cusr.second_given_name(),
 335             family_name : cusr.family_name(),
 336             suffix : cusr.suffix(),
 337             pref_prefix : cusr.pref_prefix(),
 338             pref_first_given_name : cusr.pref_first_given_name(),
 339             pref_secondg_given_name : cusr.second_given_name(),
 340             pref_family_name : cusr.pref_family_name(),
 341             suffix : cusr.suffix(),
 342             card : { barcode : cusr.card().barcode() },
 343             money_summary : patronSvc.patron_stats.fines,
 344             expire_date : cusr.expire_date(),
 345             alias : cusr.alias(),
 346             has_email : Boolean($scope.has_email_address()),
 347             has_phone : Boolean(cusr.day_phone() || cusr.evening_phone() || cusr.other_phone())
 348         };
 349
 350         return egCore.print.print({
 351             context : 'default',
 352             template : 'checkout',
 353             scope : print_data,
 354             show_dialog : $scope.show_print_dialog
 355         });
 356     }
 357
 358     $scope.email_receipt = function() {
 359         if ($scope.has_email_address() && $scope.checkouts.length) {
 360             return egCore.net.request(
 361                 'open-ils.circ',
 362                 'open-ils.circ.checkout.batch_notify.session.atomic',
 363                 egCore.auth.token(),
 364                 patronSvc.current.id(),
 365                 $scope.checkouts.map(function (c) { return c.circ.id() })
 366             ).then(function() {
 367                 ngToast.create(egCore.strings.EMAILED_CHECKOUT_RECEIPT);
 368                 return $q.when();
 369             });
 370         }
 371         return $q.when();
 372     }
 373
 374     $scope.print_or_email_receipt = function() {
 375         if ($scope.may_email_receipt()) return $scope.email_receipt();
 376         $scope.print_receipt();
 377     }
 378
 379     // set of functions to issue a receipt (if desired), then
 380     // redirect
 381     $scope.done_auto_receipt = function() {
 382         if ($scope.may_email_receipt()) {
 383             $scope.email_receipt().then(function() {
 384                 $scope.done_redirect();
 385             });
 386         } else {
 387             if (printOnComplete) {
 388
 389                 $scope.print_receipt().then(function() {
 390                     $scope.done_redirect();
 391                 });
 392
 393             } else {
 394                 $scope.done_redirect();
 395             }
 396         }
 397     }
 398     $scope.done_print_receipt = function() {
 399         $scope.print_receipt().then( function () {
 400             $scope.done_redirect();
 401         });
 402     }
 403     $scope.done_email_receipt = function() {
 404         $scope.email_receipt().then( function () {
 405             $scope.done_redirect();
 406         });
 407     }
 408     $scope.done_no_receipt = function() {
 409         $scope.done_redirect();
 410     }
 411
 412     // Redirect the user to the barcode entry page to load a new patron.
 413     $scope.done_redirect = function() {
 414         $location.path('/circ/patron/bcsearch');
 415     }
 416 }])
 417