| Beide Seiten der vorigen RevisionVorhergehende ÜberarbeitungNächste Überarbeitung | Vorhergehende Überarbeitung |
| de:create:placeholders [30.07.2019 21:23] – admin | de:create:placeholders [23.10.2026 14:44] (aktuell) – Externe Bearbeitung 127.0.0.1 |
|---|
| * benutzerdefinierte Platzhalter und | * benutzerdefinierte Platzhalter und |
| * Platzhalter für Eingabefelder. | * Platzhalter für Eingabefelder. |
| | |
| | **Hinweis:** Benutzerdefinierte Platzhalter funktionieren __nicht__ auf der "Letzten Seite" eines Fragebogens, weil mit Abschluss des Interviews (FINISHED=1) Hintergrunddaten aus dem Fall entfernt werden. Erstellen Sie im Bedarfsfall eine zusätzliche vorletzte Seite mit ''[[:de:create:functions:buttonHide]]''. |
| |
| **Tipp:** Platzhalter funktionieren in nahezu allen Texten, von der Frage selbst über Items, Textbausteine, HTML-Code Elemente u.s.w. | **Tipp:** Platzhalter funktionieren in nahezu allen Texten, von der Frage selbst über Items, Textbausteine, HTML-Code Elemente u.s.w. |
| Das folgende Beispiel zeigt, wie sich Platzhalter mit Filterfragen kombinieren lassen. | Das folgende Beispiel zeigt, wie sich Platzhalter mit Filterfragen kombinieren lassen. |
| |
| In der Frage ''SD01'' wird das Geschlecht des Teilnehmers abgefragt. In weiteren Fragen soll nun erhoben werden, wie der Teilnehmer auf Personen des anderen Geschlecht reagiert. Dafür wird ein Platzhalter ''%person%'' vorbereitet, der im Fragebogen entweder durch "ein Mann" oder "eine Frau" ersetzt wird. Ein zweiter Platzhalter ''%personen%'' wird mit der Plural-Form vorbereitet. | In der Frage ''SD01'' wird das Geschlecht des Teilnehmers abgefragt. In weiteren Fragen soll nun erhoben werden, wie der Teilnehmer auf Personen des anderen Geschlechts reagiert. Dafür wird ein Platzhalter ''%person%'' vorbereitet, der im Fragebogen entweder durch "ein Mann" oder "eine Frau" ersetzt wird. Ein zweiter Platzhalter ''%personen%'' wird mit der Plural-Form vorbereitet. |
| |
| Der folgende PHP-Code wird auf der Seite __nach__ Frage ''SD01'' platziert. | Der folgende PHP-Code wird auf der Seite __nach__ Frage ''SD01'' platziert. |
| replace('%person%', 'ein Mann'); | replace('%person%', 'ein Mann'); |
| replace('%personen%', 'Männer'); | replace('%personen%', 'Männer'); |
| } elseif (value('DC02') == 2) { | } elseif (value('SD01') == 2) { |
| replace('%person%', 'eine Frau'); | replace('%person%', 'eine Frau'); |
| replace('%personen%', 'Frauen'); | replace('%personen%', 'Frauen'); |
| ===== Vordefinierte Platzhalter ===== | ===== Vordefinierte Platzhalter ===== |
| |
| Folgende Platzhalter stehen automatisch zur Verfügung, diese Kennungen dürfen __nicht__ für benutzerdefinierte Platzhalter verwendet werden. Die Inhalte der Platzhalter können auch mittels PHP-Funktion zur weiteren Verwendung abgerufen werden (rechte Spalte). | Folgende Platzhalter stehen automatisch zur Verfügung, diese Kennungen dürfen __nicht__ für benutzerdefinierte Platzhalter verwendet werden. Die Inhalte einiger Platzhalter können auch mittels PHP-Funktion zur weiteren Verwendung abgerufen werden (rechte Spalte). |
| |
| ^Kennung^Beschreibung^Variable im Datensatz^PHP-Funktion^ | ^Kennung^Beschreibung^Variable im Datensatz^PHP-Funktion^ |
| |''%caseLanguage%''|Sprache des laufenden Interviews [Sprache-Code] |LANGUAGE|''[[:de:create:functions:getlanguage]]''| | |''%caseLanguage%''|Sprache des laufenden Interviews [Sprache-Code] |LANGUAGE|''[[:de:create:functions:getlanguage]]''| |
| |''%caseNumber%''|Fortlaufende Nummer des Interviews|CASE|''[[:de:create:functions:casenumber]]''| | |''%caseNumber%''|Fortlaufende Nummer des Interviews|CASE|''[[:de:create:functions:casenumber]]''| |
| |''%caseSerial%''|Seriennummer des Interviews|SERIAL|''[[:de:create:functions:caseserial|caseSerial()]]''| | |''%caseSerial%''|Teilnahmecode oder Personenkennung des Interviews|SERIAL|''[[:de:create:functions:caseserial|caseSerial()]]''| |
| |''%caseToken%''|Interne Kennung des Interviews|-|''[[:de:create:functions:casetoken|caseToken()]]''| | |''%caseToken%''|Interne Kennung des Interviews|-|''[[:de:create:functions:casetoken|caseToken()]]''| |
| |''%reference%''|Referenz, die an den Fragebogen übergeben wurde|REF|''[[:de:create:functions:reference|reference()]]''| | |''%reference%''|Referenz, die an den Fragebogen übergeben wurde|REF|''[[:de:create:functions:reference|reference()]]''| |
| |''%pageNumber.abs%''|Nummer der aktuellen Seite laut **Fragebogen zusammenstellen** (Vorsicht bei der Verwendung von Filterfragen)||| | |''%pageNumber.abs%''|Nummer der aktuellen Seite laut **Fragebogen zusammenstellen** (Vorsicht bei der Verwendung von Filterfragen)||| |
| |''%pageNumber.cnt%''|Nummer der Seite laut **Fragebogen zusammenstellen**, von welcher der Inhalt der Seite stammt -- wie ''%pageNumber.abs%'' solange nicht mittels ''[[:de:create:functions:gotopage]]'' zu einer anderen Seite gesprungen wird und dort eine Frage oder anderer Inhalt angezeigt wurde.||| | |''%pageNumber.cnt%''|Nummer der Seite laut **Fragebogen zusammenstellen**, von welcher der Inhalt der Seite stammt -- wie ''%pageNumber.abs%'' solange nicht mittels ''[[:de:create:functions:gotopage]]'' zu einer anderen Seite gesprungen wird und dort eine Frage oder anderer Inhalt angezeigt wurde.||| |
| |''%pageNumber.rel%''|Nummer der aktuellen Seite gezählt seit Beginn des Interviews (nicht kompatibel mit ''[[:de:create:function:gotoquestionnaire]]'', ''[[:de:create:functions:multileveldown]]'' und der Funktion **Erhobene Daten** -> **Ausgefüllten Fragebogen ändern**)||| | |''%pageNumber.rel%''|Nummer der aktuellen Seite gezählt seit Beginn des Interviews (nicht kompatibel mit ''[[:de:create:functions:gotoquestionnaire]]'', ''[[:de:create:functions:multileveldown]]'' und der Funktion **Erhobene Daten** -> **Ausgefüllten Fragebogen ändern**)||| |
| | |''%lang.label%''|Name der aktiven Sprachversion (z.B. "Deutsch")||| |
| | |''%lang.short%''|2-stelliges Kürzel der aktiven Sprachversion (z.B. "DE")||| |
| | |''%year%''|4-stellige Jahreszahl (zum Beispiel zur Verwendung im Impressum)||''date('Y')''| |
| |
| Folgende Platzhalter stehen innerhalb von Items bzw. Optionen (z.B. im Item-Text) zur Verfügung. Die Nummerierung hilft u.a. dabei, zufällig rotierte Auswahloptionen fortlaufend zu nummerieren. | Folgende Platzhalter stehen innerhalb von Items bzw. Optionen (z.B. im Item-Text) zur Verfügung. Die Nummerierung hilft u.a. dabei, zufällig rotierte Auswahloptionen fortlaufend zu nummerieren. |
| |''%imprint%''|HTML-Code für das Impressum| | |''%imprint%''|HTML-Code für das Impressum| |
| |''%progress%''|HTML-Code für den Fortschrittsbalken| | |''%progress%''|HTML-Code für den Fortschrittsbalken| |
| |''%head%''|HTML-Code für den Kopfbereich im Layout-Template| | |''%head%''\\ ''%%<link type="placeholder" href="head">%%''|HTML-Code für den Kopfbereich im Layout-Template\\ (HTML-kompatible Variante)| |
| |''%questionnaire%''|HTML-Code für den Inhalte im Layout-Template| | |''%questionnaire%''|HTML-Code für den Inhalt im Layout-Template| |
| |
| |
| <code> | <code> |
| "Bitte beurteilen Sie die folgenden Aussagen zu %marke%!" | "Bitte beurteilen Sie die folgenden Aussagen zu %marke%!" |
| Item 1: "Ich finde %marke% besser als oFb" | Item 1: "Ich finde %marke% besser als SoSci Survey" |
| Item 2: "%marke% wirkt eher künstlich" | Item 2: "%marke% wirkt eher künstlich" |
| </code> | </code> |
| |
| {{scr.placeholders.example.gif?nolink|Beispiel für die Verwendung von Platzhaltern}} | {{:de:create:scr.placeholders.example.gif?nolink|Beispiel für die Verwendung von Platzhaltern}} |
| |
| |
| ==== Texteingabe ==== | ==== Texteingabe ==== |
| |
| Voraussetzung für das folgende Beispiel ist, dass in der offenen Texteingabe ''TX01_01'' eine Marke abegfragt wurde. Der folgende PHP-Code darf __nicht__ auf derselben Seite wie Frage ''TX01'' platziert werden, sondern erst auf einer der folgenden Seiten. | Voraussetzung für das folgende Beispiel ist, dass in der offenen Texteingabe ''TX01_01'' eine Marke abgefragt wurde. Der folgende PHP-Code darf __nicht__ auf derselben Seite wie Frage ''TX01'' platziert werden, sondern erst auf einer der folgenden Seiten. |
| |
| <code php> | <code php> |
