Archive

Author Archive

How To Get the survey ID of a survey

August 19, 2015 Leave a comment

 

Overview

 

Every survey in SurveyToGo has a name and ID. When you contact us for assistance and refer us to a survey (the issue or question is related to) we would want to receive the Survey ID which is the unique identifier of the survey and will make sure we are looking at the correct survey. A Survey name is not unique and can contain various special characters that may cause us to not find the survey or find several surveys so providing the survey ID will ensure we are focusing on the correct one. There are 2 options to retrieve the Survey ID:

 

  1. Step 1: Right clicking the survey in the survey tree and selecting Copy ID
  2. Step 2: Survey Info in the survey designer

 

Step 1: Right clicking the survey in the survey tree and selecting Copy ID

  1. Right click the survey name in the Studio and chose ‘Copy ID’ which will copy the ID into the clipboard

  2. Paste the ID from the clipboard (into email, reply window in the support portal etc)

 

 

Step 2: Survey Info in the survey designer

  1. Open the survey
  2. Navigate to the ‘Survey Info’ tab

That’s it!

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

Categories: Uncategorized

How To Show an interview summary on the device

July 30, 2015 Leave a comment

Overview

 

SurveyToGo android application allows one to view a summary of an interview on the device. This can be viewed by the surveyor itself or for example by a supervisor who wishes to review on the surveyor’s device what has been done on a specific interview before the interview was uploaded to the server.

Step 1: Displaying the interview’s summary.

Step 2: Analyzing the interview’s summary.

 

Step 1: Displaying the interview’s summary:

To display the interview’s summary, hold-press on the relevant interview and on the prompted screen press on ‘View’. This, in its turn, will show the summary of the interview until the point it has stopped.

Step 2: Looking at the interview summary:

The interview’s summary is now displayed on the screen with the following details:

Survey Name – The name of the survey the interview was conducted on

Device Index – The unique interview device identifier that is then associated with a unique subject id when uploaded. You can read more about the device index here: The Interview Device Related Identifiers DeviceIndex DeviceID and SID

Start – The date when the interview was started.

End – The date when the interview was stopped.

Questions – The questions indexes and texts.

Answer – The answers collected for the relevant question.

 

That’s it!

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

 

Categories: Uncategorized

How To Overcome the installation restriction of Android when installing from an installation link or while upgrading the App

July 30, 2015 Leave a comment

Overview

 

The SurveyToGo Android app can be installed from the play store or by a direct link in the browser.

Some of the devices, in the newer Android Os versions, have a security setting that forbids installations from unknown sources and allow the installation from Play Store only.

This guide will advise how to change this security setting to allow the Android App installation in such cases.

  1. Step 1: Installing SurveyToGo for Android through an APK link on your Android device.
  2. Step 2: changing the security setting to allow the installation/upgrade when instructed to.

 

Step 1: Download SurveyToGo for Android APK file

To install SurveyToGo for Android APK file:

  1. Paste or type the apk link on the device internet browser.

 

Step 2: change the security setting to allow installation of apps from unknown sources if you get the following message:

  1. Go to Device Setting -> Security -> Mark the unknown sources box.

  2. Once marked, return to the installation and install the app.
  3. After the installation you will see the SurveyToGo app icon as expected.
  4. That’s it you’re ready to go!

 

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

 

Categories: Uncategorized

How To Check Regional and Language Settings

July 30, 2015 Leave a comment

 

Overview

 

Certain errors, can often be solved by ensuring that your computer’s regional and language settings are correct.  This process can vary based on which operating system you are using on your computer.

On this guide we will see how to check those settings via operation system of: Windows XP, Vista, 7, 8.

 

Windows XP

 

  1. Click on the “Start” button to open the Windows Start Menu, and left-click on “Control Panel”.

 

 

  1. Click on “Regional and Language Options”, which will either be its own icon, or behind the category “Date, Time, Language, and Regional Options”.

 

  1. In the “Regional and Language Options” window, ensure that the format is set to “English (United States)”, and click on the “Customize” button as shown below.


 

  1. In the “Customize Regional Options” window, click on the “Date” tab (see the green square) at the top of the window, then confirm that the short and long date formats are as shown below. If either format is different than shown below, click on it and select the correct format in the drop-down menu.

  2. Click on “Apply” and then “OK” to save any changes.  You can click on “OK” again to close down the “Regional and Language Options” window.

 

