The Questionnaire | Edit... menu option and toolbar button, shown below, displays the Editor screen that allows you to insert or modify questions or sections into your questionnaire.
This section of the manual explains how the item editor screen works and summarises the different question types available. However, since questions are the main component of a questionnaire or survey, you should also read the two chapters described below.
Item Editor Screen - Questions
The Questionnaire | Item Editor screen is a special tabbed screen that allows you to change between question types without loosing any common information. It also lets you insert or modify sections. For a detailed explanation of the options for different question types, see "Chapter 14: Questions in Detail".
This is the text that will be displayed to the user when you run the survey to capture answers.
Defines where the result of answering a particular question will be directed. For more a detailed discussion of how questions map on to data, see "Chapter 3: -- "Questions and Collected Data".
Follow Up Questions Start At
If you want to follow the current question with a series of common questions you choose the starting question or section from the list. If you are working on questions within the 'Common Section' then this item will not appear on the dialog.
If you ask a question more than once in a survey, for example with questions in a common section, the answer many be similar the previously answered question. To save the handheld user typing this in again you can set an initial value to use previous to automatically display the previous answer to the question. The user can then accept the answer with the enter key or change it as required.
You can also set the initial value to the contents of a specified variable.
Tick Confirm to prompt to the user running the survey to confirm their answer by accepting or retyping the answer as shown below
This forces the user to answer the question.
Commonly Used Buttons
The commonly used buttons Insert, Modify, Close and Help, work as expected.
Inserting & Modifying Questions
If your mouse is positioned on a section name or at the end of the list (on the diamond) choosing question from the menu or toolbar will show an empty question screen prompting you to insert a question before the current cursor position.
However if your cursor is positioned on a question in the question/section display area the question screen will be displayed with the existing question details. You can then modify the details or type in different name and insert another question.
Move around questions with a single click!
Summary of Question Types
For a detailed explanation of the options for different question types, see "Chapter 13: Questions in Detail". This section summarises the type of questions available.
Menu Choice - Single select or Multiple select
User choice of one or more answers from a list of choices. Used where answers are predictable, multiple-choice questions make the resultant data quicker to record and easier to analyse than where free text has been used.
Can allow one or several choices from one list. Allow the user to type answer in if no suitable choice is available on the list(s).
Entry of a number by user. Used where a predictable number is to be recorded, e.g. property code or serial number of equipment. Numbers have a pre-defined precision and optional range checking.
Text questions prompt the user to enter text. Text length can be constrained by setting maximum and minimum lengths. Certain text conversions can also be applied.
Entry of formatted string by user. Used where a predictable code is to be recorded, e.g. property code or serial number of equipment.
Provides a means of skipping questions automatically in a directed section, or jumping out of a random section.
Auto Time. Enters date automatically from the handheld computer's clock in the format set in the Settings screen.
Auto Date. Enters time automatically from the handheld computer's clock in the format set in the Settings screen.
Input Time. Allows a user defined time to be entered for example to enter an appointment time.
Input Date. Allows a user defined date to be entered for example to enter an appointment date.
This is enables you to link to another survey design. At run-time PocketSurvey will start another instance of itself with the survey name that you give here already loaded. The survey identifier of the present survey will be concatenated with that of the linked survey with an optional delimiter between the two.
When the user comes to the end of the linked survey they will not be asked to confirm that they wish to quit. Instead, the linked survey will close and the present survey will continue.
The lookup question type allows you to reference data in external comma separated files. The values returned are store in a variable and can be used to dynamically define items on a single choice of multiple-choice question.
Expressions allow computations to be performed between basic types and return the result of such computations.
Allowable computations are addition (+), subtraction (-), multiplication (*), division (/), and power (^). These operators may be used with most basic types as operands, but certain pairings may produce run-time errors, e.g. "fred" * 2
Allow you to jump to another question depending on the conditions specified.
Item Editor - Sections
The Section Tab on the item editor screen lets you insert or modify a section within a questionnaire design. For a detailed explanation of sections, see "Chapter 3: -- What are Sections?"
Section Screen Options
The options for specifying or changing sections are described below. Apart from the title of the section you must specify whether it is a random section or a section that follows in a directed sequence and whether the section must be answered.
Section Prompt or Title
Enter an alphanumeric string, with spaces if desired, to describe the section. You can write it like a short phrase or sentence.
Forces the user to enter the section when running the survey.
Random means that the questions within the section will be presented to the user just like a menu, with the menu title will being the section name. The user can then choose answer (and re-answer) the questions in any order.
Directed means the questions within the section are presented to the user in the same order as they appear in the survey design.
Form presents the question to the user on a single form.
Insert a new section above the current cursor position. Remember that section names must be unique in a questionnaire
Modifies the details of the currently selected section.
Commonly Used Buttons
The commonly used buttons Close and Help, work as expected.
Move around sections with a single click!
HandHeld Systems Ltd ©