====== multiLevelDown() ======

''void **multiLevelDown**(string //FragebogenKennung//, [mixed //Daten//])''
    
Die Funktion ''multiLevelDown()'' startet den Fragebogen mit der Kennung //FragebogenKennung// und übergibt eventuell angegebene //Daten// an den untergeordneten Fragebogen.

**Hinweis:** Der Befehl ''multiLevelDown()'' beendet die Ausführung des aktuellen PHP-Codes und der aktuellen Fragebogen-Seite und springt direkt in den untergeordneten Fragebogen.

Wenn der Teilnehmer den untergeordneten Fragebogen beendet (erreichen der letzten Seite oder mittels ''[[:de:create:functions:multilevelreturn]]''), kehrt er zum Hauptfragebogen zurück, in welchem ''multiLevelDown()'' verwendet wurde.

  * //FragebogenKennung//\\ Kennung des Fragebogens, der aufgerufen werden soll.
  * //Daten//\\ Daten, welche optional an den untergeordneten Fragebogen übergeben werden sollen, und dort mittels ''[[:de:create:functions:multileveldata]]'' abgerufen werden können.

Die Verwendung dieser Funktion wird im Kapitel [[:de:create:multilevel]] -> [[:de:create:multilevel#echtes_multi-level_design|Echtes Multi-Level-Design]] erklärt.


===== Zuordnung =====

Durch ''multiLevelDown()'' wird im Datensatz ein weiterer Fall erzeugt, in welchem die Daten aus dem untergeordneten Fragebogen gespeichert werden.

Die Fallnummer (CASE) des übergeordneten Falls wird in allen untergeordneten Fällen eines Interviews in der Variable REF vermerkt. Wenn z.B. innerhalb eines Interviews des Fragebogens "main" drei untergeordnere Fälle des Fragebogens "sub" erstellt werden, so könnte die Datenstruktur aussehen wie folgt:

^CASE^QUESTNNR^REF^Beschreibung^
|   1|    main|   |Teilnehmer A (übergeordneter Fragebogen)|
|   2|     sub|  1|Teilnehmer A (untergeordneter Fragebogen 1)|
|   5|     sub|  1|Teilnehmer A (untergeordneter Fragebogen 2)|
|   7|     sub|  1|Teilnehmer A (untergeordneter Fragebogen 3)|

Die Fälle stehen im Datensatz nicht zwangsläufig direkt untereinander. Wenn zwischen dem Erstellen der untergeordneten Fragebögen andere Interviews starten, stehen diese zwischend den Fällen, zum Beispiel:

^CASE^QUESTNNR^REF^Beschreibung^
|   1|    main|   |Teilnehmer A (übergeordneter Fragebogen)|
|   2|     sub|  1|Teilnehmer A (untergeordneter Fragebogen 1)|
|   3|    main|   |Teilnehmerin B (übergeordneter Fragebogen)|
|   4|    main|   |Teilnehmer C (übergeordneter Fragebogen)|
|   5|     sub|  1|Teilnehmer A (untergeordneter Fragebogen 2)|
|   6|     sub|  3|Teilnehmerin B (untergeordneter Fragebogen 1)|
|   7|     sub|  1|Teilnehmer A (untergeordneter Fragebogen 3)|