| Beide Seiten der vorigen RevisionVorhergehende ÜberarbeitungNächste Überarbeitung | Vorhergehende Überarbeitung |
| de:create:functions:paneldata [24.05.2019 21:49] – admin | de:create:functions:paneldata [09.07.2023 17:41] (aktuell) – Seriennummern wurden in Teilnahmecodes umbenannt admin |
|---|
| 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. | Der Befehl ''panelData()'' liefert eine Notiz aus der Liste der **Teilnahmecodes**, falls der Fragebogen die [[de:create:access|Zugriffsbeschränkung]] "Teilnahmecode" verwendet. |
| |
| |
| 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 |
| | |
| '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 |
| **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 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. |
| |
| |
| ===== Rückgabewert (Seriennummern) ===== | ===== Rückgabewert (Teilnahmecodes) ===== |
| |
| Falls der Fragebogen die [[de:create:access|Zugriffsbeschränkung]] "Seriennummer" verwendet, liefert ''panelData()'' die verwendete Seriennummer und eine eventuell dazu hinterlegte Notiz: | Falls der Fragebogen die [[de:create:access|Zugriffsbeschränkung]] "Teilnahmecode" verwendet, liefert ''panelData()'' den verwendete Teilnahmecode und eine eventuell dazu hinterlegte Notiz: |
| |
| <code php> | <code php> |
| array( | array( |
| 'serial' => (string) Seriennummer | 'serial' => (string) Teilnahmecode |
| 'note' => (string) Notiz zur Seriennummer | 'note' => (string) Notiz zum Teilnahmecode |
| ) | ) |
| </code> | </code> |
| | |
| | **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. |
| |
| |
