# Forms

# Define a Form

Start by adding a new form: Click on the + button on the top right corner.
Then add items (question formats) to your form by dragging them from the left side to the position in your form.
Save the form frequently by clicking the checkmark symbol on the top right corner.

Warning!

If you leave the forms page without saving your changes will be lost!

# Editing a form during a running study

Warning!

If you edit anything in your form while your study is already running, the changes won't propagate automatically to your participants' devices.

To fetch the changes on your participants' devices, they need to follow the steps described in the chapter App usage.

# Edit Items

You can edit an item by clicking the pen in the top right corner of an item.

Define a question you want to ask the participant.
Define a label for this question. You will see this label as a column header in your results table that you will download at the end.
Define if this item is required or not. In some item formats (e.g. Visual Analog Scale) a default value is present. In this case the required field will be ignored.
The visibility rule defines if this item will be shown. This rule is necessary for branching. Please check the branching chapter.
For some item formats you have to specify answer options (mainly for multiple choice items). You add an answer option by clicking the "+" button in the Item. A answer option consists of two fields:
1. The answer text the participant will see (large left box)
2. The label or number you will receive in the result download (smaller right box)

Warning!

If you rename a label after your collected data with a smartphone, you will not get the answer to this label in the results. If you rename the label back to the original, you will get the correct answers.

# Branching

Branching allows the participant to take different paths through multi-page forms depending on how the participant responded to earlier questions. Branching is done with visibility rules. These rules define if this item is shown. To define visibility rules click on the grey eye-icon which appears when hovered over an item. Visibility rules can only be defined depending on previous items of the types Select One, Select Many and Likert Scale. If one or more visibility rules are active the item will show a black eye-icon .

# Multi Item Screen

With the Multi Item Screen it is possible to display multiple items on the same page. First you select the Multi Item Screen (under the Group-Section) like any other Item. Until you fill it with other items it will be colored red. You can fill the Multi Item Screen with other items via drag-and-drop. The order in which the items are sorted within the web view determines the order in which they will be displayed on the phone.

As an example, the Multi Item Screen can be used to create an emotion scale with pictures:

Use a Multi Item Screen, put Display Image and either the Likert Scale or Visual Analog Scale in it.
Select an image with the desired symbols/pictures for the Display Image-Item.
Delete the headline and the labels from the scale-item.

⇒

# Reaction Time

With the Reaction Time Item, you can measure the time a certain screen (meaning a Multi Item Screen) is displayed. This way you can see how long a participant needs to answer one or multiple items. To use the Reaction Time Item, you have to follow these steps:

Take a Multi Item Screen from the Group-tab.
Add the item(s) you want to measure and configure it as usual.
Put the Reaction Time Item inside. This item is also available in the Group-tab. Please do not configure a headline, because the Reaction Time Item is hidden for the participant.

# Presentation (Available On Request)

This Item enables you to implement Presentation (Neurobehavioral Systems, Inc.) (opens new window) scenarios in you Study. To use the Presentation-Item you first need to install Presentation Android App (opens new window) on the smartphone. You can find this item in movisensXS under the Development-Tab in the Forms-Section. In the "Extra data"-field you can configure, if a scenario should be loaded from the Presentation-server or not and indicate the Package-ID of the presentation scenario. The following syntax starts for example the "Berg's Sorting Task" Presentation scenario:

{ "download": true, "package_id": "{A574389E-ABB8-43B3-BE58-08FFECC73806}" }

The Presentation experiment result will be saved in the Results-Table like this:

{"error_code":0,"error_description":"","output":{"custom_output":"","filenames":["/storage/emulated/0/Android/data/com.neurobs.presentation/files/data/629A44C8-6A14-4CA4-976D-24524DB828B1/GoNogo-20180131-193519-JNGAY.log","/storage/emulated/0/Android/data/com.neurobs.presentation/files/data/629A44C8-6A14-4CA4-976D-24524DB828B1/GoNogo-20180131-193519-JNGAY.txt"]},"movisensXS_File":"1517423725598.zip"}

The "custom_output" is the data printed to the PCL terminal object during the scenario. E.g. the custom_output will have the value Hello World if you write the following into your scenario:

term.print("Hello World");

Furthermore, Presentation will return an error code and the file names where the logs will be saved. All the Presentation logs are uploaded to the movisensXS-server and can be accessed via download for each individual praticipant or all at once by selecting "Multimedia Zip File". In this file you will find all files which are listed in "movisensXS_File" (one ZIP per Presentation experiment).

