====== setStatus() ======

Die Funktion ''setStatus()'' legt den Interview-Status fest und löst einen Panel-Redirect aus, falls im Fragebogen ein Element "Panel-Redirects" eingebunden wurde oder wenn mittels ''%%option('redirect.*', ...)%%'' ein geeigneter Redirect vorgegeben wurde.

Standardmäßig beendet der Aufruf von ''setStatus()'' mit ''%%'quota full'%%'', ''%%'screenout'%%'' oder ''%%'quality fail'%%'' die Ausführung des aktuellen PHP-Codes.

''void **setStatus**(string //StatusCode//, [bool //Fortsetzen//])''

Der Parameter //StatusCode// muss als String mit einem der folgenden Wert übergeben werden.

  * //StatusCode//
    * ''%%'complete'%%'' -- Der Fall wird als vollständig betrachtet (Redirect Complete).
    * ''%%'quota count'%%'' -- Der Fall wird als vollständig betrachtet (Zählung für die Quotierung) aber es erfolgt (noch) kein Redirect.
    * ''%%'quota full'%%'' -- Die Quota-Gruppe ist bereits voll, die Teilnehmer:in wird abgewiesen (Redirect Quota Full).
    * ''%%'screenout'%%'' -- Die Person erfüllt nicht die Teilnahmevoraussetzungen (Redirect Screenout).
    * ''%%'quality fail'%%'' -- Der Datensatz wurde als ungültig identifiziert (Redirect Quality Fail).
  * //Fortsetzen// -- Wird hier ''true'' angegeben, so beendet der Aufruf mit ''%%'quota full'%%'', ''%%'screenout'%%'' oder ''%%'quality fail'%%'' __nicht__ die Ausführung des aktuellen PHP-Codes.

Der Interview-Status wird im Datensatz als Variable STATUS ausgegeben. Falls mehrere Stati für das Interview gespeichert wurden, wird der erste in der folgenden Reihenfolge ausgegeben.

  * quality fail
  * screenout
  * quota full
  * complete
  * quota count


==== Quality Fail bei schnellem Ausfüllen ====

Der folgende Beispiel-Code für die letzte Fragebogen-Seite markiert den Fragebogen als "quality fail", falls die Befragte sich weniger als 300 Sekunden (5 Minuten) Zeit zum Ausfüllen genommen hat. Ansonsten wird der Fall als "complete" gewertet.

<code php>
if(caseTime('hitherto') < 300) {
  setStatus('quality fail');
}
setStatus('complete');
</code>