====== getItemtext() ======

''string **getItemtext**(string //FrageKennung//, int //Item//)''

''string **getItemtext**(string //ItemKennung//)''

Mit dieser Funktion kann man die Beschriftung eines Items bzw. einer Auswahloption ermitteln -- z.B. um den Text in einer anderen Frage oder als Druckansicht für den Teilnehmer anzuzeigen. Außerdem kann die Funktion den Text einer Frage ermitteln.

  * //FrageKennung//\\ Die Kennung einer Frage, z.B. "AB01"
  * //Item//
    * <n> -- Die Kennung eines Items in dieser Frage, z.B. 2 für das Item "AB01_02"
    * '''question''' -- Der Fragetext der Frage
    * '''explanation''' -- Die Erklärung zur Frage
  * //Itemkennung//\\ Die Kennung eines Items, z.B. "AB01_02".\\ Anstatt Fragekennung und Item getrennt anzugeben, kann auch direkt die Item-Kennung eingetragen werden.

**Hinweis:** Bei Auswahlfragen ist es oftmals einfacher, die Funktion ''[[:de:create:functions:value|value()]]'' mit dem zweiten Parameter '''text''' oder '''free''' als zweiten Parameter zu verwenden (vgl. Beispiel 1).


===== Beispiel 1 =====

Im folgende Beispiel ist Frage "AB01" eine längere Dropdown-Auswahl (auf Seite 1 im Fragebogen). Dort wählt der Befragte seine Lieblings-Sendung im Fernsehen aus. In der Frage ist eingestellt, dass der Befragte eine Antwort geben muss. Der Titel dieser Sendung soll in Frage "AB02" angezeigt werden. Dafür enthält "AB02" im Fragetext einen Platzhalter ''%title%''.

Damit der Platzhalter den Titel anzeigt, muss der ausgewählte Titel zunächst mit ''getItemtext()'' ermittelt und mit ''[[:de:create:functions:replace|replace()]]'' als Platzhalter vorbereitet werden. Der folgende PHP-Code steht auf Seite 2 oder später:

<code php>
$auswahl = value('AB01');  // Auswahl des Befragten (Antwortcode = Item)
$titel = getItemtext('AB01', $auswahl);
replace('%title%', $titel);  // Platzhalter vorbereiten
question('AB02');  // Frage AB02 stellen
</code>

Die Funktion ''[[:de:create:functions:value|value()]]'' kann auch mit offenen Eingaben des Teilnehmers ("Sonstiges: ...") umgehen. Abgesehen davon liefert der folgende PHP-Code dasselbe Ergebnis wie der PHP-Code oben.

<code php>
$titel = value('AB01', 'free');  // Auswahl des Befragen als Text
replace('%title%', $titel);  // Platzhalter vorbereiten
question('AB02');  // Frage AB02 stellen
</code>


===== Beispiel 2 =====

Am Ende des Fragebogens sollen dem Teilnehmer seine Antworten auf ausgewählte Items der Frage "AB02" (einer voll beschrifteten Skala) angezeigt werden. Der folgende PHP-Code ermittelt für die Items 2, 4, 6 und 8 die Beschriftungen (Itemtexte) und Antworten (als Text) und zeigt diese in einer HTML-Tabelle an.

<code php>
$html = '<table cellspacing="0" cellpadding="2" border="1">';
foreach ($item in array(2,4,6,8)) {
  $itemtext = getItemtext('AB02', $item);
  $antwort = value('AB02_'.$item, 'text');
  $html.=
    '<tr>
       <td>'.$itemtext.'</td>
       <td>'.$antwort.'</td>
     </tr>';
}
$html.= '</table>';
html($html);
</code>