mailSend()

void mailSend(string E-Mail, int SerienmailID, [int Zeitpunkt], [string Link], [string C1, string C2, string C3, string C4, string C5])

Die Funktion mailSend() verschickt die Serienmail mit der Kennung SerienmailID sofort oder zu einem definierten Zeitpunkt an eine vorgegebene E-Mail-Adresse. Die E-Mail-Adresse muss – anders als bei den Funktionen mailResume() und mailSchedule() – nicht in der Adressliste des Befragungsprojekts bekannt sein.

E-Mail
E-Mail-Adresse, an welche die E-Mail verschickt werden soll.
SerienmailID
Numerische Kennung der Serienmail, die verschickt werden soll.
Zeitpunkt (optional)
Entweder die Verzögerung bis zum Versand (in Sekunden, maximal 153900000) oder ein Unix-Zeitstempel, der den Zeitpunkt für den nächsten Versand definiert.
Link (optional)
Der Link, der in der Serienmail für den Platzhalter %link% verwendet wird. Falls kein Link angegeben wird, wird der Der Link zum Fragebogen ohne weitere Spezifikation eines Fragebogens verwendet.
C1 bis C5 (optional)
Wenn Sie hier einen Text angeben (optional), können Sie diesen Text mithilfe der Platzhalter %custom1% bis %custom5% in der Serienmail verwenden. In Verbindung mit value() können Sie beispielsweise Antworten aus dem laufenden Interview in der E-Mail anzeigen.

Hinweise

Mit der Funktion mailSend() kann pro Interview eine bestimmte Serienmail nur einmal an eine bestimmte E-Mail-Adresse verschickt werden.
Innerhalb eines Interviews können mittels mailSend() maximal 20 E-Mails verschickt werden.

Beispiel

Im Interview soll die E-Mail-Adresse eines Kollegen abgefragt, aber nicht gespeichert werden. An die E-Mail-Adresse soll eine Einladung mit Verweis auf das aktuelle Interview (Fall-Nummer CASE) verschickt werden.

Um die E-Mail-Adresse abzufragen, wird auf Seite 5 im Fragebogen ein HTML-Eingabefeld im Fragebogen platziert.

<div>
  E-Mail-Adresse des Kollegen:
  <input type="text" name="email_colleague" style="width: 160px" />
</div>

Auf der folgenden Fragebogen-Seite (nicht später!) wird die angegebene E-Mail-Adresse mittels readGET() ausgelesen und die Serienmail mit der Kennung 2 an diese E-Mail-Adresse verschickt. Im Link zum Fragebogen wird die aktuelle Fall-Nummer als Referenz angehängt.

$email = readGET('email_colleague', false);
if (trim($email) !== '') {
  $link = 'https://www.soscisurvey.de/PROJEKT/?r='.caseNumber();
  mailSend($email, 2, 0, $link);
}