Windows Vista/7

  1. Left-click on the ‘Windows’ button to open the Windows Start Menu, and left-click on “Control Panel”.

 

  1. Left-click on the “Clock, Language, and Region” category.

  2. Left-click on “Region and Language”.

  3. In the “Region and Language” window, ensure that the format is set to “English (United States)” and click on the “Additional Settings” button.

 

  1. In the “Customize Regional Options” window, click on the “Date” tab (see the green square) at the top of the window, then confirm that the short and long date formats are as shown below. If either format is different than shown below, left-click on it and then select the correct format in the drop-down menu.


  2. Click on “Apply” and then “OK” to save any changes.  You can click on “OK” again to close down the “Regional and Language Options” window.

 

Windows 8

  1. Open the Start screen (shown below).  You can get here by pressing the ‘Windows’ key on your keyboard.


  2. Type “control” on your keyboard.  Then click on “Control Panel” in the search results.

     

     

  3. In the Control Panel, click on “Clock, Language, and Region”.

 

  1. Then click on “Region”.

 

  1. In the “Region” window, ensure that the format is set to “English (United States)” and that the short and long date formats are as shown below. If either format is different than as shown below, click on it and select the correct format in the drop-down menu.

 

Categories: Uncategorized

How To Filter Answers/Topics based on additional data lists

July 28, 2015 Leave a comment

Overview

 

There are many cases where you have two different Answer/Topics lists in two different questions, where one list relies on the other and the responses given in one question will determine the Answers/Topics displayed on the other. One example is Car brands and Car models. Selecting specific brands in one question will determine which models will be displayed on the second.

A good way to perform such filters is using an external data list that will hold both lists and the filtering code will be based on its content.

 

The attached sample will show you an example of this filtering need.

 

In order to test the sample, you’ll need to perform the following:

  • Import the attached .srv file. Click here to see how to import a survey into your account.
  • Create the additional data list from the attached excel file. Click here to learn how to create an additional data list in your account. Make sure to call the data list “CitiesFilterSample” so it will match the script.
  • Add the additional data list to the sample survey: By default the survey is not imported with the subject store assigned to it. Go to the survey’s Advanced tab -> Edit Subject Store -> mark the subject store you see as “deleted” and click on “Remove”. And add the new data list you’ve created with the “New from common” button.

 

 

That’s it!

 

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

 

Categories: Uncategorized

How To Perform Silent-Photo-Capturing

July 26, 2015 Leave a comment

Overview

A great way to enhance quality control of interviews is to utilize the “Silent-Photo-Capturing” feature of SurveyToGo. “Silent-Photo-Capturing” enables you to take photo from the back camera front camera or both without the notifying the interviewer. You can snap photos at any question you wish during the interview. The photo(s) is then automatically attached to interview and is available in the Operation console so that the quality control staff can view the photo. It can provide the quality control staff with a complete view of the surroundings of the interview. To perform Silent Photo Capturing follow these steps:

  1. Step 1: Configure the photo(s) capturing in the Survey by script or by a configuration check box.
  2. Step 2: Viewing the picture(s) in the Operation console.

Step 1: Configure the photo(s) capturing in the Survey by script or by a configuration check box.

There are 2 options for configuring the photo capturing on a question in the interview.

First way by scripting:

You just add the “Silent-Photo-Capture” script call to the places in the interview where you wish to capture a photo. You can add the script in multiple places throughout the survey to take more than one photo. To configure the “Silent-Photo-Capture” in the Survey script follow these steps:

  1. Open the survey you wish to capture photo on:

  2. Select the question you want to activate the photo capture in.
  3. Go to the “Scripts” tab
  4. Add the
    SnapPicture(); function call ( Question Start/End Script) to the question(s) you want to take picture(s) in. For front camera capture add SnapPicture(true); for back camera capture SnapPicture(false); or you can call twice for both.

  5. That’s it! You have just configured silent photo capturing

The second way by check-box button:

You just press the “Silent-Photo-Capture” button on the question(s) in the interview you wish to capture photo. You can capture photo in multiple places throughout the survey to take more than one photo. To configure the “Silent-Photo-Capture” in the Survey follow these steps:

  1. Open the survey you wish to capture photo on:

  2. Select the question you want to activate the capture feature.
  3. Go to “Quality Control” tab.
  4. Then mark Front camera , Back camera or both:

     

  5. That’s it! You have just configured silent photo capturing

Step 2: Viewing the picture(s) in the Operation console

Once you have uploaded interviews from the field that include silent photo capturing you can view the photo by following these steps:

  1. Open the operations console of the project (you can learn more about how to use the operations console here)
  2. Press “Get” button:

  3. Open the relevant interview from the operations grid
  4. Switch to the attachments tab. You can then either preview the photo or click the save
    button to save a local copy of the photo:

  5. If you use multiple photo capturing in the interview you can view them all by clicking the arrows:


