Directory Listings

EvalCGI :: Overview :: Directories :: Forms :: Flags :: Security :: Utilities :: EvalSuite


Directory Browser

The directory browser is available from the main EvalCGI 'splash screen' or links ending in '...eval.cgi?browse'. There are two options: Browse Active and Browse All. A sample directory listing is shown at the right. In addition to the directory names, the browser also shows the count of enabled and disabled forms. Additional information is available to administrators by means of the info buttons * next to each directory name. The total number of directories and forms are shown at the bottom of the list. Clicking on the directory name will lead to the default directory listing described in the next section.

Directory Browser

Default Directory Listing

The default directory listing is a numbered list of links to individual forms sorted by the ETX file names. If the listing is generated by the directory browser, info buttons will lead to administrative information for each form:

Form Info Buttons

Other icons, such as the lock shown here, indicate special status, extra security in this example.

Default Directory Listing

Status Icons

Forms may have special status defined by various flags. The default evaluation form is anonymous, untimed, has average security, and is not an exam or quiz. Beginning with version 5.0, high stakes exams are no longer viewable from evalCGI (use XAM instead). However, once an exam is finished the results may be reviewed in evalCGI by changing the 'exam' flag to 'review'. Proxy forms are a special type of exam where the data are entered by a proxy such as a standardized patient.

Icon Legend

Icon Meaning
* Form with extra security
* Form with start and/or stop times
*/* Exam form / Inactive exam form
*/* Proxy form / Inactive proxy form
* Review form

Custom Directory Listing

There are two methods for creating a customized directory listing; both involve special files that override the default behavior. The simplest case is adding a file named 'index.html' to the directory. This is just a standard HTML file and won't be described further here. For full functionality use an 'index.dir' file. These files have a straight forward syntax that allows listing forms in an arbitrary order, ignoring certain forms that would otherwise be listed, as well as mixing in headings, explanatory text, and hyperlinks (see table on the left). You may add comments or temporarily suppress a line using double slashes (//).

Special 'index.dir' Formatting Syntax

Line Start Function
#head Text 'head' becomes a heading.
!form Insert 'form' at this point.
----- Insert a horizontal rule at this point.
{words|URL} Create a hypertext link with 'words'.
//comment A comment, the line is ignored.
other text Pass 'text' through as instructions/comment.

Custom Listing Example

The index.dir file listed below generated the listing on the right. Notice that the missing file 'something' generated an error.

#Heading 1
These are instructions for this section.
!faculty
!faculty2
!course
!lectures
------------
#Heading 2
!proxy
!something
!newquiz
!newxam
{Link to MedInfo|http://medinfo.ufl.edu/}
Custom Directory Listing

Submission Summary

Both types of dynamic directory listings will automatically summarize submissions for the person currently logged in. In the example on the right, this individual has submitted the first form once, the third form three times, and the second form not at all. The subjects are listed in the order they were evaluated.

Submission Summary

Version 5.0 :: September 8, 2003 :: http://evalsuite.medinfo.ufl.edu/docs/evalcgi/dirs.html