Introduction

The survey app has been designed to provide feedback from the end-users to the proprietors of the robot. Questions such as Was this information useful or how might this event be improved can be entered into the dataset and shown to the customer(s).

In addition, the survey app can also be used for entertainment-purposes (i.e. playing a quiz). Unlike the survey, answers can be set as correct or incorrect. Likt this, end-users can be tested on their knowledge or on how interesting the lecture was(n’t).

For certain follow-up procedures (such as invitations to special events or subscribing to news-feeds), the dataset can be set to ask the customers for their e-mail address.

The updater-service from the ZBOS Core also provides updates for the Survey-app, there is no need for manual installation or periodic checks.

Terminology

Some terms used in this document:

Term Explanation

Gradient

A type of styling, where one color is set at the top, and one on the bottom. The colors will then fade from one to the other.

Questionnaire

A list of questions and answers, where some answers could be marked as being correct or incorrect

Dataset

The collection of data that will be sent to the robot and used in the Survey app.

Option

An answer to the questionnaire

Survey dataset

A questionnaire designed for customer feedback

Quiz dataset

A questionnaire designed for entertainment / knowledge / training / …​

Local (storage)

This refers to the data stored on the tablet or smartphone where ZBOS Control has been installed.

Translation-matrix

A table containing the name or title of every item in the dataset, as well as the translated terms.

Color-wheel

A tool to select a color used for styling the kiosk(-items).

Color-wheel

When tapping the color-field, the following options are shown:

Colorwheel

The following parts can be discerned:

  1. Color-selector screen: Tap anywhere in the field to choose the color-shade.

  2. Preview: Contains the selected color

  3. Color slider: Slide the pointer to change the hue of the color-selector screen.

  4. Opacity slider: Slide the pointer to change how transparent the color is.

  5. Numerical values: Enter the RGB, HEX or HSLA values directly to select the color.

  6. Used colors: Contains a list of previously used colors.

Usage

There are 2 main options to define a new color, specifically:

  1. Using the color-slider, color-selector and opacity to manually specify a color (in that order).

  2. Using numerical values to enter a value.

  • The values in the field used colors are based on the current page of the dataset. This implies that values used in other folders or datasets will not be shown in this list.

  • Tap the arrows next to the field numerical values to switch between entering RGBA, HSLA or HEX-codes.

  • When entering a value using the field numerical values, the color-selector, color-slider and opacity will be filled in accordingly.

Summary

The Kiosk contains a lot of values that need to be entered, therefore a lot of actions can be taken in the page of the Kiosk-Editor:

Survey Editor

Creating a new survey dataset

When opening the Survey editor for the first time in ZBOS Control, a new dataset will be created automatically.

Tap the New button in the File menu to create a new dataset.

NewDataset
  • If a new dataset is created while a current dataset is opened, a popup will be shown asking if the current dataset may be overwritten.

  • In this chapter, the example of a quiz-dataset will be used, as it contains more features than a survey.

Selecting the type of dataset

When creating a new dataset, the type of dataset needs to be defined. There are 2 types available, specifically: Quiz or Survey.

SelectDatasetType

A quiz-type dataset can mark answers as correct and may show a score at the end of the quiz. A survey however, can only show a statistical overview of the answers at the end of the survey.

Both types of dataset store the result on the robot, but in the current version of ZBOS Control it isn’t possible to download the bundled results yet.

Select the default language

The next step is to choose a default language for the dataset. Tap the language to be used to select it and tap the Accept button to apply the changes.

LanguageSelection
This language will automatically be used if no translations are available. For more information see the chapter Editing the translations for a survey.

Editing the first question

Every dataset needs to contain at least one question. Removing all questions will still show at least one (blank) question on-screen.

A first question will automatically be added to the dataset and the editor for the question will automatically be opened. For more information on editing a question, see the chapter Editing a question.

Saving a survey dataset

To launch the dataset directly from an icon-block in the kiosk, the name of the saved dataset can’t contain spaces.

There are 2 available options to store the dataset, specifically:

  • Both options save the currently edited dataset.

  • To use the dataset directly from the kiosk, the dataset needs to be stored on the robot.

  • If no name has been entered for the dataset, a popup will be shown when saving the dataset for the first time.

