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