multiLevelURL()

string multiLevelURL(string Fragebogen, [mixed Daten, mixed Hash])

Die Funktion multiLevelURL() funktioniert wie multiLevelDown(), führt die Befragten aber nicht direkt zum untergeordneten Fragebogen (Multi-Level Struktur), sondern erzeugt eine URL, mit welcher der Fragebogen später aufgerufen werden kann. Die Funktion ist besonders nützlich in Verbindung mit dem Versand von E-Mails, z.B. mittels mailSend() oder mailSchedule().

• Fragebogen – Der untergeordnete Fragebogen, der durch die URL aufgerufen wird.
• Daten – (optional) Daten, welche für multiLevelData() verfügbar gemacht werden sollen.
• Hash – (optional) Ein eindeutiger Wert, um den untergeordneten Fragebogen zu identifizieren.

Standardmäßig erzeugt multiLevelURL() nur einen Fall und Link pro Interview. So kann dieselbe URL angezeigt werden, auch wenn die Fragebogenseite mit dem PHP-Code mehrfach aufgerufen wird. Falls unterschiedliche Fälle erzeugt werden sollen, muss ein Wert für den Hash eingetragen werden.

In dem folgenden Beispiel soll für jede E-Mail-Adresse im Array $emails ein Fall erzeugt, und der Link an die jeweilige Adresse verschickt werden. Der Link führt zu dem Fragebogen „details“. Die E-Mail-Adresse wird im untergeordneten Fragebogen für multiLevelData() verfügbar gemacht und zugleich als Hash verwendet, damit für jede E-Mail-Adresse ein anderer Fall und Link erzeugt wird.

Die Serienmail 1 enthält in diesem Beispiel einen Platzhalter %link%, an deren Stelle der Link angezeigt wird.

foreach ($emails as $email) {
    $url = multiLevelURL('details', $email, $email);
    mailSend($email, 1, 0, $url);
}