REST-Webservice
Damit externe Dienste mit FlexNow kommunizieren können, wird mit FN2Service ein REST-Schnittstelle zur Verfügung gestellt. Zur Zeit stehen folgende Funktionalitäten zur Verfügung (Stand Release 2025-05):
- Abruf aller Modulhandbüchern eines Semesters (im xml-Format)
- Eintragung von Anerkennungen von der PIM-Plattform
- Vorleistungskontrolle für die Anmeldung zu einer Lehrveranstaltung in Stud.IP
- Absolvierte Module eines Studierenden
Die Konfiguration erfolgt in der Datei web.xml des Projekts FN2Service. Anders als beim FlexNow-Login von Anwendern in z. B. FN2SSS oder FN2LM, bei dem als erstes die Authentifizierung aufgerufen wird, greifen externe Dienste zuerst auf FN2Service zu. Von dort erfolgt die Authentifzierung. Daher müssen folgende Parameter zwingend angegeben werden.
<!-- Parameter für Authentifizierungspfade -->
<context-param>
<description>Servername für dem FN2AUTH-Aufruf</description>
<param-name>FN2SERVICEAUTH_SERVERNAME</param-name>
<param-value>localhost</param-value>
</context-param>
<context-param>
<description>Port für den für den FN2AUTH-Host</description>
<param-name>FN2SERVICEAUTH_PORT</param-name>
<param-value>8080</param-value>
</context-param>
Zugriff
Um auf den Webservice zuzugreifen, muss ein Nutzer dafür in FlexNow angelegt werden. Außerdem ist eine neue Rolle zu definieren (id > 1000) oder die bereits vorhandene Rolle mit der Id 47 zu verwenden. In Abhängigkeit der gewünschten Funktionalität müssen dieser Rolle folgende Rechte zugewiesen werden (Tabelle rollenrechte):
- bez / objektid / operatorid
- FN2ServiceExtern: ActionVorleistung.check / 143 / 312 (3)
- FN2ServiceExtern: ActionStudent.getByKennung / 11 / 359 (4)
- FN2ServiceExtern: ActionStudent.readStudentendaten/ 11 / 91 (4)
- FN2ServiceExtern: ActionSemester.readSemesterByApnr / 42 / 342 (1)
- FN2ServiceExtern: ActionModulhandbuch.readAllBySemester / 71 / 117 (1)
