Dies ist eine alte Version des Dokuments!
void pageStop()
Die Funktion verhindert, dass weitere Inhalte der Fragebogen-Seite angezeigt bzw. ausgeführt werden.
Wenn innerhalb eines PHP-Code Elements im Fragebogen noch weitere Befehl folgen, so unterbindet pageStop()
auch deren Ausführung.
Im folgenden Beispiel wird pageStop()
im Zusammenspiel mit einem Screen-Out Filter verwendet. So können auf der Screen-Out Seite noch weitere Inhalte (z.B. Fragen) platziert werden.
Der Filter zeigt Personen, die bei Frage SK01 mit dem Wert 1 (jünger als 18) oder 7 (älter als 65) geantwortet haben, den Textbaustein „screenout“ und blendet den Weiter- und Zurück-Knopf aus, sodass das Interview faktisch beendet wird.
Unter diesem PHP-Code können weitere Elemente (Fragen, PHP-Code, …) auf der Seite platziert werden, auch per „Hineinziehen“ (Drag & Drop) in die Fragebogen-Seite. Diese Elemente werden den abgewiesenen Teilnehmer dank pageStop()
nicht mehr angezeigt.
if ((value('SK01') == 1) or (value('SK01') == 7)) { text('screenout'); buttonHide(); pageStop(); }
Ohne pageStop()
müsste man die weiteren Element in den Filter aufnehmen…
if ((value('SK01') == 1) or (value('SK01') == 7)) { text('screenout'); buttonHide(); } else { question('AB01'); question('AB02'); }
… oder man würde die Inhalte auf eine zusätzliche Seite (nach der aktuellen) legen, sodass auf der Seite keine Inhalte mehr folgen.
if ((value('SK01') == 1) or (value('SK01') == 7)) { text('screenout'); buttonHide(); } else { goToPage('next'); }