Sphinx Benutzung des Speicherungsskripts Assistent der Veröffentlichung... 2 Lokalisierung der Dateien... 2 Localisierung des Speicherungsskripts... 2 Lokalisierung der Umfragedateien... 2 Lösung für IIS... 3 Lösung für Apache... 3 Personalisierte Lösung... 3 Hinweise für den Webmaster... 3 Beispiele:... 3 Funktionsprinzip... 3 Linux und Unix... 4 Beschreibung der HTML-Datei... 4 Präsentation JAVA... 4 Präsentation HTML... 4 Konfiguration der Rechte... 5 Zuweisung der Rechte in einem http-server... 5 Zuweisung der Rechte in den Systemdateien... 5 Erhalt der Antworten... 5 Kopie der Dateien der Umfrage (Windows-Server)... 5 Import der Antwortdateien (Linux oder Unix)... 5 Problemlösungen... 6 Zusammenfassung... 6 1
Man kann einen Fragebogen auf seinen eigenen Webserver setzen, d.h. ohne Zusatzsoftware oder ohne die Inanspruchnahme unseres Servers SphinxOnline. Man platziert dafür ein minimales Programm das Speicherungsskript mit den Dateien der Umfrage auf den Server. Dieses Speicherungsskript kann für Windows, Linux oder Unix verwendet werden. Es ermöglicht ausschließlich das Speichern der Antworten. Real-time-Auswertungen, Zugangskontrollen, berechnete Variablen, Veränderung der Antworten, einige interaktive Funktionen (Verweise, konditionelle Anzeigen, zufällige Anordnung von Modalitäten, Scoring, Einschränkungen...), Kontenverwaltung sind nicht möglich. Man startet die Aktion, indem man in Sphinx Eureka Datei Im HTML-Format speichern wählt. Alle notwendigen Dateien werden in ein Verzeichnis auf der Festplatte kopiert. Der Studienbeauftragte teilt dieses Verzeichnis seinem Webadministrator mit. Der Administrator platziert die Dateien des Ordners auf den Server und gibt die notwendigen Schreibrechte, die weiter unten beschrieben werden, frei. Der Administrator teilt dem Studienbeauftragten die gesamte URL der Datei Questionnaire.htm mit. Diese URL wird den zu befragenden Personen mitgeteilt. Assistent der Veröffentlichung Ein Assistent ermöglicht einige Optionen, wie z.b. die Darstellung in einer Webseite, das Speichern von Kontrollvariablen, die Aktion nach dem Speichern und die Lokalisierung der Dateien. Die verschiedenen Optionen der drei ersten Etappen werden im Kompletthandbuch II (Eureka) im Teil Assistent der Veröffentlichung beschrieben. In der vierten Etappe gibt man die Lokalisierung der Dateien und die Serverplattform an. Lokalisierung der Dateien Localisierung des Speicherungsskripts Wenn der Befragte auf Speichern klickt, startet das Speicherungsskript. Es ist daher notwendig, die URL des Skripts zu kennen. Die URL wird im Assistenten als absoluter Pfad von dem Ursprung des Servers angegeben oder als relativer Pfad von der Datei Questionnaire.htm. - Lassen Sie formscript.exe, wenn alle Dateien in dem gleichen Verzeichnis liegen - Man gibt /cgi-bin/formscript.exe an, wenn die Skripte in dem Verzeichnis cgi-bin sein müssen (Apache- Server z.b.) Lokalisierung der Umfragedateien Das Skript wird eine Reihe von Zeichen für die Antworten erhalten, das es in die Antwortdateien platziert. Hier ist es wiederum notwendig, dass das FormScript.exe über die Lokalisierung der Dateien der Umfrage informiert wird. Man gibt entweder den absoluten Pfad von dem Ursprung des Servers an oder den relativen Pfad von dem FormScript.exe. - Lassen Sie Umfrage (enquete), wenn die Dateien der Umfrage neben dem Skript platziert sind. - Geben Sie /data/enquete an, wenn die Dateien mit den Antworten (über Schreibrechte zugänglich) in dem Verzeichnis Data liegen. 2
Lösung für IIS Die relativen Pfade sind also Formscript.exe und Umfrage. Alle Dateien, d.h. questionnaire.htm, questionnaire.gif, eurekapplet.jar, formscript.exe, Umfrage.rep, Umfrage.ouv, Umfrage.que werden in das gleiche Verzeichnis gelegt. Man vergibt die gesamte Kontrolle für dieses Verzeichnis. Lösung für Apache Die relativen Pfade sind /cgi-bin/formskript.exe und Umfrage. Das Skript und die Umfragedateien (formscript.exe, Umfrage.rep, Umfrage.ouv, Umfrage.que) werden in das Verzeichnis cgi-bin gesetzt. Die Seite questionnaire.htm (und die Dateien questionnaire.gif und eurekapplet.jar) werden in ein gleiches Verzeichnis unter die Source des Servers platziert. Für dieses Verzeichnis ist keine Konfiguration notwendig. Personalisierte Lösung Wenn der Serveradministrator es wünscht (z.b. aus Sicherheitsgründen), dass die Seiten in ein Verzeichnis, die Skripte in ein besonderes Verzeichnis und die Umfragedateien in ein drittes Verzeichnis gelegt werden, muss man die entsprechenden Links anpassen. Diese Operation geschieht a posteriori, indem man die Datei questionnaire.htm verändert (siehe folgenden Abschnitt). Hinweise für den Webmaster Beispiele: Sie können sich einige Beispiele für die verschiedenen Plattformen vom Internet laden: http://www.sphinxonline.com/documentation/fswin-apache.exe http://www.sphinxonline.com/documentation/fslinux-apache.exe http://www.sphinxonline.com/documentation/fswin-iis.exe Funktionsprinzip Der Fragebogen wird auf einer einzigen Seite im HTML-Format dargebstellt, per Voreinstellung Questionnaire.htm. Wenn das Format, das im Veröffentlichungsassistenten definiert wird, HTML ist, enthält die Seite ein HTML- Formular, wenn JAVA gewählt wurde, verweist die Seite auf ein Java-Applet. Dieses Applet (FormApplet.jar) benutzt GIF-Bilder (Questionnaire1.gif, Questionnaire2.gif...), um die verschiedenen Bildschirme des Formulars so darzustellen, wie der Studienbeauftragte sie gelayoutet hatte. Nach dem Ende der Antworteingabe werden die Elemente der Antworten des Servers an ein Skript übermittelt (FomScript.exe), das die Speicherung der Antworten in die Datei der Umfrage durchführt (Umfrage.que, Umfrage.rep, Umfrage.ouv). 3
Auf Linux oder Unix werden die Antworten im ASCII-Format gespeichert (Datei Umfrage.txt). Erst beim Import der Datei in Sphinx wird die Konvertierung durchgeführt. Linux und Unix Für Linux finden Sie die ausführbare Datei Formscript im Verzeichnis Eureka/Modules. Diese Datei wurde für Linux Redhat 7.0 mit einem Noyeau 2.2.16-22 und einem Kompilierer gcc Version 2.96 erstellt. Eventuell muss man das Skript neu kompilieren (siehe unten). Für Unix wird das Skript nicht mitgeliefert, da es zahlreiche Plattformen gibt, so dass es mittels des Quellprogramms FormScript.c und der Kompilierungsdatei Makefile kompiliert werden muss. Diese Dateien befinden sich im Verzeichnis Eureka / Modules. Die ausführbare Datei, die erstellt wurde, muss FormScript heißen und in das Vereichnis Eureka/Modules des Installationsverzeichnisses auf dem Rechner des Studienbeauftragten platziert werden. Beschreibung der HTML-Datei Die oben beschriebene Funktionsweise setzt voraus, dass alle notwendigen Informationen (Platzierung des Skripts, der Applets, der Umfragedateien, die URL der Rückkehr) in der Seite questionnaire.htm vorhanden sein müssen. Diese Informationen werden während der Erstellung der Datei Questionnaire.htm im Veröffentlichungsassistenten gegeben. Sie können direkt in der Datei Questionnaire.htm verändert werden. Präsentation JAVA Die in Questionnaire.htm angegebenen Pfade sind: APPLET CODE: Pfad des Java-Applets relativ zu der Datei Questionnaire.htm SCRIPT VALUE: Pfad des Skripts relativ zu der Datei Questionnaire.htm, gefolgt von dem Pfad der Umfragedateien relativ zum Skript. PAGE1 VALUE: Bilder für das Applet relativ zu der Datei Questionnaire.htm. Diese Pfade können auch absolut ausgehend von der Source des Servers oder der URL der Seite geschrieben werden. Beispiel 1 Die Skripte und die Dateien der Umfrage (xxx.*) sind in dem Verzeichnis cgi-bin, die Seiten und der Aufruf sind in irgendeinem Unterordner des Verzeichnisses htdocs (Apache Server). <PARAM NAME=SCRIPT VALUE= /cgi-bin/formscript.exe?survey=xxx > Beispiel 2 Die Skripte sind in dem Verzeichnis scripts, die Dateien der Umfragen in einem Verzeichnis data und die Seiten in irgendeinem Unterordner des Verzeichnisses wwwroot. <PARAM NAME=SCRIPT VALUE= /scripts/formscript.exe?survey=/data/xxx > Präsentation HTML Die Syntax ist leicht verändert, aber die Prinzipien bleiben die gleichen: 4
Beispiel 1 <FORM METHOD=POST ACTION= /cgi-bin/formscript.exe > <INPUT TYPE= HIDDEN NAME= survey VALUE= data > Beispiel 2 <FORM METHOD=POST ACTION= /scripts/formscript.exe > <INPUT TYPE= HIDDEN NAME= survey VALUE= data > Konfiguration der Rechte Zuweisung der Rechte in einem http-server Man muss dem http-server das Ausführungsrecht FormScript.exe geben. Z.B. für den Server IIS schaut man in der Verwaltung des Internet Service die Eigenschaften des Verzeichnisses des Skripts an. Die Authorisierungen der Ausführungen müssen auf Skripte und Ausführungen angewendet werden. Wenn diese Rechte nicht korrekt vergeben sind, wird beim Abspeichern der Antworten versucht werden, das formscript.exe herunterzuladen!!! Zuweisung der Rechte in den Systemdateien Wenn der Server Systemdateien wi NTFS benutzt, welche ermöglichen, für jeden deklarierten Benutzer Rechte zu definieren, muss man auch die Rechte für die Umfragedateien korrekt deklarieren. Wenn der Befragte den Button Speichern klickt, schreibt FormScript die Antworten in die Antwortdatei der Umfrage. Mit Hilfe des Windowsexplorers können Sie die Eigenschaften der Dateien visualisieren. Vergewissern Sie sich, das Sie die Schreib- und Leserechte für Windowsbenutzer, die der Webserver repräsentiert, haben. Wenn diese Rechte nicht korrekt vergeben sind, erhält der Befragte eine Fehlermeldung!!! Erhalt der Antworten Kopie der Dateien der Umfrage (Windows-Server) Für die Windowsserver schreibt die FormScript.exe die Antworten direkt in die Dateien der Umfrage im Format Sphinx. Diese Dateien werden anschließend auf den Computer des Studienbeauftragten kopiert, um die Analysen durchzuführen. Import der Antwortdateien (Linux oder Unix) Für Linux- oder Unixserver ist das Dateiformat ASCII. Diese Dateien werden in Sphinx importiert (Button Daten Importieren). Das Format dieser Dateien ist beispielsweise: 5
id=1a750fde42c40a52&v1=1&v2=1&v3=6&v5=1&v6=12&v7=3&v8=4&v9=1%3b3%3b8&v10=2&v11=2 &v12=1&v13=1&v17=1&v18=4&v20=2&v21=4444&v22=12&v23=1111&v27=1&v29=7&date=27%2f05%2 F2003+15%3A05%3A22 Die Identifikator der Umfrage (id=1a750fde42c40a52) dient dazu, dass diese Textdatei auch der Umfrage entspricht, in die sie importiert werden soll. Problemlösungen Die Onlinestellung einer Umfrage auf SphinxOnline läuft quasi automatisch, bei der Onlinestellung auf einem Webserver muss man eventuell folgende Probleme beheben: Wenn man auf die Seite Questionnaire.htm zugreift, ist der Bildschirm grau Ihr Navigator ermöglicht nicht die Ausführung von Java-Applets. Es handelt sich um eine sehr alte Version des Navigators oder die Ausführung wurde von Ihrer Informatikabteilung untersagt. Machen Sie ein Update oder veröffentlichen Sie die Umfrage im HTML-Format. Wenn man auf den Button Speichern klickt, passiert nichts Achtung, das Skript kann nur funktioneiren, wenn der Fragebogen auf dem Server läuft, nicht wenn er auf Ihrer Festplatte getestet wird. Wenn man auf den Button Speichern klickt, sendet der Server den Fehler Page introuvable (Seite unauffindbar) Das Skript FormScript.exe ist nicht an dem erwarteten Ort: - Überprüfen Sie, ob das FormScript.exe in dem Verzeichnis der Umfrage auf dem Server ist - Überprüfen Sie im Veröffentlichungsassistenten, ob Sie das FormScript.exe in der URL des Skripts angegeben haben. Wenn man auf den Button Speichern klickt schlägt ein Dialog das Herunterladen der Datei FormScript.exe vor Der Administrator hat die Ausführungsrechte für das Programm FormScript.exe nicht korrekt erteilt. Wenn man auf den Button Speichern klickt, sendet der Server die Fehlermeldung Erreur d enregistrement ID=1 (Speicherungsfehler ID=1) Die Antwortdateien (Umfrage.rep und Umfrage.ouv) sind nicht an dem erwarteten Ort: - Überprüfen Sie, ob die Umfrage.rep auch in dem Verzeichnis der Umfrage auf dem Server ist - Überprüfen Sie im Veröffentlichungsassistenten, dass Sie Umfrage als relativen Pfad der Umfrage bezüglich des Skripts angegeben haben. Wenn man auf den Button Speichern klickt, sendet der Server den Fehler Erreur d enregistrement ID=2 (Speicherungsfehler ID=2) Der Administrator hat die Schreibrechte für die Antwortdatei Umfrage.rep und Umfrage.ouv nicht korrekt vergeben. Zusammenfassung Hier eine Checkliste, um das minimale Programm in einer Intranetumgebung zu installieren: - Die Programme installieren sich in einer Umgebung eines Webservers, der CGI-Skripte akzeptiert - Der Studienbeauftragte kommuniziert dem Serveradministrator ein Verzeichnis, das auf den Server kopiert werden muss - Die Rechte (Webserver + Systemdateien) der Ausführung und des Schreiben werden für dieses Verzeichnis vergeben - Für Windowsserver liefern wir ein kompiliertes Skript FormScript.exe mit. Für Linux oder Unix, muss das Skript FormScript rekompiliert werden (ausgehend von der Quelldatei FormScript.c) und muss in das Vereichnis der Umfrage kopiert werden - Die URL der Datei questionnaire.htm dieses Verzeichnisses muss den zu befragenden Personen mitgeteilt werden 6
- Der Administrator sendet den Inhalt dieser Datei nach Erhalt der Antworten zurück an den Studienbeauftragten 7