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 anzeigenshow()
– Eine Frage, kombinierte Frage oder Text 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“ setzenhtml()
– 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-SeitepageHead()
– Meta-Informationen zur Fragebogen-Seite hinterlegenSoSci 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ählenrandomUse()
– Zettel eines Zufallsgenerators gezielt ablegenurnDraw()
– 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 auslesengetVariables()
– Liefert eine Liste von Variablen as dem DatensatzgetRoute()
– Ermitteln, ob der Weiter- oder Zurück-Knopf verwendet wurdecaseNumber()
– Nummer der aktuellen InterviewscaseSerial()
– Teilnahmecode oder Personenkennung der Teilnehmer:incaseTime()
– Verweildauer auf einer oder mehreren SeitencaseToken()
– Interne Kennung des InterviewscaseData()
– Alle im Interview erhobenen Daten ermittelnreference()
– Evtl. im Link zum Fragebogen übergebene Referenz abfragenserialCheck()
– Status eines Teilnahmecodes abfragenreadGET()
– Eine übertragene Variable aus dem Link auslesensendJSON()
– HTTP-Anfrage im JSON-Format senden (REST API)sendPOST()
– HTTP-Anfrage im POST-Format senden (REST API)sendXML()
– HTTP-Anfrage im XML-Format senden (REST API)getAnswerMissing()
- 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 ändernbuttonDataCode()
– Knopf auf der Seite einfügen und mit Daten verknüpfenbuttonDataGet()
– Die über einen mittels buttonDataCode()
erstellen Knopf übermittelten Daten abrufengoToQuestionnaire()
– 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 wurdenmultiLevelPut()
– Einen Wert direkt im übergeordneten Datensatz abspeichernmultiLevelURL()
– Eine URL für einen Teilfragebogen erzeugen zum späteren Wechsel in den neuen FallmultiLevelPrepare()
– Einen untergeordneten Fall erstellen und mit Werten vorbelegen, zur Verwendung mit einer Multi-Level-ÜbersichtdbGet()
– Daten aus der Datenbank für Inhalte abrufen (indiziertes Array)dbKeys()
– Schlüssel aus der Datenbank für Inhalte auflistendbLoad()
– Alle Einträge mit einem definierten Präfix aus der Datenbank für Inhalte abrufendbRetrieve()
– Daten aus der Datenbank für Inhalte abrufen (assoziatives, verschachteltes Array)dbSet()
– Daten in der Datenbank für Inhalte abspeichern (indiziertes Array)dbStore()
– Daten in der Datenbank für Inhalte abspeichern (assoziatives, verschachteltes Array)dbTouch()
– Zeitstempel für einen Eintrag in der Datenbank aktualisierendropValue()
– Eine einzelne Variable aus dem aktuellen Interview löschendropCase()
– Das aktuelle Interview zum Löschen vormerkendropHistory()
– Die Seiten-Historie des aktuellen Interviews löschenstatistic()
– 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 anzeigeninfo()
– Metainformationen zum aktuellen Interview oder zur DarstellungvalueSum()
– 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 erstellengetQRCodeImage()
– QR-Code im Fragebogen einbindenimagepng_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 stornierenmailSend()
– E-Mail an eine Adresse versenden, die nicht in der Adressliste stehtpanelData()
– 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.
Einige Funktionen stellen ein Sicherheitsrisiko dar oder funktionieren im Kontext des Fragebogens nicht wie erwartet. Nachfolgend sind Alternativen aufgeführt. Wenn Sie weitere Funktionen benötigen, teilen Sie es bitte SoSci Survey mit.
echo
mysqld_query()
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.