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:paneldata [14.03.2019 14:06] – [Rückgabewert] leinerde:create:functions:paneldata [09.07.2019 13:42] – [Rückgabewert (Adressliste)] leiner
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 nicht anonym ist, wird der Versandzeitpunkt automatisch in der Variable MAILSENT im Datensatz gespeichert und 'mailsent' liefert denselben Wert wie ''value('MAILSENT')''.+**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.txt · Zuletzt geändert: 09.07.2023 17:41 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