# Form Configuration

# Randomization (Available On Request)

With the Randomization-Option it is possible to show items randomly. In the Sampling-Scheme you can activate this option within the Form-Block. Additionally, you can choose how many items should actually be shown. For instance, if you have 30 items and want to show the participant 10 out of those 30, you would set the count to 10. In the following example the count is set to 3:

This randomization is stratified which means statistically all items will be shown the same amount of times, because the randomization picks items out of the pool of items which haven't been shown already. If all items have been shown the randomization process will start again.

If only some items are to be displayed randomly, you can put the items that are to be displayed in a defined order into a Multi Item Screen. This order is then retained. The items outside the Multi Item Screen and the Multi Item Screen itself are displayed in a random order.

# Page Indicator

The Page Indicator is an option, which adds an indicator on top of the smartphone screen to show the progress of a form. You can set this option in the Form-Item in your sampling scheme.

⇒

# Item Formats Library version 8455

# Enabled by default

Select

When used this item costs 1 credit.

Select Many

Select one or more options.

When used this item costs 1 credit.

Select One

Select one option.

Label	Description	Type	Default-Value
Auto Advance On request	Automatically advance to the next screen, if an answer is selected.	Boolean	false
Save answer as mutable value On request	Define a name to save the answer of this item as a mutable value. This mutable value can be used during the study e.g. as a condition in the sampling. Warning: Items with multiple answers store the 'Displayed Text' as the mutable value.	String

Scale

When used this item costs 1 credit.

Likert Scale

Likert scale is a bipolar item, measuring either positive or negative response to a statement.

Label	Description	Type	Default-Value
Left Extreme		String	Happy
Neutral		String
Right Extreme		String	Sad
Auto Advance On request	Automatically advance to the next screen, if an answer is selected.	Boolean	false
Save answer as mutable value On request	Define a name to save the answer of this item as a mutable value. This mutable value can be used during the study e.g. as a condition in the sampling. Warning: Items with multiple answers store the 'Displayed Text' as the mutable value.	String

When used this item costs 1 credit.

Visual Analog

Visual Analog is a bipolar item, measuring either positive or negative response to a statement.

Label	Description	Type	Default-Value
Left Extreme		String	Happy
Neutral		String
Right Extreme		String	Sad
Hide Marker if unanswered	Hide the default marker in the middle of the Visual Analog Scale	Boolean	false
Show Tooltip with value On request	Shows the selected value in a small tooltip above the VAS	Boolean	false
Left Value On request		Integer	0
Default Value On request		Integer	50
Right Value On request		Integer	100
Save answer as mutable value On request	Define a name to save the answer of this item as a mutable value. This mutable value can be used during the study e.g. as a condition in the sampling. Warning: Items with multiple answers store the 'Displayed Text' as the mutable value.	String

Free Input

When used this item costs 1 credit.

Text

Text input field.

There is no maximum for the number of characters.

Label	Description	Type	Default-Value
Save answer as mutable value On request	Define a name if you want to save the answer of this item as a mutable value.	String
History mutable value On request	Save all past answers inside this mutable value. Uses this to show history inside item.	String

When used this item costs 1 credit.

Decimal

Decimal number input field.

Label	Description	Type	Default-Value
Save answer as mutable value On request	Define a name if you want to save the answer of this item as a mutable value.	String
History mutable value On request	Save all past answers inside this mutable value. Uses this to show history inside item.	String

When used this item costs 1 credit.

Number

Whole number input field.

Label	Description	Type	Default-Value
Save answer as mutable value On request	Define a name if you want to save the answer of this item as a mutable value.	String
History mutable value On request	Save all past answers inside this mutable value. Uses this to show history inside item.	String

Output

When used this item costs 1 credit.

Display Text

Displays the headline text on the screen.

When used this item costs 1 credit.

Display Random Number

Displays a three digit random number on the screen. This number is unique during the study.

When used this item costs 1 credit.

Play Audio

Plays an audio file.

Label	Description	Type	Default-Value
Audio Filename	Audio filename from the manifest.	String
Audio scrubbing allowed	Is scrubbing (changing time in audio) allowed.	Boolean	true

When used this item costs 1 credit.

Display Image

Displays an Image.

Label	Description	Type	Default-Value
Image Filename	Image filename from the manifest.	String

Date & Time

When used this item costs 1 credit.

Date

Date input field.

Label	Description	Type	Default-Value
Default Date	The default date in the format yyyy-MM-dd. If no default is set, the current date on the smartphone is used.	String

