Beide Seiten der vorigen RevisionVorhergehende ÜberarbeitungNächste Überarbeitung | Vorhergehende ÜberarbeitungNächste ÜberarbeitungBeide Seiten der Revision |
de:create:functions:mailschedule [01.04.2019 16:04] – admin | de:create:functions:mailschedule [01.07.2019 23:28] – admin |
---|
====== mailSchedule() ====== | ====== mailSchedule() ====== |
| |
''void **mailSchedule**(string //PersonID//, int //Serienmail//, int //Zeitpunkt//)'' | ''void **mailSchedule**(string //PersonID//, int //Serienmail//, int //Zeitpunkt//, [array //Einstellungen//])'' |
| |
Diese Funktion bereitet direkt im Fragebogen den Versand einer Serienmail vor -- etwa die Einladung zum zweiten Fragebogen. Im Gegensatz zu ''[[:de:create:functions:mailresume|mailResume()]]'' wird nicht das laufende Interview fortgesetzt, sondern die Serienmail wird genauso verschickt, als hätte man den Versand manuell vorbereitet. | Diese Funktion bereitet direkt im Fragebogen den Versand einer Serienmail vor -- etwa die Einladung zum zweiten Fragebogen. Im Gegensatz zu ''[[:de:create:functions:mailresume|mailResume()]]'' wird nicht das laufende Interview fortgesetzt, sondern die Serienmail wird genauso verschickt, als hätte man den Versand manuell vorbereitet. |
* //Zeitpunkt//\\ Die Verzögerung bis zum Versand (in Sekunden, maximal 153900000) __oder__ ein Unix-Zeitstempel, der den Zeitpunkt für den nächsten Versand definiert. | * //Zeitpunkt//\\ Die Verzögerung bis zum Versand (in Sekunden, maximal 153900000) __oder__ ein Unix-Zeitstempel, der den Zeitpunkt für den nächsten Versand definiert. |
* //Einstellungen//\\ Optionale Einstellungen, als assoziatives Array angegeben mit folgenden Schlüsseln: | * //Einstellungen//\\ Optionale Einstellungen, als assoziatives Array angegeben mit folgenden Schlüsseln: |
* '''status''' Erinnerungs-/Folgemails nur verschicken, wenn der Link in der usprünglichen Serienmail ... | * '''status'''\\ Erinnerungs-/Folgemails nur verschicken, wenn der Link in der usprünglichen Serienmail ... |
* '''finished''' -- ...geöffnet und der Fragebogen bis zum Ende ausgefüllt wurde | * '''finished''' -- ...geöffnet und der Fragebogen bis zum Ende ausgefüllt wurde |
* '''incomplete''' -- ...nicht geöffnet oder nicht bis zum Ende ausgefüllt wurde | * '''incomplete''' -- ...nicht geöffnet oder nicht bis zum Ende ausgefüllt wurde |
* '''no-response''' -- ...nicht geöffnet wurde | * '''no-response''' -- ...nicht geöffnet wurde |
| * '''expire'''\\ Gültigkeit des persönlichen Teilnahme-Links beschränken, es gilt dasselbe Format wie für den //Zeitpunkt// |
| * '''to.email'''\\ E-Mail nicht an die im Adresseintrag hinterlegte E-Mail-Adresse, sondern an die hier angegeben E-Mail-Adresse versenden. Mit dieser Funktion lässt sich ein Hinweis an den Projektleiter realisieren, wenn ein Teilnehmer einen (Folge-)Fragebogen nicht innerhalb einer definierten Zeit bearbeitet. |
| * '''to.mobile'''\\ SMS nicht an die (eventuell) im Adresseintrag hinterlegte Rufnummer, sondern an die hier angegeben Rufnummer versenden. Die Rufnummer muss mit Ländervorwahl angegeben werden. |
| |
**Hinweis:** Eine Serienmail wird (im Gegensatz zu ''mailResume()'') nur einmal pro Empfänger zugestellt, auch wenn die Funktion mit derselben Serienmail mehrfach aufgerufen wird. Der Versand unterschiedlicher Serienmails ist möglich -- z.B. eine Einladung zur zweiten Befragungswelle in 14 Tagen und eine weitere Einladung zur dritten Welle in 1 Monat. | **Hinweis:** Eine Serienmail wird (im Gegensatz zu ''mailResume()'') nur einmal pro Empfänger zugestellt, auch wenn die Funktion mit derselben Serienmail mehrfach aufgerufen wird. Der Versand unterschiedlicher Serienmails ist möglich -- z.B. eine Einladung zur zweiten Befragungswelle in 14 Tagen und eine weitere Einladung zur dritten Welle in 1 Monat. |