SurveyToGo Studio Manual

Overview

In some cases, a question answers should be displayed as multiple columns, rather than one long column.
Single Choice questions & Multi-Selection questions now have this rendering feature.

How to do it:

Lets say for example that we have a single choice question, as follows:

As you can see, all of its answers appear in one column.

If we wish to change it to multiple columns, we should go to the questions ‘Answers’ tab, and change the ‘Num Of Columns’:

Next to the ‘Num Of Columns’, we can decide the order of the columns, for example:
* I chose the ‘First item on top’ option

As you can see, the order of the answers has changed.

This can be done the same way with multi selection questions too.

A very common usage for such feature is when needed to display several products in columns, for example:

Rather than in one column.
If you wish to know how to show answers as pictures, you can follow the next link:

How To: Show Answers As Pictures?

That’s It!

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

Overview

SurveyToGo has many exporting features available.
One of them is the exporting to Word format.
Sometimes when we conduct interviews with questions that are being skipped, therefore, some questions are left without an answer.
This ‘How To’ will show you how to hide those un-answered questions when you export your survey results to word in a few simple steps.

Step 1: Opening the exporting wizard

Step 2: Choosing Word Provider.

Step 3: Configuring the word exporter.

Step 1: Opening the exporting wizard

First of all, we should open the exporting wizard:

Step 2: Choosing Word Provider.

• Choose to export results:
  
• Then, choose the word provider:
  

Step 3: Configuring the word exporter

Now, in the last screen of the exporting wizard, you would see the ‘Word Exporter’ special options:

You should select the ‘Hide null answers.

If you wish, there are more configurations settings for you to choose from.

• Now when you export your results to Word, un-answered questions will not appear.
  

That’s it!

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

Overview

SurveyToGo fully supports scripting and usage of validation rules.
From the simplest ones, to the most complicated.

A Validation rule is a script that is added to a question and will be checked each time the question is being advanced forward.
If the script is valid, it will proceed to checking the jump rule (if there is one), and continue to the next question.
If it is not valid, it would prompt a custom message, and will not allow continuing.

Step 1: Add a new instance of a validation rule.

Step 2: Configuring The validation rule’s condition.

Step 3: Configuring the Validation Rule’s Custom Message.

Adding a new instance of a validation rule.

In order to add a validation rule to a question, you should go to the questions ‘Rules’ tab.
Then, you should click the button for creating a new instance of a validation rule:

Configuring The validation rule’s condition

Now let’s add the condition:

Let’s say, for this example that the current question asks about:
“How many of your kids like chocolate?”

And that question number 2 asks:
“How many kids do you have?”

So this validation rule basically checks if the answer of the current question is greater than the answer of question 2, which is not reasonable – as if a person says he has 3 kids, but he answers that 5 of his kids like chocolate, it does not make sense.
Therefore the validation rule comes in hand.

Configuring the Validation Rule’s Custom Message.

Now, let’s add an error message to prompt:

This message will prompt if the answer would be greater than the answer of question 2 and will not allow continuing, as the validation rule says.

That’s it!

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

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

SurveyToGo fully supports scripting and usage of branch rules (Jump rules).
From the simplest ones, to the most complicated.

In this ‘How to’ I will show you the simple steps in order to start implementing your branch rules (Jump rules).

Step 1: Add a new instance of a Jump Rule.

Step 2: Configuring The Branch rule’s condition.

Step 3: Configuring the Branch Rules Action & Target.

Step 1: Adding a new instance of a Jump rule.

A Branch rule is a condition that will be checked once a question was finished, if the condition is valid, the action configured would be executed:

First of all, you should go into the desired question’s Rules Tab and create a new instance of a branch rule, as the following picture:

Step 2: Configuring the Branch Rule’s condition.

If you click the ‘<Set condition>’ text box, you would be able to enter your own script for the condition, for example:
‘Answer(CurrQues)==2′

Any script that eventually returns a true\false value is valid here.

Step 3: Configuring the Branch Rules Action & Target.

By clicking on the ‘<Set Action>’ text box, you would be able to set the desired action:

And the same for the ‘Target’ text box, for example:

This branch rule, will go to question index 3, if the answer of the current question is 2.

That’s it !

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

Overview

SurveyToGo contains an enormous set of built-in functions ready to use.
We have assembled all of them in one file – a useful handbook for scripting surveys.
Please see this link for the download:

http://www.dooblo.net/downloads/SurveyToGoCommands.zip

It contains all the functions but in a more raw form. We are in the process of moving them from this file to a more elegant web manual. The beta version of the web manual is here: http://stg.dooblo.net/ULDocs – but it is only in beta so please expect things to be a bit weird with it.

We strongly recommend having this, Very Handful!

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

Overview

SurveyToGo Studio enables you to script custom actions that will appear in your survey as buttons!
Anything you have in mind that is scriptable, you can script to an action button.

This ‘How-To’ will show you how to do it with a few simple steps:
Step 1: Add a new Custom Action.
Step 2: Write the code you want.
Step 3: Test it!

Here it is:

Step 1: Adding a new Custom Action

Go to the ‘Survey Properties’ tab.

Then, after clicking ‘Edit Custom Actions’, you should add a ‘New Action’ and choose its name:

Step 2: Writing the action button script:

Now you can write your own script in the ‘Action Code’ text-box, for example:

Please disregard the ‘Action Available’ text-box.

Step 3: Testing your action button:

First, enter a survey and run it.
Now, if you click your devices settings button (Each device the button looks different) you would get the menu which you would see the ‘Actions’ Button:

After clicking it, you would see the actions you configured:

By clicking it, the script you wrote in the ‘Action Code’ text-box will run once.
As you can see, I scripted it to prompt a message box, here it is:

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

This ‘How To’ will show you how to import a survey into your SurveyToGo Studio.

• In order to export a survey you will need it’s ‘.srv’ file.
  After exporting the survey with the SurveyToGo Default Provider you will get the survey file (.srv extension)
• Now you should click on the ‘Survey’ tab -> click ‘Import’:
  
• Now choose the survey you wish to import:
  
• Now you should choose the folder location of the imported survey:
  *You will need to remember this location for the final step.
  
• Then you will be prompt with the following message, click yes:
  
• After the survey was opened, it’s not yet fully imported.
  Now we need to make a small change, just in order to re-save it.
  (you can just click ‘space’ in one the questions and then delete it).
  After doing the small change you will notice that the survey name has a asterisk next to it, which means you can save it now:
  
• Now you should right click the specific project you wish to import the survey to, and click ‘Add Existing Survey To Project’
  
• Finally, you should navigate to the survey’s location, and choose it:
  
• Now the survey is fully imported!

That’s it !

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

Overview

SurveyToGo allows you to modify most of the survey texts!
By texts I mean: Error messages, Main Menu messages, Question UI Texts, Survey messages, etc’.
This allows YOU to decide what text will show on Errors, Messages and in the UI!

How To Edit Survey Texts:

• Click on your survey root and go under the ‘Survey Texts’ tab.
  Then you will see the next menu:
  
• Those marked in Purple are the subjects.
• Those marked in Orange are names of the texts place.
• The area marked in Black is where you input the text.
• The area marked in Green is the description.

That’s it!
Now you can try changing the texts in your survey !

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