plugged in autorenewal, more event handling
[Evergreen.git] / Open-ILS / web / js / ui / default / circ / selfcheck / selfcheck.js
index 4ac16d3..25c02e7 100644 (file)
@@ -4,6 +4,7 @@ dojo.require('openils.CGI');
 dojo.require('openils.Util');
 dojo.require('openils.User');
 dojo.require('openils.Event');
+dojo.require('openils.widget.ProgressDialog');
 
 dojo.requireLocalization('openils.circ', 'selfcheck');
 var localeStrings = dojo.i18n.getLocalization('openils.circ', 'selfcheck');
@@ -15,6 +16,8 @@ const SET_ALERT_ON_CHECKOUT_EVENT = 'circ.selfcheck.alert_on_checkout_event';
 const SET_AUTO_OVERRIDE_EVENTS = 'circ.selfcheck.auto_override_checkout_events';
 const SET_PATRON_PASSWORD_REQUIRED = 'circ.selfcheck.patron_password_required';
 
+//openils.Util.playAudioUrl('/xul/server/skin/media/audio/bonus.wav');
+
 function SelfCheckManager() {
 
     this.cgi = new openils.CGI();
@@ -31,29 +34,28 @@ function SelfCheckManager() {
     // are we currently performing a renewal?
     this.isRenewal = false; 
 
-    // is a transaction pending?
-    this.pendingXact = false; 
-
     // dict of org unit settings for "here"
     this.orgSettings = {};
 
-    
     // Construct a mock checkout for debugging purposes
-    this.mockCheckout = {
-        payload : {
-            record : new fieldmapper.mvr(),
-            copy : new fieldmapper.acp(),
-            circ : new fieldmapper.circ()
-        }
-    };
+    if(this.mockCheckouts = this.cgi.param('mock-circ')) {
+
+        this.mockCheckout = {
+            payload : {
+                record : new fieldmapper.mvr(),
+                copy : new fieldmapper.acp(),
+                circ : new fieldmapper.circ()
+            }
+        };
 
-    this.mockCheckout.payload.record.title('Jazz improvisation for guitar');
-    this.mockCheckout.payload.record.author('Wise, Les');
-    this.mockCheckout.payload.record.isbn('0634033565');
-    this.mockCheckout.payload.copy.barcode('123456789');
-    this.mockCheckout.payload.circ.renewal_remaining(1);
-    this.mockCheckout.payload.circ.parent_circ(1);
-    this.mockCheckout.payload.circ.due_date('2012-12-21');
+        this.mockCheckout.payload.record.title('Jazz improvisation for guitar');
+        this.mockCheckout.payload.record.author('Wise, Les');
+        this.mockCheckout.payload.record.isbn('0634033565');
+        this.mockCheckout.payload.copy.barcode('123456789');
+        this.mockCheckout.payload.circ.renewal_remaining(1);
+        this.mockCheckout.payload.circ.parent_circ(1);
+        this.mockCheckout.payload.circ.due_date('2012-12-21');
+    }
 }
 
 
@@ -68,20 +70,20 @@ SelfCheckManager.prototype.init = function() {
     this.authtoken = openils.User.authtoken;
     this.loadOrgSettings();
 
-    // add onclick handlers for nav links
-
+    
     var self = this;
-    dojo.connect(
-        dojo.byId('oils-selfck-hold-details-link'),
-        'onclick',
-        function() { self.drawHoldsPage(); }
-    );
+    // connect onclick handlers to the various navigation links
+    var linkHandlers = {
+        'oils-selfck-hold-details-link' : function() { self.drawHoldsPage(); },
+        'oils-selfck-nav-holds' : function() { self.drawHoldsPage(); },
+        'oils-selfck-pay-fines-link' : function() { self.drawFinesPage(); },
+        'oils-selfck-nav-fines' : function() { self.drawFinesPage(); },
+        'oils-selfck-nav-home' : function() { self.drawCircPage(); },
+        'oils-selfck-nav-logout' : function() { self.logoutPatron(); }
+    }
 
-    dojo.connect(
-        dojo.byId('oils-selfck-pay-fines-link'),
-        'onclick',
-        function() { self.drawPayFinesPage(); }
-    );
+    for(var id in linkHandlers) 
+        dojo.connect(dojo.byId(id), 'onclick', linkHandlers[id]);
 
 
     if(this.cgi.param('patron')) {
@@ -129,11 +131,9 @@ SelfCheckManager.prototype.drawLoginPage = function() {
             // password is required.  wire up the scan box to read it
             self.updateScanBox({
                 msg : 'Please enter your password', // TODO i18n 
-                handler : function(pw) { self.loginPatron(barcode, ps); }
+                handler : function(pw) { self.loginPatron(barcode, pw); }
             });
 
-            dojo.connect(selfckScanBox, 'onKeyDown', pwHandler);
-
         } else {
             // password is not required, go ahead and login
             self.loginPatron(barcode);
@@ -161,7 +161,8 @@ SelfCheckManager.prototype.loginPatron = function(barcode, passwd) {
         );
 
         if(res == 0) {
-            return alert('login failed'); // TODO
+            // user-not-found results in login failure
+            this.handleXactResult('login', barcode, {textcode : 'ACTOR_USER_NOT_FOUND'});
         }
     } 
 
@@ -173,25 +174,14 @@ SelfCheckManager.prototype.loginPatron = function(barcode, passwd) {
 
     var evt = openils.Event.parse(this.patron);
     if(evt) {
+        this.handleXactResult('login', barcode, evt);
 
-        // User login failed, why?
-        
-        switch(evt.textcode) {
-
-            case 'ACTOR_USER_NOT_FOUND':
-                return alert('user not found'); // TODO
-
-            case 'NO_SESSION':
-                return alert('staff login timed out'); // TODO
+    } else {
 
-            default:
-                return alert('unexpected patron login error occured: ' + evt.textcode); // TODO
-        }
+        dojo.byId('oils-selfck-status-div').innerHTML = '';
+        dojo.byId('oils-selfck-user-banner').innerHTML = 'Welcome, ' + this.patron.usrname(); // TODO i18n
+        this.drawCircPage();
     }
-
-    // patron login succeeded
-    dojo.byId('oils-selfck-user-banner').innerHTML = 'Welcome, ' + this.patron.usrname(); // TODO i18n
-    this.drawCircPage();
 }
 
 
@@ -202,8 +192,13 @@ SelfCheckManager.prototype.loginPatron = function(barcode, passwd) {
  * @param handler Optional "on-enter" handler.  
  */
 SelfCheckManager.prototype.updateScanBox = function(args) {
+    args = args || {};
 
-    selfckScanBox.attr('value', '');
+    if(args.select) {
+        selfckScanBox.domNode.select();
+    } else {
+        selfckScanBox.attr('value', '');
+    }
 
     if(args.value)
         selfckScanBox.attr('value', args.value);
@@ -241,6 +236,8 @@ SelfCheckManager.prototype.drawCircPage = function() {
         handler : function(barcode) { self.checkout(barcode); }
     });
 
+    openils.Util.hide('oils-selfck-payment-page');
+    openils.Util.hide('oils-selfck-holds-page');
     openils.Util.show('oils-selfck-circ-page');
 
     this.circTbody = dojo.byId('oils-selfck-circ-tbody');
@@ -272,9 +269,9 @@ SelfCheckManager.prototype.drawCircPage = function() {
     this.updateCircSummary();
 
     // render mock checkouts for debugging?
-    if(this.cgi.param('mock-circ')) {
+    if(this.mockCheckouts) {
         for(var i in [1,2,3]) 
-            this.displayCheckout(this.mockCheckout);
+            this.displayCheckout(this.mockCheckout, 'checkout');
     }
 }
 
@@ -355,8 +352,91 @@ SelfCheckManager.prototype.drawHoldsPage = function() {
     openils.Util.hide('oils-selfck-circ-page');
     openils.Util.hide('oils-selfck-payment-page');
     openils.Util.show('oils-selfck-holds-page');
+
+    this.holdTbody = dojo.byId('oils-selfck-hold-tbody');
+    if(!this.holdTemplate)
+        this.holdTemplate = this.holdTbody.removeChild(dojo.byId('oils-selfck-hold-row'));
+    while(this.holdTbody.childNodes[0])
+        this.holdTbody.removeChild(this.holdTbody.childNodes[0]);
+
+    progressDialog.show(true);
+
+    var self = this;
+    fieldmapper.standardRequest( // fetch the hold IDs
+
+        ['open-ils.circ', 'open-ils.circ.holds.id_list.retrieve'],
+        {   async : true,
+            params : [this.authtoken, this.patron.id()],
+
+            oncomplete : function(r) { 
+                var ids = openils.Util.readResponse(r);
+                if(!ids || ids.length == 0) {
+                    progressDialog.hide();
+                    return;
+                }
+
+                fieldmapper.standardRequest( // fetch the hold objects with fleshed details
+                    ['open-ils.circ', 'open-ils.circ.hold.details.batch.retrieve.atomic'],
+                    {   async : true,
+                        params : [self.authtoken, ids],
+
+                        oncomplete : function(rr) {
+                            self.drawHolds(openils.Util.readResponse(rr));
+                        }
+                    }
+                );
+            }
+        }
+    );
 }
 
+/**
+ * Fetch and add a single hold to the list of holds
+ */
+SelfCheckManager.prototype.drawHolds = function(holds) {
+
+    holds = holds.sort(
+        // sort available holds to the top of the list
+        // followed by queue position order
+        function(a, b) {
+            if(a.status == 4) return -1;
+            if(a.queue_position < b.queue_position) return -1;
+            return 1;
+        }
+    );
+
+    progressDialog.hide();
+
+    for(var i in holds) {
+
+        var data = holds[i];
+        var row = this.holdTemplate.cloneNode(true);
+
+        if(data.mvr.isbn()) {
+            this.byName(row, 'jacket').setAttribute('src', '/opac/extras/ac/jacket/small/' + data.mvr.isbn());
+        }
+
+        this.byName(row, 'title').innerHTML = data.mvr.title();
+        this.byName(row, 'author').innerHTML = data.mvr.author();
+
+        if(data.status == 4) {
+
+            // hold is ready for pickup
+            this.byName(row, 'status').innerHTML = localeStrings.HOLD_STATUS_READY;
+
+        } else {
+
+            // hold is still pending
+            this.byName(row, 'status').innerHTML = 
+                dojo.string.substitute(
+                    localeStrings.HOLD_STATUS_WAITING,
+                    [data.queue_position, data.potential_copies]
+                );
+        }
+
+        this.holdTbody.appendChild(row);
+    }
+}
 
 
 
@@ -371,12 +451,21 @@ SelfCheckManager.prototype.checkout = function(barcode, override) {
         return;
     }
 
+    if(this.mockCheckouts) {
+        // if we're in mock-checkout mode, just insert another
+        // fake circ into the table and get out of here.
+        this.displayCheckout(this.mockCheckout, 'checkout');
+        return;
+    }
+
     // TODO see if it's a patron barcode
     // TODO see if this item has already been checked out in this session
 
     var method = 'open-ils.circ.checkout.full';
     if(override) method += '.override';
 
+    console.log("Checkout out item " + barcode + " with method " + method);
+
     var result = fieldmapper.standardRequest(
         ['open-ils.circ', 'open-ils.circ.checkout.full'],
         {params: [
@@ -387,43 +476,156 @@ SelfCheckManager.prototype.checkout = function(barcode, override) {
         ]}
     );
 
+    var stat = this.handleXactResult('checkout', barcode, result);
 
-    if(dojo.isArray(result)) {
-        // list of results.  See if we can override all of them.
+    if(stat.override) {
+        this.checkout(barcode, true);
+    } else if(stat.renew) {
+        // TODO check org setting for auto-renewal interval
+        this.renew(barcode);
+    }
+}
+
+
+SelfCheckManager.prototype.handleXactResult = function(action, item, result) {
+
+    var displayText = '';
+    var popup = false;
+
+    // TODO handle lost/missing/etc checkin+checkout override steps
+        
+    if(result.textcode == 'NO_SESSION') {
+
+        return this.logoutStaff();
+
+    } else if(result.textcode == 'SUCCESS') {
+
+        if(action == 'checkout') {
+
+            displayText = dojo.string.substitute(
+                localeStrings.CHECKOUT_SUCCESS, [item]);
+                this.displayCheckout(result, 'checkout');
+
+        } else if(action == 'renew') {
+
+            displayText = dojo.string.substitute(
+                localeStrings.RENEW_SUCCESS, [item]);
+                this.displayCheckout(result, 'renew');
+        }
+
+        this.updateScanBox();
+
+    } else if(result.textcode == 'OPEN_CIRCULATION_EXISTS' && action == 'checkout') {
+
+        return { renew : true };
 
     } else {
-        var evt = openils.Event.parse(result);
 
-        switch(evt.textcode) {
-            // standard result events
+        var overrideEvents = this.orgSettings[SET_AUTO_OVERRIDE_EVENTS];
+    
+        if(overrideEvents && overrideEvents.length) {
             
-            case 'SUCCESS':
-                this.displayCheckout(evt);
+            // see if the events we received are all in the list of
+            // events to override
+    
+            if(!result.length) result = [result];
+    
+            var override = true;
+            for(var i = 0; i < result.length; i++) {
+                var match = overrideEvents.filter(
+                    function(e) { return (e == result[i].textcode); })[0];
+                if(!match) {
+                    override = false;
+                    break;
+                }
+            }
+
+            if(override) 
+                return { override : true };
+        }
+    
+        this.updateScanBox({select : true});
+        popup = true;
+
+        if(result.length) 
+            result = result[0];
+
+        switch(result.textcode) {
+
+            case 'ACTOR_USER_NOT_FOUND' : 
+                displayText = dojo.string.substitute(
+                    localeStrings.LOGIN_FAILED, [item]);
                 break;
 
-            case 'OPEN_CIRCULATION_EXISTS':
-                // TODO renewal
+            case 'MAX_RENEWALS_REACHED' :
+                displayText = dojo.string.substitute(
+                    localeStrings.MAX_RENEWALS, [item]);
                 break;
 
-            case 'NO_SESSION':
-                // TODO logout staff
+            case 'ITEM_NOT_CATALOGED' :
+                displayText = dojo.string.substitute(
+                    localeStrings.ITEM_NOT_CATALOGED, [item]);
                 break;
+
+            case 'already-out' : 
+                displayText = dojo.string.substitute(
+                    localeStrings.ALREADY_OUT, [item]);
+                break;
+
+            default:
+                console.error('Unhandled event ' + result.textcode);
+
+                if(action == 'checkout' || action == 'renew') {
+                    displayText = dojo.string.substitute(
+                        localeStrings.GENERIC_CIRC_FAILURE, [item]);
+                } else {
+                    displayText = dojo.string.substitute(
+                        localeStrings.UNKNOWN_ERROR, [result.textcode]);
+                }
         }
     }
 
-    console.log("Circ resulted in " + js2JSON(result));
+    console.log("Updating status with " + displayText);
+
+    dojo.byId('oils-selfck-status-div').innerHTML = displayText;
+
+    if(popup && this.orgSettings[SET_ALERT_ON_CHECKOUT_EVENT]) 
+        alert(displayText);
+
+    return {};
 }
 
+
 /**
  * Renew an item
  */
-SelfCheckManager.prototype.renew = function() {
+SelfCheckManager.prototype.renew = function(barcode, override) {
+
+    var method = 'open-ils.circ.renew';
+    if(override) method += '.override';
+
+    console.log("Renewing item " + barcode + " with method " + method);
+
+    var result = fieldmapper.standardRequest(
+        ['open-ils.circ', method],
+        {params: [
+            this.authtoken, {
+                patron_id : this.patron.id(),
+                copy_barcode : barcode
+            }
+        ]}
+    );
+
+    var stat = this.handleXactResult('renew', barcode, result);
+
+    if(stat.override)
+        this.renew(barcode, true);
 }
 
 /**
  * Display the result of a checkout or renewal in the items out table
  */
-SelfCheckManager.prototype.displayCheckout = function(evt) {
+SelfCheckManager.prototype.displayCheckout = function(evt, type) {
 
     var copy = evt.payload.copy;
     var record = evt.payload.record;
@@ -438,12 +640,14 @@ SelfCheckManager.prototype.displayCheckout = function(evt) {
     this.byName(row, 'title').innerHTML = record.title();
     this.byName(row, 'author').innerHTML = record.author();
     this.byName(row, 'remaining').innerHTML = circ.renewal_remaining();
+    openils.Util.show(this.byName(row, type));
 
     var date = dojo.date.stamp.fromISOString(circ.due_date());
     this.byName(row, 'due_date').innerHTML = 
         dojo.date.locale.format(date, {selector : 'date'});
 
-    this.circTbody.appendChild(row);
+    // put new circs at the top of the list
+    this.circTbody.insertBefore(row, this.circTbody.getElementsByTagName('tr')[0]);
 }
 
 
@@ -451,16 +655,19 @@ SelfCheckManager.prototype.byName = function(node, name) {
     return dojo.query('[name=' + name+']', node)[0];
 }
 
-/**
- * Print a receipt
- */
-SelfCheckManager.prototype.printReceipt = function() {
+
+SelfCheckManager.prototype.drawFinesPage = function() {
+
+    openils.Util.hide('oils-selfck-circ-page');
+    openils.Util.hide('oils-selfck-holds-page');
+    openils.Util.show('oils-selfck-payment-page');
+
 }
 
 /**
- * Build the patron holds table
+ * Print a receipt
  */
-SelfCheckManager.prototype.displayHolds = function() {
+SelfCheckManager.prototype.printReceipt = function() {
 }
 
 
@@ -468,6 +675,12 @@ SelfCheckManager.prototype.displayHolds = function() {
  * Logout the patron and return to the login page
  */
 SelfCheckManager.prototype.logoutPatron = function() {
+
+    this.patron = null;
+    this.holdsSummary = null;
+    this.circSummary = null;
+
+    this.drawLoginPage();
 }