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