Archive

Archive for the ‘How To’s’ Category

How to: set an answer in an answer scale to not be part of a randomization

April 7, 2013 Leave a comment

Overview

This How-To will explain and show how you can fix a specific part of your answer scale so it will not be part of the randomization but will maintain a fixed position.

Step 1: Add an answer scale to your survey 

  1. Following is a link to our manual on how to create an Answer scale: https://manual.dooblo.net/2009/12/14/chapter12

Step 2: Randomize your answer scale

  1. Select the question that you want to randomize its answers.
  2. Click on the ‘Advanced’ tab and click on the ‘Randomized answers/topics order’

Step 3: make a specific answer in you scale not randomize

  1. Click on the survey and click on the ‘Advanced’ tab.
  2. Select ‘Edit Answer Scales’.
  3. Move the bar to the right until you see ‘Do not random’.
  4. Pick the answer that you want not to random.

That’s it!

How to: Design Surveys With Returning Visits

March 18, 2013 Leave a comment

Overview

Sometimes there’s a need to create a survey that is actually built from several different visits (Interview conducted as a series of visits) where each part is destined to a different surveyor or is a continued session of the same interview. This article will show you one possible way to do just that.

 For the example, let’s say we have a survey with 3 main parts: Screener, Main, Recall.

  1. Script the entire process into one script with 3 main chapters: screener, main, recall.
  2. Set the survey interviews to not auto get auto approved: Go to the Survey Properties tab, and enable the Review check box:

  3. A surveyor will start the interview and will stop after the screener, save it and ‘manually’ complete the interview (http://support.dooblo.net/entries/22389226-How-to-upload-Not-Completed-results)
    Through the script you can set the SubjectData to reflect the fact it has ended the screener (for example, add this code line in the end script of the last question in the screener part: SubjectData = “End Sceener”).
  4. The complete result would get uploaded.
  5. A reviewer will review it using the operations console and decide if to delete the interview (screener didn’t pass) or return it to the surveyor for the main part (http://support.dooblo.net/entries/22400888-How-to-return-interviews-to-a-surveyor).  One important note is that when returning a survey you can decide to return it to a different surveyor than the one originating it for example if the surveyors that perform the screener are a different group than the one performing the main.
  6. The surveyor will see the interview back on his device with the SubjectData that will let him know he should continue with the main chapter.
  7. Complete the main chapter and stop after the main is completed, save it and ‘manually’ complete the interview.
  8. Through the script you can set the SubjectData to reflect the fact it has ended the main (for example, add this code line in the end script of the last question in the screener part: SubjectData = “End Main”).
  9. A reviewer will review it using the operations console and decide if to delete/modify the interview and/or return it to the surveyor for the recall part.
  10. If main was ok and the interview can continue the surveyor will see the interview back on his device with the SubjectData that will let him know he should continue with the recall chapter.
  11. Once completed and uploaded the reviewer can then approve the interview.

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

How to: Install PC Surveyor

March 18, 2013 Leave a comment

Overview

‘PC Surveyor’ the application used by surveyors using PC for conducting surveys.
This How-To will show you how to install it on your PC in one quick step.

Installing PC Surveyor through the STG Studio application

  1. Under your organization node in STG Studio, navigate to ‘Device Installations’ and double-click ‘PC Client Install’.
    This will open the following page:

  2. By clicking the ‘Click here’ link you would be directed to the next page:

  3. Clicking ‘Install’ for the installation to begin.

Installing PC Surveyor not through the STG Studio application

you can install the latest PC Surveyor version compatible with Windows XP & Windows 7 both 32&64 bit versions.
This link is constantly updated by us with the latest PC Surveyor versions.

The latest version can be found in this link: PC Surveyor Installation

That’s it!

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

How to: keep variable names constant

March 14, 2013 Leave a comment

Overview

Each question in the survey has a unique Variable Name, that later shows in the exported data.
When adding a new question, its Variable Name is set automatically, usually (but not always) corresponds with the question’s index in the script.
An automatic standard Variable Name is in this format: Q_xxx (where xxx represent a 3 digits number).
Same as a question’s Variable Name, each answer and topic in the script has its own unique Variable Name that is set automatically.
You can manually change all Variable names in the script (as long as each variable name stays unique for each question/answer/topic). If you do change an automatic Variable name, the new name will stay constant throughout the whole script, even if you keep adding new questions in between.
But, if you don’t change the automatic Variable name, it can be automatically changed when adding new questions.

This how to will show you the ways to keep you variable names constant.

Define all Answers/Topics Variable Names as constant

You can define all answers/topics Variables Names to remain constant (note that this next feature defines the answers and topics variables only, and not the questions variables)

  1. Go to the Survey Properties tab, and check the “Use question’s short id and id as basis for answer/topic variables”:
  2. Confirm the message that appears:

  3. And see that check box in enabled:

Important note: When enabling the check box above after you’ve already created your questions, answers and topics in the script, this action will “reset” all answers/topics Variable Names to correspond with the short id of the question.

You can then manually change the variable names if you want.

Changing the questions Variable Names manually

In order to keep the question’s Variable Name constant, you can manually change it to any unique name you want, through the Variables tab of the question:

As long as the question’s Variable Name doesn’t start with “Q_”, it will remain constant throughout the script.

That’s it!

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

Categories: How To's, Uncategorized

How to send to support on PC Surveyor

March 6, 2013 Leave a comment

Overview

This How-To will show you how to find the ‘Send to Support’ button on your device (PC/Laptop).

This button is used when we ask you to use it, in order for us to be able to review the internal system logs of the device. With these logs, we are able to investigate issued that occur on the device when SurveyToGo is being used.

Please note that in order to ‘Send to support’ your device needs to be connected to the internet.

Step 1: Open the “Options” menu

There are two ways to enter to the ‘Options’ menu in PCSurveyor:

  1. Without logging to your account open and click on the ‘Options’ button

  2. After logging to your account open your ‘Tools’ menu and click on the ‘Options’ button

Step 2: Sending the device log to Support

To send your device log to Dooblo Support:

  1. Click on the ‘Support’ tab and click on the ‘send to support’ button

That’s it!

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

How To: Silent Recording

August 20, 2012 Leave a comment

Overview

SurveyToGo Fully supports the built-in sound recorder within your tablets.
This How-To will show you how to use the recorder silently, in order to start\stop recording silently, without the sound recorder being visible or prompted at all.

How To Do It ?

In order to start recording silently, you should write the following code:
SoundRec.StartRecording();

In order to stop recording silently, you should write the following code:
SoundRec.StopRecording();

*Note: In order for the recording to function well, after every Start function must come a Stop function.
(They don’t have to be in the same question, you can put them wherever you want, even seperately)

In This example, I would start recording in the beginning of question 1, and would stop recording in the end of question 1.

If you use these two set of functions somewhere again in your interview, it will not over-write the older recording, but it would record another new file and attach it together with the old one to the interview result.

Where to get the attachments?

Under the operations console, if you double click a result, you can find your attachments under the ‘Attachment’ tab.

That’s it!

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

Script Writer’s Function Hand-Book

August 15, 2012 1 comment

This document contains most of the common every-day usable functions in SurveyToGo.
Explained, demonstrated and elaborated.
This document is directly connected to us, and is constantly updated with new functions and info by our professional team, stay updated!
A Survey Script Writers True Gem!

FilterAnswersByAnswers \ FilterTopicsByAnswers:

Explanation: This function gets a target question index and a source question.
It filters the Current Question’s answers through, according to the answers chosen in the source questions specified.

Input: Gets 2 Parameters

1st Parameter: The Target Question.

2nd Parameter: A Boolean value – ‘true’ for showing answers selected, ‘false’ for showing answers not selected.

3rd Parameter: The Source Questions.

Output: Filters the specified answer index’s

Example of How to write:
FilterAnswersByAnswers(CurrQues,true,QRef(15));
FilterAnswersByAnswers(CurrQues,
true,QRef(15),QRef(16),QRef(17));
FilterTopicsByAnswers(3,
false,QRef(2));


SelectedAnswerText:

Explanation: This function gets a target question index and returns the text of the answer selected

Input: Gets 2 Parameters.

1st Parameter: The Target Question index.

2nd Parameter: A Boolean value – ‘true’ for getting the ‘Other Specify’ input too, ‘false’ for not getting the ‘Other Specify’ input text.

Output: Text of the answer selected

Example of How to write:
SelectedAnswerText (5,true);
SelectedAnswerText (2,
false);


Answer:

Explanation: This function gets a target question index of only single choice questions such as:
(Single-Choice, Numeric, Open Ended, Scale, Expression)
and returns its selected answer index.

Input: Gets 1 Parameters

1st Parameter: The Target Question.

Output: Returns its selected answer index

Example of How to write:
Answer(CurrQues);


Contains:

Explanation: This function gets a target question index of only Multi-Selection questions and an answer index, and checks if this answer was selected.

Input: Gets 2 Parameters

1st Parameter: The Target Question Index.

2nd Parameter: The Target Answer Index.

Output: returns ‘True’ if the given answer was selected – returns ‘False’ if the given answer was not selected.

Example of How to write:
Contains(2,1);


SetAnswerVisible \ SetTopicVisible:

Explanation: This function gets a target question index, a answer\topic index, and a Boolean value (true/false), and shows\hides the given answer\topic.

Input: Gets 3 Parameters

1st Parameter: The Target Question Index.

2nd Parameter: The Target Answer\Topic Index.

3rd Parameter: A Boolean value. (‘true’ for showing – ‘false’ for hiding)

Output:

Example of How to write:
SetAnswerVisible(CurrQues,2,false);
SetTopicVisible(CurrQues,4,
false);


AnswerChoice:

Explanation: This function gets a target question index of a ‘Single-Choice-Grid’ question only, and a topic index.
it returns the index of the selected answer in the given topic.

Input: Gets 2 Parameters

1st Parameter: The Target Question Index.

2nd Parameter: The Target Topic Index.

Output: returns an index of the selected answer in the given topic within the given multi-topic question.

Example of How to write:
AnswerChoice(CurrQues,3);
AnswerChoice(1,2);


NumOfSelectedChoices:

Explanation: This function gets a target question index of a multi-selection question only, and returns the number of selected answers.

Input: Gets 1 Parameters

1st Parameter: The Target Question Index.

Output: returns the number of selected answers.

Example of How to write:
NumOfSelectedChoices(CurrQues);


GetTopicCount:

Explanation: This function gets a target question index of a Single-Choice Grid question only, and returns the number of topics.

Input: Gets 1 Parameters

1st Parameter: The Target Question Index.

Output: returns the number of topics.

Example of How to write:
GetTopicCount(CurrQues);


AnswerIter:

Explanation: This function gets a target question index of questions that are within a loop of only single choice questions such as:
(Single-Choice, Numeric, Open Ended, Scale, Expression)
and an iteration index.
It returns the answer of the target question in the given Iteration Index.

Input: Gets 2 Parameters

1st Parameter: The Target Question Index.

2nd Parameter: The Specific Iteration Index.

Output: Returns its answer in the given iteration index within the loop.

Example of How to write:
AnswerIter (CurrQues,
3);

AnswerIter (CurrQues,IterationIndex);

*NOTE:IterationIndex Represents the current iteration when running within a loop, so it’s value is set according to the iteration which is currently running.


ContainsIter:

Explanation: This function gets a target question index of questions that are within a loop of only multi-selection question, an answer index and an iteration index.
It checks if the given answer was selected in the target question within the given Iteration Index.

Input: Gets 2 Parameters

1st Parameter: The Target Question Index.

2nd Parameter: The Specific Iteration Index.

3rd Parameter: The Specific Iteration Index.

Output: returns ‘True’ if the given answer was selected in the given iteration – returns ‘False’ if the given answer was not selected in the given iteration index.

Example of How to write:
ContainsIter(CurrQues,
3,7);

ContainsIter (CurrQues,2,IterationIndex);

*NOTE:IterationIndex Represents the current iteration when running within a loop, so it’s value is set according to the iteration which is currently running.


Random():

Explanation: This function gets an integer and returns a random number between the 0 and the integer number given minus 1.

Input: Gets 1 Parameter.

1st Parameter: Maximum number. (Please note that the number generated is between zero till a number that is 1 less than the maximum number given)

Output: returns a random integer within the given range.

Example of How to write:
Random(5);

Random(732);


SelectedAnswerText():

Explanation: This function gets a target question index and a Boolean and returns a text string with all the answers chosen in the given question index, separated with a comma.

Input: Gets 2 Parameters

1st Parameter: The Target Question Index.

2nd Parameter: ‘true’ for including any ‘Other Specify’ text, ‘false’ for not including any ‘Other Specify’ text.

Output: returns a text string with all the answers chosen in the given question index, separated with a comma.

Example of How to write:
SelectedAnswerText(12,true);

SelectedAnswerText(CurrQues,false);


SetAnswer():

Explanation: This function gets a target question index and a target answer index and sets this answer is chosen in the given question index

Input: Gets 2 Parameters

1st Parameter: The Target Question Index.

2nd Parameter: The Target Answer Index

Output: doesn’t return anything, just sets the answer given.

Example of How to write:
SetAnswer(5,2);
SetAnswer(CurrQues,8);

%d bloggers like this: