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>