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