plugged in autorenewal, more event handling
[Evergreen.git] / Open-ILS / web / js / ui / default / circ / selfcheck / selfcheck.js
index 2405c55..25c02e7 100644 (file)
@@ -1,7 +1,10 @@
+dojo.require('dojo.date.locale');
+dojo.require('dojo.date.stamp');
 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');
@@ -13,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();
@@ -29,13 +34,32 @@ 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
+    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');
+    }
 }
 
+
+
 /**
  * Fetch the org-unit settings, initialize the display, etc.
  */
@@ -46,9 +70,28 @@ SelfCheckManager.prototype.init = function() {
     this.authtoken = openils.User.authtoken;
     this.loadOrgSettings();
 
+    
+    var self = this;
+    // 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(); }
+    }
+
+    for(var id in linkHandlers) 
+        dojo.connect(dojo.byId(id), 'onclick', linkHandlers[id]);
+
+
     if(this.cgi.param('patron')) {
-        // Patron barcode via cgi param.  Mainly used for debugging.
+        
+        // Patron barcode via cgi param.  Mainly used for debugging and
+        // only works if password is not required by policy
         this.loginPatron(this.cgi.param('patron'));
+
     } else {
         this.drawLoginPage();
     }
@@ -88,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);
@@ -120,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'});
         }
     } 
 
@@ -132,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();
 }
 
 
@@ -161,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);
@@ -200,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');
@@ -224,101 +262,179 @@ SelfCheckManager.prototype.drawCircPage = function() {
         }
     );
 
-    // items out summary
-
+    // holds summary
     this.updateHoldsSummary();
+
+    // items out summary
     this.updateCircSummary();
