FAQ

Instructions for the Translators of the Survey Solutions Interface

  • Start by downloading the following Excel file (Download Excel file corresponding to v24.06.6 of Survey Solutions) and then follow the rest of these instructions. You deliver just the translated Excel file and the title of the new language.
  • Do not rename the spreadsheet. Do not convert to any other file format.
  • Translate text from column E (titled INVARIANT) to column F (titled with your language).
  • If you can’t translate the original text for any reason, the translation should be left blank (do not copy text from column E to column F in this case).
  • Do not modify any other text/cells anywhere else in the spreadsheet, even if there is a typo in the original text (feel free to notify about any discovered typos or problems in your email message, but not in this file).
  • Do not add or remove any lines.
  • Do not distort the HTML tags, such as: <br/>
  • Do not touch anything inside the curly brackets {}, for example "{value}" must remain "{value}" , do not translate the word “value” inside the curly brackets.
  • Some texts may contain terms in dual curly brackets {{}}, for example "{{count}} interviews will be approved.". Maintain the nesting in the translation. Do not reduce to {}.
  • The translation MUST HAVE all the same entries {0}, {1}, … as the original! (If there were three in the original, must be the same three mentioned in the translation). The order of mentioning may be changed, however, for example: “File {0} may not be sent to {1}” –> “May not sent to {1} the following file {0}”
  • The meaning of placeholders {0}, {1} may only be guessed from the texts. The same placeholder may be mentioned several times in the message, for example: "{0} is wrong, enter any other value than {0}!". In which case {0} means the same thing and it must be mentioned AT LEAST ONCE in the message, but for convenience MAY BE mentioned more than once.
  • Messages may contain text that shouldn’t be translated, for example: “Optionally can specify the following columns:<br/> _responsible - username of a headquarters, supervisor or an interviewer who will be responsible for the assignment;” In this case the text "_responsible" is a specific column name and must remain the same word in any translation. Same applies to:
    • emails: e.g. someone@mysurvey.solutions;
    • web addresses: https://designer.mysurvey.solutions (do not translate each word);
    • file extensions: .pdf, .zip, .xlsx, .dta, .sav, etc;
    • names of programs: Stata, SPSS, Survey Solutions;
    • terms that are internationally known under English abbreviation: GPS, UTF-8, Unicode, etc.
  • You may decide to translate units Kb, MB, GB, or keep them in English, whichever is more prevalent/intuitive.
  • Pay attention to details. There may be very similar terms with minute differences.
  • The terms questionnaire, interview, and assignment mean different documents in Survey Solutions and the difference must be maintained in the translation.
  • The terms interviewer and enumerator mean the same thing in Survey Solutions. Translators may opt to use a single term do denote either.
  • You may want to refer to the glossary online to double check the meaning of some of the terms as we apply them.
  • Use of quotes: different languages have different conventions to quote the text. In some places (such as in HTML tags: <font color=“red”>No internet connection</font> ) specifically the unicode quotation mark character is expected (") (Unicode number U+0022) and should not be replaced with any other type of quotes, such as («) („) etc.

Warning:

Copy/Pasting from other software may result in insertion of invisible control characters, which may result in an unpredictable behavior or prevent integration of the translation file. Hence it is recommended typing-in the translation directly into the Excel spreadsheet.

November 6, 2024

External Service Providers

Survey Solutions, while being an open-source product, is capable of consuming various services from external providers to deliver specific functionality to the end users.

Among these services some are free, some are charging per unit consumed, some require a payment plan, some allow for a limited use.

Warning:

The conditions of use for these services are set, and may be revised by the respective service providers.
This page may present information that is not up-to-date.
Always consult the corresponding service provider for any conditions of service to avoid unexpected charges!

Provider


Service


Usage


Costing


Price info


Configurable
GooglereCAPTCHAOptional.

A CAPTCHA is used to keep malicious software from engaging in abusive activities.

Administrator may opt for not using Google CAPTCHA and use built-in CAPTCHA instead.

documentation
Free per use, unlimited use

Administrator must obtain the key and supply it to Survey Solutions.
infoPer server

setup
GoogleMapping APIOptional.

Online map report and online map dashboard will not show the map layer if not set up.
Free per use, unlimited use.

Administrator must obtain the key and supply it to Survey Solutions.
pricingPer server

setup
EsriOnline maps in web applicationsPreset.

Base layer is used to show a superimposed map extent or map preview.

documentation
Unmetered use (no authentication).Not configurable
EsriEsri Basemap ServicesOptional.

Online maps are used to show map dashboard and answer geography-type questions in mobile applications for interviewers and supervisors. Users can select their own offline maps, or pick among the 3 online maps sourced by ESRI.

If key is not supplied, online maps will not be selectable in the mobile applications.
Paid use.

Metered use. 2,000,000 free tiles per month.

Administrator must obtain the key and supply it to Survey Solutions.
pricing
(see "basemap tiles")

Esri can be contacted at Official_Statistics@esri.com to discuss licensing and obtain an access key to use within the Survey Solutions application.
Per workspace

setup
AmazonAWS SES - Sending emails to respondentsOptional.

Used in CAWI surveys for sending invitations or reminders to respondents.

If the key is not specified, this method of sending emails to respondents will not be available. Other alternatives are listed here.
Paid use.

Metered use. 3000 free emails within 12 months of starting using the service.

Administrator must obtain the key and supply it to Survey Solutions.
pricingPer workspace

setup
TwilioSendGrid - Sending emails to respondentsOptional.

Used in CAWI surveys for sending invitations or reminders to respondents.

If the key is not specified, this method of sending emails to respondents will not be available. Other alternatives are listed here.
Paid use.

Administrator must obtain the key and supply it to Survey Solutions.
pricing plansPer workspace

setup
AmazonAWS S3 - Storage of binary dataOptional.

Used for storage of binary data collected during surveys (images, audio).

If the service is not used, binary data will be stored on the file system.
Paid use.

Administrator must obtain the key and supply it to Survey Solutions.
pricingPer server

setup

September 24, 2024

Survey Solutions Server Hosting

Here are just some of the options you may have for placement of your Survey Solutions data server:

Language

The Survey Solutions questionnaire can be designed in any language supported in Unicode. See details in this article.

A questionnaire may be multilingual. See details in multilingual questionnaires

For the langauges applicable to Survey Solutions software components refer to the following table:


Language

Interviewer (App)HeadquartersDesigner
English+++
Russian+++
French+++
Spanish+++
Chinese+++
Czech+++
Ukrainian+++
Arabic++-
Portuguese++-
Georgian++-
Romanian++-
Indonesian+--
Khmer+--
Thai+--
Vietnamese+--

How to switch the language?

readmereadmereadme


See also: Instructions for the Translators of the Survey Solutions Interface

January 30, 2024

What tablets should I buy?

Technical Requirements

Survey Solutions software works with Android tablets with the following specifications:

  • Version of Android OS:

    • Android 7.0 or better is required;
    • All versions of Android below 9.0 are no longer supported by the manufacturers and correspondingly tablets that can’t be updated to Android 9.0 or above should be considered unsafe for the World Bank projects.
  • RAM: Minimum 1.5GB

  • Storage: 8GB of flash memory storage. At least 1GB of available space must be available for Survey Solutions’ use. The Survey Solutions software installation package (.apk) is less than 200MB, but more space will be required during the operation of the software. The ultimate requirements for space depend on the kind of survey (questionnaire) and the mode of use of the tablet (number of assignments, simultaneously started interviews, rejections, use of offline maps, audio recording, etc.

    September 19, 2023

Server Requirements

Server requirements are periodically revised. The characteristics below are outlined for a server facilitating a survey of no more than 100,000 interviews. You may need a more powerful server if:

  • your survey is larger, or
  • you plan to host several surveys, or
  • if you plan to collect any multimedia data (photos, audio recordings, etc), or
  • there are other non-standard circumstances.

Requirements for the server depend on the use and the type of the survey. Below is a minimal configuration. Better hardware allows better performance.

August 28, 2023

Password issues

Click on the description of the case (1-15) below. Instructions vary depending on the type of password/login you are having an issue with.

1. Forgot your password for the Designer tool?
  1. Go to the Designer tool online: https://designer.mysurvey.solutions
  2. Click FORGOT PASSWORD?
  3. Enter your login (account name) or email address into the form field and click RESTORE.
  4. Check your email inbox for a new message with a password reset link.

IMPORTANT: The email address here is always the same email address that you’ve used to register.

June 22, 2023

Changing password

This article describes who can change passwords and for whom in the hierarchy of Survey Solutions users.

In the following table users assuming the role mentioned in the rows can change passwords of users mentioned in the columns.

ROLESadministratorheadquarterssupervisorinterviewerobserverAPI
administratoronly own passwordyesyesyesyesyes
headquartersnoonly own passwordonly if controlling this supervisor in all workspaces, to which the supervisor has accessonly if controlling this interviewer in all workspaces, to which the interviewer has accessnono
supervisornonoonly own passwordnonono
interviewernononoonly own passwordnono
observernononononono
APInononononono
Note also:
  1. To change own password the user needs to enter the old password in addition to the new password. To change the password of another user (when permitted) there is no need to enter the value of the old password.

    June 22, 2023

Navigation to Destination

This article describes the features of Survey Solutions related to guiding the field workforce (interviewers and supervisors) to the particular destinations (typically dwellings/households).

This is especially useful when the target location for interview is known (coordinates known), which helps finding the proper way to the destination in the situations of:

  • panel surveys (coordinates are known from previous wave of the survey);
  • cross-sectional surveys on geo-coded frames (households comprising the sampling frame are recorded with their coordinates during the precedeing listing or census enumeration);
  • cross-sectional multi-visit survey (coordinates are recorded during the first visit, then re-used for subsequent visits);
  • audit survey (coordinates are recorded by the interviewers during the main survey, then reused by auditors during the audit survey).

While we are mainly thinking of the location of the household or dwelling, it is not essential for Survey Solutions, and the destination can equally be the location of an enterprise, farm, plot, school, hospital, a generic facility, a landmark, a water source, etc.

April 25, 2023

Android App Permissions

Android permissions regulate access of apps to particular functionality. When it comes to Survey Solutions the following permissions are requested:

  1. Access to camera: is used to:
  • recognize qrcodes when setting up the application (enter synchronization point address);
  • recognize qrcodes/barcodes when answering the corresponding question type in the interview;
  • take pictures (answer picture type question).
  1. Access to microphone is used to:
  • answer audio type question;
  • record audio audit data during interview (all the time from the point of opening the interview to the point of closing the interview).
  1. Access to location is used to:
  • answer GPS location question;
  • answer geography question with automatic or semiautomatic modes;
  • permit near field communication for synchronization between the Interviewer and Supervisor apps.
  1. Access to files and media is used to:
  • pick photographs from the gallery as answers to picture questions;
  • store maps received from the HQ;
  • store troubleshooting packages.
  1. Access to nearby devices is used to:
  • establish connection for synchronization between the Interviewer and Supervisor apps.

The apps generally request the permissions when they are about to execute the action, for which the permission is needed. For example, a camera permission may be requested when the user wishes to answer a picture question.

April 24, 2023