Saving a survey locally

Tap the option Save locally in the File-menu to store the dataset in ZBOS Control.

SavingLocally

Uploading a survey to the robot

Before uploading a dataset to the robot, all values must have an entry in the translation matrix (at least for the default language). See the chapter Editing the translations for a survey for more information.

Tap the option Upload to robot in the File-menu to store the dataset on the robot.

UploadToRobot
This will upload the currently active dataset, not the one stored locally. For continuity, make sure the dataset is stored both locally and uploaded to the robot.

Editing a survey dataset

Before adding questions or answers to the dataset, some options need to be filled in to store the dataset correctly on the robot.

Editing the name of the dataset

This reference is needed when creating a direct link to the dataset in a kiosk-icon using the data_source variable. Do not use spaces for this section.

Tap the md edit icon next to the name of the dataset (top left corner of the survey editor-page) to edit the name of the dataset.

EditName

Enter the name in the modal and tap the Accept button to apply the changes.

NameModal

Editing the title of the dataset

Tap the md edit icon next to the title (in the title-bar in the preview- and answer-screen) to edit the title of the survey.

EditTitle

Enter the title to be used for the entire survey in the modal and tap the Accept button to apply the changes.

TitleModal

Editing the settings of the dataset

Tap the icon md options in the top right corner of the survey editor and select the option Settings in the menu to open the settings.

OpenSettings
List of settings

The following options are available for the dataset as a whole:

Settings
Repeatable

If this option is checked, the survey will repeat indefinitely. If the option is unchecked, the survey will close at the end and return to the previous screen. (1)

Ask email

If this option is checked, the user can/must input an email address. Additional options will be available for when the email will be asked and if entering an email address is mandatory.

Email required (requires Ask email)

If this option is checked, entering a valid email address is mandatory.

Email afterwards (requires Ask email)

If this option is checked, the user will be asked for an email address at the end of the survey, otherwise it will be asked at the start of the survey, before the first question.

Show reset popup

If this option is checked, a popup will be shown asking to reset the survey or quiz if no action has been detected for 5 seconds. The user then has the time set in the option Show popup after period (s) to reset the survey or to continue.

Show popup after period (s) (requires Show reset popup)

Enter the time for inactivity (2) after which the reset popup will be shown.

Set max time for questions (Quiz-type datasets only)

If this option is checked, the user must answer within a certain time or the answer will be counted as incorrect.

Skip question after period (s) (requires Set max time for questions)

Set the time for the countdown for answers (2) in seconds.

Allow to go back previous question

If this option is checked, the previous answers can be revised.

Show score (Quiz-type datasets only)

If this option is checked, the correct or incorrect answer will be shown after each question.

Show results

If this option is checked in a quiz, the final score of the quiz will be shown at the end of the quiz. If this option is checked in a survey, a summary of all answers entered by all users will be shown at the end of the survey.

Close last window automatic

If this option is checked, the last window will close automatically after some time.

Close after period (s) (requires Close last window automatic)

Set the time in seconds before the dataset is closed automatically at the end of the questionnaire and the previous instance is shown (1).

Move (requires Speech)

If this option is checked, the robot will move the limbs (if possible) when asking the question.

Speech

If this option is checked, the robot will speak the questions out loud using the settings in the translation matrix. (3)

  1. If the survey was launched from the app, the app will be shown. If the survey was launched directly from the kiosk, the kiosk will be shown.

  2. Make sure the setting for reset popup and max time for questions do not overlap (i.e. reset popup set to 10 seconds, answer-time set to 12 seconds). This may cause the reset to never happen, since the question will already have been marked as incorrect.

  3. If no translated text is available, the default text will be spoken with the set language engine (e.g. English text spoken with a French speech engine).

Editing the content of the survey

The main content of the dataset consists of questions with a specific type of answer.

Adding questions

Tap the Add-button in the left column of the editor to add a new question to the dataset.

AddNewQuestion

Enter the question into the shown modal and tap the md check icon to apply the changes.

EditQuestionModal

Editing the questions

Tap the md edit icon next to the question to alter the settings and content of the question (and the answers).

