Questionnaire | Edit
Previous Topic  Next Topic 

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.

Toolbar Button

Note

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.

  • For a detailed explanation of the different question types, see "Chapter 14: Questions in Detail"


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

Question Prompt

This is the text that will be displayed to the user when you run the survey to capture answers.

Data Destination

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.

Initial Value

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.

Confirm

Tick Confirm to prompt to the user running the survey to confirm their answer by accepting or retyping the answer as shown below

Must Answer

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.

Speed Tip

Move around questions with a single click!
With the question screen open you can move around questions quickly and easily by single clicking on the question name in the item display area. You can then change the question details, click the modify button and move on the next question.

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

Number

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

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.

Formatted

Entry of formatted string by user. Used where a predictable code is to be recorded, e.g. property code or serial number of equipment.

Jump

Provides a means of skipping questions automatically in a directed section, or jumping out of a random section.

Time

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.

Link

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.

Lookup

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.

Calculation

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

Conditional Jump

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.

Must answer

Forces the user to enter the section when running the survey.

Mode

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 Button

Insert a new section above the current cursor position. Remember that section names must be unique in a questionnaire

Modify Button

Modifies the details of the currently selected section.

Commonly Used Buttons

The commonly used buttons Close and Help, work as expected.

Speed Tip

Move around sections with a single click!
With the item editor screen open you can move around sections quickly and easily by single clicking on the section name in the item display area. You can then change the section details, click the modify button and move on the next section.


HandHeld Systems Ltd ©