Subversion Repositories wimsdev

Rev

Rev 5903 | Rev 6249 | Go to most recent revision | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
23 reyssat 1
 
5947 bpr 2
<h3 class="wimscenter">Feedback according to answers</h3>
23 reyssat 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.
5947 bpr 10
</p><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).
5947 bpr 23
</p><p>
5903 bpr 24
<span class="tt">MESSAGE</span> is a free text, accepting embedded html tags and
23 reyssat 25
mathematical symbols.
26
 
5947 bpr 27
</p><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.
5947 bpr 33
</p>
34
$table_header
23 reyssat 35
<caption>Examples of conditions
36
<small>
37
!href target=wims_mhelp cmd=help&special_parm=if complete list
38
</small>
39
</caption>
5947 bpr 40
$table_hdtr<th>condition</th><th>when it is met</th></tr>
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>
42
$table_tr<td><span class="tt wims_code_words">\reply1&gt;\reply2+2</span></td><td>first freestyle reply is &gt; second one plus 2</td></tr>
43
$table_tr<td><span class="tt wims_code_words">\choice1=Yes and \choice2=No</span></td>
23 reyssat 44
  <td>first multiple choice is Yes and second is No (<b>attention</b> the
45
comparison in multiple choices is case-sensitive!)
5947 bpr 46
</td></tr>
47
$table_tr<td><span class="tt wims_code_words">\reply1&lt;5 or \reply1&gt;8</span></td>
23 reyssat 48
  <td>first reply is outside the range from 5 to 8.
5947 bpr 49
</td></tr>$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".
5947 bpr 51
</td></tr>
23 reyssat 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.
5947 bpr 57
</p>