SurveyToGo Studio Manual

Overview

SurveyToGo fully supports scripting and usage of entrance rules (Skip Rules).
From the simplest ones, to the most complicated.

An entrance rule is a script that runs before a question is entered and decides whether this question will be asked or skipped.
If the script is valid, the question will be asked, if not, it would skip it.

Write your Entrance Rule.

You can find the entrance rule text box in each questions ‘Rules’ tab:

Now we can add an entrance rule as we wish.
For example:

This rule, will show the specific question, only if the answer of question 5 is answer 2.

You can add much more complicated rules and even use functions.
Further more, you can use the ‘Create Rule’ Wizard, however, it is more limited then writing your script on your own.

That’s it!

Visit us at: http://www.dooblo.net

Overview

One of today’s most popular model’s for selecting random respondents from a group – is the Kish Grid.
This ‘How-To’ will show you in a few simple steps how to implement you own Kish Grid on SurveyToGo.

Step 1: Organizing the Structure of the Kish Grid.

Step 2: Entering Scripts & Configuration.

Download the Kish Grid Demo Survey:
Download Kish Grid Demo Survey

And here is a an explanation of how to import it to your SurveyToGo Studio.
How To: Import A Survey

Step1: Organizing the Structure of the Kish Grid.

Basically, this is the structure you would need to implement:
Please follow this structure in terms of ‘Question Type: Body Text’.

1. Chapter 1: “Kish Template”
   1. Single Choice Question: “Kish Grid”
2. Chapter 2: “Main Survey”
   1. Numeric Question: “How many adults aged between 18 and above who are living here at the moment?”
   2. Empty Question: “Firstly, I need to decide whom I should interview from this household. Can you give me the first names and ages of all the adults aged between 18 and above who are living here at the moment?”
   3. Chapter 3: “Adults Details”
      1. Free Text Question: “@_@ITERNAME@_@ Adult name”
      2. Numeric Question: “{0}’s Age:”
   4. Chapter 4: “Kish Calculation”
      1. Expression Question: “Dummy: Selected adult Index based on Kish Grid”
   5. Chapter 5: “Continue”
      1. Empty Question: “The selected adult is {0}”

         (Continue your survey…)
         

Step 2: Entering Scripts & Configuration.

Now let’s go question by question, configure it and enter its scripts:

Question 1 – Single Choice:

1. Answers:
   1,1,1,1,1,1,1,1,1,1
   2,1,2,1,2,1,2,1,2,2
   1,2,3,1,2,3,1,2,3,1
   1,2,3,4,1,2,3,4,1,2
   4,5,1,2,3,4,5,1,2,3
   4,5,6,1,2,3,4,5,3,1
   3,4,5,6,7,1,2,3,4,5
   3,4,5,6,7,8,1,2,3,4
   2,3,4,5,6,7,8,9,1,2
   1,2,3,4,5,6,7,8,9,1
2. Scripts:
   None

1. Configuration:
   Go to its Advanced tab and configure it to be hidden from the surveyor:
   

Question 2 – Numeric:

1. Scripts: None.

Question 3 – Empty Text:

1. Scripts: None.

Chapter 3 – “Adult Details”

1. Go to ‘Edit Answer Scales’ in the Survey’s Root ‘Advanced Tab’ and create the following scale, as the picture shows:

   

• In case you are not familiar with ‘Answer Scales‘, you can find information about it in the following link:
  Answer Scales

1. After creating the scale, Go to the current chapter’s ‘Loops tab’ and configure it to iterate according to the scale we just created and enable the use entrance rule.

• In case you are not familiar with ‘Loops‘, you can find information about it in the following link:
  Programming Loops

1. Now add the following in the ‘Iteration Entrance Rule’ that is showing at the bottom of the ‘Loops’ tab:

   

• This rule will check each iteration index (Running index from 1 to the number of answers in ‘Number of Adults’ Answer Scale- as we configured it to iterate by scale) – if the iteration index is less or equal to the Answer of question 2 (number of adults we entered), enter the chapter, else – continue.
  What basically means, once the running index will be greater than the number of adults we entered, it would stop asking for the adults name’s and age.

Question 4 – Free Text:

1. Scripts: None.
   

Question 5 – Numeric:

1. Start Script:
   SetTextFormat(CurrQues,Answer(CurrQues-1));

• This script would pipe the Name of the adult entered in Question 4 into the place holder ‘{0}‘.
  
• In case you are not familiar with ‘Piping‘, you can find information about it in the following link:
  Piping Video Tutorial
  

