NIPO ODIN Version 5.17
*LIST (question option)
Purpose
Uses answer codes from a list.
Syntax
*LIST <n|[expression]|"name">
Description
This command is always used in combination with *QUESTION and a question type definition and must be specified after these commands on the same line. An earlier defined list of codes will be used as answer codes for the question. This command may be used in the following three question types:
- In combination with a
*CODES question optionally with *MULTI, the codes and the texts from the list are used. The answer codes stored in the U-file are decided by the code numbers in the list. - In combination with a
*NUMBER question the answer must be typed. The list of available options narrows down at each character entered the number, and only code labels with a matching pattern (both labels starting with or containing the text) are displayed. When finally one is selected, the code number belonging to the answer is stored as a number in the U-file. The interviewer may use the mouse or the arrow-down key to select an answer from the (narrowed-down) list. The code numbers are not displayed in a type-ahead list and cannot be entered by the interviewer or respondent. In NIPO CAPI and NIPO CAWI, a list smaller than 25 items is changed into a drop-down box. For NIPO CAWI, take care not to use very large list as some older browsers do not properly support this. - In combination with an
*ALPHA the functionality is the same as with a *NUMBER question, except that the code label is stored in the U-file rather than the code. Note that the label text is truncated to the position definition in the *ALPHA command.
Arguments
n|expression
A positive integer or expression that indicates an existing list. If the expression is a numeric variable the expression has to be placed between square brackets. If the expression is a text variable, the expression has to be placed between double quotes.
name
The name of an existing list.
Example 1
*LIST 1
1: Citroen
2: Fiat
3: Ford
4: Hyundai
5: Mazda
6: Mitsubishi
7: Nissan
8: Opel
9: Peugeot
10: Renault
11: Suzuki
12: Toyota
13: Volkswagen
14: Volvo
15: Other *NOCON *OPEN
16: Don’t know *NOCON
*QUESTION 1 *CODES 61L2 *LIST 1
What is the make of your car?
In this example the earlier defined list is used for the answer codes.
Example 2
*LIST Cars
1: Citroen
2: Fiat
3: Ford
4: Hyundai
5: Mazda
6: Mitsubishi
7: Nissan
8: Opel
9: Peugeot
10: Renault
11: Suzuki
12: Toyota
13: Volkswagen
14: Volvo
*QUESTION 2 *CODES 63L17 *MULTI
What brands of cars do you know?
*USELIST Cars
16: Other #1 *OPEN
17: Other #2 *OPEN
18: Don’t know any brand *GOTO 9999
Example 3
*LIST Cars2
01: Alfa Romeo
02: B.M.W.
02: BMW
03: Citroen
04: Fiat
05: Ford
06: Hyundai
07: Mazda
08: Mitsubishi
09: Nissan
10: Opel
11: Peugeot
12: Renault
13: Rolls Royce
14: Suzuki
15: Toyota
16: Volkswagen
16: VW
17: Volvo
18: Other *NOCON
19: Don’t know
*TEXTVARS lname
*PUT lname "Cars2"
*QUESTION 3 *NUMBER 81L2 *LIST "*? lname"
What is the make of your car?
In this example, the list displayed is determined by a text variable and therefore the name must be placed between double quotes (") when you refer to it in the question.
When selecting the brand, for instance ‘Ford’, start typing the name. When typing for example the "F" only the list narrows down to the brands "Ford" and "Fiat". The "Other" code is always displayed because it contains the *NOCON command. Either type the "O" to select "Ford"or use the Arrow Down key, then press ENTER. This stores code number 05 in the data file.
When selecting the brand "Volkswagen" after typing "VOL" still both "Volkwagen" and "Volvo" are displayed. After typing the fourth character "K" the list narrows down to "Volkswagen" only. Note that we defined the abbreviation "VW" with the same code number.
When selecting the "Rolls Royce", after typing "RO" the brands "Alfa Romeo" and "Rolls Royce" are displayed, as the second word of
Alfa Romeo" still fits. "Citroën" also contains "ro", but this is not at the beginning of a word.
Example 4
*LIST PeugeotModels
1:Peugeot 107 [11107 ]
2:Peugeot 1007 [111007 ]
3:Peugeot 206 [11206 ]
4:Peugeot 207 [11207 ]
5:Peugeot 207 CC [11207CC]
6:Peugeot 207 SW [11207SW]
7:Peugeot 307 CC [11307CC]
8:Peugeot 307 SW [11307SW]
9:Peugeot 307 Estate [11307ES]
10:Peugeot 308 [11308 ]
11:Peugeot 308 SW [11308SW]
12:Peugeot 407 [11407 ]
13:Peugeot 407 Coupe [11407CO]
14:Peugeot 407 SW [11407SW]
15:Peugeot 4007 [114007 ]
16:Peugeot 607 [11607 ]
17:Peugeot 807 [11807 ]
18:Peugeot Partner Combi [11COMBI]
*QUESTION 4 *ALPHA L7 *LIST PeugeotModels
What model Peugeot do you have?
You can start typing the model number. The list of models will become shorter with every character that you type. Then select the appropriate model by using the arrow keys or the mouse.
In this example the model of Peugeot is asked. NIPO ODIN stores the model number specified between the square brackets.
|