Annotation of loncom/html/adm/help/tex/Domain_Configuration_Scantron_Format.tex, revision 1.3
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
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
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:
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
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
1.3 ! raeburn 39: the {}``Format of data file'' dropdown in the Bubblesheet grading
1.1 raeburn 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>