1. End Script:
   

   
   if (IterationIndex == Answer(2))                     //line 1
   

   {
   

   var NumOfAdults = Answer(2);                    //line 2
   

   var kishLineString = AnswerText(1,NumOfAdults);        //line 3
   

   var kishLineArray = StringToIntArray(kishLineString);    //line 4
   

   var curInterviewID = DeviceIndex;                //line 5
   

   var lastDigitOfInterview =                     //line 6
   

   curInterviewID.ToString().substring(curInterviewID.ToString().length-1,curInterviewID.ToString().length);
   

   var kishIdx = kishLineArray[lastDigitOfInterview];    //line 7
   

   SetAnswer(6,kishIdx);                        //line 8
   

   }
   

   Code Description:
   Line 1: Create an if statement asking: “if the current iteration index is equal to the answer of question 2 -> please enter”

   Line 2: Variable Declaration: Number of adults is equal to the answer of question 2.

   Line 3: The Kish Grid format chosen according to the text of the answer in the index of ‘Number of Adults’:    e.g. (2,1,2,1,2,1,2,1,2,2 – would be for 2 adults.)

   Line 4: Turn the Kish Grid format we got from line 3 from a string to an integer array.

   Line 5: Get the interview ID according to the ‘Device Index’ which normally would be in this format: ‘NUMBER’-i    (i is a running index).
   

   Line 5: Get the last digit of the interview id and insert it into a variable called “lastDigitOfInterview”.

   Line 7: Get the selected ID (adult) by choosing the number in the ‘lastDigitOfInterview’ place in the Kish Grid Array.

   Line 8: Set our Expression (Question 6) with the ID we chose.

Chapter 4 – “Kish Calculation”

1. Scripts: Inside the Expressions ‘Answers’ tab, you should enter the following script:
   return (Answer(CurrQues));

• This script will make the Expressions answer to be the ID that was chosen.

Chapter 5 – “Continue”

Question 7 – Empty Question

1. Please add the following Start Script:
   SetTextFormat(CurrQues,AnswerIter(4,Answer(6)).ToString());

• This script would pipe the name of the chosen adult into the place holder ‘{0}’.

That’s it!

Download the Kish Grid Demo Survey:
Download Kish Grid Demo Survey

Visit us at: http://www.dooblo.net

Overview

Both on the PC surveyor and on Android devices you can show pictures as answers.

First of all you need to go to the Answer Tab, choose an answer, click the Answer Properties and choose Image Properties:

Then choose to add an image and choose an image of your choice:

Under the Appearance tab you are able to configure the alignment of the text and the picture.
Eventually it will look like this:

That’s it!

Visit us at: http://www.dooblo.net

Overview

If you wish to assign your surveyors to different surveys and projects, this is document will show you how.

SurveyToGo is configured by default to assign all surveys to the surveyors in the current project, but this can be changed in order to help you manage your organization better.

• First of all, we can see in the following picture a situation where we have different surveyors assigned to two different projects.
  Currently by default, each surveyor is assigned to all the surveys within his project.

  

• Now, if we right click one of the surveys and choose the ‘settings’ button, we will see the following window.
  In this window we should tick the ‘Non Default Assignments’ checkbox, so a survey will not be assigned by default to all surveyors within the project.

  

• After doing this, we will notice that the survey became expandable and now we have an option to assign or remove surveyors from the specific survey.
  

That’s it.

Visit us at: http://www.dooblo.net

Overview

When creating a multi-selection question, in most cases we will want to have an option such as:
“Other Specify”.

For example if we ask the respondent: “Which of the following brands are familiar to you?”

We would have to be ready for the scenario which the respondent is not familiar with the brands we mentioned, but is familiar with an-other type of brand.

Therefore, we should use the ‘Other Specify’ option.

How to add the ‘Other Specify’ option in Multi-Selection questions

• Create a Multi-Selection question and add answers
• Add an answer and call it ‘Other’ (Or whatever you wish)
• Then click the properties button as the following picture shows:

• The next window will pop up, you should check the ‘Other Specify’ check box.
  Then you will be able to choose the input type.
• If you wish this answer to be an exclusive answer, check the ‘Exclusive Answer’ checkbox.

That’s it!

This is how to add an ‘Other Specify’ answer to multi-selection questions.

Visit us at: http://www.dooblo.net

Overview

Adding multiple questions per page might come in hand in various different ways.

It comes in hand, if we want to gather a few questions regarding a product, a person, or anything you think of – in one page.

For example, let’s say our surveyor is interviewing people for very short interviews of 4 questions; it will be much more efficient to show all of the questions in one page per respondent than showing them in different pages, making it much more focused and efficient for the surveyor and for the respondent as well.

The following steps will instruct you how to add multiple questions per page:

Adding Multiple Questions Per Page

• Ok, first of all we will need to configure the maximum number of question in page through the ‘survey properties’:

• Now we can decide which question will start a new page:

• And in order to make the next questions show on the same page as the first one, we will need to uncheck the ‘Starts a new page’ box in the next questions.

• This will gather all of the next questions under the question which we checked as ‘Starts a new page’, as the following picture show’s:

Simple as that!
This is how to add multiple questions per page

Visit us at: http://www.dooblo.net

Overview

This will show you how to make an exclusive answer.

An exclusive answer is an option in Multi-Selection questions that you can configure one answer to be an exclusive one – this means that if this answer is chosen, none of the other can be chosen.

In order to do this you can follow the next steps as the picture shows:

Visit us at: http://www.dooblo.net

Overview

The following steps will introduce you to the ‘Filter Answer by Answers’ method which is built within our function libraries.

