====== multiLevelURL() ======

''string **multiLevelURL**(string //Fragebogen//, [mixed //Daten//, mixed //Hash//])''

Die Funktion ''multiLevelURL()'' funktioniert wie ''[[:de:create:functions:multileveldown]]'', führt die Befragten aber nicht direkt zum untergeordneten Fragebogen ([[:de:create:multilevel]]), 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 ''[[:de:create:functions:mailsend]]'' oder ''[[:de:create:functions:mailschedule]]''.

  * //Fragebogen// -- Der untergeordnete Fragebogen, der durch die URL aufgerufen wird.
  * //Daten// -- (optional) Daten, welche für ''[[:de:create:functions: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.


===== Beispiel =====

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 ''[[:de:create:functions: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.

<code php>
foreach ($emails as $email) {
    $url = multiLevelURL('details', $email, $email);
    mailSend($email, 1, 0, $url);
}
</code>