Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen RevisionVorhergehende Überarbeitung
Nächste Überarbeitung
Vorhergehende Überarbeitung
de:create:functions [30.11.2018 21:00] – [Funktionen zur Randomisierung] adminde:create:functions [14.03.2024 11:36] (aktuell) – [Datenbank für Inhalte] admin
Zeile 24: Zeile 24:
   * ''[[: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
Zeile 59: Zeile 58:
   * ''[[: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:getvariables]]'' -- Liefert eine Liste von Variablen as dem Datensatz
   * ''[[:de:create:functions:getroute]]'' -- Ermitteln, ob der Weiter- oder Zurück-Knopf verwendet wurde   * ''[[:de:create:functions:getroute]]'' -- Ermitteln, ob der Weiter- oder Zurück-Knopf verwendet wurde
-  * ''[[:de:create:functions:casenumber|caseNumber()]]'' -- Nummer der aktuellen Interviews +  * ''[[:de:create:functions:casenumber]]'' -- Nummer der aktuellen Interviews 
-  * ''[[:de:create:functions:caseserial|caseSerial()]]'' -- Für das Interview verwendete Seriennummer +  * ''[[:de:create:functions:caseserial]]'' -- Teilnahmecode oder Personenkennung der Teilnehmer:in 
-  * ''[[:de:create:functions:casetime|caseTime()]]'' -- Verweildauer auf einer oder mehreren Seiten +  * ''[[:de:create:functions:casetime]]'' -- Verweildauer auf einer oder mehreren Seiten 
-  * ''[[:de:create:functions:casetoken|caseToken()]]'' -- Interne Kennung des Interviews+  * ''[[: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:reference|reference()]]'' -- Evtl. im Link zum Fragebogen übergebene Referenz abfragen
-  * ''[[:de:create:functions:serialcheck|serialCheck()]]'' -- Status einer Seriennummer abfragen+  * ''[[:de:create:functions:serialcheck|serialCheck()]]'' -- Status eines Teilnahmecodes 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:sendjson|sendPOST()]]'' -- HTTP-Anfrage im POST-Format senden (REST API) 
 +  * ''[[:de:create:functions:sendjson|sendXML()]]'' -- HTTP-Anfrage im XML-Format senden (REST API)
   * ''[[:de:create:functions:getanswermissing|getAnswerMissing()]]'' - Information ob die Seite wegen einer Pflichtfrage wiederholt wird   * ''[[: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:listfails|listFails()]]'' -- Liste der nicht ausgefüllten Pflichtfragen
Zeile 77: Zeile 80:
   * ''[[:de:create:functions:getlanguage|getLanguage()]]'' -- Aktuelle Sprachversion ermitteln   * ''[[: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
 +
  
 ===== 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)
Zeile 86: Zeile 92:
   * ''[[: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: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|dbTouch()]]'' -- Zeitstempel für einen Eintrag in der Datenbank aktualisieren   * ''[[:de:create:functions:dbtouch|dbTouch()]]'' -- Zeitstempel für einen Eintrag in der Datenbank aktualisieren
 +
 +===== 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 =====
Zeile 104: Zeile 123:
   * ''[[:de:create:functions:answersoption]]'' -- Darstellung der Antworten in ''answers()'' oder ''answersPrint()'' anpassen   * ''[[:de:create:functions:answersoption]]'' -- Darstellung der Antworten in ''answers()'' oder ''answersPrint()'' anpassen
   * ''[[:de:create:functions:answersprint]]'' -- Alle Fragen eines Fragebogen-Abschnitts inkl. Antworten des Befragten anzeigen   * ''[[:de:create:functions:answersprint]]'' -- Alle Fragen eines Fragebogen-Abschnitts inkl. Antworten des Befragten anzeigen
 +  * ''[[:de:create:functions:info]]'' -- Metainformationen zum aktuellen Interview oder zur Darstellung
   * ''[[:de:create:functions:valuesum]]'' -- Summe über eine Skala oder mehrere Variablen berechnen   * ''[[:de:create:functions:valuesum]]'' -- Summe über eine Skala oder mehrere Variablen berechnen
   * ''[[:de:create:functions:valuemean]]'' -- Mittelwert über Skala oder Variablen berechnen   * ''[[:de:create:functions:valuemean]]'' -- Mittelwert über Skala oder Variablen berechnen
Zeile 115: Zeile 135:
  
   * ''[[: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:paneldata]]'' -- Informationen zum Adresseintrag abrufen
  
 ===== PHP-eigene Funktionen ===== ===== PHP-eigene Funktionen =====
Zeile 211: Zeile 233:
     * [[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 =====
de/create/functions.1543608035.txt.gz · Zuletzt geändert: 30.11.2018 21:00 von admin
 
Falls nicht anders bezeichnet, ist der Inhalt dieses Wikis unter der folgenden Lizenz veröffentlicht: CC Attribution-Share Alike 4.0 International
Driven by DokuWiki