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

1.1       raeburn     1: \label{Domain_Configuration_Scantron_Format}
                      2: Where scantron exams are used in a course, the format of data in the
                      3: file generated from the processing of bubbled-in scantron sheets may
                      4: vary between institutions. The format definitions available when performing
                      5: scantron grading in LON-CAPA were originally listed in the scantronformat.tab
                      6: file, stored in /home/httpd/lonTabs, which might have been modified
                      7: locally on each server. 
                      8: 
                      9: Starting with LON-CAPA 2.7, scantron format information is read from
                     10: either a custom.tab file, or a default.tab file both of which belong
                     11: to the special domain configuration user (\$dom-domainconfig, where
                     12: \$dom is the name of the domain) and which are automatically published
                     13: into resource space. 
                     14: 
                     15: For LON-CAPA installations older than 2.7, when the primary library
                     16: server for the domain has been updated, a Domain Coordinator should
                     17: display the \char`\"{}Scantron format file\char`\"{} configuration
                     18: page via \char`\"{}Domain Configuration\char`\"{}. The first time
                     19: this page is displayed, a default.tab (a copy of the standard LON-CAPA
                     20: scantronformat.tab file), and a custom.tab (if the scantronform.tab
                     21: file currently on the server differs from the standard file) will
                     22: be copied and published. Thereafter any changes to scantron format
                     23: files to be used for grading scantron exams in courses from the domain
                     24: will be made via the Domain Configuration menu. Any scantronform.tab
                     25: files in /home/httpd/lonTab directories on servers in the domain will
                     26: no longer be used.
                     27: 
                     28: The settings available via \char`\"{}Scantron format file\char`\"{}
                     29: support upload of a new custom file, or deletion of an existing custom
                     30: file (in which case grading will default to use of the default.tab
                     31: file). An uploaded scantron format file contains one or more lines
                     32: of colon-separated values for the parameters in the following order:
                     33: 
1.2     ! raeburn    34: {\scriptsize name:description:CODEtype:CODEstart:CODElength:IDstart:IDlength:Qstart:Qlength:Qoff:Qon:PaperID:PaperIDlength:FirstName:FirstNamelength:LastName:LastNamelength} 
1.1       raeburn    35: 
                     36: \begin{itemize}
                     37: \item name is the internal identifier used within LON-CAPA
                     38: \item description is the text displayed for each option in the   
                     39: the {}``Format of data file'' dropdown in the Scantron grading
                     40: screen.  The user will choose the appropriate format for the scantron
                     41: file currently being used for scantron grading.
                     42: \item CODEtype can be either 'none' 'letter' 'number' 
                     43: \item Qon can be either:
                     44: 
                     45: \begin{itemize}
                     46: \item the symbol that says a bubble has been selected, or
                     47: \item 'letter' (for when the selected letter appears), or 
                     48: \item 'number' for when a number indicating the selected letter appears 
                     49: \end{itemize}
                     50: \end{itemize}
                     51: As an example, below are four different format lines: the first two
                     52: were used at MSU prior to 2006; the last two have been used since
                     53: then.
                     54: 
                     55: \begin{itemize}
                     56: \item msunocode:MSU without any CODE:none:0:0:57:9:77:10: :1:5:5:51:1:41:10 
                     57: \item msucode:MSU with CODE in separate location:letter:69:6:57:9:77:10:
                     58: :1:5:5:51:1:41:10 
                     59: \item msucodelet:MSU with CODE in separate location (letter format):-1:69:6:57:9:77:1:
                     60: :letter:5:5:51:1:41:10 
                     61: \item msucodenum:MSU with CODE in separate location (number format):-1:69:6:57:9:77:1:
                     62: :number:5:5:51:1:41:10
                     63: \end{itemize}

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