64
Aleph RESTful APIs Dr. Harald Jele [email protected] Universit ¨ at Klagenfurt Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 1

Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

  • Upload
    others

  • View
    3

  • Download
    0

Embed Size (px)

Citation preview

Page 1: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

Aleph RESTful APIsDr. Harald Jele

[email protected]

Universitat Klagenfurt

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 1

Page 2: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

Die Ausgangslage• Mit Aleph lässt sich viel aber nicht alles

erledigen.

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 2

Page 3: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

Die Ausgangslage• Mit Aleph lässt sich viel aber nicht alles

erledigen.• Die individuellen Vorstellungen, was wann

wie im System zu erfolgen hat, sind m.u.deutlich voneinander verschieden.

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 2

Page 4: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

Die Ausgangslage• Mit Aleph lässt sich viel aber nicht alles

erledigen.• Die individuellen Vorstellungen, was wann

wie im System zu erfolgen hat, sind m.u.deutlich voneinander verschieden.

• Aleph bietet viele Möglichkeiten, an die Dateneiner Institution zu gelangen.

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 2

Page 5: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

Die Ausgangslage• Mit Aleph lässt sich viel aber nicht alles

erledigen.• Die individuellen Vorstellungen, was wann

wie im System zu erfolgen hat, sind m.u.deutlich voneinander verschieden.

• Aleph bietet viele Möglichkeiten, an die Dateneiner Institution zu gelangen.

• Die Art und Weise, wie die Daten gespeichertsind, unterliegt keiner (in jedem Fallzuverlässigen) Dauerhaftigkeit.Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 2

Page 6: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

Was tun Institutionen insolch einer Lage?

• Sie fügen mit der Zeit mehr und mehrRoutinen und Programme in das System ein,mit denen die individuellen Befürfnisseabgedeckt werden.

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 3

Page 7: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

Wieso ist dasproblematisch?

• Ist es im Grunde gar nicht. Man muss aberdie Mittel und Möglichkeiten haben, jedeÄnderung im System, die einen betrifft, zuerkennen und entsprechend zu reagieren.Wenn noch jemand in der Bibliothekvorhanden ist, der die Zusammenhängekennt ;-)

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 4

Page 8: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

Wo und wie dockt man typi-scherweise bei Aleph an?

• Über das Filesystem (tab17 –Öffnungszeiten).

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 5

Page 9: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

Wo und wie dockt man typi-scherweise bei Aleph an?

• Über das Filesystem (tab17 –Öffnungszeiten).

• Über die Datenbankschnittstellen (Oracle).

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 5

Page 10: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

Wo und wie dockt man typi-scherweise bei Aleph an?

• Über das Filesystem (tab17 –Öffnungszeiten).

• Über die Datenbankschnittstellen (Oracle).

• Über Aleph-eigene Routinen.

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 5

Page 11: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

Wo und wie dockt man typi-scherweise bei Aleph an?

• Über das Filesystem (tab17 –Öffnungszeiten).

• Über die Datenbankschnittstellen (Oracle).

• Über Aleph-eigene Routinen.• Ausgabe über CGI in HTML oder Text via

E-Mail.

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 5

Page 12: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

Auszug aus der Liste derErweiterungen der UBK

• Gebührenkorrektur.

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 6

Page 13: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

Auszug aus der Liste derErweiterungen der UBK

• Gebührenkorrektur.• Behandlung dritter Mahnungen.

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 6

Page 14: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

Auszug aus der Liste derErweiterungen der UBK

• Gebührenkorrektur.• Behandlung dritter Mahnungen.• Zählstatistik für Ausleihschalter.

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 6

Page 15: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

Auszug aus der Liste derErweiterungen der UBK

• Gebührenkorrektur.• Behandlung dritter Mahnungen.• Zählstatistik für Ausleihschalter.• Erinnerungs-Email an Benutzer.

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 6

Page 16: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

