eca-select-entities
v1.1.0
Published
Component to select multiple entities in Ex Libris Cloud Apps
Downloads
4
Readme
Select Entities
Reusable components for Ex Libris Cloud Apps to select one or multiple entities visible on the current Alma screen.
Installation
$ npm install eca-select-entities --save
In app.module.ts:
import { SelectEntitiesModule } from 'eca-select-entities';
...
@NgModule({
imports: [
...
SelectEntitiesModule,
],
Select Entities
The select entities component supports multiple selection. Features include:
- Display description of page entities
- Check/uncheck all
- Selection across multiple pages in Alma
Use the select entities component in your own component as follows.
Add an array to collect selected entities in your component.ts:
selectedEntities = new Array<Entity>();
In your component.html page, add a reference to the component and the array:
<eca-select-entities
[(selected)]="selectedEntities"
>
</eca-select-entities>
Select Entity
The select entity component supports selecting a single entity. Features include:
- Display description of page entities
- Radio buttons to select a single entity
Use the select entities component in your own component as follows.
Add an array to collect selected entities in your component.ts:
selectedEntity: Entity = null;
In your component.html page, add a reference to the component and the array:
<eca-select-entity
[(selected)]="selectedEntity"
>
</eca-select-entities>
Other methods
Both components also support the following properties/methods:
clear
Clears all selected items:
@ViewChild(SelectEntitiesComponent) selectEntitiesComponent: SelectEntitiesComponent;
clear() {
this.selectEntitiesComponent.clear();
}
count
Count of entities:
<eca-select-entities #selectEntities
[(selected)]="selectedEntities"
>
</eca-select-entities>
<p *ngIf="selectEntities.count == 0">Please navigate to a screen with entities.</p>
entityTypes
Filter the entity types to be displayed:
<eca-select-entities #selectEntities
[(selected)]="selectedEntities"
[entityTypes]="['BIB_MMS']"
>
</eca-select-entities>
entities$
Provide an observable of entities which overrides the entities displayed on the Alma screen.
In this example, we're retrieving all of the displayed and limiting to those created by the current user: component.ts:
entities$ = this.eventsService.entities$.pipe(
tap(() => this.loading = true),
mergeMap(entities =>
combineLatest([
of(entities),
this.eventsService.getInitData(),
forkJoin(entities.map(e => this.restService.call(e.link)))
.pipe(defaultIfEmpty([]))
])
),
map(([entities, initData, full]) => {
const relevant = full.filter(f => f.created_by.value == initData.user.primaryId).map(f=>f.id);
return entities.filter(e => relevant.includes(e.id));
}),
tap(() => this.loading = false)
)
component.html:
<eca-select-entities #selectEntities
[(selected)]="selectedEntities"
[entityTypes]="['SET']"
[entities$]="entities$"
>
</eca-select-entities>