Subversion Repositories wimsdev

Rev

Rev 4092 | Rev 5513 | Go to most recent revision | Blame | Compare with Previous | Last modification | View Log | RSS feed

  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. <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 <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 class="wims_code_variable">\reply1</tt>,
  19. <tt class="wims_code_variable">\reply2</tt>,... (for freestyle replies), <tt class="wims_code_variable">\choice1</tt>,
  20. <tt class="wims_code_variable">\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 class="wims_code_variable">\sc_reply1</tt>, <tt class="wims_code_variable">\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. does not 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 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&gt;\reply2+2<td>first freestyle reply is &gt; second one plus 2
  44. $table_tr<td><tt class="wims_code_words">\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 class="wims_code_words">\reply1&lt;5 or \reply1&gt;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
  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 class="wims_code_variable">\reply</tt> and
  55. <tt class="wims_code_variable">\choice</tt> within one same condition. Otherwise the result will be
  56. unpredictable.
  57.  
  58.