EditQuestionModal2
The question will already be entered as well as the settings for the answers.
List of answer-types
The types of answers need to be set in the question. Only one type of answer can be set per question.

The table below lists the options and restraints for the available answers.

Type Description Features

Multiple Choice (Horizontal)

Multiple choice answers (max. 4) are shown in a horizontal layout.

Images can be shown

Text can be aligned at the top or bottom or the button

Multiple items can be selected

Multiple Choice (Vertical)

Multiple choice answers are shown in a list

Unlimited number of available answers

Width will be adjusted to the widest answer

Multiple items can be selected

Slider

A slider is shown for entering numbers

Customizable values

Customizable steps

Text

Users can enter any text value

Free user-feedback

Survey only

To allow the user to select more than one multiple choice option, the option Multi-select needs to be checked in the settings for the question.
Adding answers to the question

Horizontal Multi-select

Tap the icon to add up to four answers to the questions.

AddHorizontalAnswer

Enter required settings in the modal and tap the icon md check to apply the settings.

  • The option Is correct will only be shown for quiz-type datasets

  • The option Text location will only be shown once an image has been selected

  • If an image has been defined, the image will fill the entire block, and the titles will be shown above or below the options.

  • The selected image must be stored on the robot and will be shown in full-screen.

If the displayed image isn’t up to scale or if the text is displayed incorrectly, add a blank background to the source-material.

Vertical Multi-select

Tap the icon in the bottom right to add a new answer to the question.

AddVerticalAnswer

Enter the required information in the modal and tap the icon md check to apply the changes.

EditVerticalModal
The option Is correct will only be shown for quiz-type datasets.

Slider

The options for the slider need to be set in the question itself.

EditSlider

Enter the minimum value, maximum value and the step interval in the settings of the question in the set fields and tap the icon md check to apply the new settings.

The option Correct number will only be shown for quiz-type datasets.

Text (Survey only)

Set the type of answers in the question for the answer.

EditText
Editing answers

Tap the answer to show the edit- and delete-buttons. Then, tap the icon md edit to open the settings for the selected answer.

EditAnswer
Deleting answers

Tap the answer to select it and show the edit- and delete-buttons. Then, tap the icon md trash to delete the selected answer selected answer.

DeleteAnswer
To remove all answers from a question quickly, change the question to a slider-type and then change it back to the a multi-select-type.

Deleting a question

Tap the icon md trash next to the question to remove it from the dataset.

DeleteQuestion
This option is only available if more than one question is in the dataset.

Editing the style of a survey dataset

Tap the icon md options and select the option Style to open the modal for editing the style-settings.

EditStyle

A (rather large) list of available styling-options is shown in a modal. To make this list a little more comprehensible, the options will be shown one category at a time.

Background

The setting will be applied for all the questions in the survey.
Styling Background

Tap the option Type to set the type of content to use as a background for the entire dataset. The background can be set as a single color, a gradient of two colors or as an image.

BGTypes

Color

If this option is selected, a color-wheel will be shown where the background-color can be selected. For more information, see Color-wheel.

Gradient

If this option is selected, 2 colors can be specified, specifically a top color and a bottom color. The background for the component will then be filled in gradually to flow from the top color into the bottom one.

Image

If this option is selected, an image stored on the robot can be chosen to be used as background for the kiosk.

IconSelection

Icon

An icon can also be specified to be used by the survey. This icon will be shown in the following locations:

  • During the language-selection screen, the icon will be displayed in the bottom-right of the screen

  • During the survey, the icon will be displayed in the top-left of the menu-bar

IconLocations

Tap the selection-icon md arrow dropdown to select an image stored on the robot that will be used as an icon for the survey.

Styling Icon

Top Menu Bar

The top menu bar can be further customized by setting the font and background-color.

Styling TopMenuBar

Font size

This option sets the size of the text in the menu-bar.

Font color

This option sets the color for the text in the menu-bar using a color-wheel.

Background color

This option sets the background color for the menu-bar using a color-wheel.

Bottom border color

This option sets the color for the border just below the menu-bar.

To hide the border, set the bottom border color to the same color as the background color.

Question

These settings will be applied for all the questions.

The question will be shown just below the top menu bar. The following styling options can be changed for all questions.

Styling Question

Font size

