VIP-LMS Anbindung. Uni Stgt. 27. Juni Version: 2.6

Transkript

1 Heiko Bernlöhr FreeIT.de VIP-LMS Anbindung Per Pascal Grube Uni Stgt. Thomas Richter Uni Stgt. 27. Juni 2014 David Boehringer Uni Stgt. Stephan Rudlof Uni Stgt. Version: 2.6 Zusammenfassung Maximale Integration von VIP in Ilias. Applet Backend Kommunikation wie gehabt über ECS. Ilias VIP Applets ECS Protokoll Instanz VIP Berechnungs Backends VIP Bewertungs Backends 1

2 1 Dozentenapplet Workflows 1.1 Erstellen und erweitern von Aufgaben Das Applet wird aus einem Aufgabenpool von Ilias heraus gestartet, entweder zur Erstellung einer neuen oder zum Überarbeitung einer bereits bestehenden Aufgabe (exercise). Der Dozent bearbeitet/erstellt seine Aufgabe mit dem Applet und kann diese auch jederzeit durch Angabe einer Lösung durch drücken von berechnen 1 testweise berechnen lassen. Der Dozent kann seine Aufgabe jederzeit durch drücken von speichern 2 sichern, das Applet verlassen/beenden und zu einem späteren Zeitpunkt durch erneute Auswahl der Aufgabe in Ilias wieder bearbeiten. Siehe Sequenzdiagramm auf Seite 3, Abbildung Korrektur von Aufgaben Siehe Sequenzdiagramm auf Seite 4, Abbildung 2. 2 Studentenapplet Workflows 2.1 Lösung abgeben Das Applet wird beim Bearbeiten einer VIP-Aufgabe innerhalb eines Ilias- Tests oder als alleinstehende Aufgabe gestartet. Der Student kann jederzeit eine Berechnung seiner eingegebenen Lösung durch drücken von berechnen 3 anfordern. Der Student gibt seine eingegebene Lösung durch drücken von weiter 4 ab. Sollte bis dahin noch keine oder keine aktuelle Berechnung der Aufgabe vorliegen, weist das Applet daraufhin, eine solche durchzuführen. Siehe Sequenzdiagramm auf Seite 5, Abbildung 3. 1 Wird von Applet implementiert. 2 Wird von Ilias implementiert (ExSave:Button). 3 Wird von Applet implementiert. 4 Wird von Ilias implementiert (SolutionSave:Button). 2

3 :ECS Ilias:LMS subpid,cookie:=post:sys/subparticipants POST>Applet:%exercise POST>Applet:%evaluation create/edit exercise 3 Abbildung 1: Erstellen/überarbeiten einer Aufgabe params:ecsbase,cookie,compmid,exerciselocation,solutionlocation,resultlocation,evaluationlocation Lecturer:Applet event:=*post:sys/events/fifo ex:=delete:%exercise/<id> ev:=delete:%evaluation/<id> viplab.getloadedexercise() viplab.getevaluationcode() Save:Form composing and testing exercise exercise, evaluationscode exercise,evaluationcode embedded into hidden field save exercise storing additional metadata into exercise storing evaluations code storing exercise DELETE:sys/subparticipants/<subpid>

4 4 Abbildung 2: Evaluieren einer studentischen Aufgabe durch den Dozenten :ECS subpid,cookie:=post:sys/subparticipants POST>Applet:%exercise POST>Applet:%solution POST>Applet:%result POST>Applet:%evaluation params:ecsbase,cookie,compmid,exerciselocation,solutionlocation,resultlocation,evaluationlocation,ptscallback Lecturer:Applet event:=*post:sys/events/fifo ex:=delete:%exercise/<id> sol:=delete:%solution/<id> res:=delete:%result/<id> ev:=delete:%evaluation/<id> call %ptstarget script to store evaluations evaluations placed into page form from %ptstarget script Save:Form *evaluate exercise Ilias:LMS save evaluations evaluations eval exercise store evaluations DELETE:sys/subparticipants/<subpid>

5 5 Abbildung 3: Lösungsabgabe einer aus Ilias heraus gestarteten Aufgabenbearbeitung. :ECS params:ecsbase,cookie,compmid,exerciselocation Student:Applet event:=*post:sys/events/fifo ex:=delete:%exercise/<id> viplab.getsolution() viplab.getresult() subpid,cookie:=post:sys/subparticipants exid:=post>applet,backend:%exercise solution, result embedded into hidden field Save:Form *find/compute solution solution, result DELETE:/sys/subparticipants/<subpid> DELETE:%exercise/<exid> Ilias:LMS save solution solve exercise storing solution+result maybe optional (configurable) be prepared receiving 404 (as always)

