]> git.evergreen-ils.org Git - working/Evergreen.git/blob - Open-ILS/web/js/ui/default/staff/circ/patron/regctl.js
1c29a2b99eecb35f0a356c4b4886b52ee1265b21
[working/Evergreen.git] / Open-ILS / web / js / ui / default / staff / circ / patron / regctl.js
1
2 angular.module('egCoreMod')
3 // toss tihs onto egCoreMod since the page app may vary
4
5 .factory('patronRegSvc', ['$q', 'egCore', function($q, egCore) {
6
7     var service = {
8         field_doc : {},              // config.idl_field_doc
9         profiles : [],               // permission groups
10         sms_carriers : [],
11         user_settings : {},          // applied user settings
12         user_setting_types : {},     // config.usr_setting_type
13         modified_user_settings : {}, // settings modifed this session
14         virt_id : -1                 // virtual ID for new objects
15     };
16
17     // launch a series of parallel data retrieval calls
18     service.init = function(scope) {
19         return $q.all([
20             service.get_field_doc(),
21             service.get_perm_groups(),
22             service.get_ident_types(),
23             service.get_user_settings(),
24             service.get_org_settings(),
25             service.get_stat_cats(),
26             service.get_surveys(),
27             service.get_net_access_levels()
28         ]);
29     };
30
31     service.get_surveys = function() {
32         var org_ids = egCore.org.ancestors(egCore.auth.user().ws_ou(), true);
33
34         return egCore.pcrud.search('asv', 
35             {owner : org_ids}, 
36             {flesh : 1, flesh_fields : {asv : ['questions']}}, 
37             {atomic : true}
38         ).then(function(surveys) {
39             service.surveys = surveys;
40         });
41     }
42
43     service.get_stat_cats = function() {
44         return egCore.net.request(
45             'open-ils.circ',
46             'open-ils.circ.stat_cat.actor.retrieve.all',
47             egCore.auth.token(), egCore.auth.user().ws_ou()
48         ).then(function(cats) {
49             service.stat_cats = cats;
50         });
51     };
52
53     service.get_org_settings = function() {
54         return egCore.org.settings([
55             'global.password_regex',
56             'global.juvenile_age_threshold',
57             'patron.password.use_phone',
58             'ui.patron.default_inet_access_level',
59             'ui.patron.default_ident_type',
60             'ui.patron.default_country',
61             'ui.patron.registration.require_address',
62             'circ.holds.behind_desk_pickup_supported',
63             'circ.patron_edit.clone.copy_address',
64             'ui.patron.edit.au.prefix.require',
65             'ui.patron.edit.au.prefix.show',
66             'ui.patron.edit.au.prefix.suggest',
67             'ui.patron.edit.ac.barcode.regex',
68             'ui.patron.edit.au.second_given_name.show',
69             'ui.patron.edit.au.second_given_name.suggest',
70             'ui.patron.edit.au.suffix.show',
71             'ui.patron.edit.au.suffix.suggest',
72             'ui.patron.edit.au.alias.show',
73             'ui.patron.edit.au.alias.suggest',
74             'ui.patron.edit.au.dob.require',
75             'ui.patron.edit.au.dob.show',
76             'ui.patron.edit.au.dob.suggest',
77             'ui.patron.edit.au.dob.calendar',
78             'ui.patron.edit.au.juvenile.show',
79             'ui.patron.edit.au.juvenile.suggest',
80             'ui.patron.edit.au.ident_value.show',
81             'ui.patron.edit.au.ident_value.suggest',
82             'ui.patron.edit.au.ident_value2.show',
83             'ui.patron.edit.au.ident_value2.suggest',
84             'ui.patron.edit.au.email.require',
85             'ui.patron.edit.au.email.show',
86             'ui.patron.edit.au.email.suggest',
87             'ui.patron.edit.au.email.regex',
88             'ui.patron.edit.au.email.example',
89             'ui.patron.edit.au.day_phone.require',
90             'ui.patron.edit.au.day_phone.show',
91             'ui.patron.edit.au.day_phone.suggest',
92             'ui.patron.edit.au.day_phone.regex',
93             'ui.patron.edit.au.day_phone.example',
94             'ui.patron.edit.au.evening_phone.require',
95             'ui.patron.edit.au.evening_phone.show',
96             'ui.patron.edit.au.evening_phone.suggest',
97             'ui.patron.edit.au.evening_phone.regex',
98             'ui.patron.edit.au.evening_phone.example',
99             'ui.patron.edit.au.other_phone.require',
100             'ui.patron.edit.au.other_phone.show',
101             'ui.patron.edit.au.other_phone.suggest',
102             'ui.patron.edit.au.other_phone.regex',
103             'ui.patron.edit.au.other_phone.example',
104             'ui.patron.edit.phone.regex',
105             'ui.patron.edit.phone.example',
106             'ui.patron.edit.au.active.show',
107             'ui.patron.edit.au.active.suggest',
108             'ui.patron.edit.au.barred.show',
109             'ui.patron.edit.au.barred.suggest',
110             'ui.patron.edit.au.master_account.show',
111             'ui.patron.edit.au.master_account.suggest',
112             'ui.patron.edit.au.claims_returned_count.show',
113             'ui.patron.edit.au.claims_returned_count.suggest',
114             'ui.patron.edit.au.claims_never_checked_out_count.show',
115             'ui.patron.edit.au.claims_never_checked_out_count.suggest',
116             'ui.patron.edit.au.alert_message.show',
117             'ui.patron.edit.au.alert_message.suggest',
118             'ui.patron.edit.aua.post_code.regex',
119             'ui.patron.edit.aua.post_code.example',
120             'ui.patron.edit.aua.county.require',
121             'format.date',
122             'ui.patron.edit.default_suggested',
123             'opac.barcode_regex',
124             'opac.username_regex',
125             'sms.enable',
126             'ui.patron.edit.aua.state.require',
127             'ui.patron.edit.aua.state.suggest',
128             'ui.patron.edit.aua.state.show'
129         ]).then(function(settings) {
130             service.org_settings = settings;
131             return service.process_org_settings(settings);
132         });
133     };
134
135     // some org settings require the retrieval of additional data
136     service.process_org_settings = function(settings) {
137
138         var promises = [];
139
140         if (settings['sms.enable']) {
141             // fetch SMS carriers
142             promises.push(
143                 egCore.pcrud.search('csc', 
144                     {active: 'true'}, 
145                     {'order_by':[
146                         {'class':'csc', 'field':'name'},
147                         {'class':'csc', 'field':'region'}
148                     ]}, {atomic : true}
149                 ).then(function(carriers) {
150                     service.sms_carriers = carriers;
151                 })
152             );
153         } else {
154             // if other promises are added below, this is not necessary.
155             promises.push($q.when());  
156         }
157
158         // other post-org-settings processing goes here,
159         // adding to promises as needed.
160
161         return $q.all(promises);
162     };
163
164     service.get_ident_types = function() {
165         return egCore.pcrud.retrieveAll('cit', {}, {atomic : true})
166         .then(function(types) { service.ident_types = types });
167     };
168
169     service.get_net_access_levels = function() {
170         return egCore.pcrud.retrieveAll('cnal', {}, {atomic : true})
171         .then(function(levels) { service.net_access_levels = levels });
172     }
173
174     service.get_perm_groups = function() {
175         if (egCore.env.pgt) {
176             service.profiles = egCore.env.pgt.list;
177             return $q.when();
178         } else {
179             return egCore.pcrud.search('pgt', {parent : null}, 
180                 {flesh : -1, flesh_fields : {pgt : ['children']}}
181             ).then(
182                 function(tree) {
183                     egCore.env.absorbTree(tree, 'pgt')
184                     service.profiles = egCore.env.pgt.list;
185                 }
186             );
187         }
188     }
189
190     service.get_field_doc = function() {
191
192         return egCore.pcrud.search('fdoc', {
193             fm_class: ['au', 'ac', 'aua', 'actsc', 'asv', 'asvq', 'asva']})
194         .then(null, null, function(doc) {
195             if (!service.field_doc[doc.fm_class()]) {
196                 service.field_doc[doc.fm_class()] = {};
197             }
198             service.field_doc[doc.fm_class()][doc.field()] = doc;
199         });
200     };
201
202     service.get_user_settings = function() {
203         var org_ids = egCore.org.ancestors(egCore.auth.user().ws_ou(), true);
204
205         return egCore.pcrud.search('cust', {
206             '-or' : [
207                 {name : [ // common user settings
208                     'circ.holds_behind_desk', 
209                     'circ.collections.exempt', 
210                     'opac.hold_notify', 
211                     'opac.default_phone', 
212                     'opac.default_pickup_location', 
213                     'opac.default_sms_carrier', 
214                     'opac.default_sms_notify']}, 
215                 {name : { // opt-in notification user settings
216                     'in': {
217                         select : {atevdef : ['opt_in_setting']}, 
218                         from : 'atevdef',
219                         // we only care about opt-in settings for 
220                         // event_defs our users encounter
221                         where : {'+atevdef' : {owner : org_ids}}
222                     }
223                 }}
224             ]
225         }, {}, {atomic : true}).then(function(setting_types) {
226
227             angular.forEach(setting_types, function(stype) {
228                 service.user_setting_types[stype.name()] = stype;
229             });
230
231             if (service.patron_id) {
232                 // retrieve applied values for the current user 
233                 // for the setting types we care about.
234
235                 var setting_names = 
236                     setting_types.map(function(obj) { return obj.name() });
237
238                 return egCore.net.request(
239                     'open-ils.actor', 
240                     'open-ils.actor.patron.settings.retrieve.authoritative',
241                     egCore.auth.token(),
242                     service.patron_id,
243                     setting_names
244                 ).then(function(settings) {
245                     service.user_settings = settings;
246                 });
247             } else {
248
249                 // apply default user setting values
250                 angular.forEach(setting_types, function(stype, index) {
251                     if (stype.reg_default() != undefined) {
252                         service.user_settings[setting.name()] = 
253                             setting.reg_default();
254                     }
255                 });
256             }
257         });
258     }
259
260     service.init_patron = function(current) {
261
262         if (!current)
263             return service.init_new_patron();
264
265         service.patron = current;
266         return service.init_existing_patron(current)
267     }
268
269     service.ingest_address = function(patron, addr) {
270         addr.valid = addr.valid == 't';
271         addr.within_city_limits = addr.within_city_limits == 't';
272         addr._is_mailing = (patron.mailing_address && 
273             addr.id == patron.mailing_address.id);
274         addr._is_billing = (patron.billing_address && 
275             addr.id == patron.billing_address.id);
276     }
277
278     /*
279      * Existing patron objects reqire some data munging before insertion
280      * into the scope.
281      *
282      * 1. Turn everything into a hash
283      * 2. ... Except certain fields (selectors) whose widgets require objects
284      * 3. Bools must be Boolean, not t/f.
285      */
286     service.init_existing_patron = function(current) {
287
288         var patron = egCore.idl.toHash(current);
289
290         patron.home_ou = egCore.org.get(patron.home_ou.id);
291         patron.expire_date = new Date(Date.parse(patron.expire_date));
292         patron.dob = new Date(Date.parse(patron.dob));
293         patron.profile = current.profile(); // pre-hash version
294         patron.net_access_level = current.net_access_level();
295         patron.ident_type = current.ident_type();
296
297         angular.forEach(
298             ['juvenile', 'barred', 'active', 'master_account'],
299             function(field) { patron[field] = patron[field] == 't'; }
300         );
301
302         angular.forEach(patron.cards, function(card) {
303             card.active = card.active == 't';
304             if (card.id == patron.card.id) {
305                 patron.card = card;
306                 card._primary = 'on';
307             }
308         });
309
310         angular.forEach(patron.addresses, 
311             function(addr) { service.ingest_address(patron, addr) });
312
313         return patron;
314     }
315
316     service.init_new_patron = function() {
317
318         var addr = {
319             id : service.virt_id--,
320             isnew : true,
321             valid : true,
322             address_type : 'MAILING', // TODO: i18n
323             _is_mailing : true,
324             _is_billing : true,
325             within_city_limits : true
326         };
327
328         var card = {
329             id : service.virt_id--,
330             isnew : true,
331             active : true,
332             _primary : 'on'
333         };
334
335         return {
336             isnew : true,
337             active : true,
338             card : card,
339             cards : [card],
340             home_ou : egCore.org.get(egCore.auth.user().ws_ou()),
341                         
342             // TODO default profile group?
343             addresses : [addr]
344         };
345     }
346
347     // translate the patron back into IDL form
348     service.save_patron = function(phash) {
349
350         var patron = new egCore.idl.au();
351
352         for (var key in phash) {
353             if (typeof patron[key] == 'function')
354                 patron[key](phash[key]);
355         }
356
357         patron.home_ou(patron.home_ou().id());
358         patron.expire_date(
359             patron.expire_date().toISOString().replace(/T.*/,''));
360         patron.profile(patron.profile().id());
361         if (patron.dob()) 
362             patron.dob(patron.dob().toISOString().replace(/T.*/,''));
363         if (patron.ident_type()) 
364             patron.ident_type(patron.ident_type().id());
365         if (patron.net_access_level())
366             patron.net_access_level(patron.net_access_level().id());
367
368         angular.forEach(
369             ['juvenile', 'barred', 'active', 'master_account'],
370             function(field) { patron[field](phash[field] ? 't' : 'f'); }
371         );
372
373         var card_hashes = patron.cards();
374         patron.cards([]);
375         angular.forEach(card_hashes, function(chash) {
376             var card = new egCore.idl.ac();
377             for (var key in chash) {
378                 if (typeof card[key] == 'function') 
379                     card[key](chash[key]);
380             }
381             card.usr(patron.id());
382             card.active(chash.active ? 't' : 'f');
383             patron.cards().push(card);
384
385             if (chash._primary) {
386                 patron.card(card);
387             }
388         });
389
390         var addr_hashes = patron.addresses();
391         patron.addresses([]);
392         angular.forEach(addr_hashes, function(addr_hash) {
393             var addr = new egCore.idl.aua();
394             patron.addresses().push(addr);
395             for (var key in addr_hash) {
396                 if (typeof addr[key] == 'function') 
397                     addr[key](addr_hash[key]);
398             }
399
400             addr.valid(addr.valid() ? 't' : 'f');
401             addr.within_city_limits(addr.within_city_limits() ? 't' : 'f');
402             if (addr_hash._is_mailing) patron.mailing_address(addr);
403             if (addr_hash._is_billing) patron.billing_address(addr);
404         });
405
406         // TODO extract hold_notify_phone, etc.
407
408         console.log(js2JSON(patron));
409
410         egCore.net.request(
411             'open-ils.actor', 
412             'open-ils.actor.patron.update',
413             egCore.auth.token(), patron)
414         .then(function(resp) {
415             // TODO: see original
416             console.log(js2JSON(resp));
417         });
418     }
419
420     return service;
421 }]);
422
423
424 function PatronRegCtrl($scope, $routeParams, 
425     $q, $modal, egCore, patronSvc, patronRegSvc) {
426
427     $scope.clone_id = $routeParams.clone_id;
428     $scope.stage_username = $routeParams.stage_username;
429     $scope.patron_id = 
430         patronRegSvc.patron_id = $routeParams.edit_id || $routeParams.id;
431
432     if (!$scope.edit_passthru) {
433         // in edit more, scope.edit_passthru is delivered to us by
434         // the enclosing controller.  In register mode, there is 
435         // no enclosing controller, so we create our own.
436         $scope.edit_passthru = {};
437     }
438
439     // 0=all, 1=suggested, 2=all
440     $scope.edit_passthru.vis_level = 0; 
441     // TODO: add save/clone handlers here
442
443     $q.all([
444
445         $scope.initTab ? // initTab comes from patron app
446             $scope.initTab('edit', $routeParams.id) : $q.when(),
447
448         patronRegSvc.init()
449
450     ]).then(function() {
451         // called after initTab and patronRegSvc.init have completed
452
453         var prs = patronRegSvc; // brevity
454         // in standalone mode, we have no patronSvc
455         $scope.patron = prs.init_patron(patronSvc ? patronSvc.current : null);
456         $scope.field_doc = prs.field_doc;
457         $scope.profiles = prs.profiles;
458         $scope.ident_types = prs.ident_types;
459         $scope.net_access_levels = prs.net_access_levels;
460         $scope.user_settings = prs.user_settings;
461         $scope.user_setting_types = prs.user_setting_types;
462         $scope.modified_user_settings = prs.modified_user_settings;
463         $scope.org_settings = prs.org_settings;
464         $scope.sms_carriers = prs.sms_carriers;
465         $scope.stat_cats = prs.stat_cats;
466         $scope.surveys = prs.surveys;
467
468         if ($scope.org_settings['ui.patron.edit.default_suggested'])
469             $scope.edit_passthru.vis_level = 1;
470
471         if ($scope.patron.isnew) {
472             $scope.generate_password();
473             $scope.hold_notify_phone = true;
474             $scope.hold_notify_email = true;
475
476             if (prs.org_settings['ui.patron.default_ident_type']) {
477                 $scope.patron.ident_type = 
478                     prs.org_settings['ui.patron.default_ident_type'];
479             }
480             if (prs.org_settings['ui.patron.default_inet_access_level']) {
481                 $scope.patron.ident_type = 
482                     prs.org_settings['ui.patron.default_inet_access_level'];
483             }
484             if (prs.org_settings['ui.patron.default_country']) {
485                 $scope.patron.addresses[0].country = 
486                     prs.org_settings['ui.patron.default_country'];
487             }
488         }
489             
490     });
491
492     // returns the tree depth of the selected profile group tree node.
493     $scope.pgt_depth = function(grp) {
494         var d = 0;
495         while (grp = egCore.env.pgt.map[grp.parent()]) d++;
496         return d;
497     }
498
499     // IDL fields used for labels in the UI.
500     $scope.idl_fields = {
501         au  : egCore.idl.classes.au.field_map,
502         ac  : egCore.idl.classes.ac.field_map,
503         aua : egCore.idl.classes.aua.field_map
504     };
505
506     // field visibility cache.  Some fields are universally required.
507     var field_visibility = {
508         'ac.barcode' : 2,
509         'au.usrname' : 2,
510         'au.passwd' :  2,
511         // TODO passwd2 2,
512         'au.first_given_name' : 2,
513         'au.family_name' : 2,
514         'au.ident_type' : 2,
515         'au.home_ou' : 2,
516         'au.profile' : 2,
517         'au.expire_date' : 2,
518         'au.net_access_level' : 2,
519         'aua.address_type' : 2,
520         'aua.post_code' : 2,
521         'aua.street1' : 2,
522         'aua.street2' : 2,
523         'aua.city' : 2,
524         'aua.county' : 2,
525         'aua.state' : 2,
526         'aua.country' : 2,
527         'aua.valid' : 2,
528         'aua.within_city_limits' : 2,
529         'stat_cats' : 1,
530         'surveys' : 1
531     }; 
532
533     // returns true if the selected field should be visible
534     // given the current required/suggested/all setting.
535     $scope.show_field = function(field_key) {
536
537         if (field_visibility[field_key] == undefined) {
538             // compile and cache the visibility for the selected field
539
540             // org settings have not been received yet.
541             if (!$scope.org_settings) return false;
542
543             var req_set = 'ui.patron.edit.' + field_key + '.require';
544             var sho_set = 'ui.patron.edit.' + field_key + '.show';
545             var sug_set = 'ui.patron.edit.' + field_key + '.suggest';
546
547             if ($scope.org_settings[req_set]) {
548                 field_visibility[field_key] = 2;
549             } else if ($scope.org_settings[sho_set]) {
550                 field_visibility[field_key] = 2;
551             } else if ($scope.org_settings[sug_set]) {
552                 field_visibility[field_key] = 1;
553             } else {
554                 field_visibility[field_key] = 0;
555             }
556         }
557
558         return field_visibility[field_key] >= $scope.edit_passthru.vis_level;
559     }
560
561     // generates a random 4-digit password
562     $scope.generate_password = function() {
563         $scope.patron.passwd = Math.floor(Math.random()*9000) + 1000;
564     }
565
566     $scope.set_expire_date = function() {
567         if (!$scope.patron.profile) return;
568         var seconds = egCore.date.intervalToSeconds(
569             $scope.patron.profile.perm_interval());
570         var now_epoch = new Date().getTime();
571         $scope.patron.expire_date = new Date(
572             now_epoch + (seconds * 1000 /* milliseconds */))
573     }
574
575     // grp is the pgt object
576     $scope.set_profile = function(grp) {
577         $scope.patron.profile = grp;
578         $scope.set_expire_date();
579     }
580
581     $scope.new_address = function() {
582         var addr = egCore.idl.toHash(new egCore.idl.aua());
583         patronRegSvc.ingest_address($scope.patron, addr);
584         addr.id = patronRegSvc.virt_id--;
585         addr.valid = true;
586         addr.within_city_limits = true;
587         $scope.patron.addresses.push(addr);
588     }
589
590     // keep deleted addresses out of the patron object so
591     // they won't appear in the UI.  They'll be re-inserted
592     // when the patron is updated.
593     deleted_addresses = [];
594     $scope.delete_address = function(id) {
595         var addresses = [];
596         angular.forEach($scope.patron.addresses, function(addr) {
597             if (addr.id == id) {
598                 if (id > 0) {
599                     addr.isdeleted = true;
600                     deleted_addresses.push(addr);
601                 }
602             } else {
603                 addresses.push(addr);
604             }
605         });
606         $scope.patron.addresses = addresses;
607     } 
608
609     $scope.post_code_changed = function(addr) { 
610         egCore.net.request(
611             'open-ils.search', 'open-ils.search.zip', addr.post_code)
612         .then(function(resp) {
613             if (!resp) return;
614             if (resp.city) addr.city = resp.city;
615             if (resp.state) addr.state = resp.state;
616             if (resp.county) addr.county = resp.county;
617             if (resp.alert) alert(resp.alert);
618         });
619     }
620
621     $scope.replace_card = function() {
622         $scope.patron.card.active = false;
623         $scope.patron.card.ischanged = true;
624
625         var new_card = egCore.idl.toHash(new egCore.idl.ac());
626         new_card.id = patronRegSvc.virt_id--;
627         new_card.isnew = true;
628         new_card.active = true;
629         new_card._primary = 'on';
630         $scope.patron.card = new_card;
631         $scope.patron.cards.push(new_card);
632     }
633
634     $scope.barcode_changed = function(bc) {
635         if (!bc) return;
636         egCore.net.request(
637             'open-ils.actor',
638             'open-ils.actor.barcode.exists',
639             egCore.auth.token(), bc
640         ).then(function(resp) {
641             if (resp == '1') {
642                 console.log('duplicate barcode detected: ' + bc);
643                 // DUPLICATE CARD
644             } else {
645                 // No dupe -- A-OK
646             }
647         });
648     }
649
650     $scope.cards_dialog = function() {
651         $modal.open({
652             templateUrl: './circ/patron/t_patron_cards_dialog',
653             controller: 
654                    ['$scope','$modalInstance','cards',
655             function($scope , $modalInstance , cards) {
656                 // scope here is the modal-level scope
657                 $scope.args = {cards : cards};
658                 $scope.ok = function() { $modalInstance.close($scope.args) }
659                 $scope.cancel = function () { $modalInstance.dismiss() }
660             }],
661             resolve : {
662                 cards : function() {
663                     // scope here is the controller-level scope
664                     return $scope.patron.cards;
665                 }
666             }
667         }).result.then(
668             function(args) {
669                 angular.forEach(args.cards, function(card) {
670                     card.ischanged = true; // assume cards need updating, OK?
671                     if (card._primary == 'on' && 
672                         card.id != $scope.patron.card.id) {
673                         $scope.patron.card = card;
674                     }
675                 });
676             }
677         );
678     }
679
680     $scope.edit_passthru.save = function() {
681         patronRegSvc.save_patron($scope.patron);        
682     }
683
684 }
685
686
687 // TODO: $inject controller params