4 * Search, checkout, items out, holds, bills, edit, etc.
7 angular.module('egPatronApp', ['ngRoute', 'ui.bootstrap',
8 'egCoreMod', 'egUiMod', 'egGridMod', 'egUserMod', 'ngToast'])
10 .config(['ngToastProvider', function(ngToastProvider) {
11 ngToastProvider.configure({
12 verticalPosition: 'bottom',
17 .config(function($routeProvider, $locationProvider, $compileProvider) {
18 $locationProvider.html5Mode(true);
19 $compileProvider.aHrefSanitizationWhitelist(/^\s*(https?|blob):/); // grid export
21 // data loaded at startup which only requires an authtoken goes
22 // here. this allows the requests to be run in parallel instead of
23 // waiting until startup has completed.
24 var resolver = {delay : ['egCore','egUser', function(egCore , egUser) {
26 // fetch the org settings we care about during egStartup
27 // and toss them into egCore.env as egCore.env.aous[name] = value.
28 // note: only load settings here needed by all tabs; load tab-
29 // specific settings from within their respective controllers
30 egCore.env.classLoaders.aous = function() {
31 return egCore.org.settings([
32 'ui.staff.require_initials.patron_info_notes',
33 'circ.do_not_tally_claims_returned',
36 'ui.circ.show_billing_tab_on_bills',
37 'circ.patron_expires_soon_warning',
38 'ui.circ.items_out.lost',
39 'ui.circ.items_out.longoverdue',
40 'ui.circ.items_out.claimsreturned'
41 ]).then(function(settings) {
42 // local settings are cached within egOrg. Caching them
43 // again in egEnv just simplifies the syntax for access.
44 egCore.env.aous = settings;
48 egCore.env.loadClasses.push('aous');
50 // app-globally modify the default flesh fields for
51 // fleshed user retrieval.
52 if (egUser.defaultFleshFields.indexOf('profile') == -1) {
53 egUser.defaultFleshFields = egUser.defaultFleshFields.concat([
63 return egCore.startup.go().then(function() {
65 // This call requires orgs to be loaded, because it
66 // calls egCore.org.ancestors(), so call it after startup
67 return egCore.pcrud.search('actsc',
68 {owner : egCore.org.ancestors(
69 egCore.auth.user().ws_ou(), true)},
71 ).then(function(cats) {
72 egCore.env.absorbList(cats, 'actsc');
77 $routeProvider.when('/circ/patron/search', {
78 templateUrl: './circ/patron/t_search',
79 controller: 'PatronSearchCtrl',
83 $routeProvider.when('/circ/patron/bcsearch', {
84 templateUrl: './circ/patron/t_bcsearch',
85 controller: 'PatronBarcodeSearchCtrl',
89 $routeProvider.when('/circ/patron/credentials', {
90 templateUrl: './circ/patron/t_credentials',
91 controller: 'PatronVerifyCredentialsCtrl',
95 $routeProvider.when('/circ/patron/last', {
96 templateUrl: './circ/patron/t_last_patron',
97 controller: 'PatronFetchLastCtrl',
101 // the following require a patron ID
103 $routeProvider.when('/circ/patron/:id/alerts', {
104 templateUrl: './circ/patron/t_alerts',
105 controller: 'PatronAlertsCtrl',
109 $routeProvider.when('/circ/patron/:id/checkout', {
110 templateUrl: './circ/patron/t_checkout',
111 controller: 'PatronCheckoutCtrl',
115 $routeProvider.when('/circ/patron/:id/items_out', {
116 templateUrl: './circ/patron/t_items_out',
117 controller: 'PatronItemsOutCtrl',
121 $routeProvider.when('/circ/patron/:id/holds', {
122 templateUrl: './circ/patron/t_holds',
123 controller: 'PatronHoldsCtrl',
127 $routeProvider.when('/circ/patron/:id/holds/create', {
128 templateUrl: './circ/patron/t_holds_create',
129 controller: 'PatronHoldsCreateCtrl',
133 $routeProvider.when('/circ/patron/:id/holds/:hold_id', {
134 templateUrl: './circ/patron/t_holds',
135 controller: 'PatronHoldsCtrl',
139 $routeProvider.when('/circ/patron/:id/hold/:hold_id', {
140 templateUrl: './circ/patron/t_hold_details',
141 controller: 'PatronHoldDetailsCtrl',
145 $routeProvider.when('/circ/patron/:id/bills', {
146 templateUrl: './circ/patron/t_bills',
147 controller: 'PatronBillsCtrl',
151 $routeProvider.when('/circ/patron/:id/bill/:xact_id', {
152 templateUrl: './circ/patron/t_xact_details',
153 controller: 'XactDetailsCtrl',
157 $routeProvider.when('/circ/patron/:id/bill_history/:history_tab', {
158 templateUrl: './circ/patron/t_bill_history',
159 controller: 'BillHistoryCtrl',
163 $routeProvider.when('/circ/patron/:id/messages', {
164 templateUrl: './circ/patron/t_messages',
165 controller: 'PatronMessagesCtrl',
169 $routeProvider.when('/circ/patron/:id/edit', {
170 templateUrl: './circ/patron/t_edit',
171 controller: 'PatronRegCtrl',
175 $routeProvider.when('/circ/patron/:id/credentials', {
176 templateUrl: './circ/patron/t_credentials',
177 controller: 'PatronVerifyCredentialsCtrl',
181 $routeProvider.when('/circ/patron/:id/notes', {
182 templateUrl: './circ/patron/t_notes',
183 controller: 'PatronNotesCtrl',
187 $routeProvider.when('/circ/patron/:id/triggered_events', {
188 templateUrl: './circ/patron/t_triggered_events',
189 controller: 'PatronTriggeredEventsCtrl',
193 $routeProvider.when('/circ/patron/:id/message_center', {
194 templateUrl: './circ/patron/t_message_center',
195 controller: 'PatronMessageCenterCtrl',
199 $routeProvider.when('/circ/patron/:id/edit_perms', {
200 templateUrl: './circ/patron/t_edit_perms',
201 controller: 'PatronPermsCtrl',
205 $routeProvider.when('/circ/patron/:id/group', {
206 templateUrl: './circ/patron/t_group',
207 controller: 'PatronGroupCtrl',
211 $routeProvider.when('/circ/patron/:id/stat_cats', {
212 templateUrl: './circ/patron/t_stat_cats',
213 controller: 'PatronStatCatsCtrl',
217 $routeProvider.when('/circ/patron/:id/surveys', {
218 templateUrl: './circ/patron/t_surveys',
219 controller: 'PatronSurveyCtrl',
223 $routeProvider.otherwise({redirectTo : '/circ/patron/search'});
229 .factory('patronSvc',
230 ['$q','$timeout','$location','egCore','egUser','$locale',
231 function($q , $timeout , $location , egCore, egUser , $locale) {
234 // cached patron search results
237 // currently selected patron object
240 // patron circ stats (overdues, fines, holds)
243 // event types manually overridden, which should always be
244 // overridden for checkouts to this patron for this instance of
246 checkout_overrides : {},
247 //holds the searched barcode
248 search_barcode : null,
251 // when we change the default patron, we need to clear out any
252 // data collected on that patron
253 service.resetPatronLists = function() {
254 service.checkouts = [];
255 service.items_out = []
256 service.items_out_ids = [];
258 service.hold_ids = [];
259 service.checkout_overrides = {};
260 service.patron_stats = null;
261 service.noncat_ids = [];
262 service.hasAlerts = false;
263 service.patronExpired = false;
264 service.patronExpiresSoon = false;
265 service.invalidAddresses = false;
267 service.resetPatronLists(); // initialize
269 // Returns true if the last alerted patron matches the current
270 // patron. Otherwise, the last alerted patron is set to the
271 // current patron and false is returned.
272 service.alertsShown = function() {
273 var key = 'eg.circ.last_alerted_patron';
274 var last_id = egCore.hatch.getSessionItem(key);
275 if (last_id && last_id == service.current.id()) return true;
276 egCore.hatch.setSessionItem(key, service.current.id());
280 // shortcut to force-reload the current primary
281 service.refreshPrimary = function() {
282 if (!service.current) return $q.when();
283 return service.setPrimary(service.current.id(), null, true);
286 // clear the currently focused user
287 service.clearPrimary = function() {
288 // reset with no patron
289 service.resetPatronLists();
290 service.current = null;
291 service.patron_stats = null;
295 // sets the primary display user, fetching data as necessary.
296 service.setPrimary = function(id, user, force) {
297 var user_id = id ? id : (user ? user.id() : null);
299 console.debug('setting primary user to: ' + user_id);
301 if (!user_id) return $q.reject();
303 // when loading a new patron, update the last patron setting
304 if (!service.current || service.current.id() != user_id)
305 egCore.hatch.setLoginSessionItem('eg.circ.last_patron', user_id);
307 // avoid running multiple retrievals for the same patron, which
308 // can happen during dbl-click by maintaining a single running
309 // data retrieval promise
310 if (service.primaryUserPromise) {
311 if (service.primaryUserId == user_id) {
312 return service.primaryUserPromise.promise;
314 service.primaryUserPromise = null;
318 service.primaryUserPromise = $q.defer();
319 service.primaryUserId = user_id;
321 service.getPrimary(id, user, force)
323 service.checkAlerts();
324 var p = service.primaryUserPromise;
325 service.primaryUserId = null;
326 // clear before resolution just to be safe.
327 service.primaryUserPromise = null;
331 return service.primaryUserPromise.promise;
334 service.getPrimary = function(id, user, force) {
337 if (!force && service.current &&
338 service.current.id() == user.id()) {
339 if (service.patron_stats) {
342 return service.fetchUserStats();
346 service.resetPatronLists();
347 service.current = user;
348 service.localFlesh(user);
349 return service.fetchUserStats();
352 if (!force && service.current && service.current.id() == id) {
353 if (service.patron_stats) {
356 return service.fetchUserStats();
360 service.resetPatronLists();
362 return egUser.get(id).then(
364 service.current = user;
365 service.localFlesh(user);
366 return service.fetchUserStats();
370 "unable to fetch user "+id+': '+js2JSON(err))
375 // fetching a null user clears the primary user.
376 // NOTE: this should probably reject() and log an error,
377 // but calling clear for backwards compat for now.
378 return service.clearPrimary();
382 // flesh some additional user fields locally
383 service.localFlesh = function(user) {
384 if (!angular.isObject(typeof user.home_ou()))
385 user.home_ou(egCore.org.get(user.home_ou()));
388 user.standing_penalties(),
390 if (!angular.isObject(penalty.org_unit()))
391 penalty.org_unit(egCore.org.get(penalty.org_unit()));
395 // stat_cat_entries == stat_cat_entry_user_map
396 angular.forEach(user.stat_cat_entries(), function(map) {
397 if (angular.isObject(map.stat_cat())) return;
398 // At page load, we only retrieve org-visible stat cats.
399 // For the common case, ignore entries for remote stat cats.
400 var cat = egCore.env.actsc.map[map.stat_cat()];
403 cat.owner(egCore.org.get(cat.owner()));
408 // resolves to true if the patron account has expired or will
409 // expire soon, based on YAOUS circ.patron_expires_soon_warning
410 // note: returning a promise is no longer strictly necessary
411 // (no more async activity) if the calling function is changed too.
412 service.testExpire = function() {
414 var expire = Date.parse(service.current.expire_date());
415 if (expire < new Date()) {
416 return $q.when(service.patronExpired = true);
419 var soon = egCore.env.aous['circ.patron_expires_soon_warning'];
421 var preExpire = new Date();
422 preExpire.setDate(preExpire.getDate() + Number(soon));
423 if (expire < preExpire)
424 return $q.when(service.patronExpiresSoon = true);
427 return $q.when(false);
430 // resolves to true if the patron account has any invalid addresses.
431 service.testInvalidAddrs = function() {
433 if (service.invalidAddresses)
434 return $q.when(true);
439 service.current.addresses(),
440 function(addr) { if (addr.valid() == 'f') fail = true }
443 return $q.when(fail);
445 //resolves to true if the patron was fetched with an inactive card
446 service.fetchedWithInactiveCard = function() {
447 var bc = service.search_barcode
448 var cards = service.current.cards();
449 var card = cards.filter(function(c) { return c.barcode() == bc })[0];
450 return (card && card.active() == 'f');
452 // resolves to true if there is any aspect of the patron account
453 // which should produce a message in the alerts panel
454 service.checkAlerts = function() {
456 if (service.hasAlerts) // already checked
457 return $q.when(true);
459 var deferred = $q.defer();
460 var p = service.current;
462 if (service.alert_penalties.length ||
466 service.patron_stats.holds.ready) {
468 service.hasAlerts = true;
471 // see if the user was retrieved with an inactive card
472 if(service.fetchedWithInactiveCard()){
473 service.hasAlerts = true;
476 // regardless of whether we know of alerts, we still need
477 // to test/fetch the expire data for display
478 service.testExpire().then(function(bool) {
479 if (bool) service.hasAlerts = true;
480 deferred.resolve(service.hasAlerts);
483 service.testInvalidAddrs().then(function(bool) {
484 if (bool) service.invalidAddresses = true;
485 deferred.resolve(service.invalidAddresses);
488 return deferred.promise;
491 service.fetchGroupFines = function() {
492 return egCore.net.request(
494 'open-ils.actor.usergroup.members.balance_owed',
495 egCore.auth.token(), service.current.usrgroup()
496 ).then(function(list) {
498 angular.forEach(list, function(u) {
499 total += 100 * Number(u.balance_owed)
501 service.patron_stats.fines.group_balance_owed = total / 100;
505 service.getUserStats = function(id) {
506 return egCore.net.request(
508 'open-ils.actor.user.opac.vital_stats.authoritative',
509 egCore.auth.token(), id
512 // force numeric to ensure correct boolean handling in templates
513 stats.fines.balance_owed = Number(stats.fines.balance_owed);
514 stats.checkouts.overdue = Number(stats.checkouts.overdue);
515 stats.checkouts.claims_returned =
516 Number(stats.checkouts.claims_returned);
517 stats.checkouts.lost = Number(stats.checkouts.lost);
518 stats.checkouts.out = Number(stats.checkouts.out);
519 stats.checkouts.total_out =
520 stats.checkouts.out + stats.checkouts.overdue;
522 stats.checkouts.total_out += Number(stats.checkouts.long_overdue);
524 if (!egCore.env.aous['circ.do_not_tally_claims_returned'])
525 stats.checkouts.total_out += stats.checkouts.claims_returned;
527 if (egCore.env.aous['circ.tally_lost'])
528 stats.checkouts.total_out += stats.checkouts.lost
535 // Fetches the IDs of any active non-cat checkouts for the current
536 // user. Also sets the patron_stats non_cat count value to match.
537 service.getUserNonCats = function(id) {
538 return egCore.net.request(
540 'open-ils.circ.open_non_cataloged_circulation.user.authoritative',
541 egCore.auth.token(), id
542 ).then(function(noncat_ids) {
543 service.noncat_ids = noncat_ids;
544 service.patron_stats.checkouts.noncat = noncat_ids.length;
548 // grab additional circ info
549 service.fetchUserStats = function() {
550 return service.getUserStats(service.current.id())
551 .then(function(stats) {
552 service.patron_stats = stats
553 service.alert_penalties = service.current.standing_penalties()
554 .filter(function(pen) {
555 return pen.standing_penalty().staff_alert() == 't'
558 service.summary_stat_cats = [];
559 angular.forEach(service.current.stat_cat_entries(),
561 if (angular.isObject(map.stat_cat()) &&
562 map.stat_cat().usr_summary() == 't') {
563 service.summary_stat_cats.push(map);
568 // run these two in parallel
569 var p1 = service.getUserNonCats(service.current.id());
570 var p2 = service.fetchGroupFines();
571 return $q.all([p1, p2]);
575 // Avoid using parens [e.g. (1.23)] to indicate negative numbers,
576 // which is the Angular default.
577 // http://stackoverflow.com/questions/17441254/why-angularjs-currency-filter-formats-negative-numbers-with-parenthesis
578 // FIXME: This change needs to be moved into a project-wide collection
579 // of locale overrides.
580 $locale.NUMBER_FORMATS.PATTERNS[1].negPre = '-';
581 $locale.NUMBER_FORMATS.PATTERNS[1].negSuf = '';
587 * Manages tabbed patron view.
588 * This is the parent scope of all patron tab scopes.
591 .controller('PatronCtrl',
592 ['$scope','$q','$location','$filter','egCore','egUser','patronSvc',
593 function($scope, $q, $location , $filter, egCore, egUser, patronSvc) {
595 $scope.is_patron_edit = function() {
596 return Boolean($location.path().match(/patron\/\d+\/edit$/));
599 // To support the fixed position patron edit actions bar,
600 // its markup has to live outside the scope of the patron
601 // edit controller. Insert a scope blob here that can be
602 // modifed from within the patron edit controller.
603 $scope.edit_passthru = {};
605 // returns true if a redirect occurs
606 function redirectToAlertPanel() {
608 $scope.alert_penalties =
609 function() {return patronSvc.alert_penalties}
611 if (patronSvc.alertsShown()) return false;
613 // if the patron has any unshown alerts, show them now
614 if (patronSvc.hasAlerts &&
615 !$location.path().match(/alerts$/)) {
618 .path('/circ/patron/' + patronSvc.current.id() + '/alerts')
619 .search('card', null);
623 // no alert required. If the patron has fines and the show-bills
624 // OUS is applied, direct to the bills page.
625 if ($scope.patron_stats().fines.balance_owed > 0 // TODO: != 0 ?
626 && egCore.env.aous['ui.circ.show_billing_tab_on_bills']
627 && !$location.path().match(/bills$/)) {
629 $scope.tab = 'bills';
631 .path('/circ/patron/' + patronSvc.current.id() + '/bills')
632 .search('card', null);
640 // called after each route-specified controller is instantiated.
641 // this doubles as a way to inform the top-level controller that
642 // egStartup.go() has completed, which means we are clear to
643 // fetch the patron, etc.
644 $scope.initTab = function(tab, patron_id) {
645 console.log('init tab ' + tab);
647 $scope.aous = egCore.env.aous;
650 $scope.patron_id = patron_id;
651 return patronSvc.setPrimary($scope.patron_id)
652 .then(function() {return patronSvc.checkAlerts()})
653 .then(redirectToAlertPanel);
658 $scope._show_dob = {};
659 $scope.show_dob = function (val) {
660 if ($scope.patron()) {
661 if (typeof val != 'undefined') $scope._show_dob[$scope.patron().id()] = val;
662 return $scope._show_dob[$scope.patron().id()];
664 return !egCore.env.aous['circ.obscure_dob'];
667 $scope.obscure_dob = function() {
668 return egCore.env.aous && egCore.env.aous['circ.obscure_dob'];
670 $scope.now_show_dob = function() {
671 return egCore.env.aous && egCore.env.aous['circ.obscure_dob'] ?
672 $scope.show_dob() : true;
675 $scope.patron = function() { return patronSvc.current }
676 $scope.patron_stats = function() { return patronSvc.patron_stats }
677 $scope.summary_stat_cats = function() { return patronSvc.summary_stat_cats }
678 $scope.hasAlerts = function() { return patronSvc.hasAlerts }
679 $scope.isPatronExpired = function() { return patronSvc.patronExpired }
681 $scope.print_address = function(addr) {
684 template : 'patron_address',
686 patron : egCore.idl.toHash(patronSvc.current),
687 address : egCore.idl.toHash(addr)
692 $scope.toggle_expand_summary = function() {
693 if ($scope.collapsePatronSummary) {
694 $scope.collapsePatronSummary = false;
695 egCore.hatch.removeItem('eg.circ.patron.summary.collapse');
697 $scope.collapsePatronSummary = true;
698 egCore.hatch.setItem('eg.circ.patron.summary.collapse', true);
702 // always expand the patron summary in the search UI, regardless
703 // of stored preference.
704 $scope.collapse_summary = function() {
705 return $scope.tab != 'search' && $scope.collapsePatronSummary;
708 egCore.hatch.getItem('eg.circ.patron.summary.collapse')
709 .then(function(val) {$scope.collapsePatronSummary = Boolean(val)});
712 .controller('PatronBarcodeSearchCtrl',
713 ['$scope','$location','egCore','egConfirmDialog','egUser','patronSvc',
714 function($scope , $location , egCore , egConfirmDialog , egUser , patronSvc) {
715 $scope.selectMe = true; // focus text input
716 patronSvc.clearPrimary(); // clear the default user
718 // jump to the patron checkout UI
719 function loadPatron(user_id) {
720 egCore.audio.play('success.patron.by_barcode');
722 .path('/circ/patron/' + user_id + '/checkout')
723 .search('card', $scope.args.barcode);
724 patronSvc.search_barcode = $scope.args.barcode;
727 // create an opt-in=yes response for the loaded user
728 function createOptIn(user_id) {
731 'open-ils.actor.user.org_unit_opt_in.create',
732 egCore.auth.token(), user_id).then(function(resp) {
733 if (evt = egCore.evt.parse(resp)) return alert(evt);
739 $scope.submitBarcode = function(args) {
740 $scope.bcNotFound = null;
741 $scope.optInRestricted = false;
742 if (!args.barcode) return;
744 // blur so next time it's set to true it will re-apply select()
745 $scope.selectMe = false;
752 'open-ils.actor.get_barcodes',
753 egCore.auth.token(), egCore.auth.user().ws_ou(),
754 'actor', args.barcode)
756 .then(function(resp) { // get_barcodes
758 if (evt = egCore.evt.parse(resp)) {
763 if (!resp || !resp[0]) {
764 $scope.bcNotFound = args.barcode;
765 $scope.selectMe = true;
766 egCore.audio.play('warning.patron.not_found');
770 // see if an opt-in request is needed
771 user_id = resp[0].id;
772 return egCore.net.request(
774 'open-ils.actor.user.org_unit_opt_in.check',
775 egCore.auth.token(), user_id);
777 }).then(function(optInResp) { // opt_in_check
779 if (evt = egCore.evt.parse(optInResp)) {
784 if (optInResp == 2) {
785 // opt-in disallowed at this location by patron's home library
786 $scope.optInRestricted = true;
787 $scope.selectMe = true;
788 egCore.audio.play('warning.patron.opt_in_restricted');
792 if (optInResp == 1) {
793 // opt-in handled or not needed
794 return loadPatron(user_id);
797 // opt-in needed, show the opt-in dialog
798 egUser.get(user_id, {useFields : []})
800 .then(function(user) { // retrieve user
801 var org = egCore.org.get(user.home_ou());
802 egConfirmDialog.open(
803 egCore.strings.OPT_IN_DIALOG_TITLE,
804 egCore.strings.OPT_IN_DIALOG,
805 { family_name : user.family_name(),
806 first_given_name : user.first_given_name(),
807 org_name : org.name(),
808 org_shortname : org.shortname(),
809 ok : function() { createOptIn(user.id()) },
810 cancel : function() {}
820 * Manages patron search
822 .controller('PatronSearchCtrl',
823 ['$scope','$q','$routeParams','$timeout','$window','$location','egCore',
824 '$filter','egUser', 'patronSvc','egGridDataProvider','$document',
825 'egPatronMerge','egProgressDialog',
826 function($scope, $q, $routeParams, $timeout, $window, $location, egCore,
827 $filter, egUser, patronSvc , egGridDataProvider , $document,
828 egPatronMerge , egProgressDialog) {
830 $scope.initTab('search');
831 $scope.focusMe = true;
832 $scope.searchArgs = {
833 // default to searching globally
834 home_ou : egCore.org.tree()
837 // last used patron search form element
840 $scope.gridControls = {
841 activateItem : function(item) {
842 $location.path('/circ/patron/' + item.id() + '/checkout');
844 selectedItems : function() {return []}
847 // Handle URL-encoded searches
848 if ($location.search().search) {
849 console.log('URL search = ' + $location.search().search);
850 patronSvc.urlSearch = {search : JSON2js($location.search().search)};
852 // why the double-JSON encoded sort?
853 if (patronSvc.urlSearch.search.search_sort) {
854 patronSvc.urlSearch.sort =
855 JSON2js(patronSvc.urlSearch.search.search_sort);
857 patronSvc.urlSearch.sort = [];
859 delete patronSvc.urlSearch.search.search_sort;
861 // include inactive patrons if "inactive" param
862 if ($location.search().inactive) {
863 patronSvc.urlSearch.inactive = $location.search().inactive;
868 var propagate_inactive;
869 if (patronSvc.lastSearch) {
870 propagate = patronSvc.lastSearch.search;
871 // home_ou needs to be treated specially
872 propagate.home_ou = {
873 value : patronSvc.lastSearch.home_ou,
876 } else if (patronSvc.urlSearch) {
877 propagate = patronSvc.urlSearch.search;
878 if (patronSvc.urlSearch.inactive) {
879 propagate_inactive = patronSvc.urlSearch.inactive;
883 if (egCore.env.pgt) {
884 $scope.profiles = egCore.env.pgt.list;
886 egCore.pcrud.search('pgt', {parent : null},
887 {flesh : -1, flesh_fields : {pgt : ['children']}}
890 egCore.env.absorbTree(tree, 'pgt')
891 $scope.profiles = egCore.env.pgt.list;
897 // populate the search form with our cached / preexisting search info
898 angular.forEach(propagate, function(val, key) {
899 if (key == 'profile')
900 val.value = $scope.profiles.filter(function(p) { return p.id() == val.value })[0];
901 if (key == 'home_ou')
902 val.value = egCore.org.get(val.value);
903 $scope.searchArgs[key] = val.value;
905 if (propagate_inactive) {
906 $scope.searchArgs.inactive = propagate_inactive;
910 var provider = egGridDataProvider.instance({});
913 function() {return $scope.gridControls.selectedItems()},
916 patronSvc.setPrimary(null, list[0]);
921 provider.get = function(offset, count) {
922 var deferred = $q.defer();
925 if (patronSvc.urlSearch) {
926 fullSearch = patronSvc.urlSearch;
927 // enusre the urlSearch only runs once.
928 delete patronSvc.urlSearch;
931 patronSvc.search_barcode = $scope.searchArgs.card;
933 var search = compileSearch($scope.searchArgs);
934 if (Object.keys(search) == 0) return $q.when();
936 var home_ou = search.home_ou;
937 delete search.home_ou;
938 var inactive = search.inactive;
939 delete search.inactive;
943 sort : compileSort(),
949 fullSearch.count = count;
950 fullSearch.offset = offset;
952 if (patronSvc.lastSearch) {
953 // search repeated, return the cached results
954 if (angular.equals(fullSearch, patronSvc.lastSearch)) {
955 console.log('patron search returning ' +
956 patronSvc.patrons.length + ' cached results');
958 // notify has to happen after returning the promise
961 angular.forEach(patronSvc.patrons, function(user) {
962 deferred.notify(user);
967 return deferred.promise;
971 patronSvc.lastSearch = fullSearch;
973 if (fullSearch.search.id) {
974 // search by user id performs a direct ID lookup
975 var userId = fullSearch.search.id.value;
978 egUser.get(userId).then(function(user) {
979 patronSvc.localFlesh(user);
980 patronSvc.patrons = [user];
981 deferred.notify(user);
986 return deferred.promise;
989 if (!Object.keys(fullSearch.search).length) {
990 // Empty searches are rejected by the server. Avoid
991 // running the the empty search that runs on page load.
995 egProgressDialog.open(); // Indeterminate
997 patronSvc.patrons = [];
998 var which_sound = 'success';
1001 'open-ils.actor.patron.search.advanced.fleshed',
1002 egCore.auth.token(),
1006 fullSearch.inactive,
1008 egUser.defaultFleshFields,
1015 function() { // onerror
1016 which_sound = 'error';
1019 // hide progress bar as soon as the first result appears.
1020 egProgressDialog.close();
1021 patronSvc.localFlesh(user); // inline
1022 patronSvc.patrons.push(user);
1023 deferred.notify(user);
1025 )['finally'](function() { // close on 0-hits or error
1026 if (which_sound == 'success' && patronSvc.patrons.length == 0) {
1027 which_sound = 'warning';
1029 egCore.audio.play(which_sound + '.patron.by_search');
1030 egProgressDialog.close();
1033 return deferred.promise;
1036 $scope.patronSearchGridProvider = provider;
1038 // determine the tree depth of the profile group
1039 $scope.pgt_depth = function(grp) {
1041 while (grp = egCore.env.pgt.map[grp.parent()]) d++;
1045 $scope.clearForm = function () {
1046 $scope.searchArgs={};
1047 if (lastFormElement) lastFormElement.focus();
1050 $scope.applyShowExtras = function($event, bool) {
1052 $scope.showExtras = true;
1053 egCore.hatch.setItem('eg.circ.patron.search.show_extras', true);
1055 $scope.showExtras = false;
1056 egCore.hatch.removeItem('eg.circ.patron.search.show_extras');
1058 if (lastFormElement) lastFormElement.focus();
1059 $event.preventDefault();
1062 egCore.hatch.getItem('eg.circ.patron.search.show_extras')
1063 .then(function(val) {$scope.showExtras = val});
1065 // map form arguments into search params
1066 function compileSearch(args) {
1068 angular.forEach(args, function(val, key) {
1070 if (key == 'profile' && args.profile) {
1071 search.profile = {value : args.profile.id(), group : 0};
1072 } else if (key == 'home_ou' && args.home_ou) {
1073 search.home_ou = args.home_ou.id(); // passed separately
1074 } else if (key == 'inactive') {
1075 search.inactive = val;
1077 search[key] = {value : val, group : 0};
1079 if (key.match(/phone|ident/)) {
1080 search[key].group = 2;
1082 if (key.match(/street|city|state|post_code/)) {
1083 search[key].group = 1;
1084 } else if (key == 'card') {
1085 search[key].group = 3
1093 function compileSort() {
1095 if (!provider.sort.length) {
1098 "first_given_name ASC",
1099 "second_given_name ASC",
1108 if (angular.isObject(sortdef)) {
1109 var name = Object.keys(sortdef)[0];
1110 var dir = sortdef[name];
1111 sort.push(name + ' ' + dir);
1121 $scope.setLastFormElement = function() {
1122 lastFormElement = $document[0].activeElement;
1125 // search form submit action; tells the results grid to
1127 $scope.search = function(args) { // args === $scope.searchArgs
1128 if (args && Object.keys(args).length)
1129 $scope.gridControls.refresh();
1130 if (lastFormElement) lastFormElement.focus();
1133 // TODO: move this into the (forthcoming) grid row activate action
1134 $scope.onPatronDblClick = function($event, user) {
1135 $location.path('/circ/patron/' + user.id() + '/checkout');
1138 if (patronSvc.urlSearch) {
1139 // force the grid to load the url-based search on page load
1143 $scope.need_two_selected = function() {
1144 var items = $scope.gridControls.selectedItems();
1145 return (items.length == 2) ? false : true;
1147 $scope.merge_patrons = function() {
1148 var items = $scope.gridControls.selectedItems();
1149 if (items.length != 2) return false;
1151 var patron_ids = [];
1152 angular.forEach(items, function(i) {
1153 patron_ids.push(i.id());
1155 egPatronMerge.do_merge(patron_ids).then(function() {
1156 // ensure that we're not drawing from cached
1157 // resuts, as a successful merge just deleted a
1159 delete patronSvc.lastSearch;
1160 $scope.gridControls.refresh();
1169 .controller('PatronMessagesCtrl',
1170 ['$scope','$q','$routeParams','egCore','$uibModal','patronSvc','egCirc',
1171 function($scope , $q , $routeParams, egCore , $uibModal , patronSvc , egCirc) {
1172 $scope.initTab('messages', $routeParams.id);
1173 var usr_id = $routeParams.id;
1175 // setup date filters
1176 var start = new Date(); // now - 1 year
1177 start.setFullYear(start.getFullYear() - 1),
1180 end_date : new Date()
1183 function date_range() {
1184 var start = $scope.dates.start_date.toISOString().replace(/T.*/,'');
1185 var end = $scope.dates.end_date.toISOString().replace(/T.*/,'');
1186 var today = new Date().toISOString().replace(/T.*/,'');
1187 if (end == today) end = 'now';
1188 return [start, end];
1193 var activeGrid = $scope.activeGridControls = {
1194 setSort : function() {
1195 return ['set_date'];
1197 setQuery : function() {
1202 {stop_date : {'>' : 'now'}}
1208 var archiveGrid = $scope.archiveGridControls = {
1209 setSort : function() {
1210 return ['set_date'];
1212 setQuery : function() {
1215 stop_date : {'<=' : 'now'},
1216 set_date : {between : date_range()}
1221 $scope.removePenalty = function(selected) {
1222 // the grid stores flattened penalties. Fetch penalty objects first
1224 var ids = selected.map(function(s){ return s.id });
1225 egCore.pcrud.search('ausp',
1227 {atomic : true, authoritative : true}
1230 ).then(function(penalties) {
1231 return egCore.pcrud.remove(penalties);
1233 // then refresh the grid
1234 }).then(function() {
1235 activeGrid.refresh();
1239 $scope.archivePenalty = function(selected) {
1240 // the grid stores flattened penalties. Fetch penalty objects first
1242 var ids = selected.map(function(s){ return s.id });
1243 egCore.pcrud.search('ausp',
1245 {atomic : true, authoritative : true}
1248 ).then(function(penalties) {
1249 angular.forEach(penalties, function(p){ p.stop_date('now') });
1250 return egCore.pcrud.update(penalties);
1252 // then refresh the grid
1253 }).then(function() {
1254 activeGrid.refresh();
1255 archiveGrid.refresh();
1259 // leverage egEnv for caching
1260 function fetchPenaltyTypes() {
1262 return $q.when(egCore.env.csp.list);
1263 return egCore.pcrud.search(
1264 // id <= 100 are reserved for system use
1265 'csp', {id : {'>': 100}}, {}, {atomic : true})
1266 .then(function(penalties) {
1267 egCore.env.absorbList(penalties, 'csp');
1272 $scope.createPenalty = function() {
1273 egCirc.create_penalty(usr_id).then(function() {
1274 activeGrid.refresh();
1275 // force a refresh of the user, since they may now
1276 // have blocking penalties, etc.
1277 patronSvc.setPrimary(patronSvc.current.id(), null, true);
1281 $scope.editPenalty = function(selected) {
1282 if (selected.length == 0) return;
1284 // grab the penalty from the user object
1285 var penalty = patronSvc.current.standing_penalties().filter(
1286 function(p) {return p.id() == selected[0].id})[0];
1288 egCirc.edit_penalty(penalty).then(function() {
1289 activeGrid.refresh();
1290 // force a refresh of the user, since they may now
1291 // have blocking penalties, etc.
1292 patronSvc.setPrimary(patronSvc.current.id(), null, true);
1299 * Credentials tester
1301 .controller('PatronVerifyCredentialsCtrl',
1302 ['$scope','$routeParams','$location','egCore',
1303 function($scope, $routeParams , $location , egCore) {
1304 $scope.verified = null;
1305 $scope.focusMe = true;
1307 // called with a patron, pre-populate the form args
1308 $scope.initTab('other', $routeParams.id).then(
1310 if ($routeParams.id && $scope.patron()) {
1311 $scope.prepop = true;
1312 $scope.username = $scope.patron().usrname();
1313 $scope.barcode = $scope.patron().card().barcode();
1315 $scope.username = '';
1316 $scope.barcode = '';
1317 $scope.password = '';
1322 // verify login credentials
1323 $scope.verify = function() {
1324 $scope.verified = null;
1325 $scope.notFound = false;
1329 'open-ils.actor.verify_user_password',
1330 egCore.auth.token(), $scope.barcode,
1331 $scope.username, hex_md5($scope.password || '')
1333 ).then(function(resp) {
1334 $scope.focusMe = true;
1335 if (evt = egCore.evt.parse(resp)) {
1337 } else if (resp == 1) {
1338 $scope.verified = true;
1340 $scope.verified = false;
1345 // load the main patron UI for the provided username or barcode
1346 $scope.load = function($event) {
1347 $scope.notFound = false;
1348 $scope.verified = null;
1352 'open-ils.actor.user.retrieve_id_by_barcode_or_username',
1353 egCore.auth.token(), $scope.barcode, $scope.username
1355 ).then(function(resp) {
1358 $location.path('/circ/patron/' + resp + '/checkout');
1362 // something went wrong...
1363 $scope.focusMe = true;
1364 if (evt = egCore.evt.parse(resp)) {
1365 if (evt.textcode == 'ACTOR_USR_NOT_FOUND') {
1366 $scope.notFound = true;
1375 // load() button sits within the verify form.
1376 // avoid submitting the verify() form action on load()
1377 $event.preventDefault();
1381 .controller('PatronAlertsCtrl',
1382 ['$scope','$routeParams','$location','egCore','patronSvc',
1383 function($scope, $routeParams , $location , egCore , patronSvc) {
1385 $scope.initTab('other', $routeParams.id)
1387 $scope.patronExpired = patronSvc.patronExpired;
1388 $scope.patronExpiresSoon = patronSvc.patronExpiresSoon;
1389 $scope.retrievedWithInactive = patronSvc.fetchedWithInactiveCard();
1390 $scope.invalidAddresses = patronSvc.invalidAddresses;
1395 .controller('PatronNotesCtrl',
1396 ['$scope','$filter','$routeParams','$location','egCore','patronSvc','$uibModal',
1398 function($scope, $filter , $routeParams , $location , egCore , patronSvc , $uibModal,
1400 $scope.initTab('other', $routeParams.id);
1401 var usr_id = $routeParams.id;
1404 function refreshPage() {
1406 egCore.pcrud.search('aun',
1408 {flesh : 1, flesh_fields : {aun : ['creator']}},
1409 {authoritative : true})
1410 .then(null, null, function(note) {
1411 $scope.notes.push(note);
1415 // open the new-note dialog and create the note
1416 $scope.newNote = function() {
1418 templateUrl: './circ/patron/t_new_note_dialog',
1420 ['$scope', '$uibModalInstance',
1421 function($scope, $uibModalInstance) {
1422 $scope.focusNote = true;
1424 $scope.require_initials = egCore.env.aous['ui.staff.require_initials.patron_info_notes'];
1425 $scope.ok = function(count) { $uibModalInstance.close($scope.args) }
1426 $scope.cancel = function () { $uibModalInstance.dismiss() }
1430 if (!args.value) return;
1431 var note = new egCore.idl.aun();
1433 note.title(args.title);
1434 note.value(args.value);
1435 note.pub(args.pub ? 't' : 'f');
1436 note.creator(egCore.auth.user().id());
1438 note.value(note.value() + ' [' + args.initials + ']');
1439 egCore.pcrud.create(note).then(function() {refreshPage()});
1444 // delete the selected note
1445 $scope.deleteNote = function(note) {
1446 egConfirmDialog.open(
1447 egCore.strings.PATRON_NOTE_DELETE_CONFIRM_TITLE, egCore.strings.PATRON_NOTE_DELETE_CONFIRM,
1449 egCore.pcrud.remove(note).then(function() {refreshPage()});
1451 note_title : note.title(),
1452 create_date : note.create_date()
1456 // print the selected note
1457 $scope.printNote = function(note) {
1458 var hash = egCore.idl.toHash(note);
1459 hash.usr = egCore.idl.toHash($scope.patron());
1460 egCore.print.print({
1461 context : 'default',
1462 template : 'patron_note',
1463 scope : {note : hash}
1467 // perform the initial note fetch
1471 .controller('PatronGroupCtrl',
1472 ['$scope','$routeParams','$q','$window','$timeout','$location','egCore',
1473 'patronSvc','$uibModal','egPromptDialog','egConfirmDialog',
1474 function($scope, $routeParams , $q , $window , $timeout, $location , egCore ,
1475 patronSvc , $uibModal , egPromptDialog , egConfirmDialog) {
1477 var usr_id = $routeParams.id;
1479 $scope.totals = {owed : 0, total_out : 0, overdue : 0}
1481 var grid = $scope.gridControls = {
1482 activateItem : function(item) {
1483 $location.path('/circ/patron/' + item.id + '/checkout');
1485 itemRetrieved : function(item) {
1487 if (item.id == patronSvc.current.id()) {
1488 item.stats = patronSvc.patron_stats;
1491 // flesh stats for other group members
1492 patronSvc.getUserStats(item.id).then(function(stats) {
1494 $scope.totals.total_out += stats.checkouts.total_out;
1495 $scope.totals.overdue += stats.checkouts.overdue;
1499 setSort : function() {
1500 return ['create_date'];
1504 $scope.initTab('other', $routeParams.id)
1505 .then(function(redirect) {
1506 // if we are redirecting to the alerts page, avoid updating the
1508 if (redirect) return;
1509 // let initTab() fetch the user first so we can know the usrgroup
1512 usrgroup : patronSvc.current.usrgroup(),
1515 $scope.totals.owed = patronSvc.patron_stats.fines.group_balance_owed;
1518 $scope.removeFromGroup = function(selected) {
1520 angular.forEach(selected, function(user) {
1521 console.debug('removing user ' + user.id + ' from group');
1526 'open-ils.actor.usergroup.new',
1527 egCore.auth.token(), user.id, true
1532 $q.all(promises).then(function() {grid.refresh()});
1535 function addUserToGroup(user) {
1536 user.usrgroup(patronSvc.current.usrgroup());
1537 user.ischanged(true);
1540 'open-ils.actor.patron.update',
1541 egCore.auth.token(), user
1543 ).then(function() {grid.refresh()});
1546 // fetch each user ("selected" has flattened users)
1547 // update the usrgroup, then update the user object
1548 // After all updates are complete, refresh the grid.
1549 function moveUsersToGroup(target_user, selected) {
1552 angular.forEach(selected, function(user) {
1554 egCore.pcrud.retrieve('au', user.id)
1556 u.usrgroup(target_user.usrgroup());
1558 return egCore.net.request(
1560 'open-ils.actor.patron.update',
1561 egCore.auth.token(), u
1567 $q.all(promises).then(function() {grid.refresh()});
1570 function showMoveToGroupConfirm(barcode, selected, outbound) {
1573 egCore.pcrud.search('ac', {barcode : barcode})
1575 // fetch the fleshed user
1576 .then(function(card) {
1578 if (!card) return; // TODO: warn user
1580 egCore.pcrud.retrieve('au', card.usr())
1581 .then(function(user) {
1584 templateUrl: './circ/patron/t_move_to_group_dialog',
1586 '$scope','$uibModalInstance',
1587 function($scope , $uibModalInstance) {
1589 $scope.selected = selected;
1590 $scope.outbound = outbound;
1592 function(count) { $uibModalInstance.close() }
1594 function () { $uibModalInstance.dismiss() }
1597 }).result.then(function() {
1599 moveUsersToGroup(user, selected);
1601 addUserToGroup(user);
1608 // selected == move selected patrons to another patron's group
1609 // !selected == patron from a different group moves into our group
1610 function moveToGroup(selected, outbound) {
1611 egPromptDialog.open(
1612 egCore.strings.GROUP_ADD_USER, '',
1613 {ok : function(value) {
1615 showMoveToGroupConfirm(value, selected, outbound);
1620 $scope.moveToGroup = function() { moveToGroup([], false) };
1621 $scope.moveToAnotherGroup = function(selected) { moveToGroup(selected, true) };
1623 $scope.cloneUser = function(selected) {
1624 if (!selected.length) return;
1625 var url = $location.absUrl().replace(
1627 '/patron/register/clone/' + selected[0].id);
1628 $window.open(url, '_blank').focus();
1631 $scope.retrieveSelected = function(selected) {
1632 if (!selected.length) return;
1633 angular.forEach(selected, function(usr) {
1634 $timeout(function() {
1635 var url = $location.absUrl().replace(
1637 '/patron/' + usr.id + '/checkout');
1638 $window.open(url, '_blank')
1645 .controller('PatronStatCatsCtrl',
1646 ['$scope','$routeParams','$q','egCore','patronSvc',
1647 function($scope, $routeParams , $q , egCore , patronSvc) {
1648 $scope.initTab('other', $routeParams.id)
1649 .then(function(redirect) {
1650 // Entries for org-visible stat cats are fleshed. Any others
1651 // have to be fleshed within.
1654 angular.forEach(patronSvc.current.stat_cat_entries(),
1656 if (!angular.isObject(entry.stat_cat())) {
1657 to_flesh[entry.stat_cat()] = entry;
1662 if (!Object.keys(to_flesh).length) return;
1664 egCore.pcrud.search('actsc', {id : Object.keys(to_flesh)})
1665 .then(null, null, function(cat) { // stream
1666 cat.owner(egCore.org.get(cat.owner())); // owner flesh
1667 to_flesh[cat.id()].stat_cat(cat);
1672 .controller('PatronSurveyCtrl',
1673 ['$scope','$routeParams','$location','egCore','patronSvc',
1674 function($scope, $routeParams , $location , egCore , patronSvc) {
1675 $scope.initTab('other', $routeParams.id);
1676 var usr_id = $routeParams.id;
1677 var org_ids = egCore.org.fullPath(egCore.auth.user().ws_ou(), true);
1678 $scope.surveys = [];
1679 // fetch the surveys
1680 egCore.pcrud.search('asvr',
1682 {flesh : 4, flesh_fields : {
1683 asvr : ['question', 'survey', 'answer'],
1684 asv : ['responses', 'questions'],
1685 asvq : ['responses', 'question']
1687 {authoritative : true})
1688 .then(null, null, function(survey) {
1689 var sameSurveyId = false;
1690 if (survey.survey().id() && $scope.surveys.length > 0) {
1691 for (sid = 0; sid < $scope.surveys.length; sid++) {
1692 if (survey.survey().id() == $scope.surveys[sid].id()) sameSurveyId = true;
1695 if (!sameSurveyId) $scope.surveys.push(survey.survey());
1699 .controller('PatronFetchLastCtrl',
1700 ['$scope','$location','egCore',
1701 function($scope , $location , egCore) {
1703 var id = egCore.hatch.getLoginSessionItem('eg.circ.last_patron');
1704 if (id) return $location.path('/circ/patron/' + id + '/checkout');
1706 $scope.no_last = true;
1709 .controller('PatronTriggeredEventsCtrl',
1710 ['$scope','$routeParams','$location','egCore','patronSvc',
1711 function($scope, $routeParams, $location , egCore , patronSvc) {
1712 $scope.initTab('other', $routeParams.id);
1714 var url = $location.absUrl().replace(/\/staff.*/, '/actor/user/event_log');
1715 url += '?patron_id=' + encodeURIComponent($routeParams.id);
1717 $scope.triggered_events_url = url;
1721 .controller('PatronMessageCenterCtrl',
1722 ['$scope','$routeParams','$location','egCore','patronSvc',
1723 function($scope, $routeParams, $location , egCore , patronSvc) {
1724 $scope.initTab('other', $routeParams.id);
1726 var url = $location.protocol() + '://' + $location.host()
1727 + egCore.env.basePath.replace(/\/staff.*/, '/actor/user/message');
1728 url += '/' + encodeURIComponent($routeParams.id);
1730 $scope.message_center_url = url;
1734 .controller('PatronPermsCtrl',
1735 ['$scope','$routeParams','$window','$location','egCore',
1736 function($scope , $routeParams , $window , $location , egCore) {
1737 $scope.initTab('other', $routeParams.id);
1739 var url = $location.absUrl().replace(
1740 /\/eg\/staff.*/, '/xul/server/patron/user_edit.xhtml');
1742 url += '?usr=' + encodeURIComponent($routeParams.id);
1744 // user_edit does not load the session via cookie. It uses URL
1745 // params or xulG instead. Pass via xulG.
1747 ses : egCore.auth.token(),
1748 on_patron_save : function() {
1749 $scope.funcs.reload();
1753 $scope.user_perms_url = url;