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

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.

if(caseTime('hitherto') < 300) {
  setStatus('quality fail');
}
setStatus('complete');