This option sets the size of the question.

Font color

This option sets the color the question will be displayed in.

Bold

If checked, the question will be displayed in bold. Otherwise, normal text will be used.

Reset-icon

In the top-right of the main display, the reset icon ( md close ) can be shown to reset the questionnaire. The following options are available for this button:

Styling ResetIcon

Show

If this option is checked, the rest-icon will be shown in the set color.

Color

This option sets the color for the reset-icon.

Answers

The settings for the background-color do not apply to answers where an image has been selected. Only the settings for the border- and text-color will be applied.

The answers (or options) can also be changed in terms of display.

Styling Answers

Font color

This option sets the color for the text displayed for the answers.

Background color

This option sets the background-color for the answer if it hasn’t been selected.

Background color selected

This option sets the background-color for the answer if it has been selected.

Border color selected

This option sets the color for the border around the answer if it has been selected.

Navigation

The final part of the survey that can be customized in terms of styling is the navigation-bar at the bottom of the page. The following options can be set for this section:

Styling Navigation

Arrow-color

This option will set the color for the previous- and next-icons ( md arrow back and md arrow forward ).

Font color

This option can be used to set the color for the page-numbers.

Background color

This option can be used to set the background-color for the navigation-bar.

Background color - Done

This option can be used to set the foreground-color of the navigation-bar.

Editing the translations for a survey

Tap the option Translations in the menu bar to show the translation matrix.

Translations Required

Note that every entry in the list must have a value for the default language (i.e. the language in which the dataset was created).

Adding a language to the translation matrix

Do not add an existing language to the matrix. This will cause the survey dataset to be invalid.

Tap the button Add language to add a new language to the list.

Translations Add

Select an icon from the list and tap Accept to add the language to the matrix.

Translations Result

Enter the translated terms in the corresponding box and tap the icon md check to apply the changes.

If no entry is defined for the translated language, the text set in the default language will be used.
After entering the translated values, use the preview option to show the translated values in the survey.

Show survey preview

Tap the icon md edit to open a modal to show a preview.

PreviewModal

Tap a language to be used for display and tap the button Accept to show the preview of the dataset.

  • Previewing the dataset will change the icon md edit to the set language.

  • Questions can still be added to the dataset but answers cannot. Adding a question to the dataset may cause the survey to be unable to be uploaded until all values are entered in the translation matrix.

Tap the language icon to open the modal and select the option Edit mode to continue editing the dataset.

Loading a survey dataset

It is highly recommended to save the current dataset before opening a new dataset.

There are two locations where dataset can be loaded from, specifically:

  • Locally in ZBOS Control

  • On the robot itself

Load a local dataset

The button at the bottom of the load-modal will change to Open survey or Open quiz depending on the type of dataset that has been selected.

Tap the option Local list to show the dataset stored in ZBOS Control.

LoadLocal

As shown in the image, a distinction is made between survey- and quiz-type datasets. Tap the dataset to be loaded to select it and select the option Open to load the dataset.

LoadLocalModal

Load a dataset stored on the robot

The button at the bottom of the load-modal will change to Open survey or Open quiz depending on the type of dataset that has been selected.

Tap the option List on robot to show the dataset stored on the connected robot.

LoadRobot

As shown in the image, a distinction is made between survey- and quiz-type datasets. Tap the dataset to be loaded to select it and select the option Open to load the dataset.

LoadRobotModal

Deleting a survey dataset

To remove a dataset from either ZBOS Control or a connected robot, open the Load-modal (see Loading a survey dataset ) and tap the icon md trash next to the dataset to delete it.

Managing surveys externally

The datasets stored in ZBOS Control and on the robot can be exported to an external device to create a backup of the current content. In addition, the used media-files can be exported as well in case the survey needs to be shown on another robot.

The images will be exported as a separate zip-file and will be stored in the default location Download/ZBOS/Media. This zip-file needs to be uploaded to a robot using the media-manager, not the survey editor.

Exporting an existing dataset

Tap the option Export in the File menu to open the modal showing the dataset to be exported.

Export

In the new modal, the following options are available:

