setNextPage()

void setNextPage(string SeitenKennung)

Die Funktion setNextPage() legt fest, welche Seite nach dem Klick auf „Weiter“ angezeigt werden soll. Mit setNextPage('end') werden nachfolgende Seiten nicht mehr angezeigt, sondern das Interview nach dem „Weiter“ beendet.

SeitenKennung
Kennung der Fragebogen-Seite zu der gesprungen werden soll. Dies kann die Kennung einer Seite im Fragebogen sein oder eine der Spezialkennungen 'end', 'next' oder 'repeat'.
- <SeitenKennung> – Weiter mit einer bestimmten Seite im Fragebogen
- 'end' – Beendet die Befragung
- 'next' – Fährt mit der folgenden Seite fort (Standard)
- 'repeat' – Wiederholt die aktuelle Seite

Hinweise

Diese Funktion ist vor allem dann hilfreich, wenn ein Filter nicht direkt nach der Filterfrage greift. Dann kann der Filter (der ja nicht auf derselben Seite stehen kann wie die Filterfrage) auf einer Zwischenseite platziert werden. Ein Vorteil dabei ist, dass die Bearbeitungszeit der nachfolgenden Seite in der TIMEnnn-Variable (Zusätzliche Variablen in der Datenausgabe) für die entsprechende Seite abgelegt wird – was bei goToPage() nicht gewährleistet ist.

Hinweis: Wenn Sie eine Seite mehrfach (in einer Schleife) anzeigen möchten, dann verwenden Sie anstatt setNextPage() vorzugsweise die Funktion loopPage().

Hinweis: Verwenden Sie setNextPage() nicht, um eine Seite erneut anzuzeigen, weil der Teilnehmer fehlerhafte Angaben gemacht hat (Antwort prüfen: Individuelle Antwort-Prüfung). Verwenden Sie für diesen Zweck die Funktion repeatPage().

Tipp: Falls der Teilnehmer Seiten im Fragebogen überspringen soll, ist die Funktion goToPage() in aller Regel einfacher einzusetzen.

Tipp: Mit der Funktion setPageOrder() kann nicht nur die folgende Seite, sondern auch gleich der weitere Seiten-Verlauf festgelegt werden.

Beispiel

Das folgende Beispiel geht davon aus, dass auf Seite 2 des Fragebogens die Filterfrage „AB01“ gestellt wurde. Der folgende PHP-Code auf Seite 4 sorgt dafür, dass Teilnehmer, welche die erste Antwortoption ausgewählt haben, die Seiten 5 bis 7 überspringen und erst auf Seite 8 (Kennung „tv_use“) fortsetzen.

if (value('AB01') == 1) {
  setNextPage('tv_use');
}