Flashfragen in ILIAS Test & Assessment. Helmut Schottmüller

Transkript

1 Flashfragen in ILIAS Test & Assessment Helmut Schottmüller

2 Flashfragen in ILIAS Test & Assessment Helmut Schottmüller Veröffentlicht Januar 2009 Copyright 2009 Helmut Schottmüller

3 Inhaltsverzeichnis 1. Verwendung von Flashfragen in ILIAS Test & Assessment... 1 Beschreibung des Fragentyps... 1 Bearbeiten einer Flashfrage... 1 Einbettung des Flash-Applets in den Seitencode Entwicklerdokumentation... 3 Übergabe von ILIAS-n an das Flash-Applet... 3 Kommunikation zwischen dem Flash-Applet und ILIAS über SOAP Webservices... 3 savequestion(sid, active_id, question_id, pass, solution)... 3 savequestionsolution(sid, active_id, question_id, pass, solution)... 4 getnrofquestionsinpass(sid, active_id, pass)... 4 getpositionofquestion(sid, active_id, question_id, pass)... 5 getpreviousreachedpoints(sid, active_id, question_id, pass)... 5 getquestionsolution(sid, active_id, question_id, pass)... 5 gettestuserdata(sid, active_id)... 6 iii

4 Kapitel 1. Verwendung von Flashfragen in ILIAS Test & Assessment Beschreibung des Fragentyps Der Fragentype Flashfrage bietet die Möglichkeit, ein Adobe Flash-Applet in eine ILIAS-Frage einzubetten, wobei das Flash-Applet die eigentliche Frage bereitstellt und auch für die Bewertung des Teilnehmers zuständig ist. Die Ergebnisse werden mit Hilfe der ILIAS SOAP Webservice Schnittstelle an ILIAS übergeben und fließen somit in die Bewertung eines ILIAS Tests ein. Bei der Ausgestaltung der Fragen sind keinerlei Grenzen gesetzt. Lediglich die von ILIAS vorgegebenen Übergabefunktionen und müssen berücksichtigt werden. Eine neue Flashfrage kann in einem ILIAS-Fragenpool durch Auswahl des Fragentyps hinzugefügt werden. Bearbeiten einer Flashfrage Hinzufügen einer Flashfrage in einem ILIAS Fragenpool Wenn Sie eine neue Flashfrage erstellt haben oder eine bestehende Frage bearbeiten, haben Sie neben den üblichen Einstellungen wie Fragentitel, Beschreibung, Anzahl der Punkte usw. auch die Möglichkeit, ein Flash-Applet hochzuladen. Klicken Sie unter Flash-Datei auf die Durchsuchen-Schaltfläche und laden Sie ein Flash-Applet von Ihrem Rechner. Über die Breite und Höhe können Sie die Größes des Flash-Applets für die Präsentation festlegen. Eine Vorschau des Applets wird Ihnen natürlich angezeigt. Mit der Schaltfläche Neuer können Sie ein paar bestehend aus Name und Wert erstellen, das während der Laufzeit an das Flash-Applet übergeben werden soll. Durch diese lassen sich Flash-Applets in der Regel individualisieren. Es können beliebig viele an das Applet übergeben werden. Bestehende löschen Sie durch das Setzen des löschen Kontrollkästchens neben einem. Wenn Sie die JavaScript-Unterstützung in Ihrem Webbrowser aktiviert haben, werden Paramter direkt hinzugefügt bzw. gelöscht, ohne dass die Seite neu aufgebaut werden muss. Sollten Sie das Flash-Applet löschen wollen, so können Sie alternativ einfach ein anderes Flash-Applet hochladen oder aber das Kontrollkästchen Bestehende Datei löschen auswählen und das Eingabeformular speichern. 1

5 Verwendung von Flashfragen in ILIAS Test & Assessment Bearbeitung eines Flash-Applets in einer Flashfrage Einbettung des Flash-Applets in den Seitencode Im folgenden sehen Sie, wie in etwa das Flash-Applet von ILIAS in den HTML-Code der Seite eingebettet wird. Die Einbettung erfolgt automatisch durch ILIAS und muss nicht von Ihnen vorgenommen werden. <object classid="clsid:d27cdb6e-ae6d-11cf-96b " codebase=" width="400" height="200" id="movie_904820"> <param name="movie" value="frog.swf"> <param name="flashvars" value="speed=7&tonguelength=15"> <embed src=" quality="high" bgcolor="#ffffff" width="400" height="200" name="movie_name_904820" type="application/x-shockwave-flash" pluginspage=" FlashVars="speed=7&tonguelength=15"> </embed> </object> 2

