| |
de:create:functions:getvaluetext [10.12.2014 22:43] – angelegt admin | de:create:functions:getvaluetext [21.10.2020 21:22] (aktuell) – Neuer Parameter "Format" admin |
---|
====== getValueText() ====== | ====== getValueText() ====== |
| |
''string **getValueText**(string //Variable//, int //Antwortcode//)'' | ''string **getValueText**(string //Variable//, int //Antwortcode//, [string //Format//])'' |
| |
Die Funktion ''getValueText()'' liefert die verbale Antwort (Beschriftung) zu einem Antwortcode. Bei einer Auswahl-Frage ist dies der Text der entsprechenden Auswahloption (auch zu ermitteln via ''[[:de:create:functions:getitemtext|getItemtext()]]''). Bei der Skala wird die Beschriftung (verbale Verankerung) des entsprechenden Skalenpunkts zurückgegeben. | Die Funktion ''getValueText()'' liefert die verbale Antwort (Beschriftung) zu einem Antwortcode. Bei einer Auswahl-Frage ist dies der Text der entsprechenden Auswahloption (auch zu ermitteln via ''[[:de:create:functions:getitemtext|getItemtext()]]''). Bei der Skala wird die Beschriftung (verbale Verankerung) des entsprechenden Skalenpunkts zurückgegeben. |
* //Variable//\\ Kennung der Variable, zu welcher die Beschriftung ermittelt werden soll. | * //Variable//\\ Kennung der Variable, zu welcher die Beschriftung ermittelt werden soll. |
* //Antwortcode//\\ (Numerischer) Antwortcode, dessen verbales Pendant ermittelt werden soll. | * //Antwortcode//\\ (Numerischer) Antwortcode, dessen verbales Pendant ermittelt werden soll. |
| * //Format// (optional) |
| * ''%%'text'%%'' (Standard) Die Beschriftung wird so zurückgegeben, wie sie im Fragebogen erscheint, Platzhalter werden ersetzt. |
| * ''%%'label'%%'' Die Beschriftung wird so zurückgegeben, wie sie im Fragenkatalog gespeichert ist. |
| |
Falls für den //Antwortcode// keine Beschriftung vorliegt (z.B. für den Zwischenwert in einer Skala, bei welcher nur die Extrema beschriftet sind), wird der Antwortcode zurückgegeben. | Falls für den //Antwortcode// keine Beschriftung vorliegt (z.B. für den Zwischenwert in einer Skala, bei welcher nur die Extrema beschriftet sind), wird der Antwortcode zurückgegeben. |
| |
**Tipp:** Die Funktion ''[[:de:create:functions:value|value()]]'' liefert die verbale Repräsentation einer Antwort, wenn Sie als zweiten Parameter '''text''' angeben. | **Tipp:** Die Funktion ''[[:de:create:functions:value|value()]]'' liefert die verbale Repräsentation einer Antwort, wenn Sie als zweiten Parameter '''text''' angeben. |