Auszug aus der Liste derErweiterungen der UBK

• Gebührenkorrektur.• Behandlung dritter Mahnungen.• Zählstatistik für Ausleihschalter.• Erinnerungs-Email an Benutzer.• Schließtage mit Rückgaben.

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 6

Page 17: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

Auszug aus der Liste derErweiterungen der UBK

• Gebührenkorrektur.• Behandlung dritter Mahnungen.• Zählstatistik für Ausleihschalter.• Erinnerungs-Email an Benutzer.• Schließtage mit Rückgaben.• Offen gebliebenes aus der Fernleihe.

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 6

Page 18: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

Auszug aus der Liste derErweiterungen der UBK

• Itemstatus-Check.

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 7

Page 19: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

Auszug aus der Liste derErweiterungen der UBK

• Itemstatus-Check.• Formale Prüfung der Aufstellungssystematik.

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 7

Page 20: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

Auszug aus der Liste derErweiterungen der UBK

• Itemstatus-Check.• Formale Prüfung der Aufstellungssystematik.• Bestellübersichten.

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 7

Page 21: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

Auszug aus der Liste derErweiterungen der UBK

• Itemstatus-Check.• Formale Prüfung der Aufstellungssystematik.• Bestellübersichten.• Budgetübersichten.

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 7

Page 22: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

Auszug aus der Liste derErweiterungen der UBK

• Etikettierung.

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 8

Page 23: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

Auszug aus der Liste derErweiterungen der UBK

• Etikettierung.• Verwaltung Semesterapparate.

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 8

Page 24: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

Auszug aus der Liste derErweiterungen der UBK

• Etikettierung.• Verwaltung Semesterapparate.• XML-RPC-Schnittstelle zur Uni-Verwaltung.

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 8

Page 25: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

Auszug aus der Liste derErweiterungen der UBK

• Etikettierung.• Verwaltung Semesterapparate.• XML-RPC-Schnittstelle zur Uni-Verwaltung.• etc., etc.

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 8

Page 26: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

Was ist ReST?• Web-Technologie.

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 9

Page 27: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

Was ist ReST?• Web-Technologie.• Representational State Transfer.

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 9

Page 28: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

Was ist ReST?• Web-Technologie.• Representational State Transfer.• Im Grunde bezeichnet ReST die Idee, dass

ein URL genau einen Seiteninhalt alsErgebnis einer serverseitigen Aktion (etwadas Anzeigen einer Trefferliste nach einerSuche) darstellt.

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 9

Page 29: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

Was ist ReST?• Web-Technologie.• Representational State Transfer.• Im Grunde bezeichnet ReST die Idee, dass

ein URL genau einen Seiteninhalt alsErgebnis einer serverseitigen Aktion (etwadas Anzeigen einer Trefferliste nach einerSuche) darstellt.

• Weitere bekannte sind z.B. XML-RPC, SOAP.

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 9

Page 30: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

Warum könnte die RESTful-API zu Aleph hier helfen?

• Davon ausgehend, dass die Schnittstellestabil ist.

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 10

Page 31: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

Warum könnte die RESTful-API zu Aleph hier helfen?

• Davon ausgehend, dass die Schnittstellestabil ist.

• Trennung der Art der Speicherung der Datenund deren Zugänglichkeit.

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 10

Page 32: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

Warum könnte die RESTful-API zu Aleph hier helfen?

• Davon ausgehend, dass die Schnittstellestabil ist.

• Trennung der Art der Speicherung der Datenund deren Zugänglichkeit.

• Ändert sich die Speicherung (z.B. Tabellen,Spalten der Datenbank), muss der Anbieterder API dies nachziehen.

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 10

Page 33: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

Warum könnte die RESTful-API zu Aleph hier helfen?

• Davon ausgehend, dass die Schnittstellestabil ist.

• Trennung der Art der Speicherung der Datenund deren Zugänglichkeit.