6 3 Ressourcen 3.1 /sys/subparticipants Ein Subparticipant stellt einen untergeordneten Participanten dar, der am ECS durch einen Standardparticipanten (statisch eingetragener Participant) dynamisch, über die/sys/subparticipants Ressource, angemeldet/registriert wird. Im Unterschied zu einem klassischen anonymen Participanten darf er nicht nur der public community angehören, sondern kann durch den registrierenden Participanten jeder Community zugeteilt werden, welchen der registrierende Participant selbst auch angehört. Beim erzeugen eines Subparticipanten kann dem POST folgendes JSON Initialisierungs-Objekt übergeben werden: { } "realm": "<any context>", #optional, maybe a session id "communities": ["<cid name>",...], #optional, default:[] "community_selfrouting": <boolean>, #optional, default:false "events": <boolean> #optional, default:true Also z.b. curl... -H Content-Type: application/json -X POST \ -d {"realm":"vip", "communities":["public"]} \ Eine Antwort könnte folgendermaßen aussehen: HTTP/ OK Date: Thu, 26 Jun :47:23 GMT Status: 200 OK Connection: close Location: ETag: "0dbc2769cf17bdeb71352f119586fc80" X-Runtime: 230 Content-Length: 407 Content-Type: application/json; charset=utf-8 Cache-Control: private, max-age=0, must-revalidate { "realm": "ViP", "description": "Created from \"Teacher client\" (pid:3)", "communities": [ 6

7 } "public" ], "dns": "N/A", "auth_ids": [ { "desc": "Randomized authid", "auth_id": "8a43d5d3029d17335f5adb56f1a13077" } ], "community_selfrouting": false, "name": "Subparticipant (id:52)", "events": true, " ": "xaver@ilias.lms.de" Hier ist noch besonders das erste Element von auth_ids zu erwähnen. Dort stellt der Wert von auth_id auch gleichzeitig das Cookie für den Subparticipanten dar, welches dieser bei Anfragen an den ECS zur Authentisierung stets im HTTP- Header folgendermaßen mitführen muß: curl... -H "Cookie: ecs_subparticipant=8a43d5d3029d17335f5adb56f1a13077" \ -X GET Diesen Wert muß also das LMS beim erzeugen des Studenten-/Dozentenapplets als Cookie-Parameter übergeben (siehe Abbildungen 1, 2 und 3). GET Liefert realm, communities, community_selfrouting, events und cookie (Statuscode 200). POST Erzeugt neuen Subparticipanten (Statuscode 201) und liefert im Location: Header die neue Representations-URL des Subparticipanten. Mögliche Aufrufparameter: realm, communities, community_selfrouting, events. DELETE Löscht einen Subparticipanten (Statuscode 200). PUT Erlaubt das Ändern der Subparticipanten-Attribute: realm, communities, community_selfrouting, events. Wie immer wird bei der PUT Operation die komplette Representation (alle Attribute) erneuert. Nicht angegebene Attribute erhalten also den Defaultwert (siehe oben). Liefert Statuscode /sys/configs Dient zur Statusabfrage eines Sub-/Participanten: 7

8 curl... -X GET Eine Antwort (ohne HTTP Header) könnte folgendermaßen aussehen: { } "resource_events": { "/numlab/exercises": true, "/numlab/cpp_results": true, "/numlab/dumux_exercises": true, "/numlab/cpp_exercises": true, "/sys/auths": false, "/numlab/dumux_solutions": true, "/campusconnect/cms_keynames": true, "/numlab/results": true, "/numlab/solutions": true, "/numlab/cpp_solutions": true, "/numlab/dumux_results": true }, "selfrouting": false, "participant_events": false Das Attribut resource_events zeigt an, für welche Ressourcen der ECS bei aktivierten Participanten Events ({"participant_events": true}) der Sub- /Participant Events vom ECS bekommt. GET Liest die Ressource. POST Erlaubt es dem aufrufenden Sub-/Participanten ein selektives verändern von selfrouting und/oder participant_events. Z.B. kann ein Sub- /Participant durch folgenden Aufruf für sich Eventerzeugung beim ECS einschalten: curl... -H Content-Type: application/json -X POST \ -d {"participant_events":true"} \ 4 Sicherheit 4.1 Zertifikate Ein Subparticipant wird entgegen normaler Participanten nicht mit einem Clientzertifikat ausgestattet und kann somit auch keiner Peer-Authentifikation unterzo- 8

9 gen werden, wird aber stattdessen vom generierenden Participanten mit einem individuellen Cookie versorgt, so daß es genügt, den Subparticipanten mit dem entsprechenden CA-Root-Zertifikat auszustatten. Dieses CA-Root-Zertifikat ist öffentlicher Natur und kann bedenkenlos ins Applet integriert oder auch dynamisch 5 geladen werden. 5 CA-Root-Cert von FreeIT: 9

10 A Browser Applet Kommunikation Javascript to Java Applet communication 6 Invoking Applet Methods From JavaScript Code 7 B Applet Browser Kommunikation Manipulating DOM of Applet s Web Page