| Beide Seiten der vorigen RevisionVorhergehende ÜberarbeitungNächste Überarbeitung | Vorhergehende Überarbeitung |
| de:create:functions [23.07.2018 21:46] – [Anzeige einer Fragebogen-Seite anpassen] admin | de:create:functions [08.06.2025 09:49] (aktuell) – [Teilnehmer-Management] admin |
|---|
| * ''[[:de:create:functions:question|question()]]'' -- Eine Frage im Fragebogen anzeigen | * ''[[:de:create:functions:question|question()]]'' -- Eine Frage im Fragebogen anzeigen |
| * ''[[:de:create:functions:text|text()]]'' -- Text oder HTML-Code innerhalb des Fragebogens anzeigen | * ''[[:de:create:functions:text|text()]]'' -- Text oder HTML-Code innerhalb des Fragebogens anzeigen |
| | * ''[[:de:create:functions:show|show()]]'' -- Eine Frage, kombinierte Frage oder Text anzeigen |
| * ''[[:de:create:functions:debug|debug()]]'' -- Inhalt einer Daten- oder PHP-Variable anzeigen | * ''[[:de:create:functions:debug|debug()]]'' -- Inhalt einer Daten- oder PHP-Variable anzeigen |
| |
| * ''[[:de:create:functions:preset|preset()]]'' -- Antwort für eine Frage vorgeben | * ''[[:de:create:functions:preset|preset()]]'' -- Antwort für eine Frage vorgeben |
| * ''[[:de:create:functions:markfail|markFail()]]'' -- Für ein Eingabefeld die Markierung "Antwort fehlt" setzen | * ''[[:de:create:functions:markfail|markFail()]]'' -- Für ein Eingabefeld die Markierung "Antwort fehlt" setzen |
| * ''[[:de:create:functions:prepare_input|prepare_input()]]'' -- Eingabefeld für Integration in andere Frage vorbereiten | |
| * ''[[:de:create:functions:html]]'' -- Direkt HTML-Code innerhalb des Fragebogens ausgeben | * ''[[:de:create:functions:html]]'' -- Direkt HTML-Code innerhalb des Fragebogens ausgeben |
| * ''[[:de:create:functions:textlink]]'' -- Link auf einen Fragebogen-Text berechnen | * ''[[:de:create:functions:textlink]]'' -- Link auf einen Fragebogen-Text berechnen |
| * ''[[:de:create:functions:library]]'' -- JavaScript- oder PHP-Bibliothek einbinden | * ''[[:de:create:functions:library]]'' -- JavaScript- oder PHP-Bibliothek einbinden |
| * ''[[:de:create:functions:pagecss]]'' -- CSS-Anweisungen für eine einzelne Fragebogen-Seite | * ''[[:de:create:functions:pagecss]]'' -- CSS-Anweisungen für eine einzelne Fragebogen-Seite |
| | * ''[[:de:create:functions:pagehead]]'' -- Meta-Informationen zur Fragebogen-Seite hinterlegen |
| |
| |
| * ''[[:de:create:functions:random_p|random_p()]]'' -- Zufallszahl unter Vorgabe von Wahrscheinlichkeiten | * ''[[:de:create:functions:random_p|random_p()]]'' -- Zufallszahl unter Vorgabe von Wahrscheinlichkeiten |
| * ''[[:de:create:functions:random_items|random_items()]]'' -- Zufällig Items aus einer Liste auswählen | * ''[[:de:create:functions:random_items|random_items()]]'' -- Zufällig Items aus einer Liste auswählen |
| | * ''[[:de:create:functions:randomuse]]'' -- Zettel eines Zufallsgenerators gezielt ablegen |
| * ''[[:de:create:functions:urndraw|urnDraw()]]'' -- Zieht einen Zettel aus einer Urne (Zufallsauswahl ohne Zurücklegen) | * ''[[:de:create:functions:urndraw|urnDraw()]]'' -- Zieht einen Zettel aus einer Urne (Zufallsauswahl ohne Zurücklegen) |
| * ''[[:de:create:functions:urnputaway|urnPutAway()]]'' -- Entfernt einen mit urnDraw() gezogenen Zettel aus der Urne | * ''[[:de:create:functions:urnputaway|urnPutAway()]]'' -- Entfernt einen mit urnDraw() gezogenen Zettel aus der Urne |
| * ''[[:de:create:functions:getvaluetext]]'' -- Beschriftung einer Antwortoption abfragen | * ''[[:de:create:functions:getvaluetext]]'' -- Beschriftung einer Antwortoption abfragen |
| * ''[[:de:create:functions:gettextelement]]'' -- Inhalt eines Textbausteins auslesen | * ''[[:de:create:functions:gettextelement]]'' -- Inhalt eines Textbausteins auslesen |
| * ''[[:de:create:functions:getroute]]'' -- Ermitteln, ob der Weiter- oder Zurück-Knopf verwendet wurde | * ''[[:de:create:functions:getvariables]]'' -- Liefert eine Liste von Variablen as dem Datensatz |
| * ''[[:de:create:functions:casenumber|caseNumber()]]'' -- Nummer der aktuellen Interviews | * ''[[:de:create:functions:serialcheck|serialCheck()]]'' -- Status eines Teilnahmecodes abfragen |
| * ''[[:de:create:functions:caseserial|caseSerial()]]'' -- Für das Interview verwendete Seriennummer | |
| * ''[[:de:create:functions:casetime|caseTime()]]'' -- Verweildauer auf einer oder mehreren Seiten | |
| * ''[[:de:create:functions:casetoken|caseToken()]]'' -- Interne Kennung des Interviews | |
| * ''[[:de:create:functions:reference|reference()]]'' -- Evtl. im Link zum Fragebogen übergebene Referenz abfragen | |
| * ''[[:de:create:functions:serialcheck|serialCheck()]]'' -- Status einer Seriennummer abfragen | |
| * ''[[:de:create:functions:readget|readGET()]]'' -- Eine übertragene Variable aus dem Link auslesen | * ''[[:de:create:functions:readget|readGET()]]'' -- Eine übertragene Variable aus dem Link auslesen |
| * ''[[:de:create:functions:readapi|readAPI()]]'' -- Zugriff auf APIs anderer Dienstleister | * ''[[:de:create:functions:sendjson|sendJSON()]]'' -- HTTP-Anfrage im JSON-Format senden (REST API) |
| * ''[[:de:create:functions:getanswermissing|getAnswerMissing()]]'' - Information ob die Seite wegen einer Pflichtfrage wiederholt wird | * ''[[:de:create:functions:sendjson|sendPOST()]]'' -- HTTP-Anfrage im POST-Format senden (REST API) |
| * ''[[:de:create:functions:listfails|listFails()]]'' -- Liste der nicht ausgefüllten Pflichtfragen | * ''[[:de:create:functions:sendjson|sendXML()]]'' -- HTTP-Anfrage im XML-Format senden (REST API) |
| * ''[[:de:create:functions:setnextpage|setNextPage()]]'' -- Seite nach dem Weiter-Klick festlegen | * ''[[:de:create:functions:setnextpage|setNextPage()]]'' -- Seite nach dem Weiter-Klick festlegen |
| * ''[[:de:create:functions:setpageorder|setPageOrder()]]'' -- Abfolge der Seiten im Fragebogen festlegen | * ''[[:de:create:functions:setpageorder|setPageOrder()]]'' -- Abfolge der Seiten im Fragebogen festlegen |
| * ''[[:de:create:functions:looppage|loopPage()]]'' -- Eine Seite mehrfach in einer Schleife anzeigen | * ''[[:de:create:functions:looppage]]'' -- Eine Seite mehrfach in einer Schleife anzeigen |
| * ''[[:de:create:functions:looptopage|loopToPage()]]'' -- Mehrere Seiten mehrfach in einer Schleife anzeigen | * ''[[:de:create:functions:looptopage]]'' -- Mehrere Seiten mehrfach in einer Schleife anzeigen |
| | * ''[[:de:create:functions:loopindex]]'' -- Zähler von ''loopIndex()'' abrufen |
| * ''[[:de:create:functions:pagestop|pageStop()]]'' -- Keine weiteren Inhalte auf der Seite anzeigen | * ''[[:de:create:functions:pagestop|pageStop()]]'' -- Keine weiteren Inhalte auf der Seite anzeigen |
| * ''[[:de:create:functions:getlanguage|getLanguage()]]'' -- Aktuelle Sprachversion ermitteln | |
| * ''[[:de:create:functions:setlanguage|setLanguage()]]'' -- Sprachversion ändern | * ''[[:de:create:functions:setlanguage|setLanguage()]]'' -- Sprachversion ändern |
| | * ''[[:de:create:functions:buttonDataCode|buttonDataCode()]]'' -- Knopf auf der Seite einfügen und mit Daten verknüpfen |
| | * ''[[:de:create:functions:buttonDataCode|buttonDataGet()]]'' -- Die über einen mittels ''buttonDataCode()'' erstellen Knopf übermittelten Daten abrufen |
| | |
| | ===== Laufzeit-Informationen ===== |
| | |
| | * ''[[:de:create:functions:info]]'' – Metainformationen zum aktuellen Interview oder zur Darstellung |
| | * ''[[:de:create:functions:getroute]]'' -- Ermitteln, ob der Weiter- oder Zurück-Knopf verwendet wurde |
| | * ''[[:de:create:functions:casenumber]]'' -- Nummer der aktuellen Interviews |
| | * ''[[:de:create:functions:caseserial]]'' -- Teilnahmecode oder Personenkennung der Teilnehmer:in |
| | * ''[[:de:create:functions:casetime]]'' -- Verweildauer auf einer oder mehreren Seiten |
| | * ''[[:de:create:functions:casetoken]]'' -- Interne Kennung des Interviews |
| | * ''[[:de:create:functions:casedata]]'' -- Alle im Interview erhobenen Daten ermitteln |
| | * ''[[:de:create:functions:reference|reference()]]'' -- Evtl. im Link zum Fragebogen übergebene Referenz abfragen |
| | * ''[[:de:create:functions:getanswermissing|getAnswerMissing()]]'' - Information ob die Seite wegen einer Pflichtfrage wiederholt wird |
| | * ''[[:de:create:functions:listfails|listFails()]]'' -- Liste der nicht ausgefüllten Pflichtfragen |
| | * ''[[:de:create:functions:getlanguage|getLanguage()]]'' -- Aktuelle Sprachversion ermitteln |
| | |
| |
| ===== Koordination mehrerer Fragebögen ====== | ===== Koordination mehrerer Fragebögen ====== |
| |
| * ''[[:de:create:function:gotoquestionnaire]]'' -- Von einem Fragebogen zu einem anderen springen (einmalig) | * ''[[:de:create:functions:gotoquestionnaire]]'' -- Von einem Fragebogen zu einem anderen springen (einmalig) |
| * ''[[:de:create:functions:gotoparent]]'' -- Zum ursprünglichen Fragebogen zurückkehren | * ''[[:de:create:functions:gotoparent]]'' -- Zum ursprünglichen Fragebogen zurückkehren |
| * ''[[:de:create:functions:multileveldown]]'' -- Einen Teilfragebogen innerhalb des Hauptfragebogens starten (ggf. auch mehrmals) | * ''[[:de:create:functions:multileveldown]]'' -- Einen Teilfragebogen innerhalb des Hauptfragebogens starten (ggf. auch mehrmals) |
| * ''[[:de:create:functions:multilevelreturn]]'' -- Rückkehr vom Teilfragebogen zum Hauptfragebogen | * ''[[:de:create:functions:multilevelreturn]]'' -- Rückkehr vom Teilfragebogen zum Hauptfragebogen |
| * ''[[:de:create:functions:multilevelresponse]]'' -- Daten ermitteln, die in ''multiLevelReturn()'' angegeben wurden | * ''[[:de:create:functions:multilevelresponse]]'' -- Daten ermitteln, die in ''multiLevelReturn()'' angegeben wurden |
| | * ''[[:de:create:functions:multilevelput]]'' -- Einen Wert direkt im übergeordneten Datensatz abspeichern |
| | * ''[[:de:create:functions:multilevelurl]]'' -- Eine URL für einen Teilfragebogen erzeugen zum späteren Wechsel in den neuen Fall |
| | * ''[[:de:create:functions:multilevelprepare]]'' -- Einen untergeordneten Fall erstellen und mit Werten vorbelegen, zur Verwendung mit einer [[:de:create:questions:multilevel]] |
| | |
| |
| ===== Datenbank für Inhalte ===== | ===== Datenbank für Inhalte ===== |
| |
| * ''[[:de:create:functions:dbget|dbGet()]]'' -- Daten aus der Datenbank für Inhalte abrufen | * ''[[:de:create:functions:dbget|dbGet()]]'' -- Daten aus der Datenbank für Inhalte abrufen (indiziertes Array) |
| * ''[[:de:create:functions:dbkeys|dbKeys()]]'' -- Schlüssel aus der Datenbank für Inhalte auflisten | * ''[[:de:create:functions:dbkeys|dbKeys()]]'' -- Schlüssel aus der Datenbank für Inhalte auflisten |
| * ''[[:de:create:functions:dbset|dbSet()]]'' -- Daten in der Datenbank für Inhalte abspeichern | * ''[[:de:create:functions:dbload|dbLoad()]]'' -- Alle Einträge mit einem definierten Präfix aus der Datenbank für Inhalte abrufen |
| * ''[[:de:create:functions:dbtouch|dbTouch()]]'' -- Zeitstempel für einen Eintrag in der Datenbank aktualisieren | * ''[[:de:create:functions:dbretrieve|dbRetrieve()]]'' -- Daten aus der Datenbank für Inhalte abrufen (assoziatives, verschachteltes Array) |
| | * ''[[:de:create:functions:dbset|dbSet()]]'' -- Daten in der Datenbank für Inhalte abspeichern (indiziertes Array) |
| | * ''[[:de:create:functions:dbstore|dbStore()]]'' -- Daten in der Datenbank für Inhalte abspeichern (assoziatives, verschachteltes Array) |
| | * ''[[:de:create:functions:dbtouch]]'' -- Zeitstempel für einen Eintrag in der Datenbank aktualisieren |
| | * ''[[:de:create:functions:dbdelete]]'' -- Einträge anhand eines Präfix aus der Datenbank für Inhalte löschen |
| | |
| | ===== Datensatz-Steuerung ===== |
| | |
| | * ''[[:de:create:functions:dropvalue]]'' -- Eine einzelne Variable aus dem aktuellen Interview löschen |
| | * ''[[:de:create:functions:dropcase]]'' -- Das aktuelle Interview zum Löschen vormerken |
| | * ''[[:de:create:functions:drophistory]]'' -- Die Seiten-Historie des aktuellen Interviews löschen |
| |
| ===== Auswertung über alle Datensätze ===== | ===== Auswertung über alle Datensätze ===== |
| * ''[[:de:create:functions:convertdatetime]]'' -- Zeitangaben und Zeitstempel ineinander umwandeln | * ''[[:de:create:functions:convertdatetime]]'' -- Zeitangaben und Zeitstempel ineinander umwandeln |
| * ''[[:de:create:functions:calc]]'' -- Einfache Berechnungen | * ''[[:de:create:functions:calc]]'' -- Einfache Berechnungen |
| | * ''[[:de:create:functions:uploadastable]]'' -- Liefert eine vom Teilnehmer hochgeladenen Excel- oder CSV-Datei als Array |
| | * ''[[:de:create:functions:uploadrawdata]]'' -- Liefert eine hochgeladene Datei als Binärstring |
| |
| ===== Grafische Darstellung von Daten ===== | ===== Grafische Darstellung von Daten ===== |
| |
| * ''[[:de:create:functions:diagram2|diagram2()]]'' -- Diagramm mit vorgegeben Daten erstellen | * ''[[:de:create:functions:diagram2|diagram2()]]'' -- Diagramm mit vorgegeben Daten erstellen |
| | * ''[[:de:create:functions:getqrcodeimage|getQRCodeImage()]]'' -- QR-Code im Fragebogen einbinden |
| * ''[[:de:create:functions:imagepng_embed|imagepng_embed()]]'' -- PNG-Grafik ohne Umweg über eine Datei einbinden | * ''[[:de:create:functions:imagepng_embed|imagepng_embed()]]'' -- PNG-Grafik ohne Umweg über eine Datei einbinden |
| |
| ===== Teilnehmer-Management ===== | ===== Teilnehmer-Management ===== |
| |
| * ''[[:de:create:functions:mailresume|mailResume()]]'' -- Zeitverzögerte Fortsetzung des Interviews | * ''[[:de:create:functions:mailresume]]'' -- Zeitverzögerte Fortsetzung des Interviews |
| * ''[[:de:create:functions:mailschedule|mailSchedule()]]'' -- Den zeitgesteuerten Versand einer Serienmail an einen einzelnen Teilnehmer vorbereiten | * ''[[:de:create:functions:mailschedule]]'' -- Den zeitgesteuerten Versand einer Serienmail an einen einzelnen Teilnehmer vorbereiten |
| * ''[[:de:create:functions:mailrevoke|mailRevoke()]]'' -- Fortsetzungsmail(s) oder Serienmail stornieren | * ''[[:de:create:functions:mailrevoke]]'' -- Fortsetzungsmail(s) oder Serienmail stornieren |
| * ''[[:de:create:functions:paneldata|panelData()]]'' -- Informationen zum Adresseintrag abrufen | * ''[[:de:create:functions:mailsend]]'' -- E-Mail an eine Adresse versenden, die nicht in der Adressliste steht |
| | * ''[[:de:create:functions:paneladd]]'' -- Erstellt einen neuen Adresseintrag |
| | * ''[[:de:create:functions:paneldata]]'' -- Informationen zum Adresseintrag abrufen |
| | * ''[[:de:create:functions:panelupdate]]'' -- Adresseinträge aktualisieren/ändern |
| | * ''[[:de:create:functions:paneldelete]]'' -- Einträge aus der Adressliste löschen |
| | * ''[[:de:create:functions:accesscount]]'' -- Eingabeversuche für Teilnahmecodes beschränken |
| | * ''[[:de:create:functions:setstatus]]'' -- Interview-Status festlegen und ggf. Panel-Redirects auslösen |
| |
| ===== PHP-eigene Funktionen ===== | ===== PHP-eigene Funktionen ===== |
| * [[http://php.net/manual/de/function.intval.php|intval]] - Variable in einen Integer-Wert umwandeln | * [[http://php.net/manual/de/function.intval.php|intval]] - Variable in einen Integer-Wert umwandeln |
| * [[http://php.net/manual/de/function.md5.php|md5]] - MD5-hash eines Wertes berechnen | * [[http://php.net/manual/de/function.md5.php|md5]] - MD5-hash eines Wertes berechnen |
| | |
| | ===== Eingeschränkte Funktionen ===== |
| | |
| | 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'' |
| | * ''[[:de:create:functions:html]]'' |
| | * ''[[:de:create:functions:text]]'' |
| | * ''mysqld_query()'' |
| | * ''[[de:create:databank]]'' |
| | * ''[[:de:create:functions::datasetretrieve|datasetRetrieve()]]'' |
| | |
| |
| ===== Funktionen im Detail ===== | ===== Funktionen im Detail ===== |