That’s it!

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

 

Categories: Uncategorized

How To Use The SurveyToGo REST API

July 23, 2015 7 comments

 


Overview

 

You can access your organization data using the SurveyToGo REST API. The REST API allows you to create a tight integration between the SurveyToGo system and any 3rd party system. Using the API requires prior knowledge of the REST protocol and experience in programming. You can use the REST API from any operating system and any programming language. The SurveyToGo REST API consists of a set of operations which are listed below. Please note we are adding to the list of operations so check back often or subscribe to this topic to stay on top of any new REST operation that is supported.

 

Downloading the Testbed App and Full Source code

 

Dooblo provides you with a free SurveyToGo REST API Testbed app that allows you to test all the available operations and see the output you will get to assist with the development process. In addition we provide the full C# source code of the Testbed app so that you can see the actual implementation of the code. Please note you can call the REST API from any language, not just C#:

 

SurveyToGo REST API Operations Available

 

The following operations are available:

 

General Account management:

  • GetCreditBalance – returns the current interview balance
  • GetStorageStatus – returns the current storage space usage

 

User Administration & Assignment

  • AddSurveyorUser – adds a new interviewer user to the organization
  • DeleteSurveyorUser – deletes the interviewer user from the organization
  • AssignSurveyorUserToProject – assigns the interviewer user to the project
  • UnassignSurveyorUserFromProject – unassign the interviewer user from the project
  • GetProjectSurveyorUsers – returns the list of interviewers users assigned to a project
  • GetProjectSurveyorGroups – returns the list of interviewer groups assigned to a project
  • GetGroupUsers – returns the list of users in a group

 

Projects & Customers

  • Customers – returns the list of customers in the organization
  • CustomerProjects – returns the list of projects of a certain customer
  • ProjectSurveys – returns the list of surveys within a project
  • CreateCustomer – creates a new customer
  • CreateProject – creates a new project within a customer
  • CloneSurvey – creates a copy of an existing survey in the same or different project
  • Surveys – returns the details of a specific survey
  • GetSurveyXML – returns the full survey XML structure of a specific survey

 

Data

  • OperationData – returns the interview operational data in a form similar to the operations console
  • SurveyInterviewIDs – returns the list of interview ID’s of a survey based on filters
  • SurveyInterviewData – returns the actual XML data of the interviews based on ID’s.

 

Interviews

  • ChangeStatus – changes the status of an interview

 

Additional Data Lists

 

 

 

URL For Calling the REST API

 

The SurveyToGo REST API is hosted at this URL: https://api.dooblo.net/newapi

Calling the actual operations involves referencing the correct URL and passing the relevant user/password details.

 

User ID for Accessing the REST API

 

To call the various operations you need to specify a valid user ID. The user ID is in the form of XXXX-XXXX-XXXX/YYYY where the first part is your organization REST API Key and the second part is the relevant user name you wish to use for the operations. Please note the user accessing the REST API needs to have the relevant permissions for the operations that user is calling. For example, if the user does not belong to a certain project that user will get an authorization error if that user attempts to call operations for that project.

 

For example, if the user you wish to use when calling the REST API is named “mark” and the organization REST API Key is: f150fc49-3a14-4ecb-9214-ca04698a9578 the user ID that you need to use when calling the REST API: f150fc49-3a14-4ecb-9214-ca04698a9578/mark

Contact support@dooblo.com to receive your organization REST API Key to use with the REST API.

 

JSON vs XML Output of requests

 

In some calls you can request to receive the output of the data in either JSON or XML format. This is intended to cater to each programmer preference. However, please keep in mind that for some operations that return either interview data or survey data in them, only XML will be supported as an output format. If you try to call these with JSON as format you will receive an error: “Error: This method supports only xml” from the API.

 

Sharing of your SurveyToGo REST API Integration Success Stories

 

If you developed a cool integration using the SurveyToGo REST API, we would love to hear about it and possibly share the project highlights with the rest of our community along with your name and details (if you wish) to promote your expertise and broaden the horizon of our community! Let us know by emailing us at ofer@dooblo.com .

 

Missing an API that will assist you in your integration? Let us know!

 

If during the development of your integration you are missing an API please let us know at support@dooblo.com and we will make sure our SurveyToGo REST API product team is notified of the request to be reviewed for adding to future versions.

 

 

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

 

%d bloggers like this: