| Syntax: | <LABEL="unique label name" PROMPT="some prompt" TYPE="NAME | TEXT | NUMBER | POPUP" [FILE="the name of an uploaded class roll file"] [REQUIRED="YES | NO"] [LOG="YES | NO"]> | |
| Other Options: |
[COLUMN="a number"] - If the FILE option is included and there is more than one column of data in the data file, then enter the number of the appropriate column to check (default=1) [DELIMITER="a character"] - If the FILE option is included and there is more than one column of data in the data file, then enter a character to seperate columns (default=whitespace) [MATCH="PARTIAL"] - If theTYPE is NAME and the FILE option is included then the MATCH option can be added to allowed to limit the matching to just the last name so it works with all common name formats (Jane Doe or Doe, Jane or Jane P. Doe or Jane Doe, Jr.). (default is absolute matching) [UNIQUE="YES | NO"] - If the FILE option is included and there only unique entries in the data file (i.e, only one Jane Doe, or if MATCH="PARTIAL" is included, then only one Doe) then the UNIQUE option can be set to YES to speed up the authentication routine. Do NOT set UNIQUE to YES if there are any non-unique entries (default=NO) [LENGTH="length of form field in number of characters "] - (max=50) for NAME, TEXT, and NUMBER type questions (NOT the maximum number of characters that can be entered) [ABSLENGTH="a number"] - required number of numeric characters that must be entered (ignores non-numeric characters) [CHOICES="choice1, choice 2, choice3"] - choices for POPUP type question [POPUPDEFAULTTEXT="some prompt"] - change the default text for a POPUP type question from "(click here)" to something else |
|
| Examples: |
< LABEL="name" PROMPT="Name:" TYPE="NAME" FILE="ENT100.txt" MATCH="PARTIAL" COLUMN="2" DELIMITER=","> <LABEL="ID" PROMPT="Enter your Student ID Number:" TYPE="NUMBER" FILE="ENT100.txt" COLUMN="1" DELIMITER="," LENGTH="11" ABSLENGTH="9" LOG="YES"> <LABEL="section" PROMPT="Choose your Section Number:" TYPE="POPUP" CHOICES="001, 002, 003, 004, 005" POPUPDEFAULTTEXT="(click me)" REQUIRED="YES" LOG="YES"> <LABEL="pet" PROMPT="What was the name of your favorite pet?:" TYPE="TEXT" LENGTH="25" REQUIRED="NO" LOG="YES"> |
|
|
The LABEL tag allows the quiz author to acquire user-specific or demographic information (e.g., name, ID number, address, section number, etc.). Labels are displayed on the Quiz page (unless the FILE option is included) below the Quiz Title and Info page link. For each LABEL a name and an appropriate PROMPT for the user should be included. Optionally, The quiz author can choose to have the information required or logged (REQUIRED or LOG set to YES). Alternatively, if those attributes are missing or are set to NO then information will not be required or logged as appropriate. LABELs are also part of the WhizQuiz Class Roll authentication feature. Quiz-takers can be required to enter values for LABEL fields that are checked against a data file. LABELs with the FILE option included are displayed on a page which if the proper values are entered will then let the quiz-taker view and take the quiz. The FILE option is the name of a class roll file(a text file) that is uploaded to the WhizQuiz server. See the "Quiz Administration" documentation for how to upload the class roll file. See the "Using the Class Roll" documentation for how to implement the Class Roll authentication feature. Four different types of LABEL fields are possible:
Beware about using required LABEL fields. If users forget to enter information in one of them and submit their quiz for grading, they told to go back and enter the missing information. In some rare circumstances, browsers will reload the quiz when the user hits the BACK button, causing the loss of the user's responses and potentially showing a new set of questions. The message returned to the user when an ABSLENGTH tag is used and the user does not enter the required number of digits, depends on whether that particular label is required or not. If the label is required, then the message is an error message. If not, then the message is a warning. If the TYPE attribute is missing, WhizQuiz© sets the label to type TEXT by default. |
||
|
Here are some examples of labels:
|
||
WhizQuiz© v.2.0
Developed at ISIS,
Virginia Tech
Send comments to the Developers
Copyright © 1996-1999, Virginia Tech, All Rights Reserved.