Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- de:create:functions:mailresume [10.12.2014 14:05] – ausgelagert aus functions-respondent admin
+++ de:create:functions:mailresume [01.03.2015 14:00] – [mailResume()] admin
@@ Zeile 1: / Zeile 1: @@
 ====== mailResume() ======
-''void **mailResume**(string //PersonID//, int //Serienmail//, int //Zeitpunkt//, [string //C1//, string //C2//, string //C3//])''
+''void **mailResume**(string //PersonID//, int //Serienmail//, int //Zeitpunkt//, [string //C1//, string //C2//, string //C3//, string //C4//, string //C5//])''
 Diese Funktion versendet im laufenden Interview eine E-Mail mit einem Link, um das Interview später fortzusetzen. Dies ist vor allem in Verbindung mit einer gezielten Unterbrechung in mehrwelligen Erhebungen sinnvoll (''[[:de:create:functions:buttonhide|buttonHide()]]'').
@@ Zeile 7: / Zeile 7: @@
 **Wichtig:** Der Versand funktioniert nur dann, wenn der Teilnehmer bereits in der Serienmail-Adressliste registriert ist.
-  * //PersonID//\\ Die Personenkennung des Adressaten, der die E-Mail erhalten soll. Falls das Interview durch eine Serienmail-Einladung begonnen wurde, können Sie ''false'' eintragen, die passende Kennung wird dann automatisch ermittelt. Alternativ kann die Personenkennung mittels ''[[functions-proc#caseserial|caseSerial()]]'' ermittelt werden.
+  * //PersonID//\\ Die Personenkennung des Adressaten, der die E-Mail erhalten soll. Falls das Interview durch eine Serienmail-Einladung begonnen wurde, können Sie ''false'' eintragen, die passende Kennung wird dann automatisch ermittelt. Alternativ kann die Personenkennung mittels ''[[:de:create:functions:caseserial|caseSerial()]]'' ermittelt werden.
   * //Serienmail//\\ (Numerische) Kennung der Serienmail, die an den Teilnehmer verschickt werden soll. Im Karteireiter //Erinnerungen/Folgemail// der Serienmail muss für //Art der Folgemail// der Wert "Erinnerung oder Fortsetzung" eingestellt sein. Bitte beachten Sie die Hinweise unten.
   * //Zeitpunkt//\\ 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.
-  * //C1// bis //C3// (optional)\\ Wenn Sie hier einen Text angeben (optional), können Sie diesen Text mithilfe der Platzhalter ''%custom1%'' bis ''%custom3%'' in der Serienmail verwenden. In Verbindung mit ''value()'' können Sie also sogar Antworten aus dem laufenden Interview in der E-Mail anzeigen.
+  * //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 =====
@@ Zeile 17: / Zeile 17: @@
 **Hinweis:** Der Platzhalter ''%link%'' in der Serienmail wird nicht durch einen regulären personalisierten Link ersetzte (bei dessen Aufruf das Interview u.U. von Neuem startet), sondern durch einen Link direkt zum laufenden Interview.
+**Hinweis:** Falls die E-Mail-Adressen der Teilnehmer nicht a-priori bekannt sind, müssen diese zu Beginn des ersten Fragebogens erhoben werden, damit man ''mailResume()'' einsetzen kann. Alternativ ist die Verwendung getrennter Fragebögen und der Funktion ''[[:de:create:functions:mailschedule|mailSchedule()]]'' möglich ([[:de:survey:opt-in-live|Mehrwellige Befragungen bei Selbstrekrutierung]]).
 **Tipp:** Im Internet gibt es zahlreiche Websites, die ein Datum in einen Unix-Zeitstempel umrechnen können, z.B. [[http://www.unixtime.de/|unixtime.de]]. Auch die [[http://www.php.net/manual/de/ref.datetime.php|Datums- und Zeit-Funktionen]] von PHP (insbesondere ''[[http://php.net/manual/de/function.mktime.php|mktime()]]'' und ''[[http://www.php.net/manual/de/function.strtotime.php|strtotime()]]'') sind dafür geeignet.
@@ Zeile 22: / Zeile 24: @@
 **Tipp:** Wenn Sie den Versand der Einladung nicht zu einem bestimmten Zeitpunkt, sondern nach einer bestimmten Verzögerung wünschen, geben Sie die Verzögerung an. Denn ''mailResume()'' kann den doppelten Versand von Mails dann besser verhindern.
-===== Beispiel =====
+===== Unterbrechung eines Interviews =====
 Im folgenden Beispiel wurde der Teilnehmer mittels Serienmail zum Fragebogen eingeladen. In der Mitte des Fragebogens wird eine Unterbrecher-Seite (''[[:de:create:functions:buttonhide|buttonHide()]]'') platziert und der Text "ende1" angezeigt. Nach der 24 Stunden erhält der Teilnehmer eine E-Mail, dass er nun den zweiten Teil des Frgebogens ausfüllen möge. Der Link in der E-Mail führt ihn zur nächsten Seite im vorher unterbrochenen Fragebogen.
@@ Zeile 75: / Zeile 77: @@
 </code>
+===== Infomail an den Projektleiter =====
+Die Funktion ''mailResume()'' lässt sich auch dafür "missbrauchen", den Projektleiter über eingehende Interviews zu informieren. Dafür ist es notwendig, die E-Mail-Adresse des Projektleiters in die Adressliste zu importieren ([[:de:survey:mailing|Serienmail versenden]]). Wichtig dabei: Die Adresse darf nicht //anonym// importiert werden.
+Aus der Adressliste kann anschließend die Personenkennung des Adresseintrags ermittelt werden. Diese wird angezeigt, wenn man mit der Maus über den Adresseintrag führt oder diesen zum Bearbeiten öffnet. Im Beispiel wird als Personenkennung "ABCDE123" angenommen.
+Wurde zusätzlich noch eine Serienmail (Nummer 3) angelegt, informiert folgender PHP-Code, dass ein Teilnehmer die aktuelle Seite im Fragebogen erreicht hat.
+<code php>
+mailResume('ABCDE123', 3, 0);
+</code>