SoSci Survey
Translations of this page:


mixed value(string variable, [string outputformat])

The participant's responses (answer codes, selected options or text inputs) can be determined with this function.

Note: Only responses given by the participant on an earlier page in the questionnaire, and already transmitted to the server with “Next” can be called up.

  • variable
    ID of the variable to be read. The correct ID can always be found in the Variables Overview. The variable ID is usually (not always) composed of section, question and, if applicable, item ID and must be given as a string (in quotation marks) (e.g. 'XY01_02').
  • outputformat
    The output format determines whether the function returns the answer code (default) or the label text of the response. The following entries are allowed:
    • 'code'
      Default format for value(): answer code according to the Variables Overview (also returned if no answer format is specified), for text input questions this is the text entered.
    • 'label'
      Answer code label (selection questions: option, multiple-choice selection: “not selected” or “selected”, scales: value label).
    • 'text'
      Answer option label as in questionnaire (selection question: selected option, multiple-choice selection: option text if selected, nothing else).
    • 'free'
      If you allow a selection with a free text input field, this option displays the text of the selected option or the free text input, if one of these was done.

Application in Filters

Tip: Please also see Filters and Conditional Questions.

The respondent answered question 07 in section AB (a dichotomous scale) on the previous page. The following code only calls up question XY01 if the participant answered “yes” (in this example with the value 2) to the item 03 in question AB07:

if (value('AB07_03') == 2) {

Display Individual Response

The participant can select their favorite school subject or write it in themselves in “other:”. The subject should be displayed on a later page.

Tip: Please also see Placeholders.

$subject = value('AB08', 'free');
html('<h1>School subject: '.$subject.'</h1>');
en/create/functions/value.txt · Last modified: 21.12.2014 11:45 by alexander.ritter
Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
Driven by DokuWiki