type

  • This document aims to introduce the list of question types supported in rtSurvey.
  • Testers will find it a useful base while testing new app version to see if the types work as correctly as mentioned or not.
  • Xlsform designers will find it a useful collection of types to select while building digital survey solutions for various cases in reality.
  • Availability: supported in all rtSurvey versions.

Question types

  • To define which exact data type to collect for each question, we need to set corresponding values in column type of sheet survey:
type Allowed content
Open questions
text Letters, numbers, special characters such as .,-_!?@()
integer Integer numbers below 10 digits
decimal Decimal numbers below 10 digits
Read-only Information
note A note displayed on the screen without saving data
Multiple choice question
select_one option
  • Only 1 option can be selected from the available option list
  • option is defined in column list_name in sheet choices
select_multiple options
  • More options can be selected from the available option list
  • options is defined in column list_name in sheet choices
Barcode & QR Code question
barcode Used to scan barcode types and save barcode information
Multimedia questions
image Image (taken or selected from gallery)
video Video (recorded or selected from gallery)
audio Audio (recorded or selected from gallery)
Date & time questions
datetime Date and time (Year month day hour minute)
date Date only (Year month day)
time Time only (Hour minute)
GPS questions
geopoint GPS coordinates.
geoshape Set of GPS coordinates to form an area.
geotrace Set of GPS coordinates to form a route.

Example

note

  • Mobile screen:

xlsform-survey-03a-type-note-ui

  • Xlsform:

xlsform-survey-03a-type-note-syntax

text

  • Mobile screen:

xlsform-survey-03a-type-text-ui

  • Xlsform:

xlsform-survey-03a-type-text-syntax

integer

  • Mobile screen:

xlsform-survey-03a-type-integer-ui

  • Xlsform:

xlsform-survey-03a-type-integer-syntax

decimal

  • Mobile screen:

xlsform-survey-03a-type-decimal-ui

  • Xlsform:

xlsform-survey-03a-type-decimal-syntax

select_one

  • Mobile screen:

xlsform-survey-03a-type-selectone-ui

  • Xlsform:

    • sheet survey:

    xlsform-survey-03a-type-selectone-syntax

    • sheet choices:

    xlsform-choices-03a-list_name-syntax

select_multiple

  • Mobile screen:

xlsform-survey-03a-type-selectmultiple-ui

  • Xlsform:

    • sheet survey:

    xlsform-survey-03a-type-selectmultiple-syntax

    • sheet choices:

    xlsform-choices-03a-list_name-syntax

barcode

  • Mobile screen:

xlsform-survey-03a-type-barcode-ui

  • Xlsform:

xlsform-survey-03a-type-barcode-syntax

image

  • Mobile screen:

xlsform-survey-03a-type-image-ui

  • Xlsform:

xlsform-survey-03a-type-image-syntax

video

  • Mobile screen:

xlsform-survey-03a-type-video-ui

  • Xlsform:

xlsform-survey-03a-type-video-syntax

audio

  • Mobile screen:

xlsform-survey-03a-type-audio-ui

  • Xlsform:

xlsform-survey-03a-type-audio-syntax

datetime

  • Mobile screen:

xlsform-survey-03a-type-datetime-ui

  • Xlsform:

xlsform-survey-03a-type-datetime-syntax

date

  • Mobile screen:

xlsform-survey-03a-type-date-ui

  • Xlsform:

xlsform-survey-03a-type-date-syntax

time

  • Mobile screen:

xlsform-survey-03a-type-time-ui

  • Xlsform:

xlsform-survey-03a-type-time-syntax

geopoint

  • Mobile screen:

xlsform-survey-03a-type-geopoint-ui

  • Xlsform:

xlsform-survey-03a-type-geopoint-syntax

geoshape

  • Instruction is being developed.

geotrace

  • Instruction is being developed.

Metadata

  • Besides, there are some ‘special types’ which are used to collect ‘metadata’:
type name Collected information
start starttime Datetime when user begin to fill form
end endtime Datetime when user finish filling form
deviceid deviceid
  • MAC address (for Android 4.x, 5.x)
  • Android ID (for Android 6.x or higher)
  • Unique NSUUID (for iOS)
  • It is used to distinguish between devices
subscriberid subscriberid
  • Subscriber ID (IMSI)
  • It has value when the device connect to a cellular network
  • It has value only when the device is Android 4.x, 5.x
  • It is used to distinguish between cellular networks
simserial simid
  • SIM serial number
  • It has value when the device got SIM card in it
  • It has value only when the device is Android 4.x, 5.x
  • It is used to distinguish between SIM cards
phonenumber devicephonenum
  • Phone number attached to the device
  • It has value when the device got SIM card in it
  • It has value only when the device is Android 4.x, 5.x
  • It is used to distinguish between phone numbers

Warning

‘metadata’ are invisible, so user cannot see them in the screen. - type and name of ‘metadata’ are fixed, cannot be changed or removed from the e-form. - label can be left blank.

Mobile Screen

  • Nothing is displayed!

Xlsform

xlsform-survey-03a-metadata-syntax

Data Entry

xlsform-survey-04a-metadata-data