5. SOAP SchnittstelleKapitel hinzufügen
Für die Interaktion mit MyBib eL Server stehen mehrere SOAP-basierte Webservice Schnittstellen zur Verfügung, deren WSDL-Adressen mit dem Servlet-Aufruf
${eroom-url}/system?method=getWebServiceConfiguration
abgerufen werden können, z.B. http://localhost:8080/mertest14/system?method=getWebServiceConfiguration
Dieser Aufruf liefert ein XML-Dokument zurück in der Art:
<?xml version="1.0" encoding="iso-8859-15" standalone="yes"?> <webservice-configuration> <version>1.0.x</version> <webservice> <wsdl>http://localhost:8080/mertest14/ws/eroom/account?wsdl</wsdl> </webservice> <webservice> <wsdl>http://localhost:8080/mertest14/ws/eroom/event?wsdl</wsdl> </webservice> <webservice> <wsdl>http://localhost:8080/mertest14/ws/eroom/repository?wsdl</wsdl> </webservice> <webservice> <wsdl>http://localhost:8080/mertest14/ws/eroom/session?wsdl</wsdl> </webservice> <webservice> <wsdl>http://localhost:8080/mertest14/ws/eroom/task?wsdl</wsdl> </webservice> <webservice> <wsdl>http://localhost:8080/mertest14/ws/eroom/transfer?wsdl</wsdl> </webservice> <webservice> <wsdl>http://localhost:8080/mertest14/ws/eroom/workstation?wsdl</wsdl> </webservice> </webservice-configuration>
Die Beschreibung der Webservice-Schnittstelle, ihrer Funktionen und Datenstrukturen ist in Javadoc der Stub-Klassen aufgeführt.
5.1 Übersicht der SOAP WebservicesAbschnitt hinzufügen
Benutzer-/Clientbezogene Funktionen
Seite | Datum |
---|---|
Access Webservice | 2018/06/05 08:55 |
Account Webservice | 2018/06/05 08:55 |
Session Webservice | 2018/06/05 08:55 |
Workstation Webservice | 2018/06/05 08:55 |
Dokumentbezogene Funktionen
Seite | Datum |
---|---|
Repository Webservice | 2018/06/05 08:55 |
Transfer Webservice | 2018/06/05 08:55 |
Logging-/Statistikbezogene Funktionen
Seite | Datum |
---|---|
Event Webservice | 2018/06/05 08:55 |
Steuererungsbezogene Funktionen
Seite | Datum |
---|---|
Task Webservice | 2018/06/05 08:55 |
5.2 Access WebserviceAbschnitt hinzufügen
MyBib eL Version | Webservice Version | Änderung |
---|---|---|
1.6.x | 1.0.0 | Berechtigungen |
Mit dem Access Webservice können Berechtigungen auf Objekten des elektronischen Lesesaals abgefragt werden.
5.2.1 Berechtigung eines Principals auf ein Objekt abfragen
Diese Methode ermöglicht das gezielte Abfragen der Berechtigungen eines Principals, welche exakt einem Objekt zugeordnet sind.
Ein Principal kann ein Benutzer, ein Gruppe oder eine Rolle sein, während ein Objekt ein Dokument, ein Kapitel, ein Artikel oder eine Seite sein kann.
Methodenname: getPermissions
Parameter:
Name | Beschreibung |
---|---|
session id | Id einer gültigen Session des angemeldeten Webservice Nutzers |
principal id | Id des Principals, für das Berechtigungen abgefragt werden sollen |
object id | Id des Objektes, dessen Berechtigungen abgefragt werden sollen |
Rückgabe: Liste aller Berechtigungen des Principals auf dem Objekt
5.2.2 Alle Berechtigung auf ein Objekt abfragen
Diese Methode ermöglicht das Abfragen sämtlicher Berechtigungen, welche einem Objekt zugeordnet sind.
Wie bei getPermissions kann ein Objekt ein Dokument, ein Kapitel, ein Artikel oder eine Seite sein.
Methodenname: getPermissionSet
Parameter:
Name | Beschreibung |
---|---|
session id | Id einer gültigen Session des angemeldeten Webservice Nutzers |
object id | Id des Objektes, dessen Berechtigungen abgefragt werden sollen |
Rückgabe: Liste mit sämtlichen Berechtigungen, die Principals auf dem Objekt haben
5.3 Account WebserviceAbschnitt hinzufügen
MyBib eL Version | Webservice Version | Änderung |
---|---|---|
1.4.x | 1.x??? | Benutzerverwaltung (neu) |
Mit dem Account Webservice können verschiedene Aspekte der Benutzerverwaltung durchgeführt werden. Hierzu gehören das Anlegen, Bearbeiten und Löschen von Benutzern, Gruppen und Rollen.
5.3.1 Benutzer anlegen
Mithilfe dieser Methode kann ein neuer Benutzer innerhalb des MyBib eL Servers angelegt werden.
Methodenname: createUser
Parameter:
Name | Beschreibung |
---|---|
session id | Id einer gültigen Session des angemeldeten Webservice Clients |
login name | Name, mit dem er Benutzer sich einloggen kann |
password | Passwort, mit dem er Benutzer sich einloggen kann |
full name | Vollständiger Name des Benutzers |
comment | Kommentar zum Benutzer |
Rückgabe: Eindeutige Benutzer Id, welche für weitere Operationen verwendet werden kann.
5.3.2 Benutzer löschen
Mit dieser Methode kann ein vorhandenes Benutzerkonto aus dem MyBib eL Server gelöscht werden.
Methodenname: deleteUser
Parameter:
Name | Beschreibung |
---|---|
session id | Id einer gültigen Session des angemeldeten Webservice Clients |
user id | Id des zu löschenden Benutzers |
Rückgabe: –
5.3.3 Benutzer auflisten
Diese Methode wird verwendet, um eine Liste aller Benutzer Ids abzufragen, welche momentan auf dem MyBib eL Server registriert sind.
Methodenname: getUserIds
Parameter:
Name | Beschreibung |
---|---|
session id | Id einer gültigen Session des angemeldeten Webservice Clients |
Rückgabe: Ids aller vorhandenen Benutzer
5.3.4 Benutzerdaten abfragen
Diese Methode wird verwendet, um die genauen Benutzerdaten eines auf dem MyBib eL Server existierenden Benutzers abfragen zu können.
Methodenname: getUserData
Parameter:
Name | Beschreibung |
---|---|
session id | Id einer gültigen Session des angemeldeten Webservice Clients |
user id | Id des Benutzers, dessen Daten abgefragt werden sollen |
Rückgabe: Die zurückgegebenen Nutzerdaten enthalten folgende Werte:
- Benutzer-Id: Id zur Identifizierung eines Benutzers in dem MyBib eL Server
- Login: Login Name des Nutzers für den MyBib eL Server
- Benutzername: Vollständiger Name des Benutzers
- Status: Status des Benutzers
Folgende sind möglich:- aktiviert: Benutzer ist aktiviert
- wartend: Benutzer wartet auf Aktivierung
- deaktiviert: Benutzer ist deaktiviert.
- Beschreibung: Beschreibung zu dem jeweiligen Benutzer
5.3.5 Benutzerdaten speichern
Diese Methode wird verwendet, um die Benutzerdaten eines existierenden MyBib eL Benutzerkontos neu zu setzen.
Hierunter fallen sämtliche Benutzer-Daten, welche man mithilfe der Methode getUserData zum Auslesen der Benutzerdaten abfragen kann.
Wichtig: Die ID der Benutzergruppe darf nicht geändert werden.
Methodenname: setUserData
Parameter:
Name | Beschreibung |
---|---|
session id | Id einer gültigen Session des angemeldeten Webservice Clients |
user data | Nutzerdaten, welche gültige Werte für Id, Beschreibung, Login Name, vollständiger Name, Registrierungsstatus enthalten |
Rückgabe: –
5.3.6 Benutzergruppe anlegen
Mithilfe dieser Methode kann eine neue Benutzergruppe innerhalb des MyBib eL Servers angelegt werden.
Methodenname: createUserGroup
Parameter:
Name | Beschreibung |
---|---|
session id | Id einer gültigen Session des angemeldeten Webservice Clients |
parent user group id | Id einer vorhandenen Benutzergruppe, deren Untergruppe die neu anzulegende Gruppe sein soll |
user group name | Name der Benutzergruppe |
description | Beschreibung der Benutzergruppe |
Rückgabe: Eindeutige Benutzergruppen Id, welche für weitere Operationen verwendet werden kann.
5.3.7 Benutzergruppe löschen
Mit dieser Methode kann eine vorhandene Benutzergruppe aus dem MyBib eL Server gelöscht werden.
Methodenname: deleteUserGroup
Parameter:
Name | Beschreibung |
---|---|
session id | Id einer gültigen Session des angemeldeten Webservice Clients |
user group id | Id der zu löschenden Benutzergruppe |
Rückgabe: –
5.3.8 Benutzergruppen auflisten
Diese Methode wird verwendet, um eine Liste aller Benutzergruppen Ids abzufragen, welche momentan auf dem MyBib eL Server registriert sind.
Methodenname: getUserGroupIds
Parameter:
Name | Beschreibung |
---|---|
session id | Id einer gültigen Session des angemeldeten Webservice Clients |
Rückgabe: Ids aller vorhandenen Benutzergruppen
5.3.9 Benutzergruppendaten abfragen
Diese Methode wird verwendet, um die genauen Benutzergruppendaten einer auf dem MyBib eL Server existierenden Benutzergruppe abfragen zu können.
Methodenname: getUserGroupData
Parameter:
Name | Beschreibung |
---|---|
session id | Id einer gültigen Session des angemeldeten Webservice Clients |
user group id | Id der Benutzergruppe, deren Daten abgefragt werden sollen |
Rückgabe: Die zurückgegebenen Nutzergruppendaten enthalten folgende Werte:
- Benutzergruppen Id: Id zur Identifizierung einer Benutzergruppe in dem MyBib eL Server
- Gruppenname: Name der Gruppe
- Benutzer Ids: Ids der MyBib eL Benutzer, die dieser Gruppe angehören
- Beschreibung: Beschreibung zu der jeweiligen Benutzergruppe
5.3.10 Benutzergruppendaten speichern
Diese Methode wird verwendet, um die Gruppendaten einer existierenden MyBib eL Benutzergruppe neu zu setzen.
Hierunter fallen sämtliche Benutzergruppen-Daten, welche man mithilfe der Methode getUserGroupData zum Auslesen der Benutzergruppendaten abfragen kann.
Wichtig: Die ID der Benutzergruppe darf nicht geändert werden.
Methodenname: setUserGroupData
Parameter:
Name | Beschreibung |
---|---|
session id | Id einer gültigen Session des angemeldeten Webservice Clients |
user group data | Nutzergruppendaten, welche gültige Werte für Id der Gruppe, Beschreibung, Gruppenname, Ids der Benutzer dieser Gruppe enthalten |
Rückgabe: –
5.3.11 Rolle anlegen
Mithilfe dieser Methode kann eine neue Rolle innerhalb des MyBib eL Servers angelegt werden.
Methodenname: createRole
Parameter:
Name | Beschreibung |
---|---|
session id | Id einer gültigen Session des angemeldeten Webservice Clients |
role name | Name der Rolle |
description | Beschreibung der Rolle |
Rückgabe: Eindeutige Rollen Id, welche für weitere Operationen verwendet werden kann.
5.3.12 Rolle löschen
Mit dieser Methode kann eine vorhandene Rolle aus dem MyBib eL Server gelöscht werden.
Methodenname: deleteRole
Parameter
Name | Beschreibung |
---|---|
session id | Id einer gültigen Session des angemeldeten Webservice Clients |
role id | Id der zu löschenden Rolle |
Rückgabe: –
5.3.13 Rollen auflisten
Diese Methode wird verwendet, um eine Liste aller Rollen Ids abzufragen, welche momentan auf dem MyBib eL Server registriert sind.
Methodenname: getRoleIds
Parameter:
Name | Beschreibung |
---|---|
session id | Id einer gültigen Session des angemeldeten Webservice Clients |
Rückgabe: Ids aller vorhandenen Rollen
5.3.14 Rollendaten abfragen
Diese Methode wird verwendet, um die genauen Rollendaten einer auf dem MyBib eL Server existierenden Rolle abfragen zu können.
Methodenname: getRoleData
Parameter:
Name | Beschreibung |
---|---|
session id | Id einer gültigen Session des angemeldeten Webservice Clients |
role id | Id der Rolle, deren Daten abgefragt werden sollen |
Rückgabe: Die zurückgegebenen Nutzergruppendaten enthalten folgende Werte:
- Role Id: Id zur Identifizierung einer Rolle in dem MyBib eL Server
- Rollenname: Name der Rolle
- Benutzer Ids: Ids der MyBib eL Benutzer, die diese Rolle haben
- Beschreibung: Beschreibung zu der jeweiligen Rolle
5.3.15 Rollendaten speichern
Diese Methode wird verwendet, um die Rollendaten einer existierenden MyBib eL Rolle neu zu setzen.
Hierunter fallen sämtliche Rollendaten, welche man mithilfe der Methode getRoleData zum Auslesen der Rollendaten abfragen kann.
Wichtig: Die Id der Rolle darf nicht geändert werden.
Methodenname: setRoleData
Parameter:
Name | Beschreibung |
---|---|
session id | Id einer gültigen Session des angemeldeten Webservice Clients |
role data | Rollendaten, welche gültige Werte für Id der Rolle, Beschreibung, Rollenname, Ids der Benutzer dieser Rolle enthalten |
Rückgabe: –
5.4 Event WebserviceAbschnitt hinzufügen
MyBib eL Version | Webservice Version | Änderung |
---|---|---|
1.4.x | 1.x??? | Ereignisverwaltung (neu) |
Der Event Webservice ermöglicht die Abfrage im MyBib eL Server gespeicherter Events (Ereignisse). Zusätzlich biete er die Möglichkeit, Events anzulegen und vorhandene Events zu löschen.
5.4.1 Events abfragen
Diese Methode ermöglicht die Abfrage von Events, die im MyBib eL Server im gegebenen Zeitraum aufgetreten und gespeichert worden sind.
Methodenname: getEventData
Parameter:
Name | Beschreibung |
---|---|
session id | Id einer gültigen Session des angemeldeten Webservice Nutzers |
from | Startdatum des geforderten Zeitraumes |
to | Enddatum des geforderten Zeitraumes |
Rückgabe: Liste aller Events, die im gegebenen Zeitraum aufgetreten und gespeichert worden sind. Ein Event beinhaltet folgende Daten:
- Event Id: Id eines Events
- Datum: Datum der Events
- Name: Name des Events
- Typ: Art des Events
- Quelle: Quelle des Events
- Aktion: Aktion, welche zu dem Event führte
- Beschreibung: Beschreibung des Events
- Fehlermeldung: Fehlermeldung des Events
- Liste mit zum Event gehörenden Variablen
- Name der Variable
- Wert der Variable
5.4.2 Event anlegen
Diese Methode dient zum Anlegen von Events im MyBib eL Server. Hierdurch können Events gespeichert werden, welche relevant für z.B. Dokumente im eL sind, aber nicht durch den eL Server ermittelt werden können bzw. erfasst worden sind.
Methodenname: setEventData
Parameter:
Name | Beschreibung |
---|---|
session id | Id einer gültigen Session des angemeldeten Webservice Nutzers |
events | Liste mit Events, die gespeichert werden sollen Pro Event werden folgende Daten erfasst (vgl. Datenstruktur bei getEventData): Id, Datum, Typ, Quelle, Aktion, Beschreibung, Eventvariablen |
Rückgabe: Liste mit Events, die in dieser Methode gespeichert wurden
5.4.3 Event löschen
Diese Methode dient zum Löschen von im MyBib eL Server gespeicherten Events.
Methodenname: removeEventData
Parameter:
Name | Beschreibung |
---|---|
session id | Id einer gültigen Session des angemeldeten Webservice Nutzers |
event ids | Liste mit Event Ids der zu löschenden Events |
Rückgabe: –
5.5 Repository WebserviceAbschnitt hinzufügen
MyBib eL Version | Webservice Version | Änderung |
---|---|---|
1.4.x | 1.x??? | Repositoryverwaltung (neu) |
Der Repository Webservice ist für die Verwaltung der Dokumente innerhalb eines MyBib eL Servers gedacht.
5.5.1 Dokumente auflisten
Mit dieser Methode kann eine Liste aller im MyBib eL gespeicherten Dokumente abgefragt werden. Optional kann die Liste auf Dokumente eingeschränkt werden, die einem bestimmten Benutzer gehören.
Methodenname: getMediaNumbers
Parameter:
Name | Beschreibung |
---|---|
session id | Id einer gültigen Session des angemeldeten Webservice Clients |
user id | Id eines MyBib eL Nutzers, dessen Dokumente angezeigt werden sollen (optional) |
Rückgabe: Liste mit Mediennummern der im MyBib eL vorhandenen Dokumente bzw deren Owner dem angegebenen Benutzer entspricht.
5.5.2 Druckbare Dokumente auflisten
Mit dieser Methode kann eine Liste aller Dokumente abgefragt werden, deren Druckzähler (Anzahl noch zur Verfügung stehender Druckvorgänge) größer null ist. Optional kann die Liste auf Dokumente mit Druckzähler größer null eingeschränkt werden, die einem bestimmten Benutzer gehören.
Methodenname: queryPrintableDocuments
Parameter:
Name | Beschreibung |
---|---|
session id | Id einer gültigen Session des angemeldeten Webservice Clients |
user id | Id eines MyBib eL Nutzers, dessen Dokumente angezeigt werden sollen (optional) |
Rückgabe: Liste mit Mediennummern der im MyBib eL vorhandenen Dokumente mit Druckzähler größer null, optional eingeschränkt auf Dokumente des angegebenen Nutzers. deren Owner dem angegebenen Benutzer entspricht.
5.5.3 Dokumentinformationen abfragen
Mit dieser Methode können nähere Informationen zu Dokumenten im MyBib eL Server abgefragt werden.
Methodenname: getDocumentInfos
Parameter:
Name | Beschreibung |
---|---|
session id | Id einer gültigen Session des angemeldeten Webservice Clients |
media numbers | Liste mit Mediennummern der Dokumente, deren Informationen abgefragt werden sollen |
Rückgabe: Liste mit den jeweiligen Daten der Dokumente:
- Dokument Id: Id des Dokumentes im MyBib eL Server
- Medienummer: Die Mediennummer des Dokuments im MyBib eL Server
- Name: Der Titel des Dokuments
- Identifier: Metadatenfeld für z.B. die Signatur eines Dokumentes, Inhalt abhängig von Dokumentformat/Spezifikation durch Kunden
- Seiten: Eine Liste Ids der Seiten, die zu diesem Dokument gehören
- Zähler: Die Zählerstände des Dokuments (Anzeigezähler, Exemplarzähler, Druckzähler)
5.5.4 Kapitelinformationen abfragen
Mit dieser Methode können nähere Informationen zu Kapiteln eines Dokumentes im MyBib eL Server abgefragt werden.
Methodenname: getChapterInfos
Parameter:
Name | Beschreibung |
---|---|
session id | Id einer gültigen Session des angemeldeten Webservice Clients |
document id | Id des Dokumentes, dessen Kapitelinformationen abgefragt werden sollen |
Rückgabe: Liste mit Informationen zu den Kapiteln des angegebenen Dokumentes.
- Kapitel Id: Id des jeweiligen Kapitels im MyBib eL Server
- Name: Titel des Kapitels
- Seiten: Eine Liste mit Ids der Seiten, welche zum jeweiligen Kapitel gehören
5.5.5 Artikelinformationen abfragen
Mit dieser Methode können nähere Informationen zu Artikeln eines Dokumentes im MyBib eL Server abgefragt werden.
Methodenname: getArticleInfos
Parameter:
Name | Beschreibung |
---|---|
session id | Id einer gültigen Session des angemeldeten Webservice Clients |
document id | Id des Dokumentes, dessen Artikelinformationen abgefragt werden sollen |
Rückgabe: Liste mit Informationen zu den Artikeln des angegebenen Dokumentes
- Artikel Id: Id des Artikels
- Titel: Titel des Artikels
5.5.6 Seiteninformationen abfragen
Mit dieser Methode können nähere Informationen zu Seiten eines Dokumentes im MyBib eL Server abgefragt werden.
Methodenname: getPageInfos
Parameter:
Name | Beschreibung |
---|---|
session id | Id einer gültigen Session des angemeldeten Webservice Clients |
document id | Id des Dokumentes, dessen Seiteninformationen abgefragt werden sollen |
Rückgabe: Liste mit Informationen zu den Seiten des angegebenen Dokumentes
- Seiten Id: Id der Seite des Dokuments im MyBib eL Server
- Name: Name der Seite
- Nummer: Nummer der Seite
5.5.7 Dokumentenzähler abfragen
Mit dieser Methode können Zählerstände von im MyBib eL befindlichen Dokumenten abgefragt werden.
Methodenname: getDocumentCounters
Parameter:
Name | Beschreibung |
---|---|
session id | Id einer gültigen Session des angemeldeten Webservice Clients |
media numbers | Liste mit Mediennummern der Dokumente, deren Zählerstände abgefragt werden sollen. |
Rückgabe: Liste mit den Zählerständen der angeforderten Dokumente:
- Mediennummer: Die Mediennummer des jeweiligen Dokuments
- Anzeigezähler: Die Menge der zur Anzeige verfügbaren Exemplare des Dokumentes
- Exemplarzähler: Die Menge der verfügbaren Exemplare des Dokumentes
- Druckzähler: Die Menge der noch möglichen Druckvorgänge für das Dokument
5.5.8 Dokumentenzähler setzen
Mit dieser Methode können die Zählerstände von Dokumenten im MyBib eL Server gesetzt werden.
Methodenname: setDocumentCounters
Parameter:
Name | Beschreibung |
---|---|
session id | Id einer gültigen Session des angemeldeten Webservice Clients |
document count list | Liste mit Zählerständen, die für die angegebenen Dokumente gesetzt werden sollen – Mediennummer – Anzeigezähler – Exemplarzähler – Druckzähler |
Rückgabe:
5.5.9 Erweiterte Metadatenfelder eines Objektes abfragen
Mit dieser Methode können die erweiterten Metadatenfelder eines Dokumentes/Kapitels/Artikels/einer Seite im MyBib eL Server abgefragt werden.
Methodenname:
Parameter:
Name | Beschreibung |
---|---|
session id | Id einer gültigen Session des angemeldeten Webservice Clients |
object id | Id des Objektes (Dokument/Kapitel/Artikel/Seite, dessen erweiterte Metadaten abgefragt werden sollen |
Rückgabe: Liste (Name-Wert-Paare) mit den jeweiligen erweiterten Metadaten des Dokuments/Kapitels/Artikels/der Seite
5.5.10 Erweiterte Metadatenfelder eines Objektes setzen
Mit dieser Methode können die erweiterten Metadatenfelder eines Dokumentes/Kapitels/Artikels/einer Seite im MyBib eL Server gesetzt werden.
VORSICHT: Vorhandene erweiterte Metadaten des betreffenden Objektes werden hierbei gelöscht, so dass nach dem Aufruf dieser Methode nur noch die dadurch gesetzten Felder als erweiterte Metadaten des Objektes vorhanden sind!
Methodenname:
Parameter:
Name | Beschreibung |
---|---|
session id | Id einer gültigen Session des angemeldeten Webservice Clients |
object id | Id des Objektes (Dokument/Kapitel/Artikel/Seite), dessen erweiterte Metadaten gesetzt werden sollen |
extra data fields | Liste (Name-Wert-Paare) der erweiterten Metadaten, die gesetzt werden sollen |
Rückgabe: –
5.6 Session WebserviceAbschnitt hinzufügen
MyBib eL Version | Webservice Version | Änderung |
---|---|---|
1.4.x | 1.x??? | eigener Webservice |
In dem Webservice für die Sessionverwaltung sind Funktionen zusammengefasst, welche sich auf das Sessionmanagement eines MyBib eL Servers beziehen.
5.6.1 Einloggen
Diese Methode dient dazu, einen Benutzer am MyBib eL Server einzuloggen und eine aktive Sitzung/Session zu erzeugen.
Methodenname: login
Parameter:
Name | Beschreibung |
---|---|
node id | Id der Workstation, von der aus ein Nutzer sich anmeldet |
user name | Benutzername |
password | Password |
Rückgabe: Id der Session, die für die folgende Interaktion zwischen Client und Server erzeugt worden ist.
5.6.2 Ausloggen
Diese Methode dient dazu, einen Benutzer vom MyBib eL Server auszuloggen und die aktive Sitzung zu beenden.
Methodenname: logout
Parameter:
Name | Beschreibung |
---|---|
session id | Id der Session, die beendet werden soll |
Rückgabe: –
5.7 Task WebserviceAbschnitt hinzufügen
MyBib eL Version | Webservice Version | Änderung |
---|---|---|
1.4.x | 1.x??? | Aufgabenverwaltung (neu) |
Der Task Webservice für die Verwaltung von Aufgaben/Tasks stellt Methoden zur Verfügung, mit denen Informationen über Tasks auf dem MyBib eL Server abgefragt und Tasks gelöscht werden können.
5.7.1 Aufgaben auflisten
Diese Methode gibt eine Liste aller auf dem MyBib eL Server vorhandenen Task Ids zurück.
Methodenname: getTaskIds
Parameter:
Name | Beschreibung |
---|---|
session id | Id einer gültigen Session des angemeldeten Webservice Nutzers |
Rückgabe: Liste aller Task Ids
5.7.2 Aufgabeinformationen abfragen
Mit dieser Methode können weitere Details zu Aufgaben abgefragt werden.
Methodenname: getTaskInfos
Parameter:
Name | Beschreibung |
---|---|
session id | Id einer gültigen Session des angemeldeten Webservice Clients |
task ids | Liste mit Task Ids, zu denen weitere Informationen abgefragt werden sollen |
Rückgabe: Liste mit Informationen zu vorhandenen Tasks, folgende Details werden pro Task zurückgegeben:
- Task Id: Id zur Identifizierung eines Tasks auf dem MyBib eL Server
- Typ: Art des Tasks
- Status: Status des Tasks
- Datum enqueued: Zeitpunkt, zu dem der Task hinzugefügt wurde
- Datum scheduled: Zeitpunkt, zu dem die Bearbeitung des Tasks begonnen wurde
- Datum processed: Zeitpunkt, zu dem die Bearbeitung des Tasks beendet wurde
- Kommentar: Ein Kommentar zum Task
5.7.3 Aufgabe überprüfen/warten
Mit dieser Methode werden Informationen zu einer Aufgabe abgefragt, wobei im Falls noch nicht abgeschlossener Aufgaben gewartet wird, bis diese entweder beendet wurden (Status „finished“) oder eine Grenze der Wartezeit von 100 Sekunden erreicht wurde.
Methodenname: checkForTaskCompletion
Parameter:
Name | Beschreibung |
---|---|
session id | Id einer gültigen Session des angemeldeten Webservice Clients |
task id | Id eines Tasks, auf dessen Abschluss gewartet werden soll |
Rückgabe: Informationen zum Task, folgende Details werden zurückgegeben:
- Task Id: Id zur Identifizierung eines Tasks auf dem MyBib eL Server
- Typ: Art des Tasks
- Status: Status des Tasks
- Datum enqueued: Zeitpunkt, zu dem der Task hinzugefügt wurde
- Datum scheduled: Zeitpunkt, zu dem die Bearbeitung des Tasks begonnen wurde
- Datum processed: Zeitpunkt, zu dem die Bearbeitung des Tasks beendet wurde
- Kommentar: Ein Kommentar zum Task
5.7.4 Aufgabe löschen
Mit dieser Methode können Tasks, deren Bearbeitung noch nicht begonnen wurde, gelöscht werden. So kann deren Abarbeitung verhindert werden.
Methodenname: removeTask
Parameter:
Name | Beschreibung |
---|---|
session id | Id einer gültigen Session des angemeldeten Webservice Nutzers |
task id | Id einer Aufgabe, die gelöscht werden soll |
Rückgabe: –
5.8 Transfer WebserviceAbschnitt hinzufügen
MyBib eL Version | Webservice Version | Änderung |
---|---|---|
1.4.x | 1.x??? | Import-/Exportverwaltung (neu) |
Der Transfer Webservice wird verwendet, um Dokumente in den MyBib eL Server einzuchecken bzw. auszuchecken oder zu exportieren. Hierbei ist zu beachten, das grundsätzlich keine Dokumente über den Webservice selbst gesendet werden. Vielmehr wird mitgeteilt, wo ein Dokument auf dem MyBib eL Server zu finden ist, welches importiert werden soll, bzw. wo ein zu exportierendes Dokument gespeichert werden soll.
Wichtig: Die Aktionen zu Dokumentbewegungen werden durch die Methodenaufrufe dieses Webservices nicht unmittelbar gestartet, sondern in eine Warteschlange (Task Queue) eingereiht, die automatisch sequentiell in der Reihenfolge des Eintreffens der Tasks auf dem Server abgearbeitet wird.
5.8.1 Dokumente einchecken
Mit dieser Methode kann nach dem Upload von Dokumenten in einem der unterstützten Importformate dem MyBib eL Server mitgeteilt werden, dass er diese Dokumente einchecken soll. Hierbei wird eine Liste mit Dateinamen übergeben, um explizit nur diese Dokumente einzuchecken.
Methodenname: checkinDocument
Parameter:
Name | Beschreibung |
---|---|
session id | Id einer gültigen Session des angemeldeten Webservice Clients |
file names | Liste mit Dateinamen (absolute Pfade), die eingecheckt werden sollen |
Rückgabe: Task Id des Checkin Tasks, der im MyBib eL erzeugt und in die Queue zur Abarbeitung eingereiht wurde.
5.8.2 Dokumente auschecken
Diese Methode wird verwendet, um Dokumente aus dem MyBib eL Server auszuchecken (es ist dann nicht mehr im Datenbestand des Lesesaals verfügbar). Hierbei wird das auszucheckende Dokument wieder in das XML-Format umgewandelt, welches es beim Import hatte und dann im Checkout-Verzeichnis abgelegt.
Wichtig: Es sind ggf. nicht mehr alle Metadaten vorhanden, die das ursprüngliche Dokument beim Checkin hatte. (Der Lesesaal speichert abhängig vom Dokumentformat nur eine Teilmenge der Dokumentmetadaten, die für die Verarbeitung im Lesesaal relevant sind.)
Methodenname: checkoutDocument
Parameter:
Name | Beschreibung |
---|---|
session id | Id einer gültigen Session des angemeldeten Webservice Clients |
document ids | Liste mit Dokument Ids, die ausgecheckt werden sollen |
Rückgabe: Task Id des Checkout Tasks, der im MyBib eL erzeugt und in die Queue zur Abarbeitung eingereiht wurde.
5.8.3 Dokumente löschen
Diese Methode wird verwendet, um Dokumente aus dem MyBib eL Server löschen. Im Gegensatz zur Checkout Methode, bei der Dokumente ausgespeichert werden, bevor sie aus dem Lesesaal entfernt werden, werden die Dokumente hier tatsächlich gelöscht, d.h. sie sind nach dem Löschvorgang weder im Datenbestand des Lesesaals noch im XML-Format im Checkout-Verzeichnis verfügbar.
Methodenname: deleteDocument
Parameter:
Name | Beschreibung |
---|---|
session id | Id einer gültigen Session des angemeldeten Webservice Clients |
document ids | Liste mit Dokument Ids, die gelöscht werden sollen |
Rückgabe: Task Id des Delete Document Tasks, der im MyBib eL erzeugt und in die Queue zur Abarbeitung eingereiht wurde.
5.8.4 Dokumente exportieren
Diese Methode kann zum Exportieren von Dokumenten genutzt werden. Analog zur Methode checkoutDocument werden die Dokumente in ihrem ursprünglichen XML-Format ausgespeichert. Der Unterschied zwischen diesen beiden Methoden ist, dass ein Export die Dokumente nicht aus dem Mybib eL Server löscht.
Methodenname: exportDocument
Parameter:
Name | Beschreibung |
---|---|
session id | Id einer gültigen Session des angemeldeten Webservice Clients |
document ids | Liste mit Dokument Ids, die exportiert werden sollen |
Rückgabe: Task Id des Export Document Tasks, der im MyBib eL erzeugt und in die Queue zur Abarbeitung eingereiht wurde.
5.8.5 Checkin Metadaten abfragen
Die Methode zum abfragen der Checkin-Metadaten wird verwendet, um in Erfahrung zu bringen, wie man einem MyBib eL Server neue Dokumente für den Checkin bereitstellt.
Methodenname: getCheckinConnectionMetadata
Parameter:
Name | Beschreibung |
---|---|
session id | Id einer gültigen Session des angemeldeten Webservice Clients |
Rückgabe: connection metadata, beinhaltet folgende Informationen:
- URI: Protokoll und Pfad, wo Dokumente zum Checkin abgelegt sein müssen
- Benutzer: Benutzername, um sich für den Upload über die URI mit dem Server zu verbinden
- Passwort: Passwort, um sich für den Upload über die URI mit dem Server zu verbinden
5.8.6 Checkout Metadaten abfragen
Die Methode zum Abfragen der Checkout-Metadaten wird verwendet, um in Erfahrung zu bringen, wo der MyBib eL Server ausgecheckte bzw. exportierte Dokumente bereitstellt.
Methodenname: getCheckoutConnectionMetadata
Parameter:
Name | Beschreibung |
---|---|
session id | Id einer gültigen Session des angemeldeten Webservice Clients |
Rückgabe: connection metadata, beinhaltet folgende Informationen:
- URI: Protokoll und Pfad wo sich die Dokumente zum abholen befinden
- Benutzer: Benutzername um sich über die URI mit dem Server zu verbinden
- Passwort: Passwort um sich über die URI mit dem Server zu verbinden
5.9 Workstation WebserviceAbschnitt hinzufügen
MyBib eL Version | Webservice Version | Änderung |
---|---|---|
1.4.x | 1.x??? | eigener Webservice |
Der Workstation Webservice ist für die Verwaltung von Workstations bzw. Clients vorgesehen.
5.9.1 Workstation Registrierung
Diese Methode wird verwendet, um eine neue Workstation auf dem MyBib eL Server zu registrieren oder die Registrierungsinformationen bereits registrierter Workstations anzupassen.
Der Registrierungsstatus einer Workstation kann entweder mittels eines Aktivierungscodes/Autorisierungscodes bereits während der Registrierung aktiviert werden oder aber die Workstation kann nur registriert und zu einem späteren Zeitpunkt aktiviert werden.
Methodenname: registerWorkstation
Parameter:
Name | Beschreibung |
---|---|
session id | Id einer gültigen Session des angemeldeten Webservice Clients |
node id | Id der Workstation, die registriert/deren Registrierung modifiziert werden soll |
computer name | Name der Workstation |
activation code | Aktivierungscode |
registrar name | Registrierer |
authorization code | Autorisierungscode |
comment | Kommentar zur Workstation |
Rückgabe: Registrierungsstatus der Workstation, folgende Werte sind möglich:
- aktiviert: Die Workstation hat Zugriff auf den MyBib eL Server
- wartend: Die Workstation ist noch nicht freigeschaltet
- deaktiviert: Die Workstation wurde deaktiviert
5.9.2 Workstation Registrierung entfernen
Diese Methode wird verwendet, um die Registrierung einer Workstation vom MyBib eL Server zu entfernen. D.h. nach der Entfernung ist die Workstation dem Server nicht mehr bekannt. (Soll sie weiter/wieder genutzt werden, ist eine erneute Registrierung erforderlich.)
Methodenname: unregisterWorkstation
Parameter:
Name | Beschreibung |
---|---|
session id | Id einer gültigen Session des angemeldeten Webservice Clients |
node id | Id der Workstation, deren Registrierung entfernt werden soll |
Rückgabe: –