Annotation of loncom/html/adm/help/tex/Authoring_ExternalResponse.tex, revision 1.2

1.1       bowersj2    1: \label{Authoring_ExternalResponse}
                      2: 
                      3: 
                      4: \textbf{externalresponse} is an advanced type of response tag that
                      5: implements the ability to have an external program grade a response.
                      6: It expects either a \textbf{textline} or \textbf{textfield} inside
                      7: the tag. Possible attributes are:
                      8: 
                      9: \begin{itemize}
1.2     ! vandui11   10: \item \textbf{url}\index{url}: url to submit the answer form to. It does
1.1       bowersj2   11: not need to be a LON-CAPA machine.
1.2     ! vandui11   12: \item \textbf{answer}\index{answer}:  string or scalar variable that can
        !            13: encode something that should encode the correct answer. In some cases,
1.1       bowersj2   14: this may be nothing. 
1.2     ! vandui11   15: \item \textbf{form}\index{form}: hash variable name that will be submitted
1.1       bowersj2   16: to the remote site as a HTTP form.
                     17: \end{itemize}
                     18: The response of the remote server needs to be in XML as follows: 
                     19: 
                     20: \begin{itemize}
                     21: \item \textbf{loncapagrade}\index{loncapagrade}: takes no attributes, but
                     22: must surround the response.
                     23: \item \textbf{awardetail}\index{awardetail}: required. The delimited text
                     24: inside must be one of the detailed results that appears in the data
                     25: storage documentation. CVS:loncapa/doc/homework/datastorage, look
                     26: for \textbf{resource.partid.responseid.awarddetail}.
                     27: \item \textbf{message}\index{message}: optional message to have shown to
1.2     ! vandui11   28: the student.
1.1       bowersj2   29: \end{itemize}
                     30: Example: \begin{verbatim} <loncapagrade>
                     31:     <awardetail>INCORRECT</awardetail>
                     32:     <message>
                     33: A message to be shown to the students
                     34:     </message>
                     35: </loncapagrade>
                     36: \end{verbatim}

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>