Værk

Det kan du bygge

En side for hvert værk som giver låneren nok til at beslutte sig, og en kort vej til at låne eller reservere. Værket bærer det udgaverne har til fælles, som titler, ophav, beskrivelse, emner og målgruppe. Hver udgave bærer sit eget format, sprog, omfang og forlag.

Typisk flow

1. Klienten henter værket med GetWorks. publicationIds lister udgaverne.
2. Klienten henter udgaverne med GetPublications og vælger den der skal vises, for eksempel efter lånerens sprog og format.
3. Tilgængeligheden og reserveId for hver udgave kommer fra GetHoldings.
4. For en logget ind låner giver GetPatronConfiguration det reservationsgebyr der skal vises før låneren reserverer (2.5.1).

Det leverer API'et

• Et værk kræver kun identifier og titles. Alle andre felter kan mangle.
• En udgave peger på sine værker i works. relation er embodies (udgaven er hele værket) eller contains (værket er en del af udgaven).
• numberOfReservations fortæller hvor mange reservationer udgaven har. Når tallet er ukendt, mangler feltet.

Det kan du bygge

Låneren ser om et eksemplar er ledigt lige nu, hvilken filial der har det, og vejen til hylden: filial, afdeling og opstilling.

Typisk flow

1. Klienten henter beholdningen for udgaven med GetHoldings.
2. Hver placering giver filialen, afdelingerne inde i den, shelfmark og de eksemplarer der står dér.
3. GetLocations giver afdelingstyperne i rækkefølge, for eksempel etage før afdeling.
4. Klienten viser vejen til hylden og hvor mange eksemplarer der er ledige dér.

Det leverer API'et

• Vejen til et eksemplar er filialen, derefter afdelingerne i path, derefter shelfmark. Hver afdelingstype forekommer højst én gang.
• availableState er available eller not_available. loanableState er loanable eller not_for_loan.
• show_to med værdien public fortæller provideren at data skal vises offentligt og skal filtreres derefter. Uden den bør provideren returnere alle data.

Typisk flow

1. Klienten læser filialen, afdelingerne og shelfmark fra GetHoldings.
2. Klienten sender eller udskriver dem.

Det leverer API'et

• PLAS leverer placeringsdata. Afsendelse og udskrift står klienten for.

Det kan du bygge

Hvert nummer af et tidsskrift er sin egen beholdning. Låneren indsnævrer numrene efter år, årgang og nummer, og reserverer præcis det nummer der vises.

Typisk flow

1. Klienten henter beholdningen med GetHoldings. For et tidsskrift er hver beholdning ét nummer.
2. Klienten grupperer numrene efter periodical.grouping, for eksempel år og derefter årgang.
3. Låneren vælger et nummer. periodical.name er nummerets visningsnavn.
4. Klienten reserverer nummeret med dets reserveId og CreatePatronReservation (2.5.1).

Det leverer API'et

• Et tidsskrift kan have nul eller flere beholdninger. Alle andre udgaver har højst én.
• Grupperingstyperne er year, volume og number, eller level1 til level7. Standardrækkefølgen er år, årgang, nummer; GetConfiguration kan angive en anden i holding.periodical.groupOrdering.
• Beholdningens reserveId er alt der skal til for at reservere nummeret. Når den er tom, kan nummeret ikke reserveres.