• Ändert sich die Speicherung (z.B. Tabellen,Spalten der Datenbank), muss der Anbieterder API dies nachziehen.

• Die Abfrage (Methode und Syntax) solltejedoch gleich bleiben.

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 10

Page 34: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

Warum könnte die RESTful-API zu Aleph hier helfen?

• Die Entscheidung, sich mit dieserSchnittstelle zu beschäftigen, ist eine reinökonomische und keinesfalls eine technische.

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 11

Page 35: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

Warum könnte die RESTful-API zu Aleph hier helfen?

• Die Entscheidung, sich mit dieserSchnittstelle zu beschäftigen, ist eine reinökonomische und keinesfalls eine technische.

• Zudem existiert eine gewisse Neugierdedarauf, was nach Aleph kommen mag undwas einen dann tangieren könnte.

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 11

Page 36: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

RESTful-API Doku imRahmen der „EL Commons“

• Customer-Center ->

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 12

Page 37: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

RESTful-API Doku imRahmen der „EL Commons“

• Customer-Center ->• EL Commons ->

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 12

Page 38: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

RESTful-API Doku imRahmen der „EL Commons“

• Customer-Center ->• EL Commons ->• CodeShare ->

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 12

Page 39: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

RESTful-API Doku imRahmen der „EL Commons“

• Customer-Center ->• EL Commons ->• CodeShare ->• Aleph Open Interfaces ->

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 12

Page 40: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

RESTful-API Doku imRahmen der „EL Commons“

• Customer-Center ->• EL Commons ->• CodeShare ->• Aleph Open Interfaces ->• Aleph RESTful APIs (seit v.18)

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 12

Page 41: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

RESTful-API• Kommunikation funktioniert ausschließlich

über HTTP/HTTPS.

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 13

Page 42: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

RESTful-API• Kommunikation funktioniert ausschließlich

über HTTP/HTTPS.• Jeder Aufruf ist ein Weblink zum

Web-Applikations-Server (JBOSS).http://server.name:1892/

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 13

Page 43: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

RESTful-API• Kommunikation funktioniert ausschließlich

über HTTP/HTTPS.• Jeder Aufruf ist ein Weblink zum

Web-Applikations-Server (JBOSS).http://server.name:1892/

• Weblink beinhaltet das aufgerufeneProgramm, das am Web-Server ausgeführtwird:http://server.name:1892/rest-dlf/record/

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 13

Page 44: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

RESTful-API• Einen Wert, der dem Programm übergeben

wird, sowie optionale Parameter:http://server.name:1892/rest-dlf/record/<record id>/items?view=full

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 14

Page 45: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

RESTful-API• Einen Wert, der dem Programm übergeben

wird, sowie optionale Parameter:http://server.name:1892/rest-dlf/record/<record id>/items?view=full

• Die Antwort, die der Web-Server liefert ist inXML-Notation gehalten. In diesem Fall dieExemplarliste zu einem Titel aufgrund seinerSystemnummer im Vollformat.

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 14

Page 46: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

RESTful-API• Die Daten eines spezifischen Exemplars

werden abgerufen durch:http://server.name:1892/rest-dlf/record/<record id>/items/<item id>/

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 15

Page 47: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

RESTful-API• Die Daten eines spezifischen Exemplars

werden abgerufen durch:http://server.name:1892/rest-dlf/record/<record id>/items/<item id>/

• Daran erkennt man die Architektur derSchnittstelle: sie ist rein hierarchischangelegt. Das heisst, um zu den eigentlichenInhalten zu gelangen, muss man die„übergeordneten“ Informationen besitzen.

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 15

Page 48: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

Beispiel: Benutzeraktion

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 16

Page 49: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

RESTful-API• Vormerkungen für Benutzer-ID 0036:

http://server.name:1892/rest-dlf/patron/0036/circulationActions/requests/holds

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 17

Page 50: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

