Edit Questionnaire
You can edit existing questionnaires or create new ones (using the "Create" button).
A questionnaire consists of one or several pages. For each page, you can set a header (a text that will be shown at the beginning of the page) and / or a footer (shown after the last item of the questionnaire). Ticking "Randomize item order" will shuffle the page each time it is opened.
A page can hold as many items as you need. You can change the item order by moving them via the 
icon.
By clicking the "Change" button at the right of an item, you can change its type and settings.
Note: The variable name will be used as a column name in the data file.
Note: Be aware that each item must have a unique variable name within the whole study.
Most items can be set to forced choice (by ticking "Must be filled out") and can have a "pre-filled value" that is shown (and saved) as long as the participant has not entered anything different. Most item types can also have the option of showing a text ("Shown text") above the item. There are several item types to choose from:
Simple text view: Shows text in the questionnaire. No column will be created in the data file for this item.
Image: Embeds an image from an external source inside the questionnaire. If loading the video was successful, the item variable will be 1. Otherwise, it will be 0.
Video: Embeds a webpage with an embedded video from an external source inside the questionnaire. Be aware that the video will be loaded as a frame inside the app (or webpage). That means you can not embed the video directly but must provide a link to a webpage that embeds the video. If loading the video was successful, the item variable will be 1. Otherwise, it will be 0.
Text input: An item where the participant can input text.
Number input: An item where the participant can input a number (positive or negative). You can set if decimal numbers are allowed by ticking "Allow decimals".
Binary item: Gives two answers from which one can be chosen from.
Date input: An item where the participant can input a date.
Time input: An item where the participant can input a time of day. Its value can either be saved in the data file as text (e.g. "02:30") or as accumulated minutes (e.g. "150").
Likert scale: A Likert scale with dots. See Wikipedia.
Visual analogue scale: A scale representing 0 to 100 from left to right. If no default value is used, the scale will initially be empty and when selected, a thumb will appear at the clicked position.
Note: Be aware that the visual analogue scale behaves slightly different in the fallback version (see ESMira Website)
List - single choice: A list where the user can choose one item out of predefined options. The appearance of this item can vary on different smartphones, browsers or operating systems. The item that was chosen will be saved as text in the data file.
List - multiple choice: A list where the user can choose several items out of predefined options. The appearance of this item can vary on different smartphones, browsers or operating systems. All items chosen will be saved as text (concatenated with ";") in the data file.
Dynamic item: This item has its own pool of sub items and changes every time the questionnaire was filled out. The items can either be ordered (the first item is shown until questionnaire was filled out, then second item, ... when all items have been shown, the list restarts) or randomized (every time an item is picked at random. Each item is only shown once until all items have been shown).
List of bluetooth devices: Creates an anonymized list of bluetooth devices (Bluetooth low energy) that are nearby. After pressing a button this item scans for one minute and then saves a list of found hashed device ids and RSSI values in a JSON format.
Take a picture: For capturing photos with the camera.
Image upload: For selecting and uploading a picture from the phone storage.
Record audio: Record audio and transfer the file to the server.
Compass item: Displays a compass for providing the cardinal direction (beware: this value might be inaccurate depending on the calibration of the smartphone).
Share item: Shows a button that opens a link in the browser when pressed. In the url the phrase "USER_ID" will be replaced with the participant's user id. Saves "1" when the button was pressed.
App usage tracking: Tracks the time (in ms) that either an app or the smartphone in general was active yesterday (creates an additional variable: "X~usageCount" how many times the app was opened / the screen was enabled. -1 if the value was not available)