When used this item costs 1 credit.

Time

Time input field.

Label	Description	Type	Default-Value
Default Time	The default time in the format HH:mm. If no default is set, the current time on the smartphone is used.	String
Save answer as mutable value On request	Define a name to save the answer of this item as a mutable value. This mutable value can be used during the study e.g. as a condition in the sampling. Warning: Items with multiple answers store the 'Displayed Text' as the mutable value.	String

When used this item costs 1 credit.

Date & Time

Date and time input field.

Label	Description	Type
Default Time	The default time in the format HH:mm. If no default is set, the current time on the smartphone is used.	String
Default Date	The default date in the format yyyy-MM-dd. If no default is set, the current date on the smartphone is used.	String
Save answer as mutable value On request	Define a name to save the answer of this item as a mutable value. This mutable value can be used during the study e.g. as a condition in the sampling. Warning: Items with multiple answers store the 'Displayed Text' as the mutable value.	String

Group

When used this item costs 1 credit.

Reaction Time Item

The reaction time of the item is measured.

When used this item costs no credits.

Multi-Item Screen

These items are presented on one screen.

Label	Description	Type	Default-Value
Auto advance time	Time in seconds this screen will be displayed. After the time the next screen will appear. The time 0 means, this screen will not auto advance. The items in this screen must be marked as not required!	Integer	0

Multimedia

When used this item costs 3 credits.

Video

Record video.

When used this item costs 3 credits.

Take Picture

Take a picture.

When used this item costs 1 credit.

Barcode

Scan a barcode.

When used this item costs 3 credits.

Audio

Record audio.

The participant can also listen to the recording and re-record if necessary. To use this item the participant has to grant permissions when starting the study.

Geo

When used this item costs 1 credit.

GeoPoint

Record a geopoint.

# Available on request

Item formats which are marked "On request" can be requested by contacting our support team.

If you'd like to use items which are marked "To be discontinued", please ask our support team for additional consulting.

Scale

When used this item costs 1 credit.

EQ5D Scale On request

Cool description here.

Free Input

When used this item costs 1 credit.

Number Picker On request

Pick a number in a definable range.

Label	Description	Type	Default-Value
Minimum		Integer	0
Default		Integer	50
Maximum		Integer	100
Save answer as mutable value On request	Define a name to save the answer of this item as a mutable value. This mutable value can be used during the study e.g. as a condition in the sampling. Warning: Items with multiple answers store the 'Displayed Text' as the mutable value.	String

When used this item costs 1 credit.

Color Picker Item On request

Pick a color from a specified reference image. If no image is uploaded a standard color picker will be displayed.

Label	Description	Type	Default-Value
Image Filename On request	Image filename from the manifest.	String
Auto Advance	Automatically advance to the next screen, if an answer is selected.	Boolean	false

When used this item costs 1 credit.

Image Marker On request

Displays an Image and returns the position (x,y) where the proband has clicked.

Label	Description	Type	Default-Value
Image Filename	Image filename from the manifest.	String

Output

When used this item costs 1 credit.

Display Video On request

Displays an Video from SD-Card.

The video that is to be played must be stored in .mp4 format on the following path: SD-Card/Movies/MovisensXS/

The path in the item must then be given as follows: /Movies/MovisensXS/videoname.mp4

Label	Description	Type	Default-Value
Video Filepath On request	Path to Video on SD-Card	String
Auto Start Video On request	Start Video automatically.	Boolean	true

When used this item costs 1 credit.

Display Gamification Score On request

Displays the gamification score if activated.

When used this item costs 1 credit.

Display Mutable Value On request

Displays the content of a mutable value.

More information about Mutable Values are found here.

Label	Description	Type	Default-Value
Mutable Value Name On request	The name of the mutable value that will be shown.	String	answer1

When used this item costs 1 credit.

Display Random Word On request

Displays a random word from the predefined word list. Words are only shown twice, if all other words are already shown.

Label	Description	Type	Default-Value
Word list On request	Comma separated list of words that will be shown.	String	Direction,Push,Join,Silver,Credit,Pleasure,Grass
Save answer as mutable value On request	Define a name if you want to save the answer of this item as a mutable value.	String
History mutable value On request	Save all past answers inside this mutable value. Uses this to show history inside item.	String

When used this item costs 1 credit.

Display Random Image On request

Displays an image randomly from an directory on the sdcard.

Label	Description	Type	Default-Value
Image Folder Path On request	Path to images on sdcard.	String
Already Shown Images Mutable Value Name On request	Mutable value name which stores already shown images. Use only if there is more than one random picture item which all should be randomized stratified as one entity.	String

