# Verk 4 av 6 støttet Kilde: https://plasapi.com/no/funksjoner/search-and-discovery/work/ Vis lånerne et verk med utgavene og tilgjengeligheten, hvor det står på hyllen, og hvilket nummer av et tidsskrift de vil ha. ## 1.2.1 Se verk — Støttet Vis et verk med utgavene, tilgjengeligheten og det låneren kan gjøre med det. ### Dette kan du bygge En side for hvert verk som gir låneren nok til å bestemme seg, og en kort vei til å låne eller reservere. Verket bærer det utgavene har felles, som titler, opphav, beskrivelse, emner og målgruppe. Hver utgave bærer sitt eget format, språk, omfang og forlag. ### Typisk flyt 1. Klienten henter verket med `GetWorks`. `publicationIds` lister utgavene. 2. Klienten henter utgavene med `GetPublications` og velger den som skal vises, for eksempel etter lånerens språk og format. 3. Tilgjengeligheten og `reserveId` for hver utgave kommer fra `GetHoldings`. 4. For en innlogget låner gir `GetPatronConfiguration` reservasjonsgebyret som skal vises før låneren reserverer (2.5.1). ### Dette leverer API-et - Et verk krever bare `identifier` og `titles`. Alle andre felt kan mangle. - En utgave peker på verkene sine i `works`. `relation` er `embodies` (utgaven er hele verket) eller `contains` (verket er en del av utgaven). - `numberOfReservations` forteller hvor mange reservasjoner utgaven har. Når tallet er ukjent, mangler feltet. ### Kall i API-et Kallene bak visningen - [GET /work](https://plasapi.com/no/provider/v0.6.7/work/#GetWorks) — Get Works - [GET /publication](https://plasapi.com/no/provider/v0.6.7/publication/#GetPublications) — Get Publications - [GET /holdings](https://plasapi.com/no/provider/v0.6.7/holding/#GetHoldings) — Get holdings - [GET /patron/{patronId}/configuration](https://plasapi.com/no/provider/v0.6.7/patron-configuration/#GetPatronConfiguration) — Get patron configuration ## 1.2.2 Finn materiale, hylleplass — Støttet Vis hvilke filialer som har materialet, og hvor i filialen det står. ### Dette kan du bygge Låneren ser om et eksemplar er ledig akkurat nå, hvilken filial som har det, og veien til hyllen: filial, avdeling og hylleplass. ### Typisk flyt 1. Klienten henter beholdningen for utgaven med `GetHoldings`. 2. Hver plassering gir filialen, avdelingene inne i den, `shelfmark` og eksemplarene som står der. 3. `GetLocations` gir avdelingstypene i rekkefølge, for eksempel etasje før avdeling. 4. Klienten viser veien til hyllen og hvor mange eksemplarer som er ledige der. ### Dette leverer API-et - Veien til et eksemplar er filialen, deretter avdelingene i `path`, deretter `shelfmark`. Hver avdelingstype forekommer høyst én gang. - `availableState` er `available` eller `not_available`. `loanableState` er `loanable` eller `not_for_loan`. - `show_to` med verdien `public` forteller provideren at dataene skal vises offentlig og må filtreres deretter. Uten den bør provideren returnere alle data. ### Kall i API-et Kallene bak visningen - [GET /holdings](https://plasapi.com/no/provider/v0.6.7/holding/#GetHoldings) — Get holdings - [GET /locations](https://plasapi.com/no/provider/v0.6.7/location/#GetLocations) — Get locations ## 1.2.3 Send hylleplass — Støttet La låneren ta med seg hylleplassen, på e-post eller på papir. ### Typisk flyt 1. Klienten leser filialen, avdelingene og `shelfmark` fra `GetHoldings`. 2. Klienten sender eller skriver dem ut. ### Dette leverer API-et - PLAS leverer plasseringsdataene. Sending og utskrift gjør klienten. ### Kall i API-et API-et leverer dataene — tjenesten din utfører handlingen - [GET /holdings](https://plasapi.com/no/provider/v0.6.7/holding/#GetHoldings) — Get holdings ## 1.2.4 Se eksemplar — Ikke ennå Vis ett enkelt eksemplar av en utgave. > Ikke i PLAS ennå. Funksjonen er ikke støttet i dag. Beskrivelsen viser hva den gjør, så du kan se sammenhengen med resten. ## 1.2.5 Eksemplarhistorikk — Ikke ennå Vis historikken til ett enkelt eksemplar. > Ikke i PLAS ennå. Funksjonen er ikke støttet i dag. Beskrivelsen viser hva den gjør, så du kan se sammenhengen med resten. ## 1.2.6 Velg nummer av tidsskrift — Støttet La låneren velge et bestemt nummer av et tidsskrift eller en avis. ### Dette kan du bygge Hvert nummer av et tidsskrift er sin egen beholdning. Låneren snevrer inn numrene etter år, årgang og nummer, og reserverer nøyaktig det nummeret som vises. ### Typisk flyt 1. Klienten henter beholdningen med `GetHoldings`. For et tidsskrift er hver beholdning ett nummer. 2. Klienten grupperer numrene etter `periodical.grouping`, for eksempel år og deretter årgang. 3. Låneren velger et nummer. `periodical.name` er nummerets visningsnavn. 4. Klienten reserverer nummeret med `reserveId` og `CreatePatronReservation` (2.5.1). ### Dette leverer API-et - Et tidsskrift kan ha null eller flere beholdninger. Alle andre utgaver har høyst én. - Grupperingstypene er `year`, `volume` og `number`, eller `level1` til `level7`. Standardrekkefølgen er år, årgang, nummer; `GetConfiguration` kan angi en annen i `holding.periodical.groupOrdering`. - Beholdningens `reserveId` er alt som trengs for å reservere nummeret. Når den er tom, kan nummeret ikke reserveres. ### Kall i API-et Forutsetter: 2.2.1 Slås på i konfigurasjonen: `GetConfiguration` I denne rekkefølgen 1. [GET /holdings](https://plasapi.com/no/provider/v0.6.7/holding/#GetHoldings) — Get holdings 2. [POST /patron/{patronId}/reservation](https://plasapi.com/no/provider/v0.6.7/patron-reservation/#CreatePatronReservation) — Create reservation