Skip to content

Home

Jump to bottom
Nick Ruggieri edited this page Jan 14, 2020 · 118 revisions

Welcome to the quest wiki!


QUEST – Questionnaire App – Documentation v0.1 12-13-19

Default Settings

  1. The following response codes correspond with the following options:
    a. 77 = Don’t Know
    b. 88 = NA
    c. 99 = Prefer not to answer
    The length of these response codes is increased as needed to avoid confusion with codes for other possible responses or the limits for integer responses. For example, if there are 10 other response categories, 777 = Don’t know. If age is requested as an integer and the maximum age allowed is 150, then 7777 = Don’t know.

  2. #YN following a question indicates binary, 0 = No, 1 = Yes, response options.

  3. #YNP following a question indicates 0 = No, 1 = Yes, 99 = Prefer not to answer, response options.

  4. [XX#CLEAR] preceding a response, where XX is a number code such as 99, indicates that if selected all other previously selected responses will be cleared.

Syntax

Text or question

[TEXT], [TEXT#] – Brackets enclosing all upper-case text indicates the beginning of a text section (e.g. background information, directions) or a question. Numbers and underscores may be included, but there can be no spaces (e.g. A1, BQBCK_AGE_V1R0, INTRO). Text sections that are followed by response options will be read by the QUEST app as questions. Text included in the brackets will be used as the name for that question should it be referred to in other questions (i.e. for applying skip logic or piping an answer given for one question into the text of another question) and for the variable name for that question in the output. Text sections may contain spaces between paragraphs. A new text section or question will not be created until indicated as described above.

Answer required

[TEXT!], [TEXT#!] - An ! following the text between brackets indicating a question is used when that question must be answered in order for the participant to move on to the next question. Also referred to as a hard edit.

Answer prompt

[TEXT?], [TEXT#?] - A ? following the text between brackets indicating a question is used if a prompt to answer the question, should the participant skip, is wanted. Also referred to as a soft edit. The participant will still be allowed to move on to the next question even if the current question is unanswered.

Skip logic

-> TEXT – Skip logic is indicated with an arrow after the response variable to which the skip logic is applied. The text following the arrow is the name of the question displayed if the indicated response variable is selected.

Piped response

{$QUESTION_NAME} – To pipe a response from one question (e.g. A1) into the text of another question (e.g. A2) insert the name of the first question in prentices (e.g. (A1)) into the text of the other question (e.g. A2) where the response should appear.

Categorical responses

Select one

(#) - Parenthesis preceding response options indicate that only one option may be selected. This is also referred to as a radio button.

Select many

[#], [Text], [Text#] – Brackets preceding response options indicate multiple options may be selected (i.e. Select All That Apply questions). Numbers, text, and underscores may be used in between the brackets in any combination as long as it’s a single string. Strings included between brackets will be used as the variable name for the output indicating selection of individual response options. Selection of an option will be recorded as a binary (1 = Selected, 0 = Not Selected) in the output for that question. This is also referred to as a check box.

Categorical free text responses

[textbox: VARIABLE_NAME] – Added at the end of a response option will display a follow-up text box if that response option is selected (e.g. Other: Specify, None of these fully describe me: Please describe). The text box will only be displayed to the participant if that response option is selected. The variable name indicated will be the text response variable name in the output. Note, length of response is indeterminate unless otherwise specified.

Numeric and free text responses

Numeric

|_| - Pipe, underscore, pipe, indicates a numeric response. |x,y| indicates a numeric response with a specific range (e.g. |40, 70| = a range of 40-70).

Free text

|__| - Pipe, underscore, underscore, pipe, indicates a free text response that is limited to a single line. Note, length of line is indeterminate unless otherwise specified.
|___| - Pipe, underscore, underscore, underscore, pipe, indicates a free text response that may wrap around to multiple lines. Note, length of response is indeterminate unless otherwise specified. For all numeric and free text responses that are not part of a categorical response, the variable name for the response in the output is the same as the question name.

Example

[NAME] What is your name?
[FST_NAME] First name |__|
[LST_NAME] Last name |__|

[AGE] ${FST_NAME}, how old are you?
|_|

[OWNER] Do you own a pet?
#YN

[PETS] Select from below all the animals you think make good pets.  Select as many as apply.
[1] Dogs -> BREED
[2] Cats
[3] Fish
[4] Birds
[5] Other: Specify [textbox:otherpets]

[BREED] List your favorite breed of dog
|__|

[WALK] How many times per day should a dog be walked?
(1) Once per day
(2) Two times per day
(3) Three or more times per day
(4) Prefer not to answer

Colons can be used to align columns.

Tables Are Cool
col 3 is right-aligned $1600
col 2 is centered $12
zebra stripes are neat $1

Output for Sam Smith, a 38-year-old pet owner who selected Dogs, Fish, and Other, whose favorite breed of dog is a lab, and would prefer not to answer how many times per day a dog should be walked.

NAME FST_NAME LST_NAME AGE OWNER PETS 1 2 3 4 5 otherpets BREED WALK 1 Sam Smith 38 1 1 1 0 1 0 1 rabbits lab 99

Clone this wiki locally