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

[raeburn]

raeburn		Mon Jul 21 12:42:19 2008 EDT

  Added files:                 
    /loncom/html/adm/help/tex	Domconfig_Scantron_Format.tex 
  Log:
  - Domain Configuration Help.
  
  

Index: loncom/html/adm/help/tex/Domconfig_Scantron_Format.tex
+++ loncom/html/adm/help/tex/Domconfig_Scantron_Format.tex
Where scantron exams are used in a course, the format of data in the
file generated from the processing of bubbled-in scantron sheets may
vary between institutions. The format definitions available when performing
scantron grading in LON-CAPA were originally listed in the scantronformat.tab
file, stored in /home/httpd/lonTabs, which might have been modified
locally on each server. 

Starting with LON-CAPA 2.7, scantron format information is read from
either a custom.tab file, or a default.tab file both of which belong
to the special domain configuration user (\$dom-domainconfig, where
\$dom is the name of the domain) and which are automatically published
into resource space. 

For LON-CAPA installations older than 2.7, when the primary library
server for the domain has been updated, a Domain Coordinator should
display the \char`\"{}Scantron format file\char`\"{} configuration
page via \char`\"{}Domain Configuration\char`\"{}. The first time
this page is displayed, a default.tab (a copy of the standard LON-CAPA
scantronformat.tab file), and a custom.tab (if the scantronform.tab
file currently on the server differs from the standard file) will
be copied and published. Thereafter any changes to scantron format
files to be used for grading scantron exams in courses from the domain
will be made via the Domain Configuration menu. Any scantronform.tab
files in /home/httpd/lonTab directories on servers in the domain will
no longer be used.

The settings available via \char`\"{}Scantron format file\char`\"{}
support upload of a new custom file, or deletion of an existing custom
file (in which case grading will default to use of the default.tab
file). An uploaded scantron format file contains one or more lines
of colon-separated values for the parameters in the following order:

name:description:CODEtype:CODEstart:CODElength:IDstart:IDlength:Qstart:Qlength:Qoff:Qon:PaperID:PaperIDlength:FirstName:FirstNamelength:LastName:LastNamelength 

\begin{itemize}
\item name is the internal identifier used within LON-CAPA
\item description is the text displayed for each option in the   
the {}``Format of data file'' dropdown in the Scantron grading
screen.  The user will choose the appropriate format for the scantron
file currently being used for scantron grading.
\item CODEtype can be either 'none' 'letter' 'number' 
\item Qon can be either:

\begin{itemize}
\item the symbol that says a bubble has been selected, or
\item 'letter' (for when the selected letter appears), or 
\item 'number' for when a number indicating the selected letter appears 
\end{itemize}
\end{itemize}
As an example, below are four different format lines: the first two
were used at MSU prior to 2006; the last two have been used since
then.

\begin{itemize}
\item msunocode:MSU without any CODE:none:0:0:57:9:77:10: :1:5:5:51:1:41:10 
\item msucode:MSU with CODE in separate location:letter:69:6:57:9:77:10:
:1:5:5:51:1:41:10 
\item msucodelet:MSU with CODE in separate location (letter format):-1:69:6:57:9:77:1:
:letter:5:5:51:1:41:10 
\item msucodenum:MSU with CODE in separate location (number format):-1:69:6:57:9:77:1:
:number:5:5:51:1:41:10
\end{itemize}