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