--- loncom/html/adm/help/tex/Custom_Response_Problems.tex 2007/05/10 21:04:02 1.4
+++ loncom/html/adm/help/tex/Custom_Response_Problems.tex 2009/05/24 13:08:35 1.5
@@ -2,12 +2,15 @@
Custom Response is a way to have a problem graded based on an algorithm. The use of this response type is
generally discouraged, since the responses will not be analyzable by the LON-CAPA statistics tools.
-The student answer is stored in the
-variable \$submission, and needs to be evaluated by Perl code inside the -tag. Custom Response needs to return a standard LON-CAPA. The most common response are:
+For a single textfield, the student's answer will be in a variable \$submission. If the Custom Response has multiple textfields, the answers will be in an array
+reference, and can be accessed as \$\$submission[0], \$\$submission[1], etc.
+
+The student answer needs to be evaluated by Perl code inside the -tag. Custom Response needs to return a standard LON-CAPA. The most common response are:
\begin{itemize}
\item EXACT\_ANS: return if solved exactly correctly
\item APPROX\_ANS: return if solved approximately
\item INCORRECT: return if not correct, uses up a try
+\item ASSIGNED\_SCORE: partial credit (also return the credit factor, e.g. return(ASSIGNED\_SCORE,0.3);)
\item SIG\_FAIL, NO\_UNIT, EXTRA\_ANSWER, MISSING\_ANSWER, BAD\_FORMULA,
WANTED\_NUMERIC: return if not correct for different reasons, does not use up a try
\end{itemize}
@@ -42,7 +45,7 @@ Full list of possible return codes:
\item WANTED\_NUMERIC: expected a numeric answer and didn't get one
\item SIG\_FAIL: incorrect number of Significant Figures
\item UNIT\_FAIL: incorrect unit
-\item UNIT\_NOTNEEDED: Submitted a unit when one shouldn't
+\item UNIT\_NOTNEEDED: submitted a unit when one shouldn't
\item UNIT\_INVALID\_INSTRUCTOR: the unit provided by the author of the problem is unparsable
\item UNIT\_INVALID\_STUDENT: the unit provided by the student is unparasable
\item UNIT\_IRRECONCIBLE: the unit from the student and the instructor are of different types
@@ -53,9 +56,8 @@ Full list of possible return codes:
\item DRAFT: submission only stored
\item MISORDERED\_RANK: student submitted a poorly order rank response
\item ERROR: unable to get a grade
-\item ASSIGNED\_SCORE: there is a resource.partid.responseid.awarded the real awarded should be set to the average of the individual awards
-\item TOO\_LONG: answer submission to CAPA engine longer than 500 characters
+\item ASSIGNED\_SCORE: partial credit; the customresponse needs to return the award followed by the partial credit factor
+\item TOO\_LONG: answer submission was deemed too long
\item INVALID\_FILETYPE: student tried to upload a file that was of an extension that was not specifically allowed
\item COMMA\_FAIL: answer requires the use of comma grouping and it wasn't provided or was incorrect
-
-\end{itemize}
\ No newline at end of file
+\end{itemize}