Using this function, you can filter a questions answers according to an-other question’s answers, making the questions answers adjust according to your needs.
For example, let’s say we have the following ‘Multi-Selection’ questions with the same scale of answers:

1. ‘Which of the following brands are familiar to you?’

2. ‘Which of the following brands did you purchase in the past year?’

3. ‘Which of the following brands did you purchase in the last month?’

We will need that answers which were not chosen in question 1 will not appear in question 2.
Answers which were not chosen in question 1 and question 2 will not appear in question 3.

Filtering Answers By Answers:
Let’s create a few multi-selection questions:

Just for this example, we can use the same answer scale in all of them:

Now we can choose the answers and configure them to be the only ones that will show on the next question:

By adding the following start script to the question we want to filter its answers:

FilterAnswersByAnswers(39, QRef(38));

The function will filter question 39′s answers by the answers that were chosen in question 38:

If we want to do the opposite – show answers that were NOT chosen, we can add the following start script to the question we want to filter its answers:

FilterAnswersByAnswers(39, false, QRef(38));

*Notice: Changing the value from false to true is the same like the default function we saw previously.

For example, the answers that are chosen in question 38:

Will be hidden in question 39:

That’s it! This is an introduction of how to use ‘Filter Answers By Answers’ function!

Visit us at: http://www.dooblo.net

Overview

In order to script correctly, calculate and use functions with our complex scripting engine – basic knowledge of programming operators is needed.
The following ‘How To’ will summarize all the common used operators syntax and their truth tables.

Logic Operators:

‘OR’ Operator:

The ‘OR’ operator is represented as ‘||’ in code and its truth table is the following:

‘NOT’ Operator:

The ‘NOT’ operator is represented as ‘ ! ‘ in code and its truth table is the following:

XOR’ Operator:

The ‘XOR’ operator is represented as ‘ ^ ‘ in code and its truth table is the following:

Mathematical Operators:

‘GREATER THAN’ Operator:

The ‘GREATER THAN’ operator is represented as ‘ > ‘ in code. (Return’s TRUE or FALSE)

‘GREATER THAN OR EQUALS TO’ Operator:

The ‘GREATER THAN OR EQUALS TO’ operator is represented as ‘ >=’ in code. (Return’s TRUE or FALSE)

‘SMALLER THAN’ Operator:

The ‘GREATER THAN’ operator is represented as ‘ < ‘ in code. (Return’s TRUE or FALSE)

‘SMALLER THAN OR EQUALS TO’ Operator:

The ‘GREATER THAN’ operator is represented as ‘ <= ‘ in code. (Return’s TRUE or FALSE)

The ‘EQUALS TO operator is represented as ‘ == ‘ in code. (Return’s TRUE or FALSE)
* Please note that using ‘=’ operator will assign the right value to the left and NOT check if they are equal.

‘NOT EQUALS TO’ Operator:

The ‘NOT EQUALS TO operator is represented as ‘ != ‘ in code. (Return’s TRUE or FALSE)

‘+’ is used for adding.

‘-’ is used for subtracting.

‘/’ is used for dividing. (Remnant is dismissed).

‘%’ is used for getting the remnant from dividing by ‘x’.
‘*’ is used for multiplying.

‘+=’ is used to do the following: ‘x += 2′ is a short way to write: ‘x = x + 2′. (the same for the rest of the operators).

This is a summary of most of the commonly used operators.

Visit us at: http://www.dooblo.net

Overview

The following instructions will demonstrate different export options for ‘MultiSelection’ questions.

You can choose which view of exported data for these kinds of questions, suits your goals and helps you analyze your results in the best way.

For Example, you can choose whether you like to view the data is index’s of answers or their specific text, further more you can decide whether to see the specific click order of the respondents choices or not and choose different view’s for your exported data.

Exporting to Checked\Unchecked:

• Lets choose to export ‘Checked\Unchecked variables’ as the following picture shows:

• If we choose the ‘Export to checked\unchecked variables, the following exported data table will say:

  “Ok, Answer number one is checked (1), answer number two is unchecked (0)…etc”

Exporting to ‘Each answer as a variable’:

• Let’s choose to export each answer as a variable like the following picture shows.

• The following exported data table says:

  “Hey, you chose options 1, 3, 5, 7, 9, and I don’t know what the order of the selections was”

Exporting with Saving Click Order:

• If you wish to see also the specific click order of the respondents choices, you should use this option:

• The following exported data table is exported in ‘Export each answer as a variable’ option and it will say:
  “Your 1^st choice was answer number 8, your 2^nd choice was answer number 3, etc’…”

  

• The following exported data table was exported in ‘Export to Checked\Unchecked variables’, in this case, click ‘Save Click Order’ will make no difference:

• ‘Export in both ways’ will do as it says and export the two different methods one after the other.
• ‘Export Answers as text’ will show the text of the answers instead of the answer’s index’s.That’s it! This is how to define your own exporting method for ‘Multi-Selection’ questions.

Visit us at: http://www.dooblo.net