+
+    // render mock checkouts for debugging?
+    if(this.mockCheckouts) {
+        for(var i in [1,2,3]) 
+            this.displayCheckout(this.mockCheckout, 'checkout');
+    }
 }
 
 SelfCheckManager.prototype.updateHoldsSummary = function(decrement) {
 
-
-    var self = this;
-    var oncomplete = function() {
-        dojo.byId('oils-selfck-holds-total').innerHTML = 
-            dojo.string.substitute(
-                localeStrings.TOTAL_HOLDS, 
-                [self.holdsSummary.total]
-            );
-
-        dojo.byId('oils-selfck-holds-ready').innerHTML = 
-            dojo.string.substitute(
-                localeStrings.HOLDS_READY_FOR_PICKUP, 
-                [self.holdsSummary.ready]
-            );
-    };
-
     if(!this.holdsSummary) {
-        fieldmapper.standardRequest(
+        var summary = fieldmapper.standardRequest(
             ['open-ils.circ', 'open-ils.circ.holds.user_summary'],
-            {   async : true,
-                params : [this.authtoken, this.patron.id()],
-                oncomplete : function(r) {
-                    var summary = openils.Util.readResponse(r);
-                    self.holdsSummary = {};
-                    self.holdsSummary.ready = Number(summary['4']);
-                    self.holdsSummary.total = 0;
-                    for(var i in summary) 
-                        self.holdsSummary.total += Number(summary[i]);
-                    oncomplete();
-                }
-            }
+            {params : [this.authtoken, this.patron.id()]}
         );
-    } else {
 
-        if(this.decrement) 
-            this.holdsSummary.ready -= 1;
-    
-        oncomplete();
+        this.holdsSummary = {};
+        this.holdsSummary.ready = Number(summary['4']);
+        this.holdsSummary.total = 0;
+
+        for(var i in summary) 
+            this.holdsSummary.total += Number(summary[i]);
     }
+
+    if(this.decrement) 
+        this.holdsSummary.ready -= 1;
+
+    dojo.byId('oils-selfck-holds-total').innerHTML = 
+        dojo.string.substitute(
+            localeStrings.TOTAL_HOLDS, 
+            [this.holdsSummary.total]
+        );
+
+    dojo.byId('oils-selfck-holds-ready').innerHTML = 
+        dojo.string.substitute(
+            localeStrings.HOLDS_READY_FOR_PICKUP, 
+            [this.holdsSummary.ready]
+        );
 }
 
 
 SelfCheckManager.prototype.updateCircSummary = function(increment) {
 
-    var self = this;
-    var oncomplete = function() {
-        dojo.byId('oils-selfck-circ-account-total').innerHTML = 
-            dojo.string.substitute(
-                localeStrings.TOTAL_ITEMS_ACCOUNT, 
-                [self.circSummary.total]
-            );
-
-        dojo.byId('oils-selfck-circ-session-total').innerHTML = 
-            dojo.string.substitute(
-                localeStrings.TOTAL_ITEMS_SESSION, 
-                [self.circSummary.session]
-            );
+    if(!this.circSummary) {
+
+        var summary = fieldmapper.standardRequest(
+            ['open-ils.actor', 'open-ils.actor.user.checked_out.count'],
+            {params : [this.authtoken, this.patron.id()]}
+        );
+
+        this.circSummary = {
+            total : Number(summary.out) + Number(summary.overdue),
+            overdue : Number(summary.overdue),
+            session : 0
+        };
     }
 
-    if(this.circSummary) {
+    if(increment) {
+        // local checkout occurred.  Add to the total and the session.
+        this.circSummary.total += 1;
+        this.circSummary.session += 1;
+    }
 
-        if(increment) {
-            // local checkout occurred.  Add to the total and the session.
-            this.circSummary.total += 1;
-            this.circSummary.session += 1;
-        }
+    dojo.byId('oils-selfck-circ-account-total').innerHTML = 
+        dojo.string.substitute(
+            localeStrings.TOTAL_ITEMS_ACCOUNT, 
+            [this.circSummary.total]
+        );
+
+    dojo.byId('oils-selfck-circ-session-total').innerHTML = 
+        dojo.string.substitute(
+            localeStrings.TOTAL_ITEMS_SESSION, 
+            [this.circSummary.session]
+        );
+}
 
-        oncomplete();
 
-    } else {
-        // fetch the circ summary for the patron
-        var summary = fieldmapper.standardRequest(
-            ['open-ils.actor', 'open-ils.actor.user.checked_out.count'],
-            {
-                async : true,
-                params : [this.authtoken, this.patron.id()],
-                oncomplete : function(r) {
-                    var summary = openils.Util.readResponse(r);
-                    self.circSummary = {
-                        total : Number(summary.out) + Number(summary.overdue),
-                        overdue : Number(summary.overdue),
-                        session : 0
-                    }
-                    oncomplete();
+SelfCheckManager.prototype.drawHoldsPage = function() {
+
+    // TODO add option to hid scanBox
+    // this.updateScanBox(...)
+
+    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);
     }
 }
 
@@ -335,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: [
@@ -351,60 +476,178 @@ SelfCheckManager.prototype.checkout = function(barcode, override) {
         ]}
     );
 
+    var stat = this.handleXactResult('checkout', barcode, result);
+
+    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') {
 
-    if(dojo.isArray(result)) {
-        // list of results.  See if we can override all of them.
+        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;
     var circ = evt.payload.circ;
     var row = this.circTemplate.cloneNode(true);
 
-    /*
     if(record.isbn()) {
-           var pic = $n(template, 'jacket');
-           pic.setAttribute('src', '/opac/ac/jacket/small/' + cleanISBN(record.isbn()));
+        this.byName(row, 'jacket').setAttribute('src', '/opac/extras/ac/jacket/small/' + record.isbn());
     }
-    */
 
     this.byName(row, 'barcode').innerHTML = copy.barcode();
     this.byName(row, 'title').innerHTML = record.title();
     this.byName(row, 'author').innerHTML = record.author();
-    this.circTbody.appendChild(row);
+    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'});
+
+    // put new circs at the top of the list
+    this.circTbody.insertBefore(row, this.circTbody.getElementsByTagName('tr')[0]);
 }
 
 
@@ -412,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() {
 }
 
 
@@ -429,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();
 }