Übersetzungen dieser Seite:
 

Dies ist eine alte Version des Dokuments!


mailResume()

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 (buttonHide()).

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 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 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

Hinweis: Eine Serienmail kann bei Verwendung von mailResume() mehrfach an denselben Adressaten verschickt werden.

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 mailSchedule() möglich (Mehrwellige Befragungen bei Selbstrekrutierung).

Tipp: Im Internet gibt es zahlreiche Websites, die ein Datum in einen Unix-Zeitstempel umrechnen können, z.B. unixtime.de. Auch die Datums- und Zeit-Funktionen von PHP (insbesondere mktime() und strtotime()) sind dafür geeignet.

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.

Unterbrechung eines Interviews

Im folgenden Beispiel wurde der Teilnehmer mittels Serienmail zum Fragebogen eingeladen. In der Mitte des Fragebogens wird eine Unterbrecher-Seite (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.

// Falls der Zurück-Knopf im Fragebogen eingeschaltet ist,
// sollte er auf dieser Seite nicht erscheinen
option('backbutton', false);
 
// Prüfen, wie viel Zeit seit Beginn des Befragung vergangen ist
// Falls es weniger als 24 Stunden sind (24 * 3600 Sekunden), wird das Interview unterbrochen
if (caseTime('begin') < 24 * 3600) {
  text('ende1'); // Verabschiedung zum ersten Teil anzeigen
  option('resume', true); // Hinweis auf fortgesetztes Interview verhindern
  option('nextbutton', false); // Weiter-Knopf ausblenden (Interview unterbrechen)
  // Serienmail mit der Kennung 3 morgen um dieselbe Zeit versenden (also in genau 24 Stunden)
  mailResume(false, 3, 24 * 3600);
} else {
  // Ist der Teilnehmer nach 24 Stunden zurückgekehrt? Dann geht es nun direkt weiter
  goToPage('next');
}

Alternativ können Sie auch die Zeit überprüfen, die sei dem ersten Aufruf der Seite (und damit seit Vorbereitung der E-Mail) vergangen ist:

// Zurück-Knopf bei Bedarf abschalten
option('backbutton', false);
 
// Zeit des ersten Aufrufs speichern
// Wegen isset() und registerVariable() wird der Block nur beim ersten Mal ausgeführt
if (!isset($timeBreak1)) {
  // Zeit speichern
  $timeBreak1 = time();
  registerVariable('timeBreak1');
  // E-Mail vorbereiten
  // Serienmail mit der Kennung 2 genau in 14 Tagen versenden
  mailResume(false, 3, 14 * 24 * 3600);
}
 
// Prüfen, wie viel Zeit seit dem ersten Aufruf der Seite vergangen ist
// Unterbrechung, falls es weniger als 14 Tage sind (14 * 24 * 3600 Sekunden)
if (time() - $timeBreak1 < 14 * 24 * 3600) {
  text('ende1'); // Verabschiedung zum ersten Teil anzeigen
  option('nextbutton', false); // Weiter-Knopf ausblenden (Interview unterbrechen)
} else {
  // Evtl. soll der Fortschrittsbalken angepasst werden?
  option('progress', 0);
  // Ist der Teilnehmer nach 14 Tagen zurückgekehrt? Dann geht es nun weiter
  goToPage('next');
}

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 (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.

mailResume('ABCDE123', 3, 0);
de/create/functions/mailresume.1425221973.txt.gz · Zuletzt geändert: 01.03.2015 15:59 von admin
 
Falls nicht anders bezeichnet, ist der Inhalt dieses Wikis unter der folgenden Lizenz veröffentlicht: CC Attribution-Share Alike 4.0 International
Driven by DokuWiki