ExportModal
  1. Select the location of the dataset to be exported.

  2. Select whether the images used by the dataset should also be exported in a separate zip-file.

  3. Download the dataset with the optional zip-file to the connected device. The dataset will be stored in the location Download/ZBOS/Surveys_quizzes as a .qs-file. The zip-file (containing the media-files) will be stored in the location Download/ZBOS/Media.

The exported files can then be copied or stored on an external device as a backup. For more information on copying data from the tablet/smartphone to a computer or external device, please see the user manual for the tablet/smartphone.

  • The images will only be downloaded to the tablet/smartphone if ZBOS Control is connected to the robot.

  • The files may not be shown in the list of recent files for the user.

Importing a stored dataset

The survey editor will only import the list of questions and answers, not the media files. These need to be uploaded using the Multimedia-page.

Tap the option Import in the File menu to import a dataset to ZBOS Control.

Import

A modal will be shown where the dataset can be selected and imported.

ImportModal

Tap the option Select file and select the .qs-file to be imported from the device. Then, tap the option Import to store the dataset in ZBOS Control.

To store the dataset on the robot, load the recently imported dataset and tap the option Upload to robot.

Survey sample

For this chapter, the following questionnaire will be used.

SurveySampleMap

Requirements

The following requirements should be met before creating the dataset.

  1. All the necessary media-files are stored on the robot

In this sample, the styling will not be discussed.

Use-case

The survey-example below is used to ask for feedback from customers, and linked in the kiosk to be started after certain explanations have been given. The questions are the most basic, and can be applied to (most) businesses.

Questions

The following questions need to be entered for this sample:

SurveySampleQuestions

Question 1

The first question can be answered by entering a number on a scale from 0-10.

SurveyQ1

The following answer(s) are available for the end-users:

SurveyA1

Question 2

The second question can be answered by tapping one of the available options.

SurveyQ2

The following answer(s) are available for the end-users:

SurveyA2

Question 3

The third question can be answered by tapping one or more of the available options.

SurveyQ3

The following answer(s) are available for the end-users:

SurveyA3

Question 4

The fourth question can be answered by tapping one or more items in the list with images.

SurveyQ4

The following answer(s) are available for the end-users:

SurveyA4

Settings

Since this survey was intended to be launched after a kiosk-item (containing a composition) was finished, the following options were used:

SurveySettings

Quiz sample

For this chapter, the following quiz questions will be used:

QuizSampleMap

Requirements

The following requirements should be met before creating the dataset.

  1. All the necessary media-files are stored on the robot

In this sample, the styling will not be discussed.

Use-case

The quiz is used to entertain children and is started directly from the kiosk.

Questions

The following questions need to be entered for this sample:

QuizSampleQuestions

Question 1

The first question can be answered by entering a number from 20-50 with a possible answer at every 10 (20,30,40,50).

QuizQ1

The following answer(s) are available for the end-users:

QuizA1

The correct answer has been marked as 40.

Question 2

The second question can be answered by tapping one of the available options (Correct answer is Green mushroom).

QuizQ2

The following answer(s) are available for the end-users:

QuizA2
The images have been extended to allow for more text to be placed at the bottom.

Question 3

The third question can be answered by tapping one or more of the available options.

QuizQ3

The following answer(s) are available for the end-users:

QuizA3

Question 4

The fourth question can be answered by tapping one or more items in the list.

QuizQ4

The following answer(s) are available for the end-users:

QuizA4

Note: If anyone knows any other potential answers that could trip people up, please contact me here.

Question 5

This question can be answered by tapping one or more items in the list.

QuizQ5

The following answer(s) are available for the end-users:

QuizA5

Settings

Since this survey was intended to be launched directly from the kiosk, the following options were used:

QuizSettings

Note that the auto-skip and auto-close options have been checked to keep the quiz moving along.

We sincerely hope the Survey app will provide a valuable service to your home or business. Hopefully you will continue to provide us with the desired features or bugs which occurred in the workplace, so we can keep improving and expanding the product.

In case you need to contact us, please use the contact-information below.

Documentation Portal

https://docs.zoracloud.com

Website

https://zorabots.com/index.php/en/contact

Ticketing

https://zorabots.freshdesk.com

Telephone

+32 59 20 03 11

Address

Archimedesstraat 17
8400 Oostende
Belgium