Annotation of loncom/html/adm/help/tex/Domain_Configuration_Scantron_Format.tex, revision 1.1
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:
! 34: name:description:CODEtype:CODEstart:CODElength:IDstart:IDlength:Qstart:Qlength:Qoff:Qon:PaperID:PaperIDlength:FirstName:FirstNamelength:LastName:LastNamelength
! 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>