Skip to main content
OCLC Support

Dokumentation E-Medien-Schnittstelle

  1. Last updated
  2. Save as PDF

Funktion der E-Medien-Schnittstelle

Das Angebot der Anbieter von Online-Ausleihen, Streamingdiensten und Online-Lexika ermöglicht registrierten Bibliothekskunden die Online-Ausleihe oder Nutzung digitaler Medien und Inhalten. Das System des Anbieters greift auf die OCLC E-Medien-Schnittstelle zu und prüft, ob der Benutzer berechtigt ist, digitale Medien auszuleihen.

Die E-Medien-Schnittstelle prüft die folgenden Merkmale:

  • Ausweisnummer und Passwort

  • Korrekte Anmeldedaten

  • Benutzergruppen

  • Benutzergruppen können durch die Bibliothek von der Nutzung des elektronischen Angebots ausgeschlossen werden

  • Sperrung des Lesers (z. B. durch allgemeinen Sperrvermerk in BIBLIOTHECAnext)

  • Leser mit Sperre sind von der Nutzung des elektronischen Angebots ausgeschlossen

  • Gebührengrenze (siehe BIBLIOTHECAnext / Weitere Konditionen)

  • Leser, deren offene Gebühren die Sperrgrenze übersteigen, werden ebenso wie gesperrte Leser von der Nutzung des elektronischen Angebots ausgeschlossen

  • Felder Gültig bis und Bezahlt bis im Leserkonto

  • Die Felder müssen entweder leer oder mit einem Datum in der Zukunft gefüllt sein

 Hinweis: : Ist der Leserausweis nicht (mehr) gültig, oder ist die Ausweisgebühr (Jahresgebühr) noch nicht bezahlt, wird der Leser von der Nutzung des elektronischen Angebots ausgeschlossen.

 

Test und Response

Die Schnittstelle auth.asp wird über eine individuelle URL aufgerufen. Diese URL beinhaltet als Request-Parameter die Ausweisnummer des zu authentifizierenden Lesers, sein Passwort und im Parameter Client den lizenzierten Anbieter.

Beispiel: http://localhost/EMedien/auth.asp?sn...racle&ezproxy=n

URL - Teil

Bedeutung

127.0.0.1/EMedien/auth.asp

URL (IP-Adresse oder Link zum Server) der E-Medien-Schnittstelle

sno=00000291

Ausweisnummer des zu authentifizierenden Benutzers

pwd=11111

Passwort des zu authentifizierenden Benutzers

client=OCLC

Bezeichnung des Anbieters / Angebots im Parameter-Client

Optional: Default-Wert "EMEDIEN"

db=Oracle

DSN (ODBC - DataSourceName) der ODBC - Datenquelle

Optional: Default-Eintrag mit dem Schlüssel DB1 in der Kategorie DB in der Datei auth.ini

ezproxy=n

Verwendung eines ezproxy (y/n)

Optional: Default-Wert: kein Proxy

Tabelle 1: URL-Zusammensetzung

 

Die Rückmeldung der E-Medien-Schnittstelle kann aus verschiedenen Angaben bestehen, das Feld Status ist stets enthalten.

Beispiel:

<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>-1</status>
<fsk>18</fsk>
<userid></userid>
<cardid></cardid>
</response>

Mögliche Werte für das Feld STATUS

Wert

Beschreibung

-1

Falsches Passwort

1

  • Wenn der Benutzer für die Selbstbedienung gesperrt ist

  • Wenn der Ausweis (oder falls Unterausweis, der Hauptausweis) nicht bezahlt ist (Feld ausweisbis ist kleiner als das aktuelle Systemdatum)

  • Wenn der Ausweis (oder falls Unterausweis, der Hauptausweis und der Unterausweis) nicht gültig ist (Feld gueltigbis ist kleiner als das aktuelle Systemdatum) 

  • Wenn der Nutzer mehr offene Gebühren als die Gebührensperrgrenze hat (Kondition SOSP)

  • Wenn der Benutzer einen Sperrvermerk hat

  • Wenn die Benutzergruppe des Benutzers von der Nutzung des elektronischen Angebots ausgeschlossen ist. In diesen Fällen ist es ratsam den Leser an die Bibliothek zu verweisen

3

Zugriff erlaubt

Tabelle 2: Mögliche Werte Status-Feld

 

Mögliche Werte für das Feld FSK

Der Wert für das Feld FSK wird aus dem Feld GEBDATUM in der Tabelle BIBLBENUTZER berechnet.

Wert

Beschreibung

0

Alter < 6

6

Alter < 12

12

Alter < 16

16

Alter < 18

18

Alter >= 18

Tabelle 3: Werte Feld FSK

 

Weitere Felder

Wert

Beschreibung

<userid>

Benutzernummer (unveränderliche, interne Nummer des Lesers in der Datenbank der jeweiligen Bibliothek)

<cardid>

Ausweisnummer (die sno vom Request)

Tabelle 4: Tabelle Weitere Felder

 

Die Felder userid und cardid sind nur im Erfolgsfall (Status = 3) befüllt. Andernfalls sind sie leer. Durch die Übergabe der UserID können Leser die Dienste auch mit einer neuen Ausweisnummer weiterhin nutzen.

Response (ezproxy = y)

Wird ein Proxy verwendet, steht in der Response nur:

PASSED -> im Erfolgsfall (status=3),

oder

FAIL -> im Fehlerfall (status=-1, status=1)

Beispiele für einen Schnittstellentest

Schnittstellentest mit Datenbanknamen:

http://IP-Addresse/ emedien /auth.asp?sno=12345679&pwd=01.01.1980&DB=DB-NAME

Schnittstellentest ohne Datenbanknamen:

http://IP-Addresse/ emedien /auth.asp?sno=12345678&pwd=01.01.1980

Schnittstellentest für die Statistik in BIBLIOTHECAnext:

http://IP-Addresse/ emedien /auth.asp?sno=12345678&pwd=01.01.1980&client=ANBIETERNAME