Rev 5513 | Rev 5947 | Go to most recent revision | Details | Compare with Previous | Last modification | View Log | RSS feed
Rev | Author | Line No. | Line |
---|---|---|---|
23 | reyssat | 1 | |
2 | <center><h3>Feedback according to answers</h3></center> <p> |
||
3 | |||
4 | You may define conditions (on the values of user answers) under which a |
||
5 | message will be printed on the page of results. A common use of this feature |
||
6 | will be to give warnings when a typical error to the exercise is detected. |
||
7 | <p> |
||
8 | An arbitrary number of feedbacks can be added, on any kind of replies |
||
9 | (freestyle or multiple choice). The syntax is as follows. |
||
4092 | bpr | 10 | <pre> |
23 | reyssat | 11 | \feedback{CONDITION}{MESSAGE} |
4091 | bpr | 12 | </pre> |
23 | reyssat | 13 | The line can be put into the field of parameters (under guided mode) or |
14 | anywhere in the source (under raw mode). |
||
15 | <p> |
||
5903 | bpr | 16 | When <span class="tt">CONDITION</span> is met, |
17 | <span class="tt">MESSAGE</span> will be shown to the user in the result page. Values of |
||
18 | user replies can be put into both via the variables <span class="tt wims_code_variable">\reply1</span>, |
||
19 | <span class="tt wims_code_variable">\reply2</span>,... (for freestyle replies), <span class="tt wims_code_variable">\choice1</span>, |
||
20 | <span class="tt wims_code_variable">\choice2</span>,... (for multiple choices). The order in the variables |
||
23 | reyssat | 21 | is the order of their appearance in the source (or in the form under the |
22 | guided mode). |
||
23 | <p> |
||
5903 | bpr | 24 | <span class="tt">MESSAGE</span> is a free text, accepting embedded html tags and |
23 | reyssat | 25 | mathematical symbols. |
26 | |||
27 | <p> |
||
5903 | bpr | 28 | One can use also the variables <span class="tt wims_code_variable">\sc_reply1</span>, <span class="tt wims_code_variable">\sc_reply2</span>, |
23 | reyssat | 29 | ... which are equal to 1 in case of good user reply, 0 in case of false |
30 | user reply and 0.5 in case of good reply up to numerical precision. This variable |
||
4427 | bpr | 31 | does not take care of conditions and is empty in the case where the |
23 | reyssat | 32 | answer is analyzed only with conditions. |
33 | |||
34 | |||
35 | <p>$table_header |
||
36 | <caption>Examples of conditions |
||
37 | <small> |
||
38 | !href target=wims_mhelp cmd=help&special_parm=if complete list |
||
39 | </small> |
||
40 | </caption> |
||
41 | $table_hdtr<th>condition<th>when it is met |
||
4091 | bpr | 42 | $table_tr<td><tt class="wims_code_words">\reply1=5<td>first freestyle reply is exactly equal to 5 |
43 | $table_tr<td><tt class="wims_code_words">\reply1>\reply2+2<td>first freestyle reply is > second one plus 2 |
||
44 | $table_tr<td><tt class="wims_code_words">\choice1=Yes and \choice2=No |
||
23 | reyssat | 45 | <td>first multiple choice is Yes and second is No (<b>attention</b> the |
46 | comparison in multiple choices is case-sensitive!) |
||
4091 | bpr | 47 | $table_tr<td><tt class="wims_code_words">\reply1<5 or \reply1>8 |
23 | reyssat | 48 | <td>first reply is outside the range from 5 to 8. |
4091 | bpr | 49 | $table_tr<td><tt class="wims_code_words">3 isitemof \reply1 |
23 | reyssat | 50 | <td>the first reply, of type "set" or "vector", contains a component "3". |
51 | |||
52 | $table_end |
||
53 | <p> |
||
5903 | bpr | 54 | <b>Known-bug</b>. You should avoid mixing <span class="tt wims_code_variable">\reply</span> and |
55 | <span class="tt wims_code_variable">\choice</span> within one same condition. Otherwise the result will be |
||
23 | reyssat | 56 | unpredictable. |
57 |