6 Kapitel 2. Entwicklerdokumentation Damit die Flash-Applets mit ILIAS kommunizieren können, sind die folgenden Voraussetzungen nötig: Übergabe von ILIAS-n an das Flash-Applet ILIAS übergibt einige wichtige an das Flash-Applet, die vom Flash-Applet aufbewahrt werden müssen, um die erzielten Punkte an ILIAS weiterzugeben oder andere Informationen von ILIAS abzurufen. Die Übergabe der erfolgt mit dem HTML- FlashVars. Die sind: session_id: Die Session- client: Der Name des ILIAS-Mandanten points_max: Die maximal erreichbare Punktezahl der Frage. Das Flash-Applet sollte immer einen Wert zwischen 0 und 100% der maximalen Punktezahl wieder an ILIAS zurückgeben. server: Die URL des ILIAS SOAP Servers pass: Die Nummer des aktuellen Testdurchlaufs (0, 1, 2,...) active_id: Die ID des aktuellen Testteilnehmers question_id: Die ID der ILIAS-Frage Kommunikation zwischen dem Flash-Applet und ILIAS über SOAP Webservices Zur Kommunikation zwischen dem Flash-Applet und ILIAS muss das Applet in der Lage sein, den in ILIAS integrierten SOAP Webservice zu nutzen. Die für die Aufrufe notwendigen erhält das Flash-Applet von ILIAS. Die Implementierung des SOAP-Clients muss dagegen im Flash-Applet erfolgen. Die folgenden SOAP-Funktionen stehen dem Flash-Applet zur Verfügung: savequestion(sid, active_id, question_id, pass, solution) solution: tns:stringarray String-Array, das die Lösungen des Teilnehmers und die vergebenen Punkte beinhaltet. 3

7 Entwicklerdokumentation Beschreibung: Speichert die Ergebnisse der Flash-Frage in der ILIAS-Datenbank. solution is ein Array mit N*3 Einträgen, die immer aus den Tripeln value1, value2, points bestehen, d.h. in value1, value2 können beliebige Werte der Frage abgelegt werden, in points die dazugehörigen Punkte. Alle in points vergebenen Punkte werden dann zur Gesamtpunktezahl aufsummiert und dürfen den in max_points übermittelten Wert nicht übersteigen. value1 und value2 sind Fragenabhängig und dienen lediglich dem Flash-Applet zur Identifikation der ausgewählten Lösungen eines Teilnehmers. Wenn es sich bei dem Flash-Applet z.b. um eine Multiple Choice Frage mit Einfachauswahl handelt, so könnte in value1 der Index der ausgewählten Lösung stehen, value2 wäre leer und in points würden die erzielten Punkte stehen. Bei einer Multiple Choice Frage mit Mehrfachauswahl würde es mehrere Tripel geben (z.b. nämlich genau die Anzahl der vom Teilnehmer ausgewählten Lösungen). savequestionsolution(sid, active_id, question_id, pass, solution) solution: xsd:string XML-Code, der die Lösungen des Teilnehmers und die vergebenen Punkte beinhaltet. Beschreibung: Speichert die Ergebnisse der Flash-Frage in der ILIAS-Datenbank, analog zur Funktion savequestion. Die Lösung besteht in diesem Fall aber nicht aus einem String-Array, sondern aus einem XML- String der Form <values> <value>value</value> <value>value</value> <points>points</points>... </values> Damit können wie bei savequestion die Lösungen und Punkte der Frage an ILIAS übergeben werden. getnrofquestionsinpass(sid, active_id, pass) 4

8 Entwicklerdokumentation Beschreibung: Liefert die Gesamtzahl der Fragen im angegebenen Testdurchlauf. getpositionofquestion(sid, active_id, question_id, pass) Beschreibung: Liefert die Position der Frage im angegebenen Testdurchlauf. getpreviousreachedpoints(sid, active_id, question_id, pass) Beschreibung: Liefert ein Array von Fließkommazahlen mit den erreichten Punkten der Fragen, die im angegebenen Testdurchlauf vor der Frage mit der ID question_id liegen. getquestionsolution(sid, active_id, question_id, pass) 5

9 Entwicklerdokumentation Beschreibung: Liefert die vorherige Lösung des Teilnehmers für die Frage. Diese Funktion sollte aufgerufen werden, wenn die Frage geöffnet wird, um ggfs. vorher eingegebene Werte darzustellen. Das Ergebnis ist ein String-Array, das die gespeicherten Tripel bestehend aus value1, value2, points zurückliefert. Diese Funktion berücksichtig auch die in ILIAS möglichen Test-Einstellungen, ob vorherige Lösungen angezeigt werden dürfen. Ist das nicht der Fall, wird die Funktion auch keine vorherige Lösung übermitteln. gettestuserdata(sid, active_id) Beschreibung: Liefert ein String-Array bestehend aus den Benutzerdaten des aktuellen Benutzers in der Form: "Voller Name", "Titel", "Vorname", "Nachname", "Login". Bei anonymen Tests wird nur "Unbekannt" als voller Name übergeben, die anderen Einträge sind dann leer. 6