[LON-CAPA-cvs] cvs: loncom /html/adm/help/tex Answer_Display_Overview.tex

[lira]

lira		Sun Jul 14 02:11:34 2013 EDT

  Modified files:              
    /loncom/html/adm/help/tex	Answer_Display_Overview.tex 
  Log:
  enhance description of options for displaying answers
  
  
Index: loncom/html/adm/help/tex/Answer_Display_Overview.tex
diff -u loncom/html/adm/help/tex/Answer_Display_Overview.tex:1.1 loncom/html/adm/help/tex/Answer_Display_Overview.tex:1.2
--- loncom/html/adm/help/tex/Answer_Display_Overview.tex:1.1	Fri Jul  5 18:20:09 2013
+++ loncom/html/adm/help/tex/Answer_Display_Overview.tex	Sun Jul 14 02:11:34 2013
@@ -1,5 +1,54 @@
 \label{Answer_Display_Overview}
-
+\index{answer display}
 Answers are typically not displayed to the student when they submit than answer to a problem. 
-When the problem is assigned in a course, a parameter for the 'answer date' can be set that will show the students the answers when they revisit the problem after that date. The answer date is separate from the due date which is also set when the problem is assigned. Note that an xml tag 'postanswerdate' is also available if you want to include more information along with the answer. The content in the xml tag is suppressed until after the answer date.
+When the problem is assigned in a course, a parameter for the `answer date' can be set that will show the students the answers when they revisit the problem after that date. The answer date is separate from the due date which is also set when the problem is assigned. Note that an xml tag `postanswerdate' is also available if you want to include more information along with the answer. The content in the xml tag is suppressed until after the answer date.
+
+Suppose you want the answer displayed as soon as the student finishes the problem rather than waiting for 
+the answer date. For example, this may occur in a multipoint problem where you
+want the students to see the correct answer for one part before proceding to the next part. If you would like the 
+computer answer to be displayed after the student answer is correct, or the maximum number
+of tries has been reached, this can be achieved by setting the parameter \texttt{problemstatus} = answer. Using
+the colorful editor, the parameter can be inserted WITHIN the problem part, but BEFORE the response tag (e.g. 
+\texttt{numericalresponse}). For example:
+
+\begin{verbatim}
+<part id="01">
+<parameter name="problemstatus" id="11" type="string_problemstatus" 
+  default="answer" description="Show Problem Status" />
+<numericalresponse answer="$c" id="01a">
+<!-- using no tolerance since exact integer is expected for answer -->
+    <textline readonly="no" spellcheck="none" />
+</numericalresponse>
+</part>
+\end{verbatim}
+
+The options for the problemstatus are: ``yes'' - shows correct or incorrect only; 
+``answer'' - shows computer answer as described above; ``no'' - 
+don't show correct/incorrect feedback; ``no\_feedback\_ever''- supresses all feedback.
+
+If you want to provide additional explanation in addition to the answer as soons as 
+the maximum tries allowed for the part have been reached, include a conditional
+block in the problem part, and set the condition for the part to evaluate to
+true when the problem is either correct, no tries remain, or it is post-answer date.
+
+To achieve this behavior, add a call to the LON-CAPA function  \&check\_status(`partid')
+for each part to the script block, and set a scalar to the value returned for each part, then use
+that scalar in the conditional block, e.g.,
+
+\begin{verbatim}
+<script type="loncapa/perl">
+# for part: a
+$status_a = &check_status('a');
+# other computations
+</script>
+
+<part id="a">
+<block condition="$status_a">
+<startouttext />
+<br />
+Some explanation text about the answer, $answer
+<endouttext />
+</block>
+</part>
+\end{verbatim}