K2 Availability Server als DAIA-Server

k2-to-daia.md

Der K2 Availability Server des KOBV Portal 2.0 liefert aktuelle Verfügbarkeitsinformationen zu Publikationen in Bibliotheken des KOBV. Die Informationen werden aus den einzelnen Ausleihsystemen der Bibliotheken per DAIA oder auf anderem Wege ermittelt und zusammengeführt. Die Schnittstelle lässt sich folgendermaßen nutzen, um wieder DAIA-Konforme DAIA für eine Bibliothek zu bekommen. Sinnvoller ist allerdings direkt auf einen DAIA-Server zuzugreifen.

• Anfrage-URL: http://avail.kobv.de/k2?ids={isil};{id}
• Beispiel: http://avail.kobv.de/k2?ids=DE-188;BV024100711

Die id ist die interne ID des jeweiligen Titeldatensatz im Bibliothekskatalog z.B. BV024100711.

Die JSON-Antwort besteht aus einem Array mit (bei einer Bibliothek) einem Objekt, hier ein Beispiele:

http://avail.kobv.de/k2?ids=DE-188;BV024100711

[  
   {  
      "uid":"BV024100711",
      "isil":"DE-188",
      "isReferenceLibrary": false,
      "availItems": [  
         {  
            "id": "003163971_UB_1985838188_88/2007/ 21843",
            "departmentCode": "MAG-G",
            "label": "88/2007/ 21843",
            "barcode": "1985838188",
            "issue": "",
            "library": "FUB50",
            "subLibrary": "UB",
            "subLibraryDescription": "Universtitätsbibliothek",
            "department": "Magazin",
            "localIdentifier": "003163971",
            "source": "local",
            "libraryGuideId": "FUB00001",
            "presentation": { },
            "loan":{ "available": true },
            "interloan":{ },
            "openAccess": { },
            "lastUpdate": "May 18, 2015 12:03:37 PM"
         }
      ]
   }
]

Das Array availItems kann mehere Exemplare enthalten (in DAIA item), allerdings sollten die Felder library und lastUpdate bei allen Exemplaren gleich sein.

Hier ein (noch unvollständiges) Mapping:

• uid → doc.requested
• isil → institution.id (plus URI-Präfix)
• isReferenceLibrary ?
• availItems.id ? (scheinbar nur intern)
• availItems.localIdentifier ? (ggf. für mapping auf item.id)
• availItems.barcode ? (ggf. für mapping auf item.id)
• availItems.source ? (scheinbar nur intern)
• availItems.issue ?
• availItems.library - sollte von isil abhängen, kann entfallen
• availItems.subLibrary → item.department.id? (plus URI-Präfix)
• availItems.libraryGuideId → item.department.id? (plus URI-Präfix)
• availItems.subLibraryDescription → item.department.content
• availItems.departmentCode → item.storage.id (plus URI-Präfix)
• availItems.department → item.storage.content
• availItems.label → item.label
• availItems.presentation → available/unavailable (plus mapping)
• availItems.loan → available/unavailable (plus mapping)
• availItems.interloan → available/unavailable (plus mapping)
• availItems.openAccess → available/unavailable (plus mapping)