]> git.evergreen-ils.org Git - working/Evergreen.git/blob - Open-ILS/xul/staff_client/server/circ/checkout.js
Allow translating one final untranslatable error message in checkout interface
[working/Evergreen.git] / Open-ILS / xul / staff_client / server / circ / checkout.js
1 dump('entering circ.checkout.js\n');
2
3 if (typeof circ == 'undefined') { circ = {}; }
4 circ.checkout = function (params) {
5
6     JSAN.use('util.error'); this.error = new util.error();
7     JSAN.use('util.network'); this.network = new util.network();
8     JSAN.use('OpenILS.data'); this.data = new OpenILS.data(); this.data.init({'via':'stash'});
9     JSAN.use('util.money');
10     JSAN.use('util.barcode');
11 };
12
13 circ.checkout.prototype = {
14
15     'init' : function( params ) {
16
17         var obj = this;
18
19         obj.event_listeners = new EventListenerList();
20         obj.patron_id = params.patron_id;
21
22         obj.auto_override_events = [];
23
24         JSAN.use('circ.util');
25         var columns = circ.util.columns( 
26             { 
27                 'barcode' : { 'hidden' : false },
28                 'title' : { 'hidden' : false },
29                 'due_date' : { 'hidden' : false }
30             } 
31         );
32
33         JSAN.use('util.list'); obj.list = new util.list('checkout_list');
34         obj.list.init(
35             {
36                 'columns' : columns,
37                 'on_select' : function() {
38                     var sel = obj.list.retrieve_selection();
39                     document.getElementById('clip_button').disabled = sel.length < 1;
40                 }
41             }
42         );
43         
44         JSAN.use('util.controller'); obj.controller = new util.controller();
45         obj.controller.init(
46             {
47                 'control_map' : {
48                     'save_columns' : [ [ 'command' ], function() { obj.list.save_columns(); } ],
49                     'sel_clip' : [
50                         ['command'],
51                         function() { obj.list.clipboard(); }
52                     ],
53                     'checkout_menu_placeholder' : [
54                         ['render'],
55                         function(e) {
56                             return function() {
57                                 JSAN.use('util.widgets'); JSAN.use('util.functional'); JSAN.use('util.fm_utils');
58                                 var items = [ [ document.getElementById('circStrings').getString('staff.circ.checkout.barcode') , 'barcode' ] ].concat(
59                                     util.functional.map_list(
60                                         util.functional.filter_list(
61                                             obj.data.list.my_cnct,
62                                             function(o) {
63                                                 return util.fm_utils.compare_aou_a_is_b_or_ancestor(o.owning_lib(), obj.data.list.au[0].ws_ou());
64                                             }
65                                         ).sort(
66
67                                             function(a,b) {
68                                                 try { 
69                                                     return util.fm_utils.sort_func_aou_by_depth_and_then_string(
70                                                         [ a.owning_lib(), a.name() ],
71                                                         [ b.owning_lib(), b.name() ]
72                                                     );
73                                                 } catch(E) {
74                                                     alert(document.getElementById('circStrings').getFormattedString('staff.circ.checkout.sorting.exception', [E]));
75                                                     return 0;
76                                                 }
77                                             }
78
79                                         ),
80                                         function(o) {
81                                             return [ obj.data.hash.aou[ o.owning_lib() ].shortname() + ' : ' + o.name(), o.id() ];
82                                         }
83                                     )
84                                 );
85                                 g.error.sdump('D_TRACE','items = ' + js2JSON(items));
86                                 util.widgets.remove_children( e );
87                                 var ml = util.widgets.make_menulist(items);
88                                 e.appendChild( ml );
89                                 ml.setAttribute('id','checkout_menulist');
90                                 ml.setAttribute('accesskey','');
91                                 obj.event_listeners.add(ml,
92                                     'command',
93                                     function(ev) {
94                                         var tb = obj.controller.view.checkout_barcode_entry_textbox;
95                                         var db = document.getElementById('duedate_hbox');
96                                         if (ev.target.value == 'barcode') {
97                                             db.hidden = false;
98                                             tb.disabled = false;
99                                             tb.value = '';
100                                             tb.focus();
101                                         } else {
102                                             db.hidden = true;
103                                             tb.disabled = true;
104                                             tb.value = document.getElementById('circStrings').getString('staff.circ.non_cataloged');
105                                         }
106                                     }, false
107                                 );
108                                 obj.controller.view.checkout_menu = ml;
109                             };
110                         }
111                     ],
112                     'checkout_barcode_entry_textbox' : [
113                         ['keypress'],
114                         function(ev) {
115                             if (ev.keyCode && ev.keyCode == 13) {
116                                 obj.checkout( { barcode: ev.target.value } );
117                             }
118                         }
119                     ],
120                     'checkout_duedate_datepicker' : [
121                         ['change'],
122                         function(ev) { 
123                             try {
124                                 document.getElementById('checkout_duedate_checkbox').checked = true;
125                                 if (obj.check_date(ev.target)) {
126                                     ev.target.parentNode.setAttribute('style','');
127                                 } else {
128                                     ev.target.parentNode.setAttribute('style','background-color: red');
129                                 }
130                             } catch(E) {
131                                 alert('Error in checkout.js, checkout_duedate_datepicker @change: ' + E);
132                             }
133                         }
134                     ],
135                     'cmd_broken' : [
136                         ['command'],
137                         function() { alert(document.getElementById('circStrings').getString('staff.circ.checkout.unimplemented')); }
138                     ],
139                     'cmd_checkout_submit' : [
140                         ['command'],
141                         function() {
142                             var params = {}; var count = 1;
143
144                             if (obj.controller.view.checkout_menu.value == 'barcode' ||
145                                 obj.controller.view.checkout_menu.value === '') {
146                                 params.barcode = obj.controller.view.checkout_barcode_entry_textbox.value;
147                             } else {
148                                 params.noncat = 1;
149                                 params.noncat_type = obj.controller.view.checkout_menu.value;
150                                 var r = window.prompt(
151                                     document.getElementById('circStrings').getFormattedString('staff.circ.checkout.cmd_checkout_submit.msg', [obj.data.hash.cnct[params.noncat_type].name()]),
152                                     '1',
153                                     document.getElementById('circStrings').getString('staff.circ.checkout.cmd_checkout_submit.title')
154                                 );
155                                 if (r) {
156                                     count = Number(r);
157                                     if (count > 0) {
158                                         if (count > 99) {
159                                             obj.error.yns_alert(
160                                                 document.getElementById('circStrings').getFormattedString('staff.circ.checkout.cmd_checkout_submit.too_many.msg', [count, obj.data.hash.cnct[params.noncat_type].name()]),
161                                                 document.getElementById('circStrings').getString('staff.circ.checkout.cmd_checkout_submit.too_many.title'),
162                                                 document.getElementById('circStrings').getString('staff.circ.checkout.ok.btn'),
163                                                 null,
164                                                 null,
165                                                 document.getElementById('circStrings').getString('staff.circ.confirm')
166                                             );
167                                             return;
168                                         } else if (count > 20) {
169                                             r = obj.error.yns_alert(
170                                                 document.getElementById('circStrings').getFormattedString('staff.circ.checkout.cmd_checkout_submit.confirm.msg', [count, obj.data.hash.cnct[params.noncat_type].name()]),
171                                                 document.getElementById('circStrings').getString('staff.circ.checkout.cmd_checkout_submit.confirm.title'),
172                                                 document.getElementById('circStrings').getString('staff.circ.checkout.yes.btn'),
173                                                 document.getElementById('circStrings').getString('staff.circ.checkout.no.btn'),
174                                                 null,
175                                                 document.getElementById('circStrings').getString('staff.circ.confirm')
176                                             );
177                                             if (r !== 0) { return; }
178                                         }
179                                     } else {
180                                         r = obj.error.yns_alert(
181                                             document.getElementById('circStrings').getFormattedString('staff.circ.checkout.cmd_checkout_submit.non_numeric.msg', [r]),
182                                             document.getElementById('circStrings').getString('staff.circ.checkout.cmd_checkout_submit.non_numeric.title'),
183                                             document.getElementById('circStrings').getString('staff.circ.checkout.ok.btn'),
184                                             null,
185                                             null,
186                                             document.getElementById('circStrings').getString('staff.circ.confirm')
187                                         );
188                                         return;
189                                     }
190                                 } else {
191                                     return;
192                                 }
193                             }
194                             for (var i = 0; i < count; i++) {
195                                 obj.checkout( params );
196                             }
197                         }
198                     ],
199                     'cmd_checkout_print' : [
200                         ['command'],
201                         function() {
202                             try {
203                                 obj.print();
204                             } catch(E) {
205                                 obj.error.standard_unexpected_error_alert('cmd_checkout_print',E);
206                             }
207
208                         }
209                     ],
210                     'cmd_checkout_export' : [
211                         ['command'],
212                         function() {
213                             try {
214                                 obj.export_list();
215                             } catch(E) {
216                                 obj.error.standard_unexpected_error_alert('cmd_checkout_export',E); 
217                             }
218                         }
219                     ],
220
221
222                     'cmd_checkout_reprint' : [
223                         ['command'],
224                         function() {
225                             JSAN.use('util.print'); var print = new util.print();
226                             print.reprint_last();
227                         }
228                     ],
229                     'cmd_checkout_done' : [
230                         ['command'],
231                         function() {
232                             try {
233                                 var no_print_prompting = obj.data.hash.aous['circ.staff_client.do_not_auto_attempt_print'];
234                                 if (no_print_prompting) {
235                                     if (no_print_prompting.indexOf( "Checkout" ) > -1) {
236                                         obj.list.clear();
237                                         xulG.set_tab(urls.XUL_PATRON_BARCODE_ENTRY,{},{}); 
238                                         return;
239                                     }
240                                 }
241                                 if (document.getElementById('checkout_auto').checked) {
242                                     obj.print(true,function() { 
243                                         obj.list.clear();
244                                         xulG.set_tab(urls.XUL_PATRON_BARCODE_ENTRY,{},{}); 
245                                     });
246                                 } else {
247                                     obj.print(false,function() {
248                                         obj.list.clear();
249                                         xulG.set_tab(urls.XUL_PATRON_BARCODE_ENTRY,{},{});
250                                     });
251                                 }
252                             } catch(E) {
253                                 obj.error.standard_unexpected_error_alert('cmd_checkout_done',E);
254                             }
255                         }
256                     ]
257                 }
258             }
259         );
260         this.controller.render();
261         //this.controller.view.checkout_barcode_entry_textbox.focus();
262
263         this.check_disable();
264
265         var robj = obj.network.simple_request(
266             'FM_CIRC_COUNT_RETRIEVE_VIA_USER.authoritative',
267             [ ses(), obj.patron_id ]
268         );
269         obj.items_out_count = (robj.out + robj.overdue + robj.claims_returned + robj.long_overdue );
270
271     },
272
273     'cleanup' : function() {
274         var obj = this;
275         obj.list.cleanup();
276         obj.controller.cleanup();
277         obj.event_listeners.removeAll();
278     },
279
280     'check_disable' : function() {
281         var obj = this;
282         try {
283             if (typeof xulG.check_stop_checkouts == 'function') {
284                 var disable = xulG.check_stop_checkouts();
285                 if (disable) {
286                     document.getElementById('checkout_submit_barcode_button').disabled = true;
287                     document.getElementById('checkout_done').disabled = true;
288                     document.getElementById('checkout_duedate_checkbox').disabled = true;
289                     document.getElementById('checkout_duedate_timepicker').disabled = true;
290                     obj.controller.view.checkout_menu.disabled = true;
291                     obj.controller.view.checkout_barcode_entry_textbox.disabled = true;
292                     obj.controller.view.checkout_duedate_datepicker.disabled = true;
293                 } else {
294                     document.getElementById('checkout_submit_barcode_button').disabled = false;
295                     document.getElementById('checkout_done').disabled = false;
296                     document.getElementById('checkout_duedate_checkbox').disabled = false;
297                     document.getElementById('checkout_duedate_timepicker').disabled = false;
298                     obj.controller.view.checkout_menu.disabled = false;
299                     obj.controller.view.checkout_barcode_entry_textbox.disabled = false;
300                     obj.controller.view.checkout_duedate_datepicker.disabled = false;
301                 }
302             }
303         } catch(E) {
304             obj.error.standard_unexpected_error_alert(document.getElementById('circStrings').getString('staff.circ.checkout.disable.error'),E);
305         }
306     },
307
308     'print' : function(silent,f) {
309         var obj = this;
310         try {
311             obj.patron = obj.network.simple_request('FM_AU_FLESHED_RETRIEVE_VIA_ID',[ses(),obj.patron_id]);
312             var params = { 
313                 'patron' : obj.patron, 
314                 'lib' : obj.data.hash.aou[ obj.data.list.au[0].ws_ou() ],
315                 'staff' : obj.data.list.au[0],
316                 'data' : {
317                     'balance_owed' : util.money.sanitize( obj.most_recent_balance_owed ),
318                 },
319                 'printer_context' : 'receipt',
320                 'template' : 'checkout',
321                 'callback' : function() {
322                     setTimeout(
323                         function(){
324                             if (typeof f == 'function') { 
325                                 setTimeout( 
326                                     function() {
327                                         f();
328                                     }, 1000
329                                 );
330                             } 
331                         }, 1000
332                     );
333                 }
334             };
335             if (silent) { params.no_prompt = true; }
336             obj.list.print(params);
337         } catch(E) {
338             obj.error.standard_unexpected_error_alert('print',E);
339         }
340     },
341     
342     'export_list' : function(silent,f) {
343         var obj = this;
344         try {
345             obj.list.dump_csv_to_clipboard();
346         } catch(E) {
347             obj.error.standard_unexpected_error_alert('export',E);
348         }
349     },
350
351     'check_date' : function(node) {
352         var obj = this;
353         JSAN.use('util.date');
354         try {
355             obj.controller.view.checkout_barcode_entry_textbox.setAttribute('disabled','false');
356             obj.controller.view.checkout_barcode_entry_textbox.disabled = false;
357             obj.controller.view.cmd_checkout_submit.setAttribute('disabled','false');
358             obj.controller.view.cmd_checkout_submit.disabled = false;
359             try {
360                 if (util.date.check_past('YYYY-MM-DD',node.value) ) {
361                     obj.controller.view.checkout_barcode_entry_textbox.setAttribute('disabled','true');
362                     obj.controller.view.cmd_checkout_submit.setAttribute('disabled','true');
363                     return false;
364                 }
365             }
366             catch (E) {
367                     obj.controller.view.checkout_barcode_entry_textbox.setAttribute('disabled','true');
368                     obj.controller.view.cmd_checkout_submit.setAttribute('disabled','true');
369                     return false;
370             }
371             return true;
372         } catch(E) {
373             throw(E);
374         }
375     },
376
377     '_checkout_pending_hash' : {},
378
379     '_checkout' : function(params,permit) {
380         var obj = this;
381         try {
382         
383             /**********************************************************************************************************************/
384             /* This handles the return value of the checkout/renewal */
385             function _checkout_callback(req,x) {
386                 try {
387
388                     if (params.barcode) { 
389                         delete obj._checkout_pending_hash[ params.barcode ];
390                     }
391
392                     var checkout = req.getResultObject();
393
394                     if (checkout.ilsevent === '0') {
395         
396                         if (!checkout.payload) { checkout.payload = {}; }
397         
398                         if (!checkout.payload.circ) {
399                             checkout.payload.circ = new aoc();
400                             /*********************************************************************************************/
401                             /* Non Cat */
402                             if (checkout.payload.noncat_circ) {
403                                 checkout.payload.circ.circ_lib( checkout.payload.noncat_circ.circ_lib() );
404                                 checkout.payload.circ.circ_staff( checkout.payload.noncat_circ.staff() );
405                                 checkout.payload.circ.usr( checkout.payload.noncat_circ.patron() );
406                                 checkout.payload.circ.due_date( checkout.payload.noncat_circ.duedate() );
407                             }
408                         }
409     
410                         if (!checkout.payload.record) {
411                             checkout.payload.record = new mvr();
412                             /*********************************************************************************************/
413                             /* Non Cat */
414                             if (checkout.payload.noncat_circ) {
415                                 checkout.payload.record.title(
416                                     obj.data.hash.cnct[ checkout.payload.noncat_circ.item_type() ].name()
417                                 );
418                             }
419                         }
420             
421                         if (!checkout.payload.copy) {
422                             checkout.payload.copy = new acp();
423                             checkout.payload.copy.barcode( '' );
424                         }
425             
426                         /*********************************************************************************************/
427                         /* Override mvr title/author with dummy title/author for Pre cat */
428                         if (checkout.payload.copy.dummy_title()) {
429                             checkout.payload.record.title( checkout.payload.copy.dummy_title() );
430                         }
431                         if (checkout.payload.copy.dummy_author()) {
432                             checkout.payload.record.author( checkout.payload.copy.dummy_author() );
433                         }
434            
435                         if (checkout.payload.patron_money) {
436                             obj.most_recent_balance_owed = checkout.payload.patron_money.balance_owed();
437                         }
438  
439                         obj.list.append(
440                             {
441                                 'row' : {
442                                     'my' : {
443                                     'circ' : checkout.payload.circ,
444                                     'mvr' : checkout.payload.record,
445                                     'acp' : checkout.payload.copy,
446                                     'acn' : checkout.payload.volume
447                                     }
448                                 },
449                                 'to_top' : true
450                             //I could override map_row_to_column here
451                             }
452                         );
453                         var is_renewal = (
454                             get_bool(checkout.payload.circ.opac_renewal())
455                             ||get_bool(checkout.payload.circ.phone_renewal())
456                             ||get_bool(checkout.payload.circ.desk_renewal())
457                         );
458                         try {
459                             obj.error.work_log(
460                                 document.getElementById('circStrings').getFormattedString(
461                                         is_renewal
462                                         ? 'staff.circ.work_log_renew.message'
463                                         : 'staff.circ.work_log_checkout.message',
464                                     [
465                                         ses('staff_usrname'),
466                                         xulG.patron.family_name(),
467                                         xulG.patron.card().barcode(),
468                                         checkout.payload.copy.barcode()
469                                     ]
470                                 ), {
471                                     'au_id' : xulG.patron.id(),
472                                     'au_family_name' : xulG.patron.family_name(),
473                                     'au_barcode' : xulG.patron.card().barcode(),
474                                     'acp_barcode' : checkout.payload.copy.barcode()
475                                 }
476                             );
477                         } catch(E) {
478                             obj.error.sdump('D_ERROR','Error with work_logging in server/circ/checkout.js, _checkout:' + E);
479                         }
480                         document.getElementById('msg_area').removeChild(x);
481                         /*
482                         if (typeof obj.on_checkout == 'function') {
483                             obj.on_checkout(checkout.payload);
484                         }
485                         */
486                         if (typeof window.xulG == 'object' && typeof window.xulG.on_list_change == 'function') {
487                             window.xulG.on_list_change(checkout.payload,is_renewal);
488                         } else {
489                             obj.error.sdump('D_CIRC','circ.checkout: No external .on_checkout()\n');
490                         }
491         
492                     } else {
493                         // Should get here with failed renewals
494                         switch(Number(checkout.ilsevent)) {
495                             case null /* custom event */ : 
496                             case 5000 /* PERM_FAILURE */: 
497                             case 1212 /* PATRON_EXCEEDS_OVERDUE_COUNT */ : 
498                             case 1213 /* PATRON_BARRED */ : 
499                             case 1215 /* CIRC_EXCEEDS_COPY_RANGE */ : 
500                             case 1224 /* PATRON_ACCOUNT_EXPIRED */ : 
501                             case 1232 /* ITEM_DEPOSIT_REQUIRED */ : 
502                             case 1233 /* ITEM_RENTAL_FEE_REQUIRED */ : 
503                             case 1234 /* ITEM_DEPOSIT_PAID */ : 
504                             case 1500 /* ACTION_CIRCULATION_NOT_FOUND */ : 
505                             case 7002 /* PATRON_EXCEEDS_CHECKOUT_COUNT */ : 
506                             case 7003 /* COPY_CIRC_NOT_ALLOWED */ : 
507                             case 7004 /* COPY_NOT_AVAILABLE */ : 
508                             case 7006 /* COPY_IS_REFERENCE */ : 
509                             case 7007 /* COPY_NEEDED_FOR_HOLD */ : 
510                             case 7008 /* MAX_RENEWALS_REACHED */ : 
511                             case 7009 /* CIRC_CLAIMS_RETURNED */ : 
512                             case 7010 /* COPY_ALERT_MESSAGE */ : 
513                             case 7013 /* PATRON_EXCEEDS_FINES */ : 
514                                 x.setAttribute('style','color: red');
515                                 x.setAttribute('value', document.getElementById('circStrings').getFormattedString('staff.circ.checkout.barcode.failed', [params.barcode]));
516                                 if (typeof params.noncat == 'undefined') { obj.items_out_count--; }
517                             break;
518                             default: throw(checkout);
519                         }
520                     }
521         
522                 } catch(E) {
523                     x.setAttribute('style','color: red');
524                     x.setAttribute('value', document.getElementById('circStrings').getFormattedString('staff.circ.checkout.barcode.failed', [params.barcode]));
525                     if (typeof params.noncat == 'undefined') { obj.items_out_count--; }
526                     obj.error.standard_unexpected_error_alert(document.getElementById('circStrings').getFormattedString('staff.circ.checkout.barcode.failed.alert', ['#3']),E);
527                 }
528             }
529
530             /**********************************************************************************************************************/
531             /* This used to do the actual checkout/renewal */
532         
533             var x = document.createElement('label');
534             x.setAttribute('style','color: green');
535             if (params.barcode) {
536                 x.setAttribute('value',document.getElementById('circStrings').getFormattedString('staff.circ.checkout.barcode.pending', [params.barcode]));
537             } else {
538                 x.setAttribute('value',document.getElementById('circStrings').getString('staff.circ.checkout.non_cataloged.pending'));
539             }
540             document.getElementById('msg_area').appendChild(x);
541
542             /*
543             obj.network.request(
544                 api.CHECKOUT.app,
545                 api.CHECKOUT.method,
546                 [ ses(), params, obj.items_out_count ],
547                 function(req) {
548                     _checkout_callback(req,x);
549                 }
550             );
551             */
552             
553             if (typeof params.noncat == 'undefined') { obj.items_out_count++; }
554            
555            /* new */
556             _checkout_callback({ 'getResultObject' : function() { return permit; } },x);
557
558         } catch(E) {
559             x.setAttribute('style','color: red');
560             x.setAttribute('value', document.getElementById('circStrings').getFormattedString('staff.circ.checkout.barcode.failed', [params.barcode]));
561             if (typeof params.noncat == 'undefined') { obj.items_out_count--; }
562             obj.error.standard_unexpected_error_alert(document.getElementById('circStrings').getFormattedString('staff.circ.checkout.barcode.failed.alert', ['#2']),E);
563         }
564     },
565
566
567     'test_barcode' : function(bc) {
568         var obj = this;
569         var x = document.getElementById('strict_barcode');
570         if (x && x.checked !== true) { return true; }
571         var good = util.barcode.check(bc);
572         if (good) {
573             return true;
574         } else {
575             if ( 1 == obj.error.yns_alert(
576                         document.getElementById('circStrings').getFormattedString('staff.circ.check_digit.bad', [bc]),
577                         document.getElementById('circStrings').getString('staff.circ.barcode.bad'),
578                         document.getElementById('circStrings').getString('staff.circ.cancel'),
579                         document.getElementById('circStrings').getString('staff.circ.barcode.accept'),
580                         null,
581                         document.getElementById('circStrings').getString('staff.circ.confirm'),
582                         '/xul/server/skin/media/images/bad_barcode.png'
583                 )
584             ) {
585                 return true;
586             } else {
587                 return false;
588             }
589         }
590     },
591
592     'checkout' : function(params) {
593         var obj = this;
594
595         JSAN.use('util.date');
596         if (document.getElementById('checkout_duedate_checkbox').checked) {
597             if (! obj.check_date(obj.controller.view.checkout_duedate_datepicker)) return;
598             var tp = document.getElementById('checkout_duedate_timepicker');
599             var dp = obj.controller.view.checkout_duedate_datepicker;
600             var tp_date = tp.dateValue;
601             var dp_date = dp.dateValue;
602             dp_date.setHours( tp_date.getHours() );
603             dp_date.setMinutes( tp_date.getMinutes() );
604
605             params.due_date = util.date.formatted_date(dp_date,'%{iso8601}');
606         }
607
608         if (typeof obj.on_checkout == 'function') { obj.on_checkout(params); }
609
610         if (! (params.barcode||params.noncat)) { return; }
611
612         if (params.barcode) {
613             var actor_on_checkout = String(
614                 obj.data.hash.aous['circ.staff_client.actor_on_checkout']
615             ) == 'true';
616             // skip barcode completion lookups if we can
617             if (actor_on_checkout || obj.data.list.cbc.length > 0) {
618                 // Default is "just items"
619                 var barcode_context = 'asset';
620                 // Add actor (can be any string that includes 'actor') if looking up patrons at checkout
621                 if(actor_on_checkout)
622                     barcode_context += '-actor';
623                 // Auto-complete the barcode
624                 var in_barcode = xulG.get_barcode(window, barcode_context, params.barcode);
625                 // user_false is "None of the above selected", don't error out/fall through as they already said no
626                 if(in_barcode == "user_false") return;
627                 // We have a barcode and there was no error?
628                 if(in_barcode && typeof in_barcode.ilsevent == 'undefined') {
629                     // Check if it was an actor barcode (will never happen unless actor was added above)
630                     if(in_barcode.type == 'actor') {
631                         // Go to new patron (do not pass go, do not collect $200, do not prompt user)
632                         var horizontal_interface = String( obj.data.hash.aous['ui.circ.patron_summary.horizontal'] ) == 'true';
633                         var loc = xulG.url_prefix( horizontal_interface ? 'XUL_PATRON_HORIZ_DISPLAY' : 'XUL_PATRON_DISPLAY' );
634                         xulG.set_tab( loc, {}, { 'barcode' : in_barcode.barcode } );
635                         return;
636                     }
637                     params.barcode = in_barcode.barcode;
638                 }
639             }
640
641             if ( obj.test_barcode(params.barcode) ) { /* good */ } else { /* bad */ return; }
642
643             if (typeof obj._checkout_pending_hash[ params.barcode ] != 'undefined') {
644
645                 obj.error.sdump('D_CIRC','Redundant barcode scan == ' + params.barcode);
646                 return; // redundant barcode scan
647
648             } else {
649
650                 obj._checkout_pending_hash[ params.barcode ] = true;    
651
652             }
653         }
654
655
656         /**********************************************************************************************************************/
657         /* This used to be the Permissibility test before checkout */
658         try {
659
660             params.patron = obj.patron_id;
661
662             var permit = obj.network.simple_request(
663                 //api.CHECKOUT_PERMIT.app,
664                 'CHECKOUT_FULL',
665                 [ ses(), params, obj.items_out_count ],
666                 null,
667                 {
668                     'title' : document.getElementById('circStrings').getString('staff.circ.checkout.override.confirm'),
669                     'overridable_events' : [ 
670                         null /* custom event */,
671                         1212 /* PATRON_EXCEEDS_OVERDUE_COUNT */,
672                         1213 /* PATRON_BARRED */,
673                         1215 /* CIRC_EXCEEDS_COPY_RANGE */,
674                         1232 /* ITEM_DEPOSIT_REQUIRED */,
675                         1233 /* ITEM_RENTAL_FEE_REQUIRED */,
676                         7002 /* PATRON_EXCEEDS_CHECKOUT_COUNT */,
677                         7003 /* COPY_CIRC_NOT_ALLOWED */,
678                         7004 /* COPY_NOT_AVAILABLE */, 
679                         7006 /* COPY_IS_REFERENCE */, 
680                         7010 /* COPY_ALERT_MESSAGE */,
681                         7016 /* ITEM_ON_HOLDS_SHELF */,
682                         7013 /* PATRON_EXCEEDS_FINES */
683                     ],
684                     'report_override_on_events' : [ /* Allow auto-override of Patron overrides only */
685                         1212 /* PATRON_EXCEEDS_OVERDUE_COUNT */,
686                         1213 /* PATRON_BARRED */,
687                         7002 /* PATRON_EXCEEDS_CHECKOUT_COUNT */,
688                         7013 /* PATRON_EXCEEDS_FINES */
689                     ],
690                     'auto_override_these_events' : obj.auto_override_events,
691                     'text' : {
692                         '1212' : function(r) {
693                             return document.getElementById('circStrings').getString('staff.circ.checkout.override.will_auto');
694                         },
695                         '1213' : function(r) {
696                             return document.getElementById('circStrings').getString('staff.circ.checkout.override.will_auto');
697                         },
698                         '1232' : function(r) {
699                             return document.getElementById('circStrings').getString('staff.circ.checkout.override.item_deposit_required.warning');
700                         },
701                         '1233' : function(r) {
702                             return document.getElementById('circStrings').getString('staff.circ.checkout.override.item_rental_fee_required.warning');
703                         },
704                         '7002' : function(r) {
705                             return document.getElementById('circStrings').getString('staff.circ.checkout.override.will_auto');
706                         },
707                         '7004' : function(r) {
708                             try {
709                                 status_name = obj.data.hash.ccs[ r.payload.status() ].name();
710                                 return status_name;
711                             } catch (E) {
712                                 return document.getElementById('circStrings').getString('staff.circ.checkout.error_retrieving_copy_status');
713                             }
714                         },
715                         '7010' : function(r) {
716                             return r.payload;
717                         },
718                         '7013' : function(r) {
719                             return document.getElementById('circStrings').getString('staff.circ.checkout.override.will_auto');
720                         }
721                     }
722                 }
723             );
724
725             if (!permit) { throw(permit); }
726
727             function test_event(list,ev) {
728                 if (typeof list.ilsevent != 'undefined' ) {
729                     if (list.ilsevent == ev) {
730                         return list;
731                     } else {
732                         return false;
733                     }
734                 } else {
735                     for (var i = 0; i < list.length; i++) {
736                         if (typeof list[i].ilsevent != 'undefined') {
737                             if (list[i].ilsevent == ev) { return list[i]; }
738                         }
739                     }
740                     return false;
741                 }
742             }
743
744             /**********************************************************************************************************************/
745             /* Normal case, proceed with checkout */
746             if (permit.ilsevent === '0') {
747                 if(permit._reported_events != 'undefined') {
748                     obj.auto_override_events = obj.auto_override_events.concat(permit._reported_events);
749                 }
750                 JSAN.use('util.sound'); var sound = new util.sound(); sound.circ_good();
751                 params.permit_key = permit.payload;
752                 obj._checkout( params, permit ); 
753
754             /**********************************************************************************************************************/
755             /* Item not cataloged or barcode mis-scan.  Prompt for pre-cat option */
756             } else {
757             
758                 if (params.barcode) { delete obj._checkout_pending_hash[ params.barcode ];    }
759
760                 var found_handled = false; var found_not_handled = false; var msg = '';    
761
762                 if (test_event(permit,1202 /* ITEM_NOT_CATALOGED */)) {
763
764                     if ( 1 == obj.error.yns_alert(
765                         document.getElementById('circStrings').getFormattedString('staff.circ.checkout.not_cataloged.confirm', [params.barcode]),
766                         document.getElementById('circStrings').getString('staff.circ.alert'),
767                         document.getElementById('circStrings').getString('staff.circ.cancel'),
768                         document.getElementById('circStrings').getString('staff.circ.pre_cataloged'),
769                         null,
770                         document.getElementById('circStrings').getString('staff.circ.confirm'),
771                         '/xul/server/skin/media/images/book_question.png'
772                     ) ) {
773
774                         obj.data.dummy_title = ''; obj.data.dummy_author = ''; obj.data.stash('dummy_title','dummy_author');
775                         JSAN.use('util.window'); var win = new util.window();
776                         win.open(urls.XUL_PRE_CAT, 'dummy_fields', 'chrome,resizable,modal');
777                         obj.data.stash_retrieve();
778
779                         params.permit_key = permit.payload;
780                         params.dummy_title = obj.data.precat_dummy_title;
781                         params.dummy_author = obj.data.precat_dummy_author;
782                         params.dummy_isbn = obj.data.precat_dummy_isbn;
783                         params.circ_modifier = obj.data.precat_circ_modifier;
784                         params.precat = 1;
785
786                         if (obj.data.precat_submit == 'go') { 
787                             //obj._checkout( params ); No real request method here anymore
788                             obj.checkout( params );
789                         } else {
790                             alert(document.getElementById('circStrings').getString('staff.circ.checkout.cancelled'));
791                         }
792                     }
793
794                     return;
795                 }
796
797                 var test_permit;
798                 if (typeof permit.ilsevent != 'undefined') { test_permit = [ permit ]; } else { test_permit = permit; }
799
800                 var stop_checkout = false;
801                 for (var i = 0; i < test_permit.length; i++) {
802                     switch(Number(test_permit[i].ilsevent)) {
803                         case 1216 /* PATRON_CARD_INACTIVE */ :
804                         case 1217 /* PATRON_INACTIVE */ :
805                         case 1224 /* PATRON_ACCOUNT_EXPIRED */ :
806                             stop_checkout = true;
807                         break;
808                     }
809                 }
810
811                 for (var i = 0; i < test_permit.length; i++) {
812                     dump('found [' + test_permit[i].ilsevent + ']\n');
813                     switch(test_permit[i].ilsevent == null || test_permit[i].ilsevent == '' ? null : Number(test_permit[i].ilsevent)) {
814                         case null /* custom event */ :
815                             found_handled = true;
816                         break;
817                         case 1212 /* PATRON_EXCEEDS_OVERDUE_COUNT */ :
818                             found_handled = true;
819                         break;
820                         case 1213 /* PATRON_BARRED */ :
821                             found_handled = true;
822                         break;
823                         case 1215 /* CIRC_EXCEEDS_COPY_RANGE */ :
824                             found_handled = true;
825                         break;
826                         case 1216 /* PATRON_CARD_INACTIVE */ :
827                             found_handled = true;
828                             msg += document.getElementById('circStrings').getString('staff.circ.checkout.card.inactive') + '\n';
829                             obj.error.yns_alert(
830                                 msg,
831                                 document.getElementById('circStrings').getString('staff.circ.checkout.barcode.check_out_failed'),
832                                 document.getElementById('circStrings').getString('staff.circ.checkout.ok.btn'),
833                                 null,
834                                 null,
835                                 document.getElementById('circStrings').getString('staff.circ.confirm.msg')
836                             );
837                         break;
838                         case 1217 /* PATRON_INACTIVE */ :
839                             found_handled = true;
840                             msg += document.getElementById('circStrings').getString('staff.circ.checkout.account.inactive') + '\n';
841                             obj.error.yns_alert(
842                                 msg,
843                                 document.getElementById('circStrings').getString('staff.circ.checkout.barcode.check_out_failed'),
844                                 document.getElementById('circStrings').getString('staff.circ.checkout.ok.btn'),
845                                 null,
846                                 null,
847                                 document.getElementById('circStrings').getString('staff.circ.confirm.msg')
848                             );
849                         break;
850                         case 1224 /* PATRON_ACCOUNT_EXPIRED */ :
851                             found_handled = true;
852                             msg += document.getElementById('circStrings').getString('staff.circ.checkout.account.expired') + '\n';
853                             obj.error.yns_alert(
854                                 msg,
855                                 document.getElementById('circStrings').getString('staff.circ.checkout.barcode.check_out_failed'),
856                                 document.getElementById('circStrings').getString('staff.circ.checkout.ok.btn'),
857                                 null,
858                                 null,
859                                 document.getElementById('circStrings').getString('staff.circ.confirm.msg')
860                             );
861                         break;
862                         case 1232 /* ITEM_DEPOSIT_REQUIRED */ :
863                         case 1233 /* ITEM_RENTAL_FEE_REQUIRED */ :
864                         case 7013 /* PATRON_EXCEEDS_FINES */ :
865                             found_handled = true;
866                         break;
867                         case 7002 /* PATRON_EXCEEDS_CHECKOUT_COUNT */ :
868                             found_handled = true;
869                         break;
870                         case 7003 /* COPY_CIRC_NOT_ALLOWED */ :
871                             found_handled = true;
872                         break;
873                         case 7004 /* COPY_NOT_AVAILABLE */ :
874                             msg += test_permit[i].desc + '\n' + document.getElementById('circStrings').getFormattedString('staff.circ.checkout.copy_status', [obj.data.hash.ccs [test_permit[i].payload.status() ].name()]) + '\n';
875                             found_handled = true;
876                         break;
877                         case 7006 /* COPY_IS_REFERENCE */ :
878                             msg += test_permit[i].desc + '\n';
879                             found_handled = true;
880                         break;
881                         case 7009 /* CIRC_CLAIMS_RETURNED */ :
882                             msg += test_permit[i].desc + '\n';
883                             obj.error.yns_alert(
884                                 msg,
885                                 document.getElementById('circStrings').getString('staff.circ.checkout.barcode.check_out_failed'),
886                                 document.getElementById('circStrings').getString('staff.circ.checkout.ok.btn'),
887                                 null,
888                                 null,
889                                 document.getElementById('circStrings').getString('staff.circ.confirm.msg')
890                             );
891                             found_handled = true;
892                         break;
893                         case 7010 /* COPY_ALERT_MESSAGE */ :
894                             msg += test_permit[i].desc + '\n' + document.getElementById('circStrings').getFormattedString('staff.circ.checkout.alert_message', [test_permit[i].payload]) + '\n';
895                             found_handled = true;
896                         break;
897                         case 7016 /* ITEM_ON_HOLDS_SHELF */ :
898                             msg += test_permit[i].desc + '\n';
899                             found_handled = true;
900                         break;
901                         case 1202 /* ITEM_NOT_CATALOGED */ :
902                             found_handled = true;
903                         break;
904                         case 5000 /* PERM_FAILURE */ :
905                             msg += test_permit[i].desc + '\n' + document.getElementById('circStrings').getFormattedString('staff.circ.checkout.permission_denied', [test_permit[i].ilsperm]) + '\n';
906                             found_handled = true;
907                         break;
908                         case 1702 /* OPEN_CIRCULATION_EXISTS */ :
909                             msg += test_permit[i].desc + '\n';
910                             found_handled = true;
911                             var foreign_circ = true;
912                             var my_circ; 
913
914                             var payload = test_permit[i].payload;
915                             if (payload) {
916                                 if (typeof payload.old_circ == 'object') {
917                                     foreign_circ = false;
918                                     my_circ = payload.old_circ;
919                                 }
920                             }
921
922                             if (foreign_circ) {
923                                 var my_copy = obj.network.simple_request('FM_ACP_RETRIEVE_VIA_BARCODE',[params.barcode]);
924                                 if (typeof my_copy.ilsevent != 'undefined') { throw(my_copy); }
925                                 my_circ = obj.network.simple_request('FM_CIRC_RETRIEVE_VIA_COPY',[ses(),my_copy.id(),1]);
926                                 if (typeof my_circ.ilsevent != 'undefined') { throw(my_copy); }
927                                 my_circ = my_circ[0];
928                             }
929
930                             if (! stop_checkout ) {
931
932                                 var due_date = my_circ.due_date() ? util.date.formatted_date( my_circ.due_date(), '%F' ) : null;
933                                 JSAN.use('util.date'); var today = util.date.formatted_date(new Date(),'%F');
934                                 if (due_date) {
935                                     if (today > due_date) {
936                                         msg += (document.getElementById('circStrings').getFormattedString('staff.circ.checkout.item_due', [ util.date.formatted_date( my_circ.due_date(), '%{localized}' ) ]) + '\n');
937                                     }
938                                 }
939
940                                 if (foreign_circ) { // OFFER CANCEL, NORMAL CHECKIN, AND POSSIBLY FORGIVING-BACKDATED CHECKIN
941                                     if (msg.length) msg += ' / ';
942                                     msg+= document.getElementById('circStrings').getFormattedString('staff.circ.checkout.failed_to_patron_other', [ util.date.formatted_date( my_circ.create_time(), '%{localized_date}' ) ]);
943                                     var r = obj.error.yns_alert(
944                                         msg,
945                                         document.getElementById('circStrings').getString('staff.circ.checkout.barcode.check_out_failed'),
946                                         document.getElementById('circStrings').getString('staff.circ.cancel'),
947                                         document.getElementById('circStrings').getString('staff.circ.checkout.normal_checkin_then_checkout'),
948                                         due_date ? (today > due_date ? document.getElementById('circStrings').getString('staff.circ.checkout.forgiving_checkin_then_checkout') : null) : null,
949                                         document.getElementById('circStrings').getString('staff.circ.confirm.msg')
950                                     );
951                                     JSAN.use('circ.util');
952                                     switch(r) {
953                                         case 1:
954                                             circ.util.checkin_via_barcode( ses(), { 'barcode' : params.barcode, 'noop' : 1 } );
955                                             obj.checkout(params);
956                                         break;
957                                         case 2:
958                                             circ.util.checkin_via_barcode( ses(), { 'barcode' : params.barcode, 'noop' : 1 }, due_date );
959                                             obj.checkout(params);
960                                         break;
961                                     }
962                                 } else { // EITHER AUTO-RENEW OR OFFER CANCEL, NORMAL CHECKIN, AND RENEW
963                                     if (payload.auto_renew) {
964                                         circ.util.renew_via_barcode( { 'barcode': params.barcode, 'patron' : obj.patron_id }, function(r) {
965                                             try {
966                                                 params.renewal = true;
967                                                 obj._checkout( params, r[0] ); 
968                                             } catch(E) {
969                                                 alert('Error in checkout.js, RENEW 1: ' + E);
970                                             }
971                                         } );
972                                     } else {
973
974                                         // Include info about date of previous checkout in warning
975                                         if (msg.length) msg += ' / ';
976                                         var cko_d = util.date.formatted_date( my_circ.create_time(), '%{localized_date}' );
977                                         var cur_d = util.date.formatted_date( new Date(), '%{localized_date}');
978                                         if (cko_d == cur_d) {
979                                             msg+= document.getElementById('circStrings').getString('staff.circ.checkout.failed_to_patron_today');
980                                         } else {
981                                             msg+= document.getElementById('circStrings').getString('staff.circ.checkout.failed_to_patron_renew');
982                                         }
983
984                                         var r = obj.error.yns_alert(
985                                             msg,
986                                             document.getElementById('circStrings').getString('staff.circ.checkout.barcode.check_out_failed'),
987                                             document.getElementById('circStrings').getString('staff.circ.cancel'),
988                                             document.getElementById('circStrings').getString('staff.circ.checkout.normal_checkin_then_checkout'),
989                                             document.getElementById('circStrings').getString('staff.circ.checkout.offer_renewal'),
990                                             document.getElementById('circStrings').getString('staff.circ.confirm.msg')
991                                         );
992                                         JSAN.use('circ.util');
993                                         switch(r) {
994                                             case 1:
995                                                 circ.util.checkin_via_barcode( ses(), { 'barcode' : params.barcode, 'noop' : 1 } );
996                                                 obj.checkout(params);
997                                             break;
998                                             case 2:
999                                                 circ.util.renew_via_barcode( { 'barcode' : params.barcode, 'patron' : obj.patron_id }, function(r) {
1000                                                     try {
1001                                                         params.renewal = true;
1002                                                         obj._checkout( params, r[0] ); 
1003                                                     } catch(E) {
1004                                                         alert('Error in checkout.js, RENEW 2: ' + E);
1005                                                     }
1006                                                 } );
1007                                             break;
1008                                         }
1009                                     }
1010                                 }
1011                             } else {
1012                                 obj.error.yns_alert(
1013                                     msg,
1014                                     document.getElementById('circStrings').getString('staff.circ.checkout.barcode.check_out_failed'),
1015                                     document.getElementById('circStrings').getString('staff.circ.checkout.ok.btn'),
1016                                     null,
1017                                     null,
1018                                     document.getElementById('circStrings').getString('staff.circ.confirm.msg')
1019                                 );
1020                             }
1021                         break;
1022                         case 7014 /* COPY_IN_TRANSIT */ :
1023                             msg += test_permit[i].desc + '\n';
1024                             found_handled = true;
1025                             if (! stop_checkout ) {
1026                                 var r = obj.error.yns_alert(
1027                                     msg,
1028                                     document.getElementById('circStrings').getString('staff.circ.checkout.barcode.check_out_failed'),
1029                                     document.getElementById('circStrings').getString('staff.circ.cancel'),
1030                                     document.getElementById('circStrings').getString('staff.circ.checkout.abort_transit_then_checkout'),
1031                                     null,
1032                                     document.getElementById('circStrings').getString('staff.circ.confirm.msg')
1033                                 );
1034                                 if (r == 1) {
1035                                     var robj = obj.network.simple_request('FM_ATC_VOID',[ ses(), { 'barcode' : params.barcode } ]);
1036                                     if (typeof robj.ilsevent == 'undefined') {
1037                                         obj.checkout(params);
1038                                     } else {
1039                                         switch(Number(robj.ilsevent)) {
1040                                             case 1225 /* TRANSIT_ABORT_NOT_ALLOWED */ :
1041                                                 alert(robj.desc);
1042                                             break;
1043                                             case 5000 /* PERM_FAILURE */ :
1044                                             break;
1045                                             default:
1046                                                 throw(robj);
1047                                             break;
1048                                         }
1049                                     }
1050                                 }
1051                             } else {
1052                                 obj.error.yns_alert(
1053                                     msg,
1054                                     document.getElementById('circStrings').getString('staff.circ.checkout.barcode.check_out_failed'),
1055                                     document.getElementById('circStrings').getString('staff.circ.checkout.ok.btn'),
1056                                     null,
1057                                     null,
1058                                     document.getElementById('circStrings').getString('staff.circ.confirm.msg')
1059                                 );
1060                             }
1061                         break;
1062                         case -1 /* NETWORK_FAILURE */ :
1063                             msg += document.getElementById('circStrings').getString('staff.circ.checkout.network_failure') + '\n';
1064                             found_handled = true;
1065                             obj.error.yns_alert(
1066                                 msg,
1067                                 document.getElementById('circStrings').getString('staff.circ.checkout.barcode.check_out_failed'),
1068                                 document.getElementById('circStrings').getString('staff.circ.checkout.ok.btn'),
1069                                 null,
1070                                 null,
1071                                 document.getElementById('circStrings').getString('staff.circ.confirm.msg')
1072                             );
1073                         break;
1074                         default:
1075                             msg += 'FIXME: ' + js2JSON(test_permit[i]) + '\n';
1076                             found_not_handled = true;
1077                         break;
1078                     }
1079                 }
1080                 
1081                 if (found_not_handled) {
1082                     obj.error.standard_unexpected_error_alert(msg,permit);
1083                 }
1084
1085                 obj.controller.view.checkout_barcode_entry_textbox.select();
1086                 obj.controller.view.checkout_barcode_entry_textbox.focus();
1087             }
1088
1089         } catch(E) {
1090             if (params.barcode) { delete obj._checkout_pending_hash[ params.barcode ];    }
1091             if (typeof E.ilsevent != 'undefined' && E.ilsevent == -1) {
1092                 obj.error.standard_network_error_alert(document.getElementById('circStrings').getString('staff.circ.checkout.suggest_offline'));
1093             } else {
1094                 obj.error.standard_unexpected_error_alert(document.getElementById('circStrings').getString('staff.circ.checkout.barcode.check_out_failed'),E);
1095             }
1096             if (typeof obj.on_failure == 'function') {
1097                 obj.on_failure(E);
1098             }
1099             if (typeof window.xulG == 'object' && typeof window.xulG.on_failure == 'function') {
1100                 obj.error.sdump('D_CIRC','circ.checkout: Calling external .on_failure()\n');
1101                 window.xulG.on_failure(E);
1102             } else {
1103                 obj.error.sdump('D_CIRC','circ.checkout: No external .on_failure()\n');
1104             }
1105         }
1106
1107     },
1108
1109     'on_checkout' : function() {
1110         this.controller.view.checkout_menu.selectedIndex = 0;
1111         this.controller.view.checkout_barcode_entry_textbox.disabled = false;
1112         this.controller.view.checkout_barcode_entry_textbox.value = '';
1113         this.controller.view.checkout_barcode_entry_textbox.focus();
1114         document.getElementById('duedate_hbox').hidden = false;
1115     },
1116
1117     'on_failure' : function() {
1118         this.controller.view.checkout_barcode_entry_textbox.select();
1119         this.controller.view.checkout_barcode_entry_textbox.focus();
1120     }
1121 };
1122
1123 dump('exiting circ.checkout.js\n');