# Forms

# Define a Form

  1. Start by adding a new form: Click on the + button on the top right corner.
  2. Then add items (question formats) to your form by dragging them from the left side to the position in your form.
  3. 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.

  1. Define a question you want to ask the participant.
  2. 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.
  3. 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.
  4. The visibility rule defines if this item will be shown. This rule is necessary for branching. Please check the branching chapter.
  5. 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:

  1. Use a Multi Item Screen, put Display Image and either the Likert Scale or Visual Analog Scale in it.
  2. Select an image with the desired symbols/pictures for the Display Image-Item.
  3. 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:

  1. Take a Multi Item Screen from the Group-tab.
  2. Add the item you want to measure and configure it as usual.
  3. 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.

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-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

Group

When used this item costs 1 credit.

Reaction Time Item

The reaction time of the item is measured.

When used this item costs 1 credit.

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.

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

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

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

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.

When used this item costs 1 credit.

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.

ChronoSheet

When used this item costs 1 credit.

Log Medication On request

List of medication taken.

When used this item costs 1 credit.

Log Sleep On request

Allows the participant to log his sleep.

Development

When used this item costs 3 credits.

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

Deprecated

When used this item costs 3 credits.

Face Picture On request

Take a picture of the participant with the front camera.

Last Updated: 6/17/2024, 8:47:04 AM
© 2024 movisens GmbH, Imprint