# 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!
# 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:
- The answer text the participant will see (large left box)
- 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 an item. To use the Reaction Time Item, you have to follow these steps:
- Take a Multi Item Screen from the Group-tab.
- Add the item 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.
# Record Front Video (Available On Request)
The Record Front Video Item is used inside a Multi Item Screen. It uses the front camera of the smartphone to record a Video while the participant answers the other items on the screen. The video will be saved under the movisensXS-Folder on the SD-Card. The video will be named with a timestamp, which can be seen in the Result-File Excel-sheet. You find this item under the Group section.
Warning!
For data security reasons, you are advised to lock the smartphone with a
PIN and format a SD-card as the internal storage. This ensures that it
is not possible to read the SD-card by simply connecting it with a
computer and transfer the videos.
Not every device is able to use a SD-card as internal Storage. We can
recommend using the Moto G5. A complete list of all recommended
devices is available in the FAQ.
# 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.
# 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 7365
ChronoSheet
Log Medication On request
List of medication taken.
Log Sleep On request
Allows the participant to log his sleep.
Cognitive Tests
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 |
Date & Time
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 |
Date & Time
Date and 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 | |
| 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 |
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 |
Development
External Application On request
This item starts an external application (Android activity) and stores the results.
| Label | Description | Type | Default-Value |
|---|---|---|---|
| Activity Intent On request | An intent to an external app that returns a value. Please read the help. | String | com.yourApp.TEST |
| Intent Extra On request | Additional information that is passed to the external app in the extra field 'XS_config'. | String | |
| Button Title On request | Title for button which starts external application. | String | Start external application |
Presentation Item On request
This item starts a Presentation scenario.
| Label | Description | Type | Default-Value |
|---|---|---|---|
| Extra data On request | Additional information that is passed to the Presentation app. | String |
Free Input
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 |
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 |
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 |
Text
Text 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 |
Geo
GeoPoint
Record a geopoint.
Group
Record Front Video On request
Records a video from the front facing camera.
Reaction Time Item
The reaction time of the item is measured.
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
Audio
Record audio.
Barcode
Scan a barcode.
Choose Picture On request
Choose a picture.
Take Picture
Take a picture.
Video
Record video.
Output
Display Image
Displays an Image.
| Label | Description | Type | Default-Value |
|---|---|---|---|
| Image Filename | Image filename from the manifest. | String |
Display Random Number
Displays a three digit random number on the screen. This number is unique during the study.
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 |
Display Text
Displays the headline text on the screen.
Display Mutable Value On request
Displays the content of a mutable value.
| Label | Description | Type | Default-Value |
|---|---|---|---|
| Mutable Value Name On request | The name of the mutable value that will be shown. | String | answer1 |
Display Video On request
Displays an Video from SD-Card.
| 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 |
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 |
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 |
Stop Watch On request
Displays a stop watch.
| Label | Description | Type | Default-Value |
|---|---|---|---|
| Auto Start On request | Start stop watch automatically. | Boolean | false |
Scale
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 |
Visual Analog + Image Extremes On request
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 |
| Left Image | Left Image. | String | |
| Neutral Image | Neutral Image. | String | |
| Right Image | Right Image. | 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 |
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 |
Select
Select Many
Select one or more options.
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 |
