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
}}