Question Type | Menu
Previous Topic  Next Topic 

Allows the user to choose one or more answers from one or more lists of choices. Used where answers are predictable. Menu questions make the resultant data quicker to record and easier to analyse than where free text has been used.

List Types

You can build menus from different list types: Fixed, Variable or Lookup.

Fixed. With the fixed type you hard code the menu choices in your survey design.

Variable. You can choose an existing variable that contains a list or menu items created from an earlier lookup statement.

Lookup. With the lookup type you can build and display a list directly by looking up external data. The lookup menu list type is very powerful as it combines the lookup question type with a menu type in one statement.

Advanced
Features

This option to populate the menu choices from the contents of a Variable or a dynamic Lookup is an advanced feature that is only available if you have purchased an enterprise or advanced license for PocketSurvey.

Choice

Choice is the editable area where you can add items that will appear on the user's menu.

Double clicking on a choice item will copy the item into the edit box.

Jump to

Each item in a list may have a jump attached to it. Clicking on the space next to the menu item in the Jump to column produces a drop-down list from which the target of the jump can be selected. The current question does not appear in the list and is represented instead by an asterisk (*). To remove a jump, select the asterisk (*) from the list.

At run time, jumps are executed as soon as the item is selected. If jumps are used in random mode then the run-time effect will be to move the menu cursor to the target if the jump is selected. If the jump is to the end of the questions then the section will be exited (unless already at root level).

Pseudo Section

At run-time this will display the menu with a Section-like look:

This has the advantage that previously selected items are remembered and appear with a box around the item's icon. Although it behaves in many ways like a section menu it is a still a Multi-choice menu behind the scenes; selections from it can be stored on the database by selecting an appropriate Data destination file at design time.

This option is not available with fixed lists.

See also: Menu Scoring | Pseudo Section scoring.

Append Free Text

This switch will automatically add a Free text item to the end of the menu list at run-time. It is particularly useful when constructing menus using lookup tables as it allows users to type in items that may not appear in the list.

This option is not available with fixed lists.

Free Text

Clicking this inserts the legend 'Free text' into a fixed choice list at the current position. Any 'Free text' item allows the user to enter text from the hand-held computer's keyboard at run-time.

Populate

Boilerplate answers from external files, as plain text comma separated format, may be inserted into the text window by using the populate screen, shown below.

Each working folder where you store your questionnaires can have a number of external files.

Menu scoring

A subtle feature of PocketSurvey allows you to attach a score, or value, to each item on any fixed list menu.

Menu scores are hidden in the first column of the item list. To see the score values you need to click on the column divider and drag it to the right so that you can see the score column in full.

To alter any score value, simply double-click on the score; you can now edit the score. Scores can be negative or positive.

Using menu scores

At run-time, whenever a menu is used it will automatically produce a score and place into a system variable called MenuScore. You can refer to this variable in calculations, messages, or any type of question that uses variables. If your menu is a multi-select or nested type, then the scores for each item selected will be added together before being placed into the MenuScore variable.

N.B. MenuScore is overwritten each time a menu (any menu) is used. Therefore, if you want to use or refer to a menu score, you must make sure that you do so before allowing another menu to be used.

Here is an example of how to display a menu score to the user by using the message statement

Nested Menus

Multiple lists may be defined, each list of items being referred to as a Nested Menu. If more than one menu list is defined then the user will be presented with each list in succession starting with the first menu list.

See the topic Nested Single Select Menus & Validation for more information on nested menus.

Pseudo Section scores

If the Pseudo Section switch is used (this applies only to single-select, variable or lookup type menus) then MenuScore will be set to the index of the item selected from the list. The first item on the list will be 1, the second 2, and so on. If the user selects the diamond at the end of the list or taps the Done button then MenuScore will be set to -1.

HandHeld Systems Ltd ©