Subversion Repositories wimsdev

Rev

Go to most recent revision | Details | 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.
10
<p><tt>
11
\feedback{CONDITION}{MESSAGE}
12
</tt> <p>
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>
16
When <tt>CONDITION</tt> is met,
17
<tt>MESSAGE</tt> will be shown to the user in the result page. Values of
18
user replies can be put into both via the variables <tt>\reply1</tt>,
19
<tt>\reply2</tt>,... (for freestyle replies), <tt>\choice1</tt>,
20
<tt>\choice2</tt>,... (for multiple choices). The order in the variables
21
is the order of their appearance in the source (or in the form under the
22
guided mode).
23
<p>
24
<tt>MESSAGE</tt> is a free text, accepting embedded html tags and
25
mathematical symbols.
26
 
27
<p>
28
One can use also the variables <tt>\sc_reply1</tt>, <tt>\sc_reply2</tt>,
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
31
doesn't take care of conditions and is empty in the case where the
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
42
$table_tr<td><tt>\reply1=5<td>first freestyle reply is exactly equal to 5
43
$table_tr<td><tt>\reply1&gt;\reply2+2<td>first freestyle reply is &gt; second one plus 2
44
$table_tr<td><tt>\choice1=Yes and \choice2=No
45
  <td>first multiple choice is Yes and second is No (<b>attention</b> the
46
comparison in multiple choices is case-sensitive!)
47
$table_tr<td><tt>\reply1&lt;5 or \reply1&gt;8
48
  <td>first reply is outside the range from 5 to 8.
49
$table_tr<td><tt>3 isitemof \reply1
50
  <td>the first reply, of type "set" or "vector", contains a component "3".
51
 
52
$table_end
53
<p>
54
<b>Known-bug</b>. You should avoid mixing <tt>\reply</tt> and
55
<tt>\choice</tt> within one same condition. Otherwise the result will be
56
unpredictable.
57