Open-ILS/src/eg2/src/app/share/org-select/org-select.component.ts

   1 /** TODO PORT ME TO <eg-combobox> */
   2 import {Component, OnInit, Input, Output, ViewChild, EventEmitter} from '@angular/core';
   3 import {Observable, Subject} from 'rxjs';
   4 import {map, mapTo, debounceTime, distinctUntilChanged, merge, filter} from 'rxjs/operators';
   5 import {AuthService} from '@eg/core/auth.service';
   6 import {StoreService} from '@eg/core/store.service';
   7 import {OrgService} from '@eg/core/org.service';
   8 import {IdlObject} from '@eg/core/idl.service';
   9 import {PermService} from '@eg/core/perm.service';
  10 import {NgbTypeahead, NgbTypeaheadSelectItemEvent} from '@ng-bootstrap/ng-bootstrap';
  11
  12 // Use a unicode char for spacing instead of ASCII=32 so the browser
  13 // won't collapse the nested display entries down to a single space.
  14 const PAD_SPACE = ' '; // U+2007
  15
  16 interface OrgDisplay {
  17   id: number;
  18   label: string;
  19   disabled: boolean;
  20 }
  21
  22 @Component({
  23   selector: 'eg-org-select',
  24   templateUrl: './org-select.component.html'
  25 })
  26 export class OrgSelectComponent implements OnInit {
  27
  28     selected: OrgDisplay;
  29     hidden: number[] = [];
  30     click$ = new Subject<string>();
  31     startOrg: IdlObject;
  32
  33     // Disable the entire input
  34     @Input() disabled: boolean;
  35
  36     @ViewChild('instance', { static: false }) instance: NgbTypeahead;
  37
  38     // Placeholder text for selector input
  39     @Input() placeholder = '';
  40     @Input() stickySetting: string;
  41
  42     // ID to display in the DOM for this selector
  43     @Input() domId = '';
  44
  45     // Org unit field displayed in the selector
  46     @Input() displayField = 'shortname';
  47
  48     // Apply a default org unit value when none is set.
  49     // First tries workstation org unit, then user home org unit.
  50     // An onChange event WILL be generated when a default is applied.
  51     @Input() applyDefault = false;
  52
  53     @Input() readOnly = false;
  54
  55     // List of org unit IDs to exclude from the selector
  56     @Input() set hideOrgs(ids: number[]) {
  57         if (ids) { this.hidden = ids; }
  58     }
  59
  60     // List of org unit IDs to disable in the selector
  61     _disabledOrgs: number[] = [];
  62     @Input() set disableOrgs(ids: number[]) {
  63         if (ids) { this._disabledOrgs = ids; }
  64     }
  65
  66     // Apply an org unit value at load time.
  67     // This will NOT result in an onChange event.
  68     @Input() set initialOrg(org: IdlObject) {
  69         if (org) { this.startOrg = org; }
  70     }
  71
  72     // Apply an org unit value by ID at load time.
  73     // This will NOT result in an onChange event.
  74     @Input() set initialOrgId(id: number) {
  75         if (id) { this.startOrg = this.org.get(id); }
  76     }
  77
  78     // Modify the selected org unit via data binding.
  79     // This WILL result in an onChange event firing.
  80     @Input() set applyOrg(org: IdlObject) {
  81         if (org) {
  82             this.selected = this.formatForDisplay(org);
  83         }
  84     }
  85
  86     permLimitOrgs: number[];
  87     @Input() set limitPerms(perms: string[]) {
  88         this.applyPermLimitOrgs(perms);
  89     }
  90
  91     // Modify the selected org unit by ID via data binding.
  92     // This WILL result in an onChange event firing.
  93     @Input() set applyOrgId(id: number) {
  94         if (id) {
  95             this.selected = this.formatForDisplay(this.org.get(id));
  96         }
  97     }
  98
  99     // Emitted when the org unit value is changed via the selector.
 100     // Does not fire on initialOrg
 101     @Output() onChange = new EventEmitter<IdlObject>();
 102
 103     // convenience method to get an IdlObject representing the current
 104     // selected org unit. One way of invoking this is via a template
 105     // reference variable.
 106     selectedOrg(): IdlObject {
 107         if (this.selected == null) {
 108             return null;
 109         }
 110         return this.org.get(this.selected.id);
 111     }
 112
 113     constructor(
 114       private auth: AuthService,
 115       private store: StoreService,
 116       private org: OrgService,
 117       private perm: PermService
 118     ) { }
 119
 120     ngOnInit() {
 121
 122         // Apply a default org unit if desired and possible.
 123         if (!this.startOrg && this.applyDefault && this.auth.user()) {
 124             // note: ws_ou defaults to home_ou on the server
 125             // when when no workstation is used
 126             this.startOrg = this.org.get(this.auth.user().ws_ou());
 127             this.selected = this.formatForDisplay(
 128                 this.org.get(this.auth.user().ws_ou())
 129             );
 130
 131             // avoid notifying mid-digest
 132             setTimeout(() => this.onChange.emit(this.startOrg), 0);
 133         }
 134
 135         if (this.startOrg) {
 136             this.selected = this.formatForDisplay(this.startOrg);
 137         }
 138     }
 139
 140     //
 141     applyPermLimitOrgs(perms: string[]) {
 142
 143         if (!perms) {
 144             return;
 145         }
 146
 147         // handle lazy clients that pass null perm names
 148         perms = perms.filter(p => p !== null && p !== undefined);
 149
 150         if (perms.length === 0) {
 151             return;
 152         }
 153
 154         // NOTE: If permLimitOrgs is useful in a non-staff context
 155         // we need to change this to support non-staff perm checks.
 156         this.perm.hasWorkPermAt(perms, true).then(permMap => {
 157             this.permLimitOrgs =
 158                 // safari-friendly version of Array.flat()
 159                 Object.values(permMap).reduce((acc, val) => acc.concat(val), []);
 160         });
 161     }
 162
 163     // Format for display in the selector drop-down and input.
 164     formatForDisplay(org: IdlObject): OrgDisplay {
 165         let label = org[this.displayField]();
 166         if (!this.readOnly) {
 167             label = PAD_SPACE.repeat(org.ou_type().depth()) + label;
 168         }
 169         return {
 170             id : org.id(),
 171             label : label,
 172             disabled : false
 173         };
 174     }
 175
 176     // Fired by the typeahead to inform us of a change.
 177     // TODO: this does not fire when the value is cleared :( -- implement
 178     // change detection on this.selected to look specifically for NULL.
 179     orgChanged(selEvent: NgbTypeaheadSelectItemEvent) {
 180         // console.debug('org unit change occurred ' + selEvent.item);
 181         this.onChange.emit(this.org.get(selEvent.item.id));
 182     }
 183
 184     // Remove the tree-padding spaces when matching.
 185     formatter = (result: OrgDisplay) => result ? result.label.trim() : '';
 186
 187     // reset the state of the component
 188     reset() {
 189         this.selected = null;
 190     }
 191
 192     filter = (text$: Observable<string>): Observable<OrgDisplay[]> => {
 193         return text$.pipe(
 194             debounceTime(200),
 195             distinctUntilChanged(),
 196             merge(
 197                 // Inject a specifier indicating the source of the
 198                 // action is a user click
 199                 this.click$.pipe(filter(() => !this.instance.isPopupOpen()))
 200                 .pipe(mapTo('_CLICK_'))
 201             ),
 202             map(term => {
 203
 204                 let orgs = this.org.list().filter(org =>
 205                     this.hidden.filter(id => org.id() === id).length === 0
 206                 );
 207
 208                 if (this.permLimitOrgs) {
 209                     // Avoid showing org units where the user does
 210                     // not have the requested permission.
 211                     orgs = orgs.filter(org =>
 212                         this.permLimitOrgs.includes(org.id()));
 213                 }
 214
 215                 if (term !== '_CLICK_') {
 216                     // For search-driven events, limit to the matching
 217                     // org units.
 218                     orgs = orgs.filter(org => {
 219                         return term === '' || // show all
 220                             org[this.displayField]()
 221                                 .toLowerCase().indexOf(term.toLowerCase()) > -1;
 222
 223                     });
 224                 }
 225
 226                 return orgs.map(org => this.formatForDisplay(org));
 227             })
 228         );
 229     }
 230 }
 231
 232