Differences

This shows you the differences between two versions of the page.

--- en:create:functions:multileveldown [25.01.2020 19:50] – created mueller.sara94
+++ en:create:functions:multileveldown [05.09.2023 23:07] (current) – swissel.uni-mannheim
@@ Line 1: / Line 1: @@
 ====== multiLevelDown() ======
-''void **multiLevelDown**(string //FragebogenKennung//, [mixed //Daten//])''
+''void **multiLevelDown**(string //QuestionnaireIdentifier//, [mixed //Data//])''
-The function ''multiLevelDown()'' starts the questionnaire with the //ID// and transports eventually named //data// to the subordinated questionnaire.
+The function ''multiLevelDown()'' starts the questionnaire with the identifier //questionnaireID// and passes any specified //data// to the child questionnaire.
+**Note:** The ''multiLevelDown()'' command terminates the execution of the current PHP code and questionnaire page and jumps directly to the child questionnaire.
-When the user closes the subordinated questionnaire (reaching the last page or through  ''[[:de:create:functions:multilevelreturn]]''), he returns to the main questionaire, in which  ''multiLevelDown()'' was used.
+When the participant finishes the subordinate questionnaire (reaching the last page or using ''[[:en:create:functions:multilevelreturn]]''), he returns to the main questionnaire in which ''multiLevelDown()'' was used.
-  * //questionnaire ID//\\ ID of the questionnaire that should be opened.
+  * //questionnaireIdentifier//\\ Identifier of the questionnaire to be called.
-  * //data//\\ data, which should optionally be transported to the subordinated questionnaire and there be able to be opened through''[[:de:create:functions:multileveldata]]''
+  * //Data//\\ Data which should optionally be passed to the child questionnaire, and can be retrieved there using ''[[:en:create:functions:multileveldata]]''.
-The usage of this function is explained in the chapter [[:de:create:multilevel]] -> [[:de:create:multilevel#echtes_multi-level_design|Echtes Multi-Level-Design]] .
+The use of this function is described in chapter [[:en:create:multilevel]] -> [[:en:create:multilevel#real_multi-level_design|real multilevel design]].
+===== Assignment =====
+By ''multiLevelDown()'' another case is created in the data set, in which the data from the subordinate questionnaire are stored.
+The case number (CASE) of the parent case is noted in all subordinate cases of an interview in the variable REF. For example, if within one interview of the questionnaire "main" three subordinate cases of the questionnaire "sub" are created, the data structure could look like this:
+^CASE^QUESTNNR^REF^Description^
+|      1|     main|       |Participant A (parent questionnaire)       |
+|      2|      sub|      1|Participant A (subordinate questionnaire 1)|
+|      5|      sub|      1|Participant A (subordinate questionnaire 2)|
+|      7|      sub|      1|Participant A (subordinate questionnaire 3)|
+The cases are not necessarily directly below each other in the data set. If other interviews start between the creation of the subordinate questionnaires, they will stand between the cases, for example:
+^CASE^QUESTNNR^REF^Description^
+|      1|     main|       |Participant A (parent questionnaire)       |
+|      2|      sub|      1|Participant A (subordinate questionnaire 1)|
+|      3|     main|       |Participant B (superordinate questionnaire)|
+|      4|     main|       |Participant C (superordinate questionnaire)|
+|      5|      sub|      1|Participant A (subordinate questionnaire 2)|
+|      6|      sub|      3|Participant B (subordinate questionnaire 1)|
+|      7|      sub|      1|Participant A (subordinate questionnaire 3)|