RESTful-API• Vormerkungen für Benutzer-ID 0036:

http://server.name:1892/rest-dlf/patron/0036/circulationActions/requests/holds

• Vormerkungen innerhalb einer LIB:http://server.name:1892/rest-dlf/patron/0036/circulationActions/requests/holds?institution=UBK50

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 17

Page 51: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

Antwort: Vormerkungsliste

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 18

Page 52: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

Antwort: Vormerkung Detail

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 19

Page 53: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

Die Krux mit der Hierarchie• . . . beginnt immer dann, wenn man sie selbst

nicht auflösen kann (Top-Down).

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 20

Page 54: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

Die Krux mit der Hierarchie• . . . beginnt immer dann, wenn man sie selbst

nicht auflösen kann (Top-Down).• Dies ist meist der Fall, wenn man

Informationen erfragen möchte, dieexemplarspezifisch sind (Bottom-Up).

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 20

Page 55: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

Die Krux mit der Hierarchie• . . . beginnt immer dann, wenn man sie selbst

nicht auflösen kann (Top-Down).• Dies ist meist der Fall, wenn man

Informationen erfragen möchte, dieexemplarspezifisch sind (Bottom-Up).

• Ausgangspunkt solcher Abfragen sind dannzumeist der Barcode, eine Bestellnummer,eine Signatur . . .

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 20

Page 56: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

Die Krux mit der Hierarchie• . . . und man kennt üblicherweise nicht die

dazugehörige Systemnummer des Titels undden Item-Record-Key, um an dieExemplarinformationen zu gelangen.

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 21

Page 57: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

Die Krux mit der Hierarchie• . . . und man kennt üblicherweise nicht die

dazugehörige Systemnummer des Titels undden Item-Record-Key, um an dieExemplarinformationen zu gelangen.

• Hier wäre eine Art „Resolver“ notwendig, deraufgrund solcher Informationen denhierarchischen Baum auflöst, um mit diesenInformationen weiterarbeiten zu können.

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 21

Page 58: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

Die Bescheidenheit

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 22

Page 59: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

Die Bescheidenheit• Kein Zugang zu Bestell-Informationen oder

Budgets.

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 23

Page 60: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

Die Bescheidenheit• Kein Zugang zu Bestell-Informationen oder

Budgets.• Aber auch kein Zugang zu allen anderen

Informationen, die mit einem Exemplarverknüpft sind.

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 23

Page 61: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

Die Bescheidenheit• Kein Zugang zu Bestell-Informationen oder

Budgets.• Aber auch kein Zugang zu allen anderen

Informationen, die mit einem Exemplarverknüpft sind.

• Und diese bildeten im Wesentlichen ja denAusgangspunkt der Fragestellung.

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 23

Page 62: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

Die Nützlichkeit• Es sind genau jene Funktionen definiert, die

man braucht, wenn man typische Funktioneneines OPACs in einem ExLibris-fremdenProdukt (z.B. VuFind in Kombination mitAleph) abbilden möchte.

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 24

Page 63: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

Die Nützlichkeit• Es sind genau jene Funktionen definiert, die

man braucht, wenn man typische Funktioneneines OPACs in einem ExLibris-fremdenProdukt (z.B. VuFind in Kombination mitAleph) abbilden möchte.

• Dazu gehören Funktionen wie Verfügbarkeit,Vormerkungen, Verlängerungen,Bestellungen, Fernleihaktivitäten, Kontostandetc.

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 24

Page 64: Aleph RESTful APIs - uni-klu.ac.at · Die Ausgangslage • Mit Aleph lässt sich viel aber nicht alles erledigen. • Die individuellen Vorstellungen, was wann wie im System zu erfolgen

Vielen Dank für dieAufmerksamkeit

Vortrag am 6.5.2014 zum Treffen der SystembibliothekarInnen an der Vorarlberger Landesbibliothek – p. 25