| Beide Seiten der vorigen RevisionVorhergehende ÜberarbeitungNächste Überarbeitung | Vorhergehende Überarbeitung |
| de:create:functions:paneldata [03.02.2018 22:15] – admin | de:create:functions:paneldata [23.10.2026 14:44] (aktuell) – Externe Bearbeitung 127.0.0.1 |
|---|
| 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 **Teilnahmecodes**, falls der Fragebogen die [[:de:create:access|Zugriffsbeschränkung]] "Teilnahmecode" 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: |
| <code php> | <code php> |
| array( | array( |
| 0 => (string) Teilgruppe, | 0 => (string) Teilgruppe |
| 1 => (string) Benutzerdefinierte Daten 1, | 1 => (string) Benutzerdefinierte Daten 1 |
| 2 => (string) Benutzerdefinierte Daten 2, | 2 => (string) Benutzerdefinierte Daten 2 |
| 3 => (string) Benutzerdefinierte Daten 3, | 3 => (string) Benutzerdefinierte Daten 3 |
| 4 => (string) Benutzerdefinierte Daten 4, | 4 => (string) Benutzerdefinierte Daten 4 |
| 5 => (string) Benutzerdefinierte Daten 5, | 5 => (string) Benutzerdefinierte Daten 5 |
| 'subgroup' => (string) Teilgruppe, | 'subgroup' => (string) Teilgruppe |
| | 'mailing' => (int) Nummer (ID) der Serienmail, in welcher der Einladungslink verschickt wurde |
| 'mailsent' => (int) Unix-Zeitstempel des Versand-Zeitpunkts | 'mailsent' => (int) Unix-Zeitstempel des Versand-Zeitpunkts |
| | 'smstime' => (int) Unix-Zeitstempel der Übermittlungsbestätigung einer SMS (falls verfügbar) |
| | |
| | // Nur für Teilnehmer mit Datenschutz-Modus "Personenbezogen" verfügbar, sonst NULL |
| | 'firstname' => (string) Vorname |
| | 'lastname' => (string) Nachname |
| | 'gender' => (string) Geschlecht ('female', 'male', 'other' oder '') |
| | 'email' => (string) E-Mail-Adresse |
| | 'email.cc' => (string) E-Mail CC-Adresse |
| | 'mobile' => (string) Mobiltelefonnummer |
| | 'serial' => (string) Personenkennung |
| ) | ) |
| </code> | </code> |
| |
| **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 Teilnehmer 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:privacy|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:privacy|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 und in ''%%'mailing'%%'' steht die ID der ursprünglichen Einladung -- unabhängig davon, ob er den Link in der Einladung oder in der Erinnerung aufruft. |
| | |
| | **Hinweis:** Falls der Login im Fragebogen mittels Single-Sign-On (SSO) erfolgt, liefert ''panelData()'' nur unmittelbar nach dem Start des Fragebogens Informationen, platzieren Sie die Funktion in diesem Fall auf der ersten Seite. |
| | |
| | |
| | ===== Rückgabewert (Teilnahmecodes) ===== |
| | |
| | Falls der Fragebogen die [[:de:create:access|Zugriffsbeschränkung]] "Teilnahmecode" verwendet, liefert ''panelData()'' den verwendeten Teilnahmecode und eine eventuell dazu hinterlegte Notiz: |
| | |
| | <code php> |
| | array( |
| | 'serial' => (string) Teilnahmecode |
| | 'note' => (string) Notiz zum Teilnahmecode |
| | ) |
| | </code> |
| |
| **Hinweis:** Falls beim Versand der Serienmail individuelle Zeitpunkte verwendet werden, kann die Information zum Versandzeitpunkt (ähnlich wie bestimmte benutzerdefinierte Daten) die Anonymität 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')''. | **Wichtig:** Der Fragebogen muss die Zugriffsbeschränkung "Teilnahmecode" verwenden, die Angabe eines Teilnahmecodes im [[:de:survey:url|Link zum Fragebogen]] reicht nicht aus. Der [[:de:create:placeholders|Platzhalter]] ''%caseSerial%'' hingegen liefert einen Teilnahmecode auch, wenn der Fragebogen öffentlich ist. |
| |
| |
| |
| |
| ===== Beispiel: Experiment in mehrwelliger Befragug ===== | ===== Beispiel: Experiment in mehrwelliger Befragung ===== |
| |
| In diesem Beispiel registrieren sich Teilnehmer selbst für eine Studie ([[:de:survey:opt-in-live]]). Im folgenden sollen Teilnehmer der Kontroll- und Experimentalgruppe unterschiedliche Serienmails als experimentellen Stimulus erhalten. Deshalb müssen ihre Adresseinträge unterschiedlichen Teilgruppen zugeordnet werden. Dies erfolgt, indem je nach Zufallsziehung ([[:de:create:questions:random]]) eine von zwei Opt-In-Fragen angezeigt wird. | In diesem Beispiel registrieren sich Teilnehmer selbst für eine Studie ([[:de:survey:opt-in-live]]). Im folgenden sollen Teilnehmer der Kontroll- und Experimentalgruppe unterschiedliche Serienmails als experimentellen Stimulus erhalten. Deshalb müssen ihre Adresseinträge unterschiedlichen Teilgruppen zugeordnet werden. Dies erfolgt, indem je nach Zufallsziehung ([[:de:create:questions:random]]) eine von zwei Opt-In-Fragen angezeigt wird. |
| |
| **Hinweis:** Eine [[de:create:questions:opt-in|Opt-in Frage]] kann einen neu registrierten Teilnehmer automatisch einer //Teilgruppe zuordnen//. | **Hinweis:** Eine [[:de:create:questions:opt-in|Opt-in-Frage]] kann einen neu registrierten Teilnehmer automatisch einer //Teilgruppe zuordnen//. |
| |
| <code php> | <code php> |
