Dokumentation der Zope-Vorlage Umfragen von netEstate ----------------------------------------------------- (C) netEstate GmbH, www.netestate.de 1. Installation -Voraussetzung für dieses Modul ist ein installiertes Produkt Zopilot - DTML Document mit den DTML-Methoden SeitenKopf und SeitenFuss im Zope-Startverzeichnis sowie das netEstate Datenbankinterface. -Importieren Sie Umfragen.zexp ins Startverzeichnis -Rufen Sie "Installationsskript" im Verezeichnis Installation auf -Im Datenbankinterface sollte nun die Tabellen umfragen, umfragen_themen und umfragen_fragen sichtbar sein. 2. Erstellen einer Umfrage 2.1 Eingabe in die Datenbank -Geben Sie den Titel der Umfrage in die Tabelle umfragen ein. Es wird automatisch eine umfragenid für die Umfrage vergeben. -Jede Frage muss einem Thema zugeordnet werden. Kleinere Umfragen bestehen im Normalfall nur aus einem Thema - größere Umfragen aus mehreren Themen. Geben Sie die Themen über die Tabelle umfragen_themen ein. Über das Feld sortierung können Sie die Sortierung der Themen in der Auswertung beeinflussen. Diese werden dort zuerst nach dem Wert von sortierung und dann nach der aufsteigenden themenid sortiert. Im Normalfall sind die Themen also nach der Reihenfolge der Eingabe sortiert. -In der Bearbeiten-Maske der Themen stehen die Links "Frage einfügen" und "Fragen auflisten" zur verfügung, die die Eingabe von Fragen zum Thema oder das Auflisten aller Fragen zum Thema erlauben. Im Feld frage der Maske für die Fragen geben Sie die Frage ein, im Feld antworten alle möglichen Antworten durch | getrennt (leer bei "freien" Fragen). Die Felder nureineantwort und pflichtangabe sind selbsterklärend. reihenfolgezufaellig wechselt die Reihenfolge der Antworten im Umfrageformular. Es wird automatisch eine fragenid für jede Frage vergeben. 2.1 Erstellen der Formulare Im Verzeichnis Vorlage befindet sich eine Vorlage für eine Umfrage aus zwei Fragen, die auf zwei Seiten verteilt sind. Startseite ist 1, die letzte Seite ist 3. Damit die Vorlage funktioniert, müssen zwei Fragen mit der Fragenid 1 und 2 der Umfrageid 1 definiert werden. Die Fragen sollten jeweils mehere mögliche Antworten haben. Um die Formulare für eine neue Umfrage zu erstellen, kopieren Sie das Verzeichnis Vorlage und bennenen Sie die Kopie nach der neuen Umfrage. Jede Seite der Umfrage muss ein HTML-Formular enthalten, das jeweils auf die nächste Seite zeigt (Attribut action des form-Tags):
Die hidden-Parameter umfragenid und teilnehmerid sind obligatorisch. Setzen Sie umfragenid auf die jeweilige umfragenid Ihrer Umfrage aus dem Datenbankinterface: Eine neue teilnehmerid erzeugen Sie auf der ersten Seite mit der Funktion ErzeugeTeilnehmer(umfragenid): Auf den folgenden Seiten ist die teilnehmerid dann bereits bekannt: Zum Einbinden der Fragen gibt es eine Reihe von Hilfsfunktionen, die alle die fragenid der jeweiligen Frage als Parameter benötigen und Eingabefelder für die Fragen automatisch erzeugen: Fragen mit mehreren festen Antworten: -Frageselect: Auswahl der Antwort über Dropdown. Über die optionalen Properties selectdefaultvalue und selectdefautoption kann eine zusätzliche Auswahlmöglichkeit an den Anfang gestellt werden. selectdefautoption ist der Text im Auswahlfeld und selectdefaultvalue der zugehörige Antwortwert (leere Antwort wenn nicht definiert). -Fragehoch: Eine Tabellenzeile für die Frage. Pro Antwort eine Tabellenzeile mit zwei Spalten (Antwort, checkbox bzw. radio-Button). Die HTML-Tabelle muss von Ihnen geöffnet und geschlossen werden. -Fragequer: Pro Antwort eine Tabellenspalte (checkbox bzw. radio-Button). Macht Sinn wenn mehrere Fragen mit den gleichen Antwortmöglichkeiten gestellt werden. Die HTML-Tabelle muss von Ihnen geöffnet und geschlossen werden und es ist eine Tabellenzeile zur Erklärung der Antwortmöglichkeiten notwendig. Ja/Nein-Fragen: -Fragecheckbox: Eine Tabellenzeile mit einer checkbox und der Frage. Die HTML-Tabelle muss von Ihnen geöffnet und geschlossen werden. -Fragecheckboxchecked: Wie Fragecheckbox - allerdings ist die checkbox standardmäßig aktiviert. Freie Fragen: -Fragefrei: Frage und anschließende Textarea für die Antwort. Wenn Änderungen am von den Hilfsfunktionen generierten HTML-Code notwendig sind, empfehlen wir die betroffene Hilfsfunktion in das Verzeichnis der Umfrage zu kopieren und dort zu verändern. Die Hilfsfunktion HoleAntwort(fragenid) liefert die Antwort zu einer bereits beantworteten Frage und kann verwendet werden, um Umfragen in Abhängigkeit von den Antworten zu variieren. Wenn die Hilfsfunktionen für die Erzeugung einer Frage nicht geeignet sind, kann diese auch per Hand "programmiert" werden. Es wird pro Frage ein hidden-Parameter vorhanden_ mit dem Wert "Ja" und der Parameter antwort_ mit der Antwort benötigt. Ab der zweiten Seite muss folgendes Grundgerüst verwendet werden, um die Antworten zu speichern bevor es weiter geht: Hier geht es weiter... Sollte beim Speichern der Antworten ein Fehler auftreten (z.B. Pflichtfeld nicht ausgefüllt), so wird eine entsprechende Fehlermeldung angezeigt (""). 3. Auswertung Unter http://Servername/Umfragen/Auswertung/1 können die Umfrageergebnisse ausgewertet und ins Format Text mit Tabs exportiert werden. Der Zugang ist nur für Zope-Nutzer nach Anmeldung möglich.