Archive

Archive for the ‘FAQ’ Category

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);

How To Assign Surveyors To Projects

August 13, 2012 Leave a comment

Overview

If you wish to assign your surveyors to specific projects, this is how-to will show you how.

Choose your project, right click the surveyors node and choose “Add Surveyor”.

Now you would be prompt with a box asking you to choose a surveyor:

Within this box you can do the following:

  • Add an existing surveyor to this project.
  • Create a new surveyor and add it to this project.
  • Create a new surveyor’s group and add it to this project.

At the bottom of the box you have some display settings.

After choosing the surveyors needed for this project, just click OK and you are done.

That’s it!

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

Categories: FAQ, How To's

How To Measure Time Between Questions?

August 9, 2012 Leave a comment

Overview

This how-to will show you how to measure time differences between parts in your survey.
Time differences can be given in most of the common time formats seconds, minutes, etc’.

How To Do It?

In the place where you want to tick the start time you can use the following code:
Vars[“Start”]=Now;

This will capture the current time & date within a global variable that I called it “Start” (Can call it whatever you like).

Then, in the place you want to capture the end time & date, you should use the following code:
Vars[“End”]=Now;

*Note: These code lines would be best written within start\end scripts.

Now, all that’s left to do, is to check the time difference we want, here are the functions optional for it:

TimeDiffYears(Vars[“End”],Vars[“Start”]);

TimeDiffMonths(Vars[“End”],Vars[“Start”]);

TimeDiffDays(Vars[“End”],Vars[“Start”]);

TimeDiffHours(Vars[“End”],Vars[“Start”]);

TimeDiffMinutes(Vars[“End”],Vars[“Start”]);

TimeDiffMilliSeconds(Vars[“End”],Vars[“Start”]);

TimeDiffSeconds(Vars[“End”],Vars[“Start”]);

Each will return a numeric value which corresponds to the difference in the given time format.
You can return this value in an expression question, or even use it for rules and scripts!

Example

In this example, all I did is capture the time taken for Question 1:

And created an entrance rule for question 2, so it would enter it only if the difference was greater than 10.

The time representation/format may very between different devices. If you want the time difference to be formatted the way you want it to be you can use the following function:  FormatNumber(numberToFormat, digitsAfterDecimalPoint, toRound);

Below you can find few examples:

FormatNumber (203.4675, 1, false) will return 203.4
FormatNumber (203.4675, 1, true) will return 203.5
FormatNumber (203.4675, 2, false) will return 203.46

That’s it!

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

Categories: FAQ, How To's

How To: Validate GPS is Working

August 7, 2012 Leave a comment

Overview

If you are planning to use the device GPS feature for conducting results with GPS coordinates, it is important to validate it is working.

How to Do It

Testing the GPS in the app’s options:

If the GPS is available & capturing you would see the following:

If not, it would write that it is not available.

The GPS Options

Enable\Disable GPS Capturing.

Enables usage of only the hardware GPS, preventing other GPS apps to interfere.


Will make the GPS sample constantly – important for Geo-Fencing.


Capture interviewer’s position in the GPS data.


Lets you determine the sampling frequency.



Disables usage of old GPS capturing in case of lack in functionality in the GPS.


Set the ‘lifetime’ of old GPS data, in case that your result haven’t collected GPS data due to a problem with the GPS it would turn to an old GPS reading, this would decide how long would old GPS readings last.


Cheking GPS functionality within the survey

You can check the following function, wherever you want in your survey:
GetGPSLocation().Latitude != “”

If it returns ‘true’ it means there is a Latitude, which means GPS is working.
If this returns ‘false’ it means that the Latitude returned is empty, which means GPS is not working.

That’s it!

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

Categories: FAQ, How To's

How To: use Geo-Fencing with SurveyToGo

August 6, 2012 Leave a comment

Overview

Geo-Fencing is an incredible feature allowing you to check whether your surveyor is conducting surveys within a given radius according to given latitude and longitude coordinates.

SurveyToGo allows you now to input a specific point & radius, to assure your results are conducted in the correct place.

Setting The Device & Application

First of all assure that your GPS is enabled within your devices settings.

Then, Assure that the GPS is enabled in SurveyToGo mobile App, and that the ‘Constant GPS Sampling’ is enabled.

*Please note that using ‘Constant GPS Sampling’ is needed for this feature, although it consumes battery life faster as it has to sample GPS coordinates much more frequently.

You can validate your GPS is enabled by checking with the ‘GPS Status’ button.

How To Get Coordinates of your target location?

Locate your target location on Google maps, right click it and choose ‘What’s Here?’:

This will now provide you with the latitude and longitude of the location:

First number is the Latitude, second number is the Longitude.
This numbers would be entered in our functions later on.

How To Do It?

Basically there are two different functions:
1st function:
dblIsInGPSFence (fenceLat, fenceLon, distInKM)

Gets latitude and longitude coordinates and a radius in Kilo-Meters.
Returns ‘true’ if the surveyor is in the given radius.
Returns ‘false’ if the surveyor is not in the given radius.

2nd function:
dblDistanceFromGPSFence (fenceLat, fenceLon)

Gets latitude and longitude coordinates, and returns the distance of the surveyor from the specific point.

Examples of usage
If we want to verify our surveyor is conducting results within the location we entered in the given radius.
Lets say the following coordinates:
40.769752,-73.974235 (Central Park – New York)
With radius of 10.

Now, we would like to cancel a result that is trying to be conducted outside of the given radius.
Basically we can configure within our survey in its beginning an empty question that would have a jump rule like this for example:

This will cancel the result, if the surveyor is not within the target location radius.
There can be many other usages for these functions, you can use it however you want.

That’s it!

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

Categories: FAQ, How To's

How To Print Out Interviews

July 24, 2012 Leave a comment

Overview

SurveyToGo enables you to print out your survey results in a very intuitive view, rather than just exporting your results.
This How-To will show you how to print out your results, making them look in a more intuitive way for reviewing.

How to Do It?

When viewing your collected data in the operations console, you can simply right click one or multiple interviews and choose print.

Doing this will generate the results in the following format, making them available for saving & printing too.

That’s It!

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

Categories: FAQ
%d bloggers like this: