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             } else {
 247
 248                 // apply default user setting values
 249                 angular.forEach(setting_types, function(stype, index) {
 250                     if (stype.reg_default() != undefined) {
 251                         service.user_settings[setting.name()] =
 252                             setting.reg_default();
 253                     }
 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                 patron.card = card;
 305                 card._primary = 'on';
 306             }
 307         });
 308
 309         angular.forEach(patron.addresses,
 310             function(addr) { service.ingest_address(patron, addr) });
 311
 312         return patron;
 313     }
 314
 315     service.init_new_patron = function() {
 316
 317         var addr = {
 318             valid : true,
 319             address_type : 'MAILING', // TODO: i18n
 320             within_city_limits : true
 321             // default state, etc.
 322         };
 323
 324         return {
 325             isnew : true,
 326             active : true,
 327             card : {},
 328             home_ou : egCore.org.get(egCore.auth.user().ws_ou()),
 329
 330             // TODO default profile group?
 331             mailing_address : addr,
 332             addresses : [addr]
 333         };
 334     }
 335
 336     // translate the patron back into IDL form
 337     service.save_patron = function(phash) {
 338
 339         var patron = new egCore.idl.au();
 340
 341         for (var key in phash) {
 342             if (typeof patron[key] == 'function')
 343                 patron[key](phash[key]);
 344         }
 345
 346         patron.home_ou(patron.home_ou().id());
 347         patron.expire_date(
 348             patron.expire_date().toISOString().replace(/T.*/,''));
 349         patron.dob(patron.dob().toISOString().replace(/T.*/,''));
 350         patron.profile(patron.profile().id());
 351         patron.net_access_level(patron.net_access_level().id());
 352         patron.ident_type(patron.ident_type().id());
 353
 354         angular.forEach(
 355             ['juvenile', 'barred', 'active', 'master_account'],
 356             function(field) { patron[field](phash[field] ? 't' : 'f'); }
 357         );
 358
 359         var card_hashes = patron.cards();
 360         patron.cards([]);
 361         angular.forEach(card_hashes, function(chash) {
 362             var card = new egCore.idl.ac();
 363             for (var key in chash) {
 364                 if (typeof card[key] == 'function')
 365                     card[key](chash[key]);
 366             }
 367             card.usr(patron.id());
 368             card.active(chash.active ? 't' : 'f');
 369             patron.cards().push(card);
 370
 371             if (chash._primary) {
 372                 patron.card(card);
 373             }
 374         });
 375
 376         var addr_hashes = patron.addresses();
 377         patron.addresses([]);
 378         angular.forEach(addr_hashes, function(addr_hash) {
 379             var addr = new egCore.idl.aua();
 380             patron.addresses().push(addr);
 381             for (var key in addr_hash) {
 382                 if (typeof addr[key] == 'function')
 383                     addr[key](addr_hash[key]);
 384             }
 385
 386             addr.valid(addr.valid() ? 't' : 'f');
 387             addr.within_city_limits(addr.within_city_limits() ? 't' : 'f');
 388             if (addr_hash._is_mailing) patron.mailing_address(addr);
 389             if (addr_hash._is_billing) patron.billing_address(addr);
 390         });
 391
 392         // TODO extract hold_notify_phone, etc.
 393
 394         egCore.net.request(
 395             'open-ils.actor',
 396             'open-ils.actor.patron.update',
 397             egCore.auth.token(), patron)
 398         .then(function(resp) {
 399             // TODO: see original
 400             console.log(js2JSON(resp));
 401         });
 402
 403         console.log(js2JSON(patron));
 404     }
 405
 406     return service;
 407 }]);
 408
 409
 410 function PatronRegCtrl($scope, $routeParams,
 411     $q, $modal, egCore, patronSvc, patronRegSvc) {
 412
 413     $scope.clone_id = $routeParams.clone_id;
 414     $scope.stage_username = $routeParams.stage_username;
 415     $scope.patron_id =
 416         patronRegSvc.patron_id = $routeParams.edit_id || $routeParams.id;
 417
 418     if (!$scope.edit_passthru) {
 419         // in edit more, scope.edit_passthru is delivered to us by
 420         // the enclosing controller.  In register mode, there is
 421         // no enclosing controller, so we create our own.
 422         $scope.edit_passthru = {};
 423     }
 424
 425     // 0=all, 1=suggested, 2=all
 426     $scope.edit_passthru.vis_level = 0;
 427     // TODO: add save/clone handlers here
 428
 429     $q.all([
 430
 431         $scope.initTab ? // initTab comes from patron app
 432             $scope.initTab('edit', $routeParams.id) : $q.when(),
 433
 434         patronRegSvc.init()
 435
 436     ]).then(function() {
 437         // called after initTab and patronRegSvc.init have completed
 438
 439         var prs = patronRegSvc; // brevity
 440         // in standalone mode, we have no patronSvc
 441         $scope.patron = prs.init_patron(patronSvc ? patronSvc.current : null);
 442         $scope.field_doc = prs.field_doc;
 443         $scope.profiles = prs.profiles;
 444         $scope.ident_types = prs.ident_types;
 445         $scope.net_access_levels = prs.net_access_levels;
 446         $scope.user_settings = prs.user_settings;
 447         $scope.user_setting_types = prs.user_setting_types;
 448         $scope.modified_user_settings = prs.modified_user_settings;
 449         $scope.org_settings = prs.org_settings;
 450         $scope.sms_carriers = prs.sms_carriers;
 451         $scope.stat_cats = prs.stat_cats;
 452         $scope.surveys = prs.surveys;
 453
 454         if ($scope.org_settings['ui.patron.edit.default_suggested'])
 455             $scope.edit_passthru.vis_level = 1;
 456
 457         if ($scope.patron.isnew) {
 458             $scope.generate_password();
 459             $scope.hold_notify_phone = true;
 460             $scope.hold_notify_email = true;
 461
 462             if (prs.org_settings['ui.patron.default_ident_type']) {
 463                 $scope.patron.ident_type =
 464                     prs.org_settings['ui.patron.default_ident_type'];
 465             }
 466             if (prs.org_settings['ui.patron.default_inet_access_level']) {
 467                 $scope.patron.ident_type =
 468                     prs.org_settings['ui.patron.default_inet_access_level'];
 469             }
 470             if (prs.org_settings['ui.patron.default_country']) {
 471                 $scope.patron.addresses[0].country =
 472                     prs.org_settings['ui.patron.default_country'];
 473             }
 474         }
 475
 476     });
 477
 478     // returns the tree depth of the selected profile group tree node.
 479     $scope.pgt_depth = function(grp) {
 480         var d = 0;
 481         while (grp = egCore.env.pgt.map[grp.parent()]) d++;
 482         return d;
 483     }
 484
 485     // IDL fields used for labels in the UI.
 486     $scope.idl_fields = {
 487         au  : egCore.idl.classes.au.field_map,
 488         ac  : egCore.idl.classes.ac.field_map,
 489         aua : egCore.idl.classes.aua.field_map
 490     };
 491
 492     // field visibility cache.  Some fields are universally required.
 493     var field_visibility = {
 494         'ac.barcode' : 2,
 495         'au.usrname' : 2,
 496         'au.passwd' :  2,
 497         // TODO passwd2 2,
 498         'au.first_given_name' : 2,
 499         'au.family_name' : 2,
 500         'au.ident_type' : 2,
 501         'au.home_ou' : 2,
 502         'au.profile' : 2,
 503         'au.expire_date' : 2,
 504         'au.net_access_level' : 2,
 505         'aua.address_type' : 2,
 506         'aua.post_code' : 2,
 507         'aua.street1' : 2,
 508         'aua.street2' : 2,
 509         'aua.city' : 2,
 510         'aua.county' : 2,
 511         'aua.state' : 2,
 512         'aua.country' : 2,
 513         'aua.valid' : 2,
 514         'aua.within_city_limits' : 2,
 515         'stat_cats' : 1,
 516         'surveys' : 1
 517     };
 518
 519     // returns true if the selected field should be visible
 520     // given the current required/suggested/all setting.
 521     $scope.show_field = function(field_key) {
 522
 523         if (field_visibility[field_key] == undefined) {
 524             // compile and cache the visibility for the selected field
 525
 526             // org settings have not been received yet.
 527             if (!$scope.org_settings) return false;
 528
 529             var req_set = 'ui.patron.edit.' + field_key + '.require';
 530             var sho_set = 'ui.patron.edit.' + field_key + '.show';
 531             var sug_set = 'ui.patron.edit.' + field_key + '.suggest';
 532
 533             if ($scope.org_settings[req_set]) {
 534                 field_visibility[field_key] = 2;
 535             } else if ($scope.org_settings[sho_set]) {
 536                 field_visibility[field_key] = 2;
 537             } else if ($scope.org_settings[sug_set]) {
 538                 field_visibility[field_key] = 1;
 539             } else {
 540                 field_visibility[field_key] = 0;
 541             }
 542         }
 543
 544         return field_visibility[field_key] >= $scope.edit_passthru.vis_level;
 545     }
 546
 547     // generates a random 4-digit password
 548     $scope.generate_password = function() {
 549         $scope.patron.passwd = Math.floor(Math.random()*9000) + 1000;
 550     }
 551
 552     $scope.set_expire_date = function() {
 553         if (!$scope.patron.profile) return;
 554         var seconds = egCore.date.intervalToSeconds(
 555             $scope.patron.profile.perm_interval());
 556         var now_epoch = new Date().getTime();
 557         $scope.patron.expire_date = new Date(
 558             now_epoch + (seconds * 1000 /* milliseconds */))
 559     }
 560
 561     // grp is the pgt object
 562     $scope.set_profile = function(grp) {
 563         $scope.patron.profile = grp;
 564         $scope.set_expire_date();
 565     }
 566
 567     var new_addr_id = -1;
 568     $scope.new_address = function() {
 569         var addr = egCore.idl.toHash(new egCore.idl.aua());
 570         patronRegSvc.ingest_address($scope.patron, addr);
 571         addr.id = new_addr_id--;
 572         addr.valid = true;
 573         addr.within_city_limits = true;
 574         $scope.patron.addresses.push(addr);
 575     }
 576
 577     // keep deleted addresses out of the patron object so
 578     // they won't appear in the UI.  They'll be re-inserted
 579     // when the patron is updated.
 580     deleted_addresses = [];
 581     $scope.delete_address = function(id) {
 582         var addresses = [];
 583         angular.forEach($scope.patron.addresses, function(addr) {
 584             if (addr.id == id) {
 585                 if (id > 0) {
 586                     addr.isdeleted = true;
 587                     deleted_addresses.push(addr);
 588                 }
 589             } else {
 590                 addresses.push(addr);
 591             }
 592         });
 593         $scope.patron.addresses = addresses;
 594     }
 595
 596     $scope.post_code_changed = function(addr) {
 597         egCore.net.request(
 598             'open-ils.search', 'open-ils.search.zip', addr.post_code)
 599         .then(function(resp) {
 600             if (!resp) return;
 601             if (resp.city) addr.city = resp.city;
 602             if (resp.state) addr.state = resp.state;
 603             if (resp.county) addr.county = resp.county;
 604             if (resp.alert) alert(resp.alert);
 605         });
 606     }
 607
 608     var new_card_id = -1;
 609     $scope.replace_card = function() {
 610         $scope.patron.card.active = false;
 611         $scope.patron.card.ischanged = true;
 612
 613         var new_card = egCore.idl.toHash(new egCore.idl.ac());
 614         new_card.id = new_card_id--;
 615         new_card.isnew = true;
 616         new_card.active = true;
 617         new_card._primary = 'on';
 618         $scope.patron.card = new_card;
 619         $scope.patron.cards.push(new_card);
 620     }
 621
 622     $scope.barcode_changed = function(bc) {
 623         if (!bc) return;
 624         egCore.net.request(
 625             'open-ils.actor',
 626             'open-ils.actor.barcode.exists',
 627             egCore.auth.token(), bc
 628         ).then(function(resp) {
 629             if (resp == '1') {
 630                 console.log('duplicate barcode detected: ' + bc);
 631                 // DUPLICATE CARD
 632             } else {
 633                 // No dupe -- A-OK
 634             }
 635         });
 636     }
 637
 638     $scope.cards_dialog = function() {
 639         $modal.open({
 640             templateUrl: './circ/patron/t_patron_cards_dialog',
 641             controller:
 642                    ['$scope','$modalInstance','cards',
 643             function($scope , $modalInstance , cards) {
 644                 // scope here is the modal-level scope
 645                 $scope.args = {cards : cards};
 646                 $scope.ok = function() { $modalInstance.close($scope.args) }
 647                 $scope.cancel = function () { $modalInstance.dismiss() }
 648             }],
 649             resolve : {
 650                 cards : function() {
 651                     // scope here is the controller-level scope
 652                     return $scope.patron.cards;
 653                 }
 654             }
 655         }).result.then(
 656             function(args) {
 657                 angular.forEach(args.cards, function(card) {
 658                     card.ischanged = true; // assume cards need updating, OK?
 659                     if (card._primary == 'on' &&
 660                         card.id != $scope.patron.card.id) {
 661                         $scope.patron.card = card;
 662                     }
 663                 });
 664             }
 665         );
 666     }
 667
 668     $scope.edit_passthru.save = function() {
 669         patronRegSvc.save_patron($scope.patron);
 670     }
 671
 672 }
 673
 674
 675 // TODO: $inject controller params