panelRecords()

array panelRecords(array Variablen, [array Filter, string Personenkennung])

Die Funktion panelRecords() liefert die Daten von anderen Fällen (CASE) aus dem Datensatz, welche dieselbe Personenkennung (SERIAL) tragen wie das laufende Interview. Damit lassen sich beispielsweise in Tagebuchstudien Verlaufsdaten ermitteln.

Hinweis: Diese Funktion liefert die erhobenen Daten mit bis zu 30 Minuten Verspätung. Das bedeuetet: Andere Interviews, welches innerhalb der vergangenen 30 Minuten noch bearbeitet wurde, tauchen womöglich nicht oder nicht mit dem aktuellen Bearbeitungsstand in den Daten auf. Dies betrifft nicht das aktuelle Interview (Filter 'current').

Variablen
Eine Liste von Variablen-Kennungen, welche Variablen aus den anderne Fällen extrahiert werden sollen.
Filter
In einem assoziativen Array können Einschränkungen für den Datenabruf festgelegt werden, erlaubte Schlüssel sind:
- 'QUESTNNR' – Nur Fälle abrufen, welchen diesen Fragebogne verwendet haben.
- 'STARTED.min' – Nur Interviews, die zu diesem Zeitpunkt oder später begonnen wurden.
- 'STARTED.max' – Nur Interviews, die vor oder zu diesem Zeitpunkt begonnen wurden.
- 'current' – Das aktuelle Interview mit in die Daten aufnehmen (true) oder nicht (false, Standard).
Personenkennung
Fälle für eine andere Personenkennung (SERIAL) abrufen als jene des laufenden Interviews.

Rückgabewert

Die Funktion gibt ein indiziertes Array zurück, welches – sortiert nach Fallnummer CASE – für jeden Fall ein assoziatives Array enthält. Diese Arrays verwenden die Variablennamen als Schlüssel und die Antwortcodes als Inhalt.

[
    ['CASE' => 1, 'STARTED' => 1650470506, 'AB01' => 1, 'SK01_01' => 1, 'SK01_01' => 2],
    ['CASE' => 3, 'STARTED' => 1650470617, 'AB01' => 2, 'SK01_01' => 2, 'SK01_01' => 4],
    ['CASE' => 5, 'STARTED' => 1650471728, 'AB01' => 1, 'SK01_01' => 3, 'SK01_01' => 5],
    ['CASE' => 9, 'STARTED' => 1650482839, 'AB01' => 3, 'SK01_01' => 4, 'SK01_01' => 5]
]

Beispiel: Filter

Der folgende PHP-Code liefert alle Fälle des aktuellen Teilnehmers, die vor min. einem Tag ausgefüllt wurden und den Fragebogen „main“ verwendeten.

$data = panelRecords(
  ['CASE', 'STARTED'],
  [
    'STARTED.max' => strtotime('-1 day'),
    'QUESTNNR' => 'main'
  ]
);

Mit folgendem Aufruf werden alle Fälle der aktuellen Teilnehmerin abgerufen, die nach dem 01.01.2022 begonnen wurden.

$data = panelRecords(
  ['CASE', 'STARTED', 'AB01', 'AB02', 'BB01'],
  ['STARTED.min' => '2022-01-01']
);