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') 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     constructor(
 104       private auth: AuthService,
 105       private store: StoreService,
 106       private org: OrgService,
 107       private perm: PermService
 108     ) { }
 109
 110     ngOnInit() {
 111
 112         // Apply a default org unit if desired and possible.
 113         if (!this.startOrg && this.applyDefault && this.auth.user()) {
 114             // note: ws_ou defaults to home_ou on the server
 115             // when when no workstation is used
 116             this.startOrg = this.org.get(this.auth.user().ws_ou());
 117             this.selected = this.formatForDisplay(
 118                 this.org.get(this.auth.user().ws_ou())
 119             );
 120
 121             // avoid notifying mid-digest
 122             setTimeout(() => this.onChange.emit(this.startOrg), 0);
 123         }
 124
 125         if (this.startOrg) {
 126             this.selected = this.formatForDisplay(this.startOrg);
 127         }
 128     }
 129
 130     //
 131     applyPermLimitOrgs(perms: string[]) {
 132
 133         if (!perms) {
 134             return;
 135         }
 136
 137         // handle lazy clients that pass null perm names
 138         perms = perms.filter(p => p !== null && p !== undefined);
 139
 140         if (perms.length === 0) {
 141             return;
 142         }
 143
 144         // NOTE: If permLimitOrgs is useful in a non-staff context
 145         // we need to change this to support non-staff perm checks.
 146         this.perm.hasWorkPermAt(perms, true).then(permMap => {
 147             this.permLimitOrgs =
 148                 // safari-friendly version of Array.flat()
 149                 Object.values(permMap).reduce((acc, val) => acc.concat(val), []);
 150         });
 151     }
 152
 153     // Format for display in the selector drop-down and input.
 154     formatForDisplay(org: IdlObject): OrgDisplay {
 155         let label = org[this.displayField]();
 156         if (!this.readOnly) {
 157             label = PAD_SPACE.repeat(org.ou_type().depth()) + label;
 158         }
 159         return {
 160             id : org.id(),
 161             label : label,
 162             disabled : false
 163         };
 164     }
 165
 166     // Fired by the typeahead to inform us of a change.
 167     // TODO: this does not fire when the value is cleared :( -- implement
 168     // change detection on this.selected to look specifically for NULL.
 169     orgChanged(selEvent: NgbTypeaheadSelectItemEvent) {
 170         // console.debug('org unit change occurred ' + selEvent.item);
 171         this.onChange.emit(this.org.get(selEvent.item.id));
 172     }
 173
 174     // Remove the tree-padding spaces when matching.
 175     formatter = (result: OrgDisplay) => result.label.trim();
 176
 177     filter = (text$: Observable<string>): Observable<OrgDisplay[]> => {
 178         return text$.pipe(
 179             debounceTime(200),
 180             distinctUntilChanged(),
 181             merge(
 182                 // Inject a specifier indicating the source of the
 183                 // action is a user click
 184                 this.click$.pipe(filter(() => !this.instance.isPopupOpen()))
 185                 .pipe(mapTo('_CLICK_'))
 186             ),
 187             map(term => {
 188
 189                 let orgs = this.org.list().filter(org =>
 190                     this.hidden.filter(id => org.id() === id).length === 0
 191                 );
 192
 193                 if (this.permLimitOrgs) {
 194                     // Avoid showing org units where the user does
 195                     // not have the requested permission.
 196                     orgs = orgs.filter(org =>
 197                         this.permLimitOrgs.includes(org.id()));
 198                 }
 199
 200                 if (term !== '_CLICK_') {
 201                     // For search-driven events, limit to the matching
 202                     // org units.
 203                     orgs = orgs.filter(org => {
 204                         return term === '' || // show all
 205                             org[this.displayField]()
 206                                 .toLowerCase().indexOf(term.toLowerCase()) > -1;
 207
 208                     });
 209                 }
 210
 211                 return orgs.map(org => this.formatForDisplay(org));
 212             })
 213         );
 214     }
 215 }
 216
 217