| Beide Seiten der vorigen RevisionVorhergehende ÜberarbeitungNächste Überarbeitung | Vorhergehende Überarbeitung |
| de:create:functions [16.11.2020 21:15] – Neue Funktion QR Code 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: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: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 ===== |
| ===== 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 ===== |
| ===== Eingeschränkte Funktionen ===== | ===== 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 an SoSci Survey mit. | 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'' | * ''echo'' |
