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

1.1       raeburn     1: \label{Domain_Configuration_Scantron_Format}
1.4       raeburn     2: Where bubblesheet exams are used in a course, the format of data in the
                      3: file generated from the processing of bubbled-in bubblesheets may
1.1       raeburn     4: vary between institutions. The format definitions available when performing
1.4       raeburn     5: bubblesheet grading in LON-CAPA were originally listed in the scantronformat.tab
1.1       raeburn     6: file, stored in /home/httpd/lonTabs, which might have been modified
                      7: locally on each server. 
                      8: 
1.4       raeburn     9: Starting with LON-CAPA 2.7, bubblesheet format information is read from
1.1       raeburn    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
1.3       raeburn    17: display the \char`\"{}Bubblesheet format file\char`\"{} configuration
1.1       raeburn    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
1.4       raeburn    22: be copied and published. Thereafter any changes to bubblesheet format
                     23: files to be used for grading bubblesheet exams in courses from the domain
1.1       raeburn    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: 
1.3       raeburn    28: The settings available via \char`\"{}Bubblesheet format file\char`\"{}
1.1       raeburn    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
1.4       raeburn    31: file). An uploaded bubblesheet format file contains one or more lines
1.1       raeburn    32: of colon-separated values for the parameters in the following order:
                     33: 
1.5     ! raeburn    34: \begin{quote}
        !            35: {\scriptsize name:description:CODEtype:CODEstart:CODElength:IDstart:IDlength:Qstart:Qlength:Qoff:Qon:PaperID:PaperIDlength:}
        !            36: {\scriptsize FirstName:FirstNamelength:LastName:LastNamelength} 
        !            37: \end{quote}
1.1       raeburn    38: 
                     39: \begin{itemize}
                     40: \item name is the internal identifier used within LON-CAPA
                     41: \item description is the text displayed for each option in the   
1.3       raeburn    42: the {}``Format of data file'' dropdown in the Bubblesheet grading
1.4       raeburn    43: screen.  The user will choose the appropriate format for the bubblesheet 
                     44: file currently being used for bubblesheet grading.
1.1       raeburn    45: \item CODEtype can be either 'none' 'letter' 'number' 
                     46: \item Qon can be either:
                     47: 
                     48: \begin{itemize}
                     49: \item the symbol that says a bubble has been selected, or
                     50: \item 'letter' (for when the selected letter appears), or 
                     51: \item 'number' for when a number indicating the selected letter appears 
                     52: \end{itemize}
                     53: \end{itemize}
                     54: As an example, below are four different format lines: the first two
                     55: were used at MSU prior to 2006; the last two have been used since
                     56: then.
                     57: 
                     58: \begin{itemize}
                     59: \item msunocode:MSU without any CODE:none:0:0:57:9:77:10: :1:5:5:51:1:41:10 
                     60: \item msucode:MSU with CODE in separate location:letter:69:6:57:9:77:10:
                     61: :1:5:5:51:1:41:10 
                     62: \item msucodelet:MSU with CODE in separate location (letter format):-1:69:6:57:9:77:1:
                     63: :letter:5:5:51:1:41:10 
                     64: \item msucodenum:MSU with CODE in separate location (number format):-1:69:6:57:9:77:1:
                     65: :number:5:5:51:1:41:10
                     66: \end{itemize}

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