| Both sides previous revisionPrevious revisionNext revision | Previous revision |
| en:create:functions:getitemtext [24.01.2015 15:42] – [Example 1] alexander.ritter | en:create:functions:getitemtext [26.08.2020 22:14] (current) – sophia.schauer |
|---|
| |
| ''string **getItemtext**(string //questionID//, int //item//)'' | ''string **getItemtext**(string //questionID//, int //item//)'' |
| | ''string **getItemtext**(string //ItemID//)'' |
| |
| An item's or option's label can be determined with this function -- e.g. to use the text in another question or to display in the print view for the participant. The function can also determine the text in the question. | An item's or option's label can be determined with this function -- e.g. to use the text in another question or to display in the print view for the participant. The function can also determine the text in the question. |
| * '''question''' -- Question's title | * '''question''' -- Question's title |
| * '''explanation''' -- Question's explanation | * '''explanation''' -- Question's explanation |
| | * //ItemID//\\ The identifier of an item, e.g. "AB01_02".\\ Instead of specifying question identifier and item separately, the item identifier can also be entered directly. |
| |
| **Note:** It is often easier to use the function ''[[:en:create:functions:value|value()]]'' with '''text''' or '''free''' as the second parameter (compare example 1). | **Note:** selection questions it is often easier to use the function ''[[:en:create:functions:value|value()]]'' with '''text''' or '''free''' as the second parameter (compare example 1). |
| |
| |
| ===== Example 1 ===== | ===== Example 1 ===== |
| |
| In the following example, question "AB01" is a lengthier drop-down selection (on page 1 in the questionnaire). The respondent selects his favourite television program in the question. The question is set so that the respondent must give a response. The title of the program will be shown in question "AB02". Thus, "AB02" has a placeholder ''%title%'' in the question title. | In the following example, question "AB01" is a lengthier drop-down selection (on page 1 in the questionnaire). The respondent selects his favourite television program. The question is set so that the respondent must give a response. The title of the program will be shown in question "AB02". Thus, "AB02" has a placeholder ''%title%'' in the question title. |
| |
| In order for the placeholder to display the title, the selected title has to be identified initially with ''getItemtext()'' , and set up as placeholder with ''[[:en:create:functions:replace|replace()]]''. The following PHP code is put on page 2 or later on: | In order for the placeholder to display the title, the selected title has to be identified initially with ''getItemtext()'' , and set up as placeholder with ''[[:en:create:functions:replace|replace()]]''. The following PHP code is put on page 2 or later on: |
| <code php> | <code php> |
| $selection = value('AB01'); // respondent's selection (answer code = item) | $selection = value('AB01'); // respondent's selection (answer code = item) |
| $titel = getItemtext('AB01', $auswahl); | $title = getItemtext('AB01', $selection); |
| replace('%title%', $title); // set up placeholder | replace('%title%', $title); // set up placeholder |
| question('AB02'); // ask question AB02 | question('AB02'); // ask question AB02 |
| <code php> | <code php> |
| $title = value('AB01', 'free'); // Respondent's selection as text | $title = value('AB01', 'free'); // Respondent's selection as text |
| replace('%title%', $titel); // Set up placeholder | replace('%title%', $title); // Set up placeholder |
| question('AB02'); // Ask question AB02 | question('AB02'); // Ask question AB02 |
| </code> | </code> |
