Referencing
You can "quote" a block by its REF. By default, REF is 'Q' + block position. You can rename this REF in the header of each block.
Answers to questions, items and zones also have a REF, but this one is uneditable. This REF is 'F' for field, 'I' for item, 'A' for answer and 'Z' for zone + position.
This function is used to quote answers to closed questions (simple type), to battery of items, open questions and hotspot zones.
This referencing system can be used to refer to previous user responses as well as the texts associated with those responses. It facilitates content personalization and tracking the respondent’s journey throughout the questionnaire.
If a reference answer is a freeField, the entered value will be returned.
Usage
Quoting answers is used in question labels and transitions but also answers to questions, items or zones.
Loop support
The referencing system also supports loops with LOOPXXX
syntax. All refs and VAR_X
variables can be used within loop contexts to dynamically reference content based on loop iterations.
Syntax
Basic referencing
[Q1]
- Quote all answers to Q1 question, separated by a comma[Q2.I1]
- Quote answers to Q2 first item, separated by a comma[Q3.Z4]
- Quote the answer to Q3 fourth zone[Q7.A001]
- Quote the first respondent answer to Q7 question[Q2.I2.TEXT]
- Quote the label of item n°2 (the one with REF I2)
[Q5.A003]
refers to the third answer that the respondent has ticked, not the third in chronological order.
Question types
Profile question
[Q1]
- Returns all answers of the user separated by a comma ("Answer 1, Answer 2, Answer 3")[Q1.A002]
- Returns only the second answer of the user (e.g "Answer 2"), IF ANY[Q1.A3]
- Returns only the value of the answer A3 (e.g "Answer 3"), ONLY IF SELECTED BY THE USER[Q1.TEXT]
- Returns the text of a question[Q1.A1.TEXT]
- Returns the text of an answer
Battery of items
[Q2.I1]
- Returns all answers separated by a comma for Item 1 ("Answer 1, Answer 2, Answer 3")[Q2.I2.A002]
- Returns only the second answer of the user for Item 2 (e.g "Answer 2"), IF ANY[Q2.I4.A3]
- Returns only the value of the answer A3 at Item 4 (e.g "Answer 3"), ONLY IF SELECTED BY THE USER[Q2.TEXT]
- Returns the text of the main question of the battery[Q2.I1.TEXT]
- Returns the text of an item[Q2.A1.TEXT]
- Returns the text of thane answer
Hotspot
[Q3.Z1]
- Returns the answer for a zone (hotspot can only have 1 answer)[Q3.Z2.A001]
- Returns only the first answer of the user for Zone 2 (e.g "Answer 2"), IF ANY[Q3.Z4.A3]
- Returns only the value of the answer A3 at Zone 4 (e.g "Answer 3"), ONLY IF SELECTED BY THE USER[Q3.TEXT]
- Returns the text of the main question of the hotspot[Q3.Z1.TEXT]
- Returns the text (name) of a zone[Q3.A1.TEXT]
- Returns the text of an answer
Open question
[Q4.TEXT]
- Returns the text of the main question[Q4.F1]
- Returns the answer for a field (e.g "field value 1")[Q4.F1.TEXT]
- Returns the text of a field (e.g "Name")
Adaptive
[Q5]
- Returns the answer of the adaptive question (e.g "My name is John")[Q5.TEXT]
- Returns the text of the adaptive question (e.g "What is your name?")
Loop references
[LOOP1.Q1.TEXT]
- Returns the text of a the Q1 question inside the first iteration of the loop.LOOP1.VAR_1
- Use variables within loops for dynamic referencing
Global variables
[VAR_1]
- Returns the first global variable
URL parameters
[PARAM_ID]
- Returns the value of the 'id' parameter[PARAM_LANG]
- Returns the value of the 'lang' parameter
Examples
Thank you [Q1.F1] for participating in our survey, can you tell us what is your favorite color?
Your favorite color is [Q2.A001], can you rate those items?.
You rated item 1 with a score of [Q3.I1].