====== 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'''.
    * <[[:de:glossary#seitenkennung|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 ([[:de:results:variables|Zusätzliche Variablen in der Datenausgabe]]) für die entsprechende Seite abgelegt wird -- was bei ''[[:de:create:functions:gotopage|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 ''[[:de:create:functions:looppage|loopPage()]]''.

**Hinweis:** Verwenden Sie ''setNextPage()'' __nicht__, um eine Seite erneut anzuzeigen, weil der Teilnehmer fehlerhafte Angaben gemacht hat ([[:de:create:checks#individuelle_antwort-pruefung|Antwort prüfen: Individuelle Antwort-Prüfung]]). Verwenden Sie für diesen Zweck die Funktion ''[[:de:create:functions:repeatpage|repeatPage()]]''.

**Tipp:** Falls der Teilnehmer Seiten im Fragebogen überspringen soll, ist die Funktion ''[[:de:create:functions:gotopage|goToPage()]]'' in aller Regel einfacher einzusetzen.

**Tipp:** Mit der Funktion ''[[:de:create:functions:setpageorder|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.

<code php>
if (value('AB01') == 1) {
  setNextPage('tv_use');
}
</code>