| Nächste Überarbeitung | Vorhergehende Überarbeitung |
| de:create:functions:value [28.11.2014 11:24] – Ausgelagert aus functions-base admin | de:create:functions:value [01.06.2023 18:05] (aktuell) – [value()] admin |
|---|
| **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. | **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 immer 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'''). | * //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: | * //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. | * ''%%'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) | * ''%%'code:ifany'%%''\\ Wie ''%%'code'%%'', unterdrückt aber die Warnung (die für Befragte ohnehin nicht sichtbar ist), wenn für die Variable noch keine Antwort vorliegt. |
| * '''text'''\\ Beschriftung der Antwortoption wie im Fragebogen (Auswahlfrage: gewählte Option, Mehrfachauswahl: Text der Option, falls ausgewählt, sonst nichts) | * ''%%'label'%%''\\ Beschriftung des Antwortcodes (Auswahlfragen: Option, Mehrfachauswahl: "nicht ausgewählt" oder "ausgewählt", Skalen: Wertelabel) |
| * '''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. | * ''%%'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 ([[:de:create:randomization]]). |
| |
| | |
| | **Hinweis:** Die Funktion ''value()'' kann auch die Ziehung eines [[:de:create:questions:random|Zufallsgenerators]] auslesen. Dies ist bereits auf derselben Seite möglich, auf welcher der Zufallsgenerator platziert wurde, sofern der PHP-Code unterhalb des Zufallsgenerators steht. |
| | |
| | **Hinweis:** Die Verweildauer ("TIME001", "TIME002", ...) kann mittels ''value()'' nicht ausgelesen werden. Verwenden Sie dafür bitte die Funktion [[:de:create:functions:casetime]]. |
| |
| ===== Anwendung in Filtern ===== | ===== Anwendung in Filtern ===== |
| Der Teilnehmer kann sein Lieblings-Schulfach auswählen oder bei "Anderes:" selbst eintragen. Das Fach soll auf einer späteren Seite angezeigt werden. | 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 [[:de:create:placeholders|Platzhalter]]. | **Tipp:** Siehe auch [[:de:create:placeholders|Platzhalter]] und [[:de:create:transfer-responses]]. |
| |
| <code php> | <code php> |
