Profi-Editor

Struktur

EFS verwendet für das Systemlayout ein sogenanntes Template-System. Ein Template ist eine HTML-Datei mit eingeschobenen Platzhaltern. Über diese Platzhalter wird die „Business-Logik“ in die HTML-Seite gebracht, zum Beispiel notwendiger HTML-Code in eine Ausgabeseite geprinted, die EFS für die Verarbeitung der Plausichecks benötigt. Sie können den HTML-Code bis auf wenige Ausnahmen frei umstrukturieren, dazu später mehr. Die Templates eines Projekts können im Menü unter Profi-Editor auf der Registerkarte Struktur angepasst werden. Folgende Informationen sind in der Übersichtstabelle zu finden:

• Zu jedem Template werden neben dem Titel auch Dateiname, Größe, Datum der letzten Änderung und Bearbeiter angegeben.

• Mit der Suchfunktion können Sie nicht nur Template-Name und Dateiname, sondern auch Template-Inhalt und Kommentare erfassen.

• Sie können sich Notizen zu einzelnen Templates machen: Mit einem Klick auf das Edit-Icon können Sie ein Popup-Fenster mit einem Kommentarfeld öffnen, Ihre Anmerkung eingeben und abspeichern.

Sie können den Bereich außerhalb des eigentlichen Fragebogenformulars frei gestalten. Sie können die Rahmentabelle um Fragen, um Antworten und um das komplette Fragebogenformular frei gestalten. Sie können Frage- und Ausfüllanweisung frei gestalten. Auf die Antwortblöcke haben Sie im Allgemeinen keinen Einfluss.

Templates bearbeiten

Sie haben die folgenden Möglichkeiten zum Bearbeiten oder Neuanlegen von Templates:

• Mit einem Klick auf den Titel können Sie ein Template öffnen und den Inhalt bearbeiten.

• Wenn Sie den Platzhalter {debug} in ein Template einfügen (z.B. main.tpl), speichern und dann eine Fragebogenseite aufrufen, werden die  zur Verfügung stehenden Variablen in einem Popup-Fenster eingeblendet. Bitte beachten Sie, dass die üblichen Platzhalter von EFS in den Smarty-Templates nicht verwendet werden können.

• Ein neues Template anlegen können Sie mit Hilfe des Buttons Template anlegen.

• Bereits vorhandene Templates können mit einem Klick auf das Icon Kopieren dupliziert werden.

• Neu angelegte und duplizierte Templates können gelöscht werden, Systemtemplates dagegen nicht.

• Wenn Sie den Originalzustand, den ein Template beim Anlegen des Projekts hatte, wiederherstellen möchten, klicken Sie das Wiederherstellen-Icon in der Spalte „Funktionen“ an.

Eine Umfrageseite besteht aus einem Haupttemplate „main.tpl“, das alle Elemente auf einer Fragebogenseite positioniert. Einige Bestandteile sind der Übersichtlichkeit halber in separate Untertemplates ausgelagert:

• progressbar.tpl stellt die Fortschrittsanzeige dar

• questioncomplete.tpl stellt den Plausicheck-Text dar

• qtext.tpl formatiert Fragetext und Ausfüllanweisung

• question.tpl formatiert die Rahmentabelle um Fragen

• answer.tpl formatiert die Rahmentabelle um Antworten

Sondertemplates

Über die oben genannten Templates hinaus gibt es einige Sondertemplates mit Spezialaufgaben:

• login.tpl definiert das Login-Fenster bei passwortgeschützten Umfragen. Auf auf einer solchen Umfragevorschalt-Seite geben die zukünftigen Auskunftgeber ihre Zugangskennungen ein. Je nach gewähltem Zugangsschutz tragen die Umfrageteilnehmer E-Mail-Adresse, Passwort oder Code in vordefinierte Formulare ein.

• critical.tpl wird für Systemfehlermeldungen verwendet (z.B. „Umfrage ist nicht aktiviert“).

• helpwin.tpl formatiert das Hilfe-Popup-Fenster (die Texte für die Hilfe geben Sie im Editor zur jeweiligen Frage ein).

• Über errorwin.tpl lassen sich die Popups für JavaScript-Plausichecks gestalten.

• mixedextern.tpl ist eine Variante des Maintemplates main.tpl, das für gemischtexterne Seiten verwendet wird (in gemischt-externen Seiten lassen sich mit EFS angelegte Fragen wahlfrei auf dem Bildschirm anordnen).

Templates extern bearbeiten und wieder hochladen

