Dies ist eine alte Version des Dokuments!
Dieses Kapitel stellt die Funktionen vor, die in PHP-Code Elementen zur Verwendung stehen. Die Einführung in PHP-Code erklärt, wie man PHP-Funktionen im Fragebogen einsetzen kann.
Ganz unten auf dieser Seite wird erläutert, wie die Dokumentation der einzelnen PHP-Funktionen zu lesen ist: Funktionen im Detail
Siehe auch Filterfragen und Filter.
value()
– Eine Antwort des Befragten verwenden, z.B. für FiltergoToPage()
– Zu einer anderen Seite springengoToPage('end')
– Interview beendenrepeatPage()
– Die letzte Seite erneut anzeigenredirect()
– Den Befragten zu einer anderen Website weiterleitenquestion()
– Eine Frage im Fragebogen anzeigentext()
– Text oder HTML-Code innerhalb des Fragebogens anzeigendebug()
– Inhalt einer Daten- oder PHP-Variable anzeigenoption()
– Darstellung der Seite anpassen (u.a. Fortschrittsanzeige, Weiter-Button)preset()
– Antwort für eine Frage vorgebenmarkFail()
– Für ein Eingabefeld die Markierung „Antwort fehlt“ setzenprepare_input()
– Eingabefeld für Integration in andere Frage vorbereitenhtml()
– Direkt HTML-Code innerhalb des Fragebogens ausgebentextlink()
– Link auf einen Fragebogen-Text berechnenbuttonToPage()
– Knopf, um innerhalb des Fragebogens zu springenbuttonCode()
– HTML-Code für den Knopf „Weiter“ oder „Zurück“ erzeugenbuttonHide()
– Weiter- und Zurück-Knopf deaktivierenlibrary()
– JavaScript- oder PHP-Bibliothek einbindenpageCSS()
– CSS-Anweisungen für eine einzelne Fragebogen-SeiteSoSci Survey bietet verschiedene Funktionen für spezielle Zufallsauswahlen und zufällige Gruppeneinteilungen. Für eine einfache experimentelle Variation empfehlen wir einen Zufallsgenerator (Randomisierung).
put()
– Wert im Datensatz abspeichernrandom()
– Zufallszahl würfelnrandom_p()
– Zufallszahl unter Vorgabe von Wahrscheinlichkeitenrandom_items()
– Zufällig Items aus einer Liste auswählenurnDraw()
– Zieht einen Zettel aus einer Urne (Zufallsauswahl ohne Zurücklegen)urnPutAway()
– Entfernt einen mit urnDraw() gezogenen Zettel aus der UrneurnStatus()
– Aktuellen Status einer Urne auslesenreplace()
– Einen Platzhalter vorbereitenregisterVariable()
– PHP-Variable für die Verwendung auf weiteren Seiten registrierenid()
– Frage- oder Item-Kennung aus Einzelangaben erstellengetItems()
– Listet die Items einer Frage nach bestimmten Kriterien aufgetQuestions()
– Listet die Fragen einer Rubrik aufgetItemtext()
– Beschriftung eines Items oder einer Antwortoption abfragengetValueText()
– Beschriftung einer Antwortoption abfragengetTextElement()
– Inhalt eines Textbausteins auslesengetRoute()
– Ermitteln, ob der Weiter- oder Zurück-Knopf verwendet wurdecaseNumber()
– Nummer der aktuellen InterviewscaseSerial()
– Für das Interview verwendete SeriennummercaseTime()
– Verweildauer auf einer oder mehreren SeitencaseToken()
– Interne Kennung des Interviewsreference()
– Evtl. im Link zum Fragebogen übergebene Referenz abfragenserialCheck()
– Status einer Seriennummer abfragenreadGET()
– Eine übertragene Variable aus dem Link auslesenreadAPI()
– Zugriff auf APIs anderer DienstleistergetAnswerMissing()
- Information ob die Seite wegen einer Pflichtfrage wiederholt wirdlistFails()
– Liste der nicht ausgefüllten PflichtfragensetNextPage()
– Seite nach dem Weiter-Klick festlegensetPageOrder()
– Abfolge der Seiten im Fragebogen festlegenloopPage()
– Eine Seite mehrfach in einer Schleife anzeigenloopToPage()
– Mehrere Seiten mehrfach in einer Schleife anzeigenpageStop()
– Keine weiteren Inhalte auf der Seite anzeigengetLanguage()
– Aktuelle Sprachversion ermittelnsetLanguage()
– Sprachversion änderngotoquestionnaire
– Von einem Fragebogen zu einem anderen springen (einmalig)goToParent()
– Zum ursprünglichen Fragebogen zurückkehrenmultiLevelDown()
– Einen Teilfragebogen innerhalb des Hauptfragebogens starten (ggf. auch mehrmals)multiLevelData()
– Daten ermitteln, die in multiLevelDown()
angegeben wurdenmultiLevelReturn()
– Rückkehr vom Teilfragebogen zum HauptfragebogenmultiLevelResponse()
– Daten ermitteln, die in multiLevelReturn()
angegeben wurdenstatistic()
– Einfache statistische Auswertung über alle erhobenen Datendiagram()
– Einfaches Diagramm (z.B. Häufigkeiten) über alle erhobenen Datenanswers()
– Frage mit Antworten des Befragten anzeigenanswersPrint()
– Alle Fragen eines Fragebogen-Abschnitts inkl. Antworten des Befragten anzeigenvalueSum()
– Summe über eine Skala oder mehrere Variablen berechnenvalueMean()
– Mittelwert über Skala oder Variablen berechnenvalueSD()
– Standardabweichung über Skala oder Variablen berechnenvalueVar()
– Varianz über Skala oder Variablen berechnenvalueList()
– Mehreren Item-Antworten einer Frage als Array abrufenconvertDateTime()
– Zeitangaben und Zeitstempel ineinander umwandelncalcMean(), calcSD(), ...
– Einfache Berechnungendiagram2()
– Diagramm mit vorgegeben Daten erstellenimagepng_embed()
– PNG-Grafik ohne Umweg über eine Datei einbindenmailResume()
– Zeitverzögerte Fortsetzung des InterviewsmailSchedule()
– Den zeitgesteuerten Versand einer Serienmail an einen einzelnen Teilnehmer vorbereitenmailRevoke()
– Fortsetzungsmail(s) oder Serienmail stornierenpanelData()
– Informationen zum Adresseintrag abrufenWeiterhin stellt PHP selbst zahlreiche Funktionen bereit, von denen einige im Fragebogen sehr hilfreich sein können. Diese Funktionen sind im PHP Manual dokumentiert.
Für die Funktionen ist jeweils eine Referenz-Syntax angegeben, zum Beispiel:
void set(mixed Wert, [string Speicherplatz])
In dieser Referenz-Syntax steht, welche Argumente eine Funktion erwartet und welchen Datentyp diese haben.
set()
muss also mindestens ein Argument Wert haben und darf ein zweites Argument Speicherplatz nutzen.