Dies ist eine alte Version des Dokuments!
value()
mixed value(string Variable, [string Ausgabeformat])
Mit dieser Funktionen können Antworten (Antwort-Codes, ausgewählte Optionen oder Texteingaben) des Teilnehmers ermittelt werden.
Wichtig: Es können nur solche Antworten abgefragt werden, welche der Teilnehmer auf einer früheren Fragebogen-Seite angegeben und bereits mit „Weiter“ an den Server übermittelt hat.
Variable
Kennung der Variable, die ausgelesen werden soll. Die korrekte Kennung finden Sie in der Variablen-Übersicht.
Die Variablen-Kennung setzt sich meist (nicht immer) aus Rubriken-, Fragen- und ggf. Item-Kennung zusammen und muss als String (also in Anführungszeichen) angegeben werden (z.B. 'XY01_02
').
Neben den Variablen von Fragen sind auch folgende Variablen verfügbar: CASE, MISSING, SERIAL, REF, QUESTNNR, MODE, LANGUAGE und STARTED
Ausgabeformat
Mit dem Ausgabeformat wird festgelegt, ob die Funktion den Antwort-Code (Standard) oder den Beschriftungstext der Antwort zurückgibt. Folgende Angaben sind möglich:
'code'
Standard-Format für value()
: Antwortcode entsprechend der Variablen-Übersicht (wird auch zurückgegeben, wenn kein Antwortformat angegeben ist), bei Texteingabe-Fragen der eingegebene Text.
'label'
Beschriftung des Antwortcodes (Auswahlfragen: Option, Mehrfachauswahl: „nicht ausgewählt“ oder „ausgewählt“, Skalen: Wertelabel)
'text'
Beschriftung der Antwortoption wie im Fragebogen (Auswahlfrage: gewählte Option, Mehrfachauswahl: Text der Option, falls ausgewählt, sonst nichts)
'free'
Falls Sie eine Auswahl mit offenem Texteingabefeld erlauben, liefert diese Option den Text der gewählten Option oder die offene Texteingabe, wenn eine solche gemacht wurde.
'csv'
Teilt die Beschriftung anhand von Kommata (CSV) und liefert ein Array zurück. Dies kann in Kombination mit einem Zufallsgenerator für mehrfaktorielle experimentelle Designs verwendet werden (
Randomisierung).
Anwendung in Filtern
Tipp: Siehe auch Filterfragen und Filter.
Der Befragte hat die Frage 07
in der Rubrik AB
(eine dichotome Skala) auf der vorhergehenden Seite beantwortet. Folgender Code zeigt fragt die Frage XY01
nur dann ab, wenn der Teilnehmer das Item 03
der Frage AB07
mit „ja“ (in diesem Fall also der Ausprägung 2) beantwortet hat:
if (value('AB07_03') == 2) {
question('XY01');
}
Anzeige der eigenen Antwort
Der Teilnehmer kann sein Lieblings-Schulfach auswählen oder bei „Anderes:“ selbst eintragen. Das Fach soll auf einer späteren Seite angezeigt werden.
Tipp: Siehe auch Platzhalter und Antworten in einer Folgefrage anzeigen.
$fach = value('AB08', 'free');
html('<h1>Schulfach: '.$fach.'</h1>');