Dies ist eine alte Version des Dokuments!
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.
%link%
verwendet wird. Falls kein Link angegeben wird, wird der Der Link zum Fragebogen ohne weitere Spezifikation eines Fragebogens verwendet.%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.mailSend()
kann pro Interview eine bestimmte Serienmail nur einmal an eine bestimmte E-Mail-Adresse verschickt werden.mailSend()
maximal 20 E-Mails verschickt werden.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.
Hinweis: Dieser Anwendungsfall lässt sich i.d.R. einfacher mit einer Frage vom Typ E-Mail an persönlichen Kontakt und ganz ohne PHP-Code umsetzen. Hier ist nur eine alternative Lösung mittels mailSend()
dargestellt.
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); }
Ein Teilnehmer füllt einen Test aus, der Punktwert wurde in Variable $points
berechnet und soll nun zusammen mit der Teilnehmern-Kennung (SERIAL) an eine Mailadresse geschickt werden, damit der Forscher automatisch über abgeschlossene Tests informiert wird.
Dafür wurde unter Einladungen verschicken → Serienmails eine Serienmail (ID 1) angelegt, die u.a. folgenden Inhalte hat:
Teilnehmer: %custom1% Testergebnis: %custom2%
Auf der letzten Seite des Fragebogens würde nun unter der Berechnung des Punktswerts ($points
) folgender PHP-Code platziert, um das Ergebnis an store@example.com
zu senden.
mailSend('store@example.com', 1, 0, NULL, caseSerial(), $points);