Archive

Archive for the ‘Field Data Collection’ Category

How to – Add “city search” to a location question

November 30, 2014 Leave a comment

Overview

The SurveyToGo location question can work in both online and offline modes. For both offline and online modes, you can add the ability to search for a city within the map and have the map automatically center to the selected city. The city search feature works for offline maps as well. Here is how to do it:

 

  1. Step 1: Download the corresponding country cities information file
  2. Step 2: Convert the file to SQLITE format
  3. Step 3: Load the cities-database file to the SurveyToGo survey and configure the location question to use that file as a cities source
  4. Step 4: Searching on the tablet

 

 

Step 1: Download the corresponding country cities information file

 

In order to download the country cities information file please follow these steps:

 

  1. Open the browser here: http://download.geofabrik.de/
  2. Click on the relevant continent, for example Europe:
  3. Next, click on the “.osm.pbf” link next to the country you would like to download:
  4. This will download the relevant country .pbf file to your computer. Please note the country files can be relatively large and might take some time to download.

 

 

 

Step 2: Convert the file to SQLITE format

 

Now you need to create the SQLITE database file from the relevant country cities pbf file. To create the SQLLITE file, please follow these steps:

 

  1. Download the Dooblo-Converter package from here: http://www.dooblo.net/downloads/LocationQuestionCitySearch.zip
  2. Extract the contents of the zip file to a folder
  3. Copy the city .pbf file you downloaded from “Step 1” to this folder, then open a command prompt, switch to the folder and put in the following command:”ProcessPBF.bat <cities-file.osm.pbf>”(where “cities-file.osm.pbf” should be replaced with your file. So for example, here is how it would look for the Portugal cities .pbf file:
  4. This will generate the “portugal-latest_cities.sqlite” file which you can now use in “Step 3”. IMPORTANT NOTE: This step can potentially take a long time to complete!!!

 

Note: The file generated will include the cities of the country in both English plus the 3 most used languages in the cities pbf file. The non-english city name will appear on the tablet next to the English name in parenthesis.

 

Step 3: Load the cities-database file to the SurveyToGo survey and configure the location question to use that file as a cities source

 

Once you created the “cities.sqlite” file in Step 2 (you can rename it to any file name you wish) you are now ready to use this file from within the SurveyToGo location question. There are 2 ways of using this file:

  1. Copy the file to the devices by yourself, then point the map question to use the already existing file.
  2. Attach the file as a survey attachments, then point the map question to use the survey attachment.

 

There are pros and cons to each approach, but our guideline is to use option #1 for any SQLite file bigger than 15MBs:

 

Approach Pros Cons
Option 1: Copy the “Sqllite” file to the devices by yourself
  • For large “Sqllite” files, copying the files to many devices will be much quicker
  • Syncing of the survey will be much quicker as the survey itself will not include the “Sqllite” file as an attachment
  • The download of the file to the devices is done manually by the customer and not by SurveyToGo
Option 2: Attach the “SQLite” file as a survey attachment
  • SurveyToGo will take care of downloading the file to all the devices that sync this survey
  • The upload of the SQLite file will take time, if this file is over 15MB of size the upload of the file might fail due to file size restrictions.
  • The download of the SQLite file will be much slower as it will use the SurveyToGo download attachments mechanism

 

We will now show you how to use each approach.

 

 

Option 1: Copy the cities “SQLITE” file to the devices by yourself

In this approach you simply copy the file to the device. Then, in the survey do the following steps:

  1. Add a location question and configure it, then in the answers check the “Use Cities Search”:

 

  1. Next, set the “Cities Source” to “New”:
  2. Now you’ll need to add a new attachment source by clicking on the “+” sign, and entering the path to the file that you copied to the device. The script to use is in the form of: “list.Add(“$ROOT$/Portugal-latest_cities.sqlite”,“1”);” , lastly you need to give this attachment source a name and click on OK to approve:

 

  1. Finally, select the new Attachment Source name you just created from the list:
  2. That’s it!

 

Option 2:

In this approach you first attach the sqlite file to the survey and then configure the survey to use the attachment. Here is how to do it:

  1. Click the main survey and then select the “Advanced tab”, and click on the “Edit Survey Attachments” link:

 

  1. Click the “New” button to add a new attachment:
  2. Click the “Add files” button and locate the sqlite file. Then click on open to add it to the list of files to upload:

 

  1. To complete the upload click the “Upload” button:
  2. Once the upload complete you will be able to use this uploaded file when configuring the location question.
  3. Add a location question and configure it, then in the answers check the “Use Cities Search”:

 

  1. Next, set the “Cities Source” to “New”:
  2. Important note:
    This step is slightly different than in the other option, please note the change in the script syntax and do not use the script from the previous approach.
    Now you’ll need to add a new attachment source by clicking on the “+” sign, and entering the name of the attachment. The script to use is in the form of: “list.AddFromAttachment(“portugal-latest_cities.sqlite”);“, lastly you need to give this attachment source a name and click on OK to approve:

 

  1. Finally, select the new Attachment Source name you just created from the list:
  2. That’s it!

 

Step 4: Searching on the tablet

 

Once everything is configured correctly and after the survey is synchronized to the tablet the location question will show on the tablet:

 

Clicking on the “Open Map” button will open the map. It will then allow you to search for a city:

 

As you type any 2 letters the search will show you a list of relevant cities for you to choose from:

 

You are now able to select from the city and the map will center the map (in the current zoom factor) to the selected city.

 

 

That’s it!

 

 

 

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

 

Categories: Field Data Collection

Different ways of terminating an interview

November 16, 2014 Leave a comment

Overview

While collecting data, sometimes, an interview has to be terminated or filtered out due to the survey’s logic as indicated in the questionnaire..
SurveyToGo enables you to terminate interviews during their execution in several different methods.

In this How-To we will go over the following termination methods:

  1. Canceling interviews.
  2. Filtering interviews.

Canceling Interviews

In most questionnaires there are logic instructions that require you to terminate the interview – for example during the screening process. In many situations you will not be interested in the data collected during the screening process thus indicating SurveyToGo to not save the collected data while terminating it. This is referred to as canceling the interview.

Canceled interviews will not be saved on the device hence, are not uploaded to the server and do not show in the operations grid. Canceled interviews are not recorded nor credited from your organization credit balance.

Let’s say we have a single choice question asking for the respondent’s age group:


For Example, we would want to cancel all interviews which are conducted with respondents that are not within the 18-60 age group, we would have to add it in the ‘Jump Rules’ section of the question.
How To Add Jump Rules
Add a jump rule saying that if the answer to this age group question is other than ’18-60` , Cancel the interview:


The jump rule shown above will cancel our interview and bring us back to the ‘Start’ screen before running a new survey.
If you wish to be prompt before a survey is cancelled, you can tick this feature’s checkbox through the survey’s properties tab:


Then, when a cancelation occurs, you would be prompt as following:


* ‘Yes’ will cancel the interview.
*’No’ will get back to the question and you would be able to change the answer.

 

Filtering interviews

In many surveys you will be interested in keeping the data collected during the screening process for analysis purposes.

In such cases you will be indicating SurveyToGo to save the collected data while terminating it. This is referred to as Filtering the interview.

Filtered interviews will be saved on the device hence, will get uploaded to the server and show in the operations grid. Filtereded interviews are credited from your organization credit balance.

This is more common to use in later stages of the survey, after collecting information which you would like to save. Let’s say we have a single choice question asking for the respondent’s favorite brand (after a long questionnaire including general questions, LSM, brand awareness, etc):

 


In this case, we would like to filter all interviews which the favorite brand was not `Brand 3`. Meaning, the survey will continue from this point only if the favorite brand was `Brand 3`. For other answers, the interview will terminate at that point and the data will be saved and uploaded, indicated as filtered.

Add a jump rule saying that if the answer is other than ‘Brand 3`, Filter the interview:


Regarding prompts, it is the same as jump rules, you should tick it’s feature check box in the ‘Survey Properties’ tab:



Filtered results are not included in the exporting by default, if you wish to add them to your exporting,
you should do this manually through the 
exporting wizard:

When exporting to excel, you would be able to see which subjects were filtered out.

Each value different than (-1) is filtered, and the value represents the number of question it was filtered at.


Please note this (as mentioned above):

Canceled results are not counted in your organizations credit balance.
Filtered results do count in your organization credit balance.

That’s it!

How to: Lock the device “options” screen

August 20, 2013 Leave a comment

Overview

Sometimes you need to prevent interviewers from accessing the options screen on the device so that the interviewers will not change critical options for the app. SurveyToGo allows you to configure your SurveyToGo organization so that the options screen on the device will require a password to access. This password will then be available only to admins.

  1. Step 1: Configure the SurveyToGo organization for locked options screen

Step 1: Configure the SurveyToGo organization for locked options screen

To configure the options screen to be locked:

  1. Right click on the account node and select “Organization properties”:
  2. Switch to the “Advanced” tab and check the “Block Surveyors ” box:
  3. Click the OK button
  4. Now, in order for this setting to apply the devices will need to re-sync. Only after the interviewer re-syncs will the setting apply.
  5. Please contact the Dooblo support to receive your organization specific unlock password for admins at support@dooblo.com .
  6. That’s it!

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

Categories: Field Data Collection

How to: Retrieve failed subjects

August 13, 2013 Leave a comment

How to: Retrieve failed subjects

Overview

In the rare case the PC Surveyor was unable to write the data of an interview to the database it will save this interview data in a file in a special folder. By sending the support team the contents of the folder the Dooblo support team will be able to upload the data of these failed interviews. To do this:

  1. Step 1: Retrieve the path of the failed-interviews folder
  2. Step 2: Zip and send the contents of the folder to support@dooblo.com

Step 1 & 2: Retrieve the path of the failed-interviews folder and send it to support

To retrieve the folder of the failed interviews:

  1. From the PC Surveyor, click the “Tools > Options”:
  2. Switch to the “Support” tab and click the “Get data path” button:
  3. Paste this path (using CTRL-V) to a file explorer to get to the PC Surveyor data path folder:
  4. Now, simply right click and ZIP the contents of the “FailedSubjects” folder and send it to support@dooblo.com along with your SurveyToGo user name and contact details:
  5. That’s it!

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

Categories: Field Data Collection

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

Which tablet device to use for offline CAPI surveys?

June 5, 2012 Leave a comment

Overview – To download this article in PDF, click here

Android tablets come in all sizes and features. From very cheap low end devices to full featured expensive high end devices. The following will detail some possible options for low, mid & high end devices. Tablets vary mainly in the following:

  • Size (3.5″, 7″, 10″ and sizes in between)
  • Screen quality
  • GPS (yes/no)
  • Cameras (No camera, forward facing or both forward and back facing)
  • Battery power
  • Storage
  • CPU power

Tablet sizes

There is a big distinction between the smaller 3.5″ mini tablets and the other 7″+ tablets. The mini tablets while being less expensive usually come equipped with both GPS and 2 cameras almost as a standard. However, for the larger tablets the availability of GPS and cameras is very dependent on price. It’s therefore that if the project requirements can endure smaller 3.5″ tablets, it will provide for better cost/benefits. For obvious reasons, smaller tablets will have smaller screens.

Screen quality

When showing videos & photos, screen size and quality can make a big difference. 10″ high-end devices will obviously provide the best combination of screen sizes and quality. However, smaller 7″ devices are also adequate in size to display images and videos. As a rule of thumb, the lower end devices tend to have screens of less quality so if displaying media is a high priority screen quality should be given attention.

Cameras

There are 2 types of cameras. Forward facing and backward facing. The forward facing camera is used in video conferencing to shoot the face of the person using the tablet. The backward facing camera is the one you use to take pictures of places. Usually, on the lower end tablets, either no camera is present or a forward facing camera only is present. If you need to take pictures of places/people on a regular basis, it is advised to choose a device with a backward facing camera.

Battery power

Battery power in tablets is affected from 3 main components:

  • The battery size – the bigger the better
  • CPU strength – the slower the better
  • Screen size/usage – the smaller the better, the less time the screen is on, the better.

Battery power is as far as we know not directly related to the cost of the device. There are high end devices with small batteries and lower end ones with big batteries.

CPU & Storage

While CPU & storage plays a big role when choosing a tablet for consumer use, when choosing a tablet for tablet surveys this has almost no implications. Any CPU will run SurveyToGo surveys fine. As for storage, for surveys with no videos this has no implication at all and for surveys where you need to capture/display videos it might be a consideration but with careful planning most devices should suffice.

Semi Rugged device (3.7″)

Device name Price Features Comment
Motorola Defy Mini XT320 ~$200

Possible low-end devices

Device name Price Features Comments
Archos 70 Internet Tablet 8 GB – Android 2.2 1 GHz $170
Lenovo Ideapad A1 22282MU 7-Inch Tablet $199
ViewSonic ViewPad 7e 4 GB $170
ViewSonic ViewPad 10s 16 GB

Possible Mid-High range devices

Device name Price Features Comment
Samsung Galaxy Tab 7.0 Plus WiFi 16 GB $350
ViewSonic ViewPad 10s 16 GB $250
Motorola XOOM With Wi-Fi 32 GB $350
Acer ICONIA Tab A500-10S16u 16 GB $300-$400
ASUS Eee Pad Transformer TF101 16 GB $350
Samsung Galaxy Tab 10.1 WiFi 16 GB $350-$400

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

%d bloggers like this: