Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen Revision Vorhergehende Überarbeitung
Nächste Überarbeitung
Vorhergehende Überarbeitung
de:create:functions:paneldata [12.04.2019 08:39]
admin [Rückgabewert]
de:create:functions:paneldata [09.07.2019 13:42] (aktuell)
leiner [Rückgabewert (Adressliste)]
Zeile 5: Zeile 5:
 Der Befehl ''​panelData()''​ liefert Informationen aus der **Adressliste**,​ falls das Interview durch einen personalisierten Link (z.B. aus einer Serienmail) gestartet wurde. Der Befehl ''​panelData()''​ liefert Informationen aus der **Adressliste**,​ falls das Interview durch einen personalisierten Link (z.B. aus einer Serienmail) gestartet wurde.
  
 +Der Befehl ''​panelData()''​ liefert eine Notiz aus der Liste der **Seriennummern**,​ falls der Fragebogen die [[de:​create:​access|Zugriffsbeschränkung]] "​Seriennummer"​ verwendet.
  
-===== Rückgabewert =====+ 
 +===== Rückgabewert ​(Adressliste) ​=====
  
 Der Befehl ''​panelData()''​ liefert in einem Array die Zugehörigkeit des Teilnehmers zu einer Teilgruppe, den Zeitpunkt des Mail-Versands und die Daten, die als //​benutzerdefinierte Daten// im Adresseintrag hinterlegt wurden: Der Befehl ''​panelData()''​ liefert in einem Array die Zugehörigkeit des Teilnehmers zu einer Teilgruppe, den Zeitpunkt des Mail-Versands und die Daten, die als //​benutzerdefinierte Daten// im Adresseintrag hinterlegt wurden:
Zeile 24: Zeile 26:
   '​firstname'​ => (string) Vorname   '​firstname'​ => (string) Vorname
   '​lastname'​ => (string) Nachname   '​lastname'​ => (string) Nachname
 +  '​gender'​ => (string) Geschlecht ('​female',​ '​male',​ '​other'​ oder ''​)
   '​email'​ => (string) E-Mail-Adresse   '​email'​ => (string) E-Mail-Adresse
 +  '​email.cc'​ => (string) E-Mail CC-Adresse
   '​mobile'​ => (string) Mobiltelefonnummer   '​mobile'​ => (string) Mobiltelefonnummer
   '​serial'​ => (string) Personenkennung   '​serial'​ => (string) Personenkennung
Zeile 32: Zeile 36:
 **Wichtig:​** Die Funktion liefert nur dann ein Array, wenn das Interview durch Klick auf den personalisierten Link einer Serienmail gestartet wurde (sonst ''​NULL''​). Wenn der Teilnahmer nach einer Opt-In-Bestätigung automatisch zu einem Fragebogen weitergeleitet wird ([[:​de:​survey:​opt-in-live]]),​ so ist das technisch äquivalent zum Klick auf den personalisierten Link einer Serienmail. **Wichtig:​** Die Funktion liefert nur dann ein Array, wenn das Interview durch Klick auf den personalisierten Link einer Serienmail gestartet wurde (sonst ''​NULL''​). Wenn der Teilnahmer nach einer Opt-In-Bestätigung automatisch zu einem Fragebogen weitergeleitet wird ([[:​de:​survey:​opt-in-live]]),​ so ist das technisch äquivalent zum Klick auf den personalisierten Link einer Serienmail.
  
-**Hinweis:​** Falls für den Adressaten der [[de:​survey:​mailing#​datenschutz-modus|Datenschutzmodus]] "​anonym"​ eingestellt wurde, liefert ''​panelData()''​ keine Daten (''​NULL''​).+**Hinweis:​** Falls für den Adressaten der [[de:​survey:​mailing#​datenschutz-modus|Datenschutz-Modus]] "​anonym"​ eingestellt wurde, liefert ''​panelData()''​ keine Daten (''​NULL''​).
  
 **Hinweis:​** Falls beim Versand der Serienmail individuelle Zeitpunkte verwendet werden, kann die Information zum Versandzeitpunkt (ähnlich wie bestimmte benutzerdefinierte Daten) die Vertraulichkeit ​ pseudonymer Adresseinträge aufheben und sollte nicht im Datensatz gespeichert werden. Falls der Adresseintrag den [[:​de:​survey:​mailing#​datenschutz-modus|Datenschutz-Modus]] "​personenbezogen"​ verwendet, wird der Versandzeitpunkt automatisch in der Variable MAILSENT im Datensatz gespeichert und '​mailsent'​ liefert denselben Wert wie ''​value('​MAILSENT'​)''​. Bei Adresseinträgen mit Datenschutz-Modus "​pseudonym"​ oder "​anonymisieren bei Abschluss des Interviews"​ ist der Versandzeitpunkt nur über ''​panelData()''​ verfügbar, um eine versehentliche De-Anonymisierung zu vermeiden. **Hinweis:​** Falls beim Versand der Serienmail individuelle Zeitpunkte verwendet werden, kann die Information zum Versandzeitpunkt (ähnlich wie bestimmte benutzerdefinierte Daten) die Vertraulichkeit ​ pseudonymer Adresseinträge aufheben und sollte nicht im Datensatz gespeichert werden. Falls der Adresseintrag den [[:​de:​survey:​mailing#​datenschutz-modus|Datenschutz-Modus]] "​personenbezogen"​ verwendet, wird der Versandzeitpunkt automatisch in der Variable MAILSENT im Datensatz gespeichert und '​mailsent'​ liefert denselben Wert wie ''​value('​MAILSENT'​)''​. Bei Adresseinträgen mit Datenschutz-Modus "​pseudonym"​ oder "​anonymisieren bei Abschluss des Interviews"​ ist der Versandzeitpunkt nur über ''​panelData()''​ verfügbar, um eine versehentliche De-Anonymisierung zu vermeiden.
  
 **Hinweis:​** Falls der Teilnehmer eine Einladung und eine Erinnerung erhalten hat, wird in MAILSENT der Zeitpunkt angegeben, wann die ursprüngliche Einladung verschickt wurde -- unabhängig davon, ob er den Link in der Einladung oder in der Erinnerung aufruft. **Hinweis:​** Falls der Teilnehmer eine Einladung und eine Erinnerung erhalten hat, wird in MAILSENT der Zeitpunkt angegeben, wann die ursprüngliche Einladung verschickt wurde -- unabhängig davon, ob er den Link in der Einladung oder in der Erinnerung aufruft.
 +
 +
 +===== Rückgabewert (Seriennummern) =====
 +
 +Falls der Fragebogen die [[de:​create:​access|Zugriffsbeschränkung]] "​Seriennummer"​ verwendet, liefert ''​panelData()''​ die verwendete Seriennummer und eine eventuell dazu hinterlegte Notiz:
 +
 +<code php>
 +array(
 +  '​serial'​ => (string) Seriennummer
 +  '​note'​ => (string) Notiz zur Seriennummer
 +)
 +</​code>​
 +
 +**Wichtig:​** Der Fragebogen muss die Zugriffsbeschränkung "​Seriennummer"​ verwenden, die Angabe einer Seriennummer im [[:​de:​survey:​url|Link zum Fragebogen]] reicht nicht aus. Der [[:​de:​create:​placeholders|Platzhalter]] ''​%caseSerial%''​ hingegen liefert eine Seriennummer auch, wenn der Fragebogen öffentlich ist.
  
  
de/create/functions/paneldata.1555051161.txt.gz · Zuletzt geändert: 12.04.2019 08:39 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