This article covers these topics:

Introduction to response arrays

Response arrays are used to store answers to any number of questions in one single variable. The most common use of a response array is to script favourites, a diary functionality where respondents can complete an entry by simply "playing back" a previously stored entry.

Functions

The available functions for response arrays are described below:

Function

Description

recordanswers(var, [start_question],[end_question])

Saves the answer(s) from the start question to the end question into the entry.

recordanswers(var): Saves all answers currently set in the survey in the variable var (including local variables).
recordanswers(var, Q1): Saves the answer of the specified question in the variable var. If var already contains Q1 answers those are replaced, otherwise appended.
recordanswers(var, Q1, Q5): Saves all answers in the range specified, including Q1 and Q5, in variable var. If var already contains answer from Q1 to Q5 those are replaced, otherwise appended.

Note 1: It only saves questions that actually have an answer, so if you run this function on the first question in the survey it will only record the first question, since no other answers have been set in the survey.

Note 2: both Alias and question ID can be used to reference start_question and end_question.

playanswers(var)

Loads entry saved in the specified variable and runs setans() on all the questions found in the entry.

deleteanswers(var,[question])

Deletes the answer from the saved entry.

deleteanswers(var) - Deletes the whole record.
deleteanswers(var, Q1) - Deletes the answer of the specified question from an old record if available.

Note: both Alias and question ID can be used to reference the question.

Example

You can find an example of this functionality in the survey "FavoriteExample.zip" below; import the survey and run through it. You will notice in Q1, the first day of this diary, the respondent can answer all question for each meal, which then will change that meal choice from "Meal" to "My usual Meal" which will run the "playanswers" function and skip the recorded questions.

</question>

That worked, because the script has recorded the answers in Q5 (for Q2 -and - Q3):

</question>

FavoriteExample.zip
1 KB Download

Articles in this section

Response array (favorites)

Introduction to response arrays

Functions

Example

Articles in this section

Introduction to response arrays

Functions

Example

Related articles