When used this item costs 1 credit.

Stop Watch On request

Displays a stop watch.

Label	Description	Type	Default-Value
Auto Start On request	Start stop watch automatically.	Boolean	false

When used this item costs 1 credit.

Display Web-Page On request

Display a given web page in this item.

Label	Description	Type	Default-Value
URL On request	URL to web page.	String
Add Participant metadata to request. On request	Add Participant metadata to request.	Boolean	false

When used this item costs 1 credit.

Play Sound Repeatedly On request

Plays an audio file and repeats it.

Label	Description	Type	Default-Value
Audio Filename On request	Audio filename from the manifest.	String
Time to First Play On request	Time in seconds after which the first play should happen.	Integer	3
Play Count On request	How often the sound should be played.	Integer	2
Pause Time On request	Pause between the playbacks in Seconds.	Integer	30

Date & Time

When used this item costs 1 credit.

Calendar On request

Calendar to add or edit Participant Time Triggers

This item only works with the corresponding Calendar Trigger sampling block.

Label	Description	Type	Default-Value
Maximal Planning Period On request	Sets the maximal planning period in weeks.	Integer	1
Calendar Mode On request	Sets the Calendar Mode. Options [View, Add, Edit]	String	View
Lead Time On request	Time range in minutes which must be before a new events start time (usually the same as in calendar trigger)	Integer	5
Auto Advance	Automatically advance to the next screen, if an answer is selected.	Boolean	false

Group

When used this item costs 1 credit.

Repeat On request To be discontinued in future versions

These items are repeated.

Multimedia

When used this item costs 3 credits.

Choose Picture On request

Choose a picture.

Geo

When used this item costs 1 credit.

Label Static Locations On request

Label new static locations which were recorded by 'Log Static Location' block

Label	Description	Type	Default-Value
Allow Multi Tag Selection On request	If this value is true, a participant can select multiple tags to describe the location. If not, only one tag at a time can be selected.	Boolean	false
Allow Adding Tags On request	If this value is true, a participant can add new tags if there is no tag which fits him. If not, only tags can be used which are specified in 'Log Static Location'.	Boolean	false

Cognitive Tests

When used this item costs 1 credit.

PVT On request

This starts a Psychomotor Vigilance Task. Only change the default values if really required to be comparable to other studies.

Label	Description	Type	Default-Value
Test Duration On request	The tests stops with the last response after the elapsed duration [ms]. Default 5 minutes.	Integer	300000
Minimum Inter-stimulus interval On request	Minimum time period between the last response and the appearance of the next stimulus [ms]	Integer	2000
Maximum Inter-stimulus interval On request	Maximum time period between the last response and the appearance of the next stimulus [ms]	Integer	10000
Anticipante Time On request	A response time lower than the anticipate time is counted as false start [ms]	Integer	100
Lapse Time On request	A response time higher or equal than the lapse time is classified as a lapse [ms]	Integer	500
Response Method On request	Method the participant has to press to give a response (Touch or VolumeButton).	String	Touch
Feedback Enabled On request	Show feedback after interaction.	Boolean	true

When used this item costs 1 credit.

DualNBack On request

This starts a DualNBack item.

Label	Description	Type	Default-Value
Minimum Delay On request	Minimum wait time before stimulus appears (ms)	Integer	1000
Maximum Delay On request	Maximum wait time before stimulus appears (ms)	Integer	4000

When used this item costs 1 credit.

Pattern On request

This item will display a pattern, which has to be answered correctly before the study continues.

Label	Description	Type	Default-Value
Pattern Path On request	Pattern path described as numbers based on the phone keyboard layout.	String	1,5,9
Number of Attempts On request	Number of attempts before the pattern will autocomplete.	Integer	5
Background Color On request	Background color of the item. Default is fully transparent.	String	#00000000
Auto Advance	Automatically advance to the next screen, if an answer is selected.	Boolean	false

Matrix

When used this item costs 1 credit.

Matrix Select Many On request To be discontinued in future versions

Multiple of these questions can be placed inside a screen below a matrix scale. This item must have the same answer options as the matrix scale.

When used this item costs 1 credit.

Matrix Scale On request To be discontinued in future versions

This scale is placed inside a screen above multiple matrix answer items. The scale must have the same answer options as all the questions below.

Please disable the required-function for this item. If you want to have all questions answered, use the required-function in the Matrix-Select-items only.