Subversion Repositories wimsdev

Rev

Rev 6249 | Go to most recent revision | Show entire file | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed

Rev 6249 Rev 10822
Line 1... Line -...
1
 
-
 
2
<h3 class="wimscenter">Feedback according to answers</h3>
-
 
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><pre>
-
 
11
\feedback{CONDITION}{MESSAGE}
-
 
12
</pre>
-
 
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 <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
-
 
21
is the order of their appearance in the source (or in the form under the
-
 
22
guided mode).
-
 
23
</p><p>
-
 
24
<span class="tt">MESSAGE</span> is a free text, accepting embedded html tags and
-
 
25
mathematical symbols.
-
 
26
 
-
 
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>,
-
 
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
does not take care of conditions and is empty in the case where the
-
 
32
answer is analyzed only with conditions.
-
 
33
</p>
-
 
34
$table_header
-
 
35
<caption>Examples of conditions
1
!changeto help/en/feedback.phtml
36
<small>
-
 
37
!href target=wims_mhelp cmd=help&special_parm=if complete list
-
 
38
</small>
-
 
39
</caption>
-
 
40
$table_hdtr<th>condition</th><th>when it is met</th></tr>
-
 
41
$table_tr<td class="tt wims_code_words">\reply1=5</td><td>first freestyle reply is exactly equal to 5</td></tr>
-
 
42
$table_tr<td class="tt wims_code_words">\reply1&gt;\reply2+2</td><td>first freestyle reply is &gt; second one plus 2</td></tr>
-
 
43
$table_tr<td class="tt wims_code_words">\choice1=Yes and \choice2=No</td>
-
 
44
  <td>first multiple choice is Yes and second is No (<b>attention</b> the
-
 
45
comparison in multiple choices is case-sensitive!)
-
 
46
</td></tr>
-
 
47
$table_tr<td class="tt wims_code_words">\reply1&lt;5 or \reply1&gt;8</td>
-
 
48
  <td>first reply is outside the range from 5 to 8.
-
 
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".
-
 
51
</td></tr>
-
 
52
$table_end
-
 
53
<p>
-
 
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
-
 
56
unpredictable.
-
 
57
</p>
-