| Beide Seiten der vorigen RevisionVorhergehende ÜberarbeitungNächste Überarbeitung | Vorhergehende Überarbeitung |
| de:create:functions:paneldata [14.03.2022 13:16] – alte Version wiederhergestellt (27.11.2021 21:35) admin | de:create:functions:paneldata [06.09.2025 13:19] (aktuell) – [Rückgabewert (Adressliste)] 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. |
| |
| |
| 'mailing' => (int) Nummer (ID) der Serienmail, in welcher der Einladungslink verschickt wurde | '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 | // Nur für Teilnehmer mit Datenschutz-Modus "Personenbezogen" verfügbar, sonst NULL |
| **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 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 (Seriennummern) ===== | |
| |
| Falls der Fragebogen die [[de:create:access|Zugriffsbeschränkung]] "Seriennummer" verwendet, liefert ''panelData()'' die verwendete Seriennummer und eine eventuell dazu hinterlegte Notiz: | ===== Rückgabewert (Teilnahmecodes) ===== |
| | |
| | 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 "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. | **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. |
| |
| |
