id()

string id(string category, integer question)

string id(string category, integer question, integer Item)

string id(string question identifier, integer Item)

The function id() is generating a formally correct qestion- or item identifier out of single statements about the category, question and (optional) item. This question- or item identifier can be used e.g. in value() or put(). The function can be helpful, when the item identifier is specified as a number, like e.g. 1 instead of 01.

• Category – Double-digit identifier of a category, e.g. 'AB'
• Question – Numeric identifier of a question within a category, e.g.1, '01'
• Question identifier – Entire identifier of a question (incl. category), e.g. 'AB01'
• Item – Numeric identifier of an item or an option within a question, e.g. 2, '02'

The function delivers the entire identifier of a question (e.g. 'AB01') or an item, when the parameter Item was set (e.g. 'AB01_01').

Im folgenden Beispiel werden jene Optionen einer Skalenbatterie SK01 aufgelistet, welche vom Teilnehmer min. mit 3 bewertet wurden (z.B. auf einer fünfstufigen Skala). Dabei soll in Klammern jeweils die Bewertung angezeigt werden. Die Bewertung wird mittels value() abgerufen. Die dafür nötige Variablen-Kennung (die hier der Item-Kennung entspricht) wird mittels id() erzeugt.

// Items mit Bewertung 3+ finden
$items = getItems('SK01', 'min', 3);
// Alle Items durchgehen
foreach ($items as $item) {
  // Text ermitteln
  $text = getItemtext('SK01', $item);
  // Wert ermitteln
  $wert = value(id('SK01', $item));
  // Im Fragebogen anzeigen
  html('<p>'.$text.' ('.$wert.')</p>);
}