LABEL Tag: Indentification Fields for the Quiz-taker

  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:

    • NAME: A NAME input field is by default always provided on the quiz. The default prompt is " Please enter your name here :". If you desire to change the prompt or to require the user to type in their name, then you should create your own label field with TYPE="NAME". If you do not want to ask the user for their name, than include the ANONYMOUS tag set to ON. WhizQuiz© uses the NAME label in its response to the user on the Results page. The LENGTH attribute can set the size of the form field for this question type.
    • TEXT: This type of label can be used for accepting any type of information which does not need to be validated, e.g., address. The LENGTH attribute can set the size of the form field for this question type.
    • NUMBER: The NUMBER label field is for accepting numeric information. The user input can be checked for a fixed number of digits (ignores non-numeric characters) by using the ABSLENGTH attribute. For example, a field for entering Social Security Number, the ABSLENGTH would be 9. The LENGTH attribute can set the size of the form field for this question type.
    • POPUP: This label is for providing a list of items a user can choose from. This list is displayed by the browser in the form of a drop-down list. The CHOICES attribute must also be included when this type of LABEL is used for specifying a list of comma-separated choices. The default text displayed on the drop-down list is "(click here)". The quiz author can change that text by using POPUPDEFAULTTEXT attribute and specifying something else.

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.