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

# 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

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

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
Last Updated: 3/6/2024, 8:44:10 AM
© 2024 movisens GmbH, Imprint