NIPO ODIN Version 5.17
*INCLUDE
Purpose
Transfers data within a questionnaire.
Syntax
*INCLUDE <Qn> <Qm|[expression]|[range]>
Description
This command is also allowed under condition. One or more answer codes are combined in the receiving data field.
Arguments
Qn
The question reference of the data field where the codes must be merged. For more codes to be inserted in a question, the question must be multiple coded (*CODES *MULTI). On single-coded questions, the existing code is overwritten with the highest code in the second parameter.
Qm
All codes of this question will be merged in the specified data field. This question may be a single (*CODES) or a multiple codes question (*CODES *MULTI).
expression
The result of the expression represents a code value. This code is marked in the data field.
range
Specifies a range of more than one code, separated by semicolons, that should be marked in the question. Use TO to specify a range.
Remarks
- Use the
*COPY command to overwrite original contents. Use *EXCLUDE Qn Qn to clear all answers from a multiple-coded question. - Contrary to the
*COPY command the *INCLUDE command does not give warning messages when data positions are used more than once, except when the *INCLUDE command is specified before the actual question definition. - When copying text or an
*ALPHA question into an *ALPHA question, use *COPY rather than *INCLUDE. - When a question already contains the codes that were included, nothing changes.
- When including more than one code or including a range in a question that is not
*MULTI, only the last code that was specified is included.
Example 1
*QUESTION 1 *CODES 71L10 *MULTI
*INCLUDE Q1 [3]
*INCLUDE Q1 [4]
*INCLUDE Q1 [5]
*INCLUDE Q1 [7]
The contents of the question will be: 2, 3, 4, 5 and 7. This may also be specified as:
*INCLUDE Q1 [3;4;5;7]
Or as:
*INCLUDE Q1 [3 TO 5;7]
Note:
Do not separate codes with commas.
Example 2
*QUESTION 1 *CODES 71L10 *MULTI
*QUESTION 2 *CODES 121L8 *MULTI
*INCLUDE Q1 Q2
The answers of Q2 are merged into the answers of Q1. For example, if Q1 contained codes 1 and 4 and Q2 contains codes 1, 3 and 7, Q1 will contain codes 1, 3, 4 and 7.
|