# 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:
- 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.
![](/assets/img/custom_scale.bbc15fbf.png)
⇒
![](/assets/img/multi_item_emoji.4768134c.png)
# 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.
![](/assets/img/page_indicator_form.c3cd60fe.png)
⇒
![](/assets/img/page_indicator_phone.3c455586.png)
# Item Formats Library version 8455
# Enabled by default
Select
Select Many
Select one or more options.
![](/movisensxs-itemformats/selectmanyitem.png)
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 |
![](/movisensxs-itemformats/selectoneitem.png)
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 |
![](/movisensxs-itemformats/likertitem.png)
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 |
![](/movisensxs-itemformats/visualanalogitem.png)
Free Input
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 |
![](/movisensxs-itemformats/textitem.png)
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 |
![](/movisensxs-itemformats/decimalitem.png)
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 |
![](/movisensxs-itemformats/numberitem.png)
Output
Display Text
Displays the headline text on the screen.
![](/movisensxs-itemformats/displaytextitem.png)
Display Random Number
Displays a three digit random number on the screen. This number is unique during the study.
![](/movisensxs-itemformats/displayrandomnumberitem.png)
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 |
![](/movisensxs-itemformats/playaudioitem.png)
Display Image
Displays an Image.
Label | Description | Type | Default-Value |
---|---|---|---|
Image Filename | Image filename from the manifest. | String |
![](/movisensxs-itemformats/displayimageitem.png)
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 |
![](/movisensxs-itemformats/dateitem.png)
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 |
![](/movisensxs-itemformats/timeitem.png)
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 |
![](/movisensxs-itemformats/datetimeitem.png)
Group
Reaction Time Item
The reaction time of the item is measured.
![](/movisensxs-itemformats/reactiontimeitem.png)
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 |
![](/movisensxs-itemformats/field-list.png)
Multimedia
Video
Record video.
![](/movisensxs-itemformats/videoitem.png)
Take Picture
Take a picture.
![](/movisensxs-itemformats/pictureitem.png)
Barcode
Scan a barcode.
![](/movisensxs-itemformats/barcodeitem.png)
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.
![](/movisensxs-itemformats/audioitem.png)
Geo
GeoPoint
Record a geopoint.
![](/movisensxs-itemformats/geopointitem.png)
# Available on request
Item formats which are marked "On request" can be requested by contacting our support team.
Scale
EQ5D Scale On request
Cool description here.
![](/movisensxs-itemformats/eq5ditemformat.png)
Free Input
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 |
![](/movisensxs-itemformats/numberpickeritem.png)
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 |
![](/movisensxs-itemformats/colorpickeritem.png)
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 |
![](/movisensxs-itemformats/imagemarkeritem.png)
Output
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 |
![](/movisensxs-itemformats/displayvideoitem.png)
Display Gamification Score On request
Displays the gamification score if activated.
![](/movisensxs-itemformats/displaygamificationscoreitem.png)
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 |
![](/movisensxs-itemformats/displayvariableitem.png)
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 |
![](/movisensxs-itemformats/displayrandomworditem.png)
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 |
![](/movisensxs-itemformats/randompictureitem.png)
Stop Watch On request
Displays a stop watch.
Label | Description | Type | Default-Value |
---|---|---|---|
Auto Start On request | Start stop watch automatically. | Boolean | false |
![](/movisensxs-itemformats/timeritem.png)
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 |
![](/movisensxs-itemformats/displaywebpageitem.png)
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 |
![](/movisensxs-itemformats/repeatsounditem.png)
Date & Time
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 |
![](/movisensxs-itemformats/calendaritem.png)
Group
Repeat On request
These items are repeated.
![](/movisensxs-itemformats/.png)
Multimedia
Choose Picture On request
Choose a picture.
![](/movisensxs-itemformats/choosepictureitem.png)
Geo
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 |
![](/movisensxs-itemformats/labelnewstaticlocationitem.png)
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 |
![](/movisensxs-itemformats/pvtitem.png)
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 |
![](/movisensxs-itemformats/dualnbackitem.png)
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 |
![](/movisensxs-itemformats/patternitemformat.png)
Matrix
Matrix Select Many On request
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.
![](/movisensxs-itemformats/matrixselectmanyitem.png)
Matrix Scale On request
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.
![](/movisensxs-itemformats/matrixscale.png)
Matrix Select One On request
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.
![](/movisensxs-itemformats/matrixselectoneitem.png)
ChronoSheet
Log Medication On request
List of medication taken.
![](/movisensxs-itemformats/medilistitem.png)
Log Sleep On request
Allows the participant to log his sleep.
![](/movisensxs-itemformats/sleeplogitem.png)
Development
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 |
![](/movisensxs-itemformats/presentationitem.png)
Deprecated
Face Picture On request
Take a picture of the participant with the front camera.
![](/movisensxs-itemformats/facepictureitem.png)