4. april 2013 skrev Roger Aunet et innlegg med tittel «Implementasjon av utlånsstatus i Primo». Artikkelen omtalte beta-versjonen av tjenesten «Utlånsstatus i BIBSYS».
Denne tjenesten er nå satt i produksjon og brukes av Oria. Den er også tilgjengelig for andre tjenesteleverandører som trenger å finne aktuell tilgjengelighet for en tittel i BIBSYS Biblioteksystem.
Tjenesten opplyser både om restriksjoner på lån (ikke lån, kortiddslån, dagslån) og utlånsstatus i øyeblikket (tilgjengelig, utlånt, tapt, skadet).
Oria viser et forenklet bilde av dette: ‘Tilgjengelig‘ eller ‘Utlånt‘.
(Oria er laget for publikum og legger vekt på å være enkelt.)
Under er en oppdatert gjengivelse av den tekniske informasjonen gitt 4. april.
Merk spesielt at tjenesten i produksjon har annen url enn den gamle beta-versjonen.
Teknisk beskrivelse
Utlånsstatus via RTA plugin
For å få vist oppdatert utlånsstatus i Primo har BIBSYS implementert en RTA-plugin (RealTimeAvailability-plugin) som skal kjøre i Primo. Denne plugin henter oppdaterte utlånsstatuser for alle eksemplarene som tilhører et dokument.
Som løsning på integrasjonen har BIBSYS implementert en tjeneste som leverer utlånsstatus for eksemplarer i BIBSYS Biblioteksystem. Tjenesten mottar et objektid og svarer med utlånsstatus for alle tilhørende eksemplarer. Svaret er pakket inn med JSON.
Spesifikasjon av tjenesten finns på: http://services.bibsys.no/services/html/availabilityService.html
Eksempel på kall av tjenesten: http://services.bibsys.no/services/json/availabilityService.jsp?id=112749968
Eksempel på svar:
{"list": {
"documents": [
{
"bibcode": "xp",
"objektId": "112749968",
"status": "0",
"dokId": "12xp02958"
},
{
"bibcode": "c",
"objektId": "112749968",
"status": "0",
"dokId": "11c068541"
},
{
"bibcode": "d",
"objektId": "112749968",
"status": "4",
"dokId": "11d037988"
},
{
"bibcode": "ug",
"objektId": "112749968",
"status": "0",
"dokId": "12ug01037"
}
],
"totalHits": 4,
"responseTime": 68
}}