Zur Weiterverwendung auf anderen EFS-Installationen oder zur lokalen Bearbeitung können Sie Templates exportieren. Dazu dient der Button Exportieren. Ebenso können Sie über den Button Importieren Templates von außen auf den Server hochladen, und zwar sowohl einzelne Templates als auch Zip-Dateien mit mehreren Templates.

Debugmodus

Die EFS-Layouts verwenden unsichtbare Tabellen, um Text auf einer Seite zu positionieren. Zur Fehlersuche ist es oft wünschenswert, die Begrenzungslinien der Tabellen kurzfristig sichtbar zu machen. Auf der Registerkarte Debugmodus können Sie die Tabellenränder für alle Betrachter der Umfrage aktivieren. Alternativ können Sie die Tabellenbegrenzungen auch nur für Teilnehmer mit einer speziellen IP sichtbar machen. Nehmen wir an, Ihr Projekt ist schon im Feld und Sie möchten kurzfristig daran etwas ändern. Natürlich möchten Sie nicht, dass Ihre Teilnehmer die Tabellenränder sehen, daher schränken Sie die Anzeige auf sich selbst ein.

Upload

Beim Gestalten des Layouts müssen häufig Dateien auf den Server geladen werden, gelegentlich auch in andere Verzeichnisse als das von der Medienbibliothek verwendete Verzeichnis /images. Dazu dient die Hochlade-Funktion Upload auf der gleichnamigen Registerkarte im Profi-Editor. Sie können damit auch Zip-Dateien hochladen, diese werden dann in dem von Ihnen gewünschten Verzeichnis entpackt.

• Die Dateigröße für Importvorgänge ist begrenzt. Überschreitet Ihre Datei den installationsspezifische Grenzwert, wird eine entsprechende Warnmeldung ausgegeben.

Neue Dateien hochladen

So laden Sie eine neue Datei hoch:

• Wählen Sie den Zeichensatz.

• Wählen Sie das Zielverzeichnis

• Suchen Sie die gewünschte Datei auf der Festplatte.

• Bestätigen Sie mit Datei uploaden.

Upload-Verzeichnisse

Platzhalter

Auf der Registerkarte Platzhalter können Sie unaufwendig dynamische Inhalte für jede Fragebogenseite außerhalb des eigentlichen Fragebogens definieren. Sie können dieses Feature zum Beispiel verwenden, um Ihre Umfrage in Themenblöcke zu gliedern und diese Gliederung im Layout zu visualisieren. Gehen Sie dazu folgendermaßen vor:

• Klicken Sie auf die Registerkarte Platzhalter.

• Klicken Sie auf den Seitentitel der ersten Seite Ihres Projektes.

• Sie sehen ein Formular, in dem Sie für diese Seite bis zu fünf Platzhalter einfügen können. Schreiben Sie in das Feld für Text 1 beliebigen Text, zum Beispiel „Fragen zur Demografie“

• Klicken Sie auf Änderungen speichern.

• Wiederholen Sie die Schritte 1 bis 4 für eine oder zwei weitere Seiten.

Jetzt teilen Sie dem Layout mit, an welcher Stelle Sie die definierten Platzhalter verwenden möchten:

• Wechseln Sie zur Registerkarte Struktur.

• Editieren Sie beispielsweise das Template main.tpl, um die Platzhalter in der allgemeinen Seitenstrukturdatei zu platzieren.

• Fügen Sie an beliebiger Stelle auf der Seite die Systemvariable {$r_text1} ein.

• Sehen Sie sich das Projekt in der Vorschau an: Sie werden feststellen, dass {$r_text1} durch den entsprechenden Text aus der Datenbank ersetzt wurde.

• Umgeben Sie den Platzhalter mit HTML-Code, so dass Sie die gewünschte Optik erzielen.

Fortschrittsanzeige

Die standardmäßig aktivierte automatische Fortschrittsanzeige errechnet einen Schätzwert für die noch zu erwartende Fragebogenlänge. Dieses Verfahren hat zwei Nachteile:

• Es handelt sich um einen Schätzalgorithmus, da eine exakte Vorhersage des Fragebogenverlaufs für den einzelnen Probanden üblicherweise nicht möglich ist.

• Die automatische Berechnung wertet sämtliche Fragebogenseiten aus. In der Praxis wird allerdings oft die Option gewünscht, die Anfangsseiten (beispielsweise mit Begrüßung, Einführung in das Thema oder Sprachauswahlfrage) von der Zählung auszunehmen.

Deshalb können Sie alternativ das automatische Berechnen deaktivieren und für jede Seite einen Wert festlegen, den die Fortschrittsanzeige annehmen soll.

Algorithmus der Fortschrittsanzeige

Zu dem Zeitpunkt, zu dem ein Teilnehmer mit der Bearbeitung eines Fragebogens beginnt, ist üblicherweise noch nicht vorhersagbar, wie viele Fragebogenseiten und welche Seiten genau er wirklich sehen wird. Dazu müsste man vorab wissen, welche Filterzweige der Teilnehmer passieren wird, die Filterung ist jedoch meist von erst während des Fragebogenverlaufs gegebenen Antworten abhängig. Die Werte der Fortschrittsanzeige werden daher in EFS über einen Schätzalgorithmus berechnet, der sich im Verlauf des Fragebogens immer mehr der wirklichen Endlänge annähert. Dabei werden nicht vermeidbare Sprünge des Wertes, die beispielsweise durch Filter verursacht werden, möglichst gering gehalten.

Die Formel lautet:

Darin ist:

• Nenner (Seite x) = (Summe aller bisher tatsächlich gesendeten Seiten + 1) + (Summe aller nach Seite x noch zu erwartenden Seiten)

• Zähler (Seite x) = Anzahl aller bisher tatsächlich gesendeten Seiten

Der Fortschrittswert auf der ersten Seite des Fragebogens ist:

• Fortschrittswert (Seite 1) = 100 / Summe aller Seiten des Fragebogens

Der Fortschrittswert auf der letzten Seite ist:

• Fortschrittswert (Endseite) = 100

Texte und Werte der Fortschrittsanzeige manuell verändern

Die Fortschrittsanzeige ist üblicherweise bereits aktiviert. Ist dies nicht der Fall, können Sie die entsprechende Einstellung im Standard-Editor auf der Registerkarte Fortschrittsanzeige vornehmen. Wechseln Sie in den Profi-Editor und öffnen Sie dort die Registerkarte Fortschrittsanzeige. Deaktivieren Sie das Kontrollkästchen Fortschritt automatisch berechnen und bestätigen Sie mit Einstellungen speichern. Bei Projekten mit herkömmlichem Systemlayout: Die Fortschrittsanzeige ist üblicherweise deaktiviert. Aktiviert wird sie im Standard-Editor auf der Registerkarte Fortschrittsanzeige. Deaktivieren Sie das Kontrollkästchen Fortschritt automatisch berechnen und bestätigen Sie mit Einstellungen speichern. Klicken Sie dann auf den neu eingeblendeten Link Detaillierte Einstellungen.

• Sie legen zunächst fest, wie viele Seiten einem Teilnehmer im Durchschnitt angezeigt werden. Bei einem Projekt ohne Filter entspricht diese Zahl der Zahl der Umfrageseiten. Bei einem Projekt mit Filterung zählen Sie die Seiten, die jedem Teilnehmer angezeigt werden, addieren dazu das gerundete arithmetische Mittel aus den Summen der Filterstränge und tragen diesen Wert bei Gesamtzahl der Seiten ein.

• Nun können Sie für jede Seite indirekt einen Wert für die Fortschrittsanzeige festlegen: Geben Sie für eine einzelne Seite einfach an, die wievielte Seite sie jeweils aus Sicht des Teilnehmers ist.

• Wenn die Anfangsseiten des Projekts nicht berücksichtigt werden sollen, geben Sie für diese Seiten „0“ ein. Die Seiten werden dann von der Berechnung ausgenommen, und es wird darauf keine Fortschrittsanzeige angezeigt.

Fortschrittsanzeige modifizieren

Die Fortschrittsanzeige wird über das Template layout_progressbar.tpl ausgegeben. Im Detail arbeitet die Anzeige folgendermaßen:

• EFS prüft, ob zu dieser Seite ein userdefinierter Fortschrittsanzeigenwert ausgegeben werden soll, wenn nein, wird die Zahl der bereits gesehenen Seiten als Rechenwert verwendet.

• EFS berechnet den Prozentwert für die Seite und speichert ihn in der Systemvariablen „sys_progress“. „aria-valuemin“ und „aria-valuemax“ geben die Minimal- und Maximalwerte für die Fortschrittsanzeige an (aria-valuemin = 0, aria-valuemax: 100).

• Im Ausgabetemplate wird nun je nach Fortschrittsanzeigentyp „sys_progress“ als Breite für die Fortschrittsanzeige genommen.

• Der Meldungstext („Sie haben bereits n Prozent der Umfrage bearbeitet“) wird aus der Datenbank gelesen und der Prozentwert dynamisch eingesetzt.

Beispiel 1:

• Aktivieren Sie in einem Testprojekt die Fortschrittsanzeige über Standard-Editor → Fortschrittsanzeige.

• Wechseln Sie in den Profi-Editor → Struktur.

• Wählen Sie das Template „layout_progressbar.tpl“.