Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen RevisionVorhergehende Überarbeitung
Nächste Überarbeitung
Vorhergehende Überarbeitung
Nächste ÜberarbeitungBeide Seiten der Revision
de:create:functions:mailschedule [01.06.2019 18:13] – [mailSchedule()] adminde:create:functions:mailschedule [01.07.2019 23:28] admin
Zeile 1: Zeile 1:
 ====== 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.
Zeile 11: Zeile 11:
   * //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// +    * '''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.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.+    * '''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.
de/create/functions/mailschedule.txt · Zuletzt geändert: 13.02.2022 17:43 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