Archive

Author Archive

How to: keep the same randomization order for several questions

August 17, 2014 Leave a comment

Overview

A common requested scripting technique is to display a set of answers on screen in some randomized order. It could be there’re several questions with the same set of answers, where you would want to display that set of answers in a randomized order, yet in the same randomized order in each question.

This HowTo will show how this can handled.

 

1. Step 1: Create a Dummy Open Ended Question:

2. Step 2: Determine the randomized order

3. Step 3: Add the randomization code to all questions

 

 

Step 1: Create a Dummy Open Ended Question

 

Add an open ended question to the script, and set it to be hidden from surveyor.

The purposes of this question would be to save a string of the answers set indexes in the chosen randomized order:

 

Step 2: Determine the randomized order

 

Add the following code to the first question’s (out of the questions to display…) start script:

 

// create array of all answers indexes in a randomized order

var arr=CreateRandomArray(GetAnswerCount(CurrQues));

// set the string of the indexes randomized order in the dummy question

SetAnswer(QRef(1),IntArrayToString(arr));

 

 

 

Step 3: Add the randomization code to all questions

 

In all displayed questions’ start script, add this code:

RandomizeAnswers(CurrQues, StringToIntArray(Answer(QRef(1)).ToString()));

 

 

That’s it!

 

Visit us at:

Categories: Uncategorized

Syncing results in SurveyToGo

July 28, 2014 Leave a comment

Overview

Interviews that are conducted on the devices get synced, together with the collected attachments, to the SurveyToGo servers either automatically or manually, depending on the configuration option defined in the SurveyToGo app (automatic is the default setting).

SurveyToGo Sync Results Mechanism


Following is a description of how the sync results mechanism works:

  • If completed interviews exist on the device the interviews data (Interview answers only, not attachments) will be uploaded first
  • When the Interviews reach the server a confirmation is sent to the device. Once the confirmation is received from the server that the subjects were uploaded the client checks if attachments exist for those already synced interviews
  • If such attachments exist the mechanism uploads the attachment headers only (type, size etc)
  • Only after that phase it will upload the attachments data

SurveyToGo Android App Sync Settings

As explained above there are 2 ways in which you enable results syncing: 

  1. You set the device to auto-sync results (the default setting). This is done via Settings->Options and setting the Result Syncing check box. This will ensure that every time interviews are completed by a surveyor and connection exists the results on the device will be uploaded to the server. 




  2. Manually selecting (after logging in to SurveyToGo on the device) Settings->Sync Results. 

        

The device auto-syncs a batch of results every 30 minutes (default), the interval and the amount of results in a batch can be changed. Please consult Dooblo support before changing the number of results in a batch.




SurveyToGo PC Surveyor Sync Settings

There are 2 ways in which you enable results syncing to the servers:

  1. You set the device to auto-sync results. This is done via Tools->Options-> Auto Sync-> Data check box.
    This will ensure that every time interviews are completed by a surveyor and connection exists the results on the device will be uploaded to the server.

     




     

  2. Manually selecting (after logging in to SurveyToGo on the device) Tools->Sync->Results->YES.

     




     

 

The device auto-syncs a batch of results every 10 minutes (default), the interval and the amount of results in a batch can be changed. The sync interval can be changed from your device and the amount of results in a batch can be changed in the “Edit PC Profile” in SurveyToGo Studio. Please consult Dooblo support before changing the number of results in a batch




Missing results troubleshooting

If interviews are missing from a certain device please follow the troubleshooting steps describes here:

http://support.dooblo.net/entries/22559548-Troubleshooting-Missing-Interviews-

Upload uncompleted results 

If you want to upload the uncompleted results of a certain device please follow the steps described here:

http://support.dooblo.net/entries/22389226-how-to-upload-not-completed-results/

Review your results

Reviewing your results is normally done by using the Operations Console. See here how to use the operations console:
https://manual.dooblo.net/2011/01/31/chapter-3-2-%E2%80%93-managing-project-data-and-operations/

Categories: Uncategorized

Troubleshooting Missing Results

July 28, 2014 Leave a comment

Problem description

 

Looking at the operations console results are missing. Interviewers say they performed a larger amount than can be seen in the console or have issue during the sync process.

 

Troubleshooting Steps

  1. Cause: Sync Issues, Connection related: Verify there are no connection issues preventing the upload

    Resolution: Identify one surveyor that faces the issue. Ask him/her to perform ‘Settings > Options > Test Connection’ on the device. If there is a connection error this may be the reason results were not synced.

    Possible Actions:

  • Ensure internet connection is available (for example that you can browse the internet) then try syncing and verify if interviews are uploaded.
  • Verify that the Server and URL have not been modified by the surveyor. Compare the values to a device where sync is working properly

 

  1. Cause: Missing Interviews, Survey Mode – Survey was not moved from Test to Production mode before starting field work.

    Resolution: If the survey is still in Test mode (only 10 results are visible in the console) move the survey to production and contact Dooblo Support for the recovery of the test surveys providing the survey name or id to restore.

     

  2. Cause: Sync Issues, Error Message related to credit or storage appears

    Resolution: Make sure the organization has interviews credits and/or enough storage space for the attachments to get uploaded.

     

If results are still missing Contact Dooblo Support with the details related to the missing interviews (Survey name, Surveyor Name, specific dates etc) and ask a surveyor that faces this issue to perform ‘Settings > Options > Admin > Send To Support’.

 

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

 

Categories: Uncategorized

How to Use The Top Banner

July 27, 2014 Leave a comment

Overview

 

The Top Banner feature is a unique section in the top of the screen where you can display a text that is not part of the question’s text. This text can be displayed in any color, as well as the Top Banner background.

The Top Banner, once defined and activated, is displayed on all screens, and can be changed or disabled in any stage of the interview.

 

1. Step 1: Enable the Top Panel property

2. Step 2: Activate the Top Banner

3. Step 3: Define and use the Top Banner properties

 

Step 1:
Enable the Top Panel property

 

Go to the Survey Properties tab, and enable the “show top panel” property:

 

Step 2: Activate the Top Banner

 

To view the Top Banner on screen, its “Visible” property must be set to ‘true’:

 

You decide when you want the Top Banner to appear. From the point you set it to ‘true’ – it will be displayed on all following screens.

 

Step 3: Define and use the Top Banner properties

 

Set the Top Banner Text: Assign the wanted text using the Text property:

 

Set the Top Banner colors: You can set the colors of both the text and the background.

The first thing you’ll need to use is this function: dblColorFromRGB(red, green, blue)

This function get 3 RGB values (3 numbers, each between 0-255), and generate an RGB value to later use to set the wanted color.

Set the Top Banner text color: Create the wanted RGB value and assign it to the ARGBColor property. For example, in the following screen shot, the text color is set to be blue:

 

Set the Top Banner background color: Create the wanted RGB value and assign it to the ARGBBackColor property. For example, in the following screen shot, the background color is set to be a shade of light blue:

 

So for example, combining all settings above, the Top Banner will appear like this:

 

 

That’s it!

 

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

Categories: Uncategorized

The SurveyToGo Android app upgrade process

July 23, 2014 Leave a comment

Overview

 

The SurveyToGo Android app version is determined first when you download and install it on your device from the Play Store or the installation link.
Once installed you can view your Android app version through the main menu in the Login screen -> About:

 

 

When you register your version is registered in our systems and is Organization wide.
It means that every Android app, when launched, verifies with the server if the version is the latest as defined per the Organization. If the Organization version is a later version (only later than the current) the app will download the latest.

The below describes the process to follow to make the upgrade take effect (after configured on the central systems by the Dooblo support team).

1. Step 1: Check for updated version

2. Step 2: Install updated version

 

Step 1: Check for updated version

Usually, if the Auto-Sync is enabled in the app (it can be found in the app’s Options menu), and there’s a later version than the one installed on the device, once you’ll login to the app, the upgrade message will pop.

Yet if the Auto-Sync is off, you can still check for later version through the “Sync Version” button:



If indeed there’s an updated version that is later than the one installed on the device, you’ll receive this message, that you’ll need to confirm:

If there’s no newer version to upgrade to, you’ll get a proper message noting that as well.

**Note: To get the upgrade message the device need to have a valid internet connection.

 

Step 2: Install updated version

Once confirming the upgrade message, just follow the installation instructions.

 

That’s it!

 

 

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

Categories: Uncategorized

How to Dynamically Display Answer Images

May 29, 2014 Leave a comment

 

Overview

 

Part of the SurveyToGo features is the ability to attach and display images as answers. One way is to assign images manually to each answer, as you can learn in this link: http://support.dooblo.net/entries/22814656-How-to-add-images-to-Answers-and-Topics

In this HowTo, you’ll learn a dynamic way to assign and display images as answers.

 

  1. Step 1: Add the wanted images to the survey
  2. Step 2: Create Attachment Source
  3. Step 3: Assign the attachment source to the question

 

Step 1: Add the wanted images to the survey

 

All images used, need to be uploaded to the survey. To upload images files to the survey, go to the survey’s Advanced tab, click on the “Edit survey attachments” link and add your files through the “New” button:

 

 

Step 2: Create Attachment Source

 

  1. Go to the survey Advanced tab and open the “Edit attachment source” link:

     

  2. Click on the “+” button to add the attachment source, and name it as you will. To add images to the attachment source, you need to use this code:

    list.AddFromAttachment(“ImageName”);

     

    “ImageName” should be replaced with a name of an image you uploaded to the survey.

    Each image you’ll add to the attachment source will be displayed for each answer, according to the order you added in. For example, in the screen shot below, you see the “MyNewAttachSrc” attachment source, where three images are added: “A.jpg”, “B.jpg” and “C.jpg”, in this order. This means that in the question I’ll use this attachment source, image “A.jpg” will be displayed in answer index 1, “B.jpg” will be displayed in answer index 2, and “C.jpg” will be displayed in answer index 3:

 

 

 

When you finish with the attachment source, click “OK”.

Step 3: Assign the attachment source to the question

Go to the question’s Advanced tab, and choose the relevant attachment source to be defined for the “AnswerAttachmentSourse” property:


 

 

That’s it!

 

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

 

Categories: Uncategorized

How to create multiple users in the organization

May 27, 2014 Leave a comment

 

Overview

 

Other than the ability to create and add new a new single user to the organization, you can also add multiple users at once, by importing a pre-defined excel file containing the users names and passwords.

 

  1. Step 1: export the sample users excel file
  2. Step 2: fill the users credentials in the excel file
  3. Step 3: load the finalized excel file and add the users

 

Step 1: export the sample users excel file

 

  1. Open the “Studio users & groups” node, right-click on the Users node and choose import users list:

     

  2. In the opened window, click on the “open example” link (this will generate an example excel file):

     

  3. Name the generated excel file and save it:

     

 

Step 2: fill the users credentials in the excel file

 

Open the excel file you saved – this is the excel file to enter the new users credentials in and later import to the organization. The first line in that file are the columns names, and you’ll see the second line is an example of a dummy user credentials. You need to fill the rest of the lines with the users you want (of course, delete the details of the dummy user in the second line, otherwise it will also be created as a new user…).

You don’t need to fill all columns. The mandatory columns to fill are the first three: “UserName”, “Password” and “isSurveyor”. Once you’re done filling the file, save it.

 

 

Step 3: load the finalized excel file and add the users

 

  1. Go back to the import window, click on Browse and open the finalized excel file:

     

  2. Click on “Load File”, and see all the users you entered. Finally click on “Add users”:

When the process is done, just click OK to close the window.

Categories: Uncategorized