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 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 multiLevelData() abgerufen werden können.

Die Verwendung dieser Funktion wird im Kapitel Multi-Level Struktur → Echtes Multi-